@flun/nodejs-mobile-gyp 1.1.3 → 1.1.4

package/lib/install.js

@@ -17,15 +17,15 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
   install = async (gyp, argv) => {
     log.stdout();
     const release = processRelease(argv, gyp, process.version, process.release),
-      // 按 create-config-gypi.js 的逻辑推断 target_arch，仅 Windows 用
+      // 按 create-config-gypi.js 的逻辑推断 target_arch,仅 Windows 用
       arch = win ? (gyp.opts.target_arch || gyp.opts.arch || process.arch || 'ia32') : '';
-    let shouldDownloadTarball = true; // 仅 Windows 下只需新 node.lib 时，避免下载 tarball
+    let shouldDownloadTarball = true; // 仅 Windows 下只需新 node.lib 时,避免下载 tarball
 
     // 确定要安装哪个版本的 Node 开发文件
     log.verbose('install', 'input version string %j', release.version);
     if (!release.semver) throw new Error('版本号无效: ' + release.version); // 无法用 semver 解析版本字符串
-    if (semver.lt(release.version, '0.8.0')) throw new Error('目标版本最低为 `0.8.0`，当前: ' + release.version);
-    // 0.x.y-pre 版本尚未发布，无法安装，直接退出
+    if (semver.lt(release.version, '0.8.0')) throw new Error('目标版本最低为 `0.8.0`,当前: ' + release.version);
+    // 0.x.y-pre 版本尚未发布,无法安装,直接退出
     if (release.semver.prerelease[0] === 'pre') {
       log.verbose('detected "pre" node version', release.version);
       if (!gyp.opts.nodedir) throw new Error('"pre" versions of node cannot be installed, use the --nodedir flag instead');
@@ -51,13 +51,13 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         for (const entry of entries) {
           if (entry.isDirectory()) await copyDirectory(path.join(src, entry.name), path.join(dest, entry.name));
           else if (entry.isFile()) {
-            // 并行安装时，Windows 上复制文件可能报文件错误，
+            // 并行安装时,Windows 上复制文件可能报文件错误,
             // 因此用指数退避解决冲突
             await backOff(async () => {
               try {
                 await fs.copyFile(path.join(src, entry.name), path.join(dest, entry.name));
               } catch (err) {
-                // 若设置了 ensure，检查文件是否已存在，存在就足够了
+                // 若设置了 ensure,检查文件是否已存在,存在就足够了
                 if (gyp.opts.ensure && err.code === 'EBUSY') {
                   try {
                     await fs.stat(path.join(dest, entry.name));
@@ -72,16 +72,16 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         }
       },
       rollback = async err => {
-        log.warn('install', '发生错误，正在回滚安装')
+        log.warn('install', '发生错误,正在回滚安装')
         await gyp.commands.remove([release.versionDir]);
         throw err;
       },
       /**
-       * EACCES 回退方案，用于处理 npm 的 `sudo` 行为：
-       * npm 在调用任何子进程（如 node-gyp）前会先降权，
-       * 于是 "nobody" 用户没有权限创建 dev dir。
-       * 作为回退，把 tmpdir() 作为本次安装的 dev dir。
-       * 这不理想，但至少编译能成功……
+       * EACCES 回退方案,用于处理 npm 的 `sudo` 行为:
+       * npm 在调用任何子进程(如 node-gyp)前会先降权,
+       * 于是 "nobody" 用户没有权限创建 dev dir;
+       * 作为回退,把 tmpdir() 作为本次安装的 dev dir;
+       * 这不理想,但至少编译能成功......
        */
       eaccesFallback = async err => {
         const noretry = '--node_gyp_internal_noretry';
@@ -90,7 +90,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         gyp.devDir = path.resolve(tmpdir, '.node-gyp');
         let userString = '';
         try {
-          userString = ` ("${os.userInfo().username}")`; // os.userInfo 在某些系统上会失败，这里不关键
+          userString = ` ("${os.userInfo().username}")`; // os.userInfo 在某些系统上会失败,这里不关键
         } catch (e) { }
         log.warn('EACCES', '当前用户%s 没有权限访问 dev dir "%s"', userString, devDir);
         log.warn('EACCES', '尝试用临时 dev dir 重新安装 "%s"', gyp.devDir);
@@ -115,7 +115,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         // 下载 Node tarball
         let extractErrors = false, extractCount = 0;
         const tarPath = gyp.opts.tarball, contentShasums = {}, expectShasums = {},
-          // 检查从 tarball 解出的文件是否有效。
+          // 检查从 tarball 解出的文件是否有效;
           // 只有 .h 头文件和 gyp 文件会被解出
           isValid = path => {
             const isValid = valid(path);
@@ -127,10 +127,10 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
           onwarn = (code, message) => {
             extractErrors = true, log.error('error while extracting tarball', code, message);
           },
-          // 下载并解压 tarball！
+          // 下载并解压 tarball!
           // 仅 Windows 上只需新 node.lib 时跳过
-          // Windows 上并行安装时（多个原生模块，很常见）tar 会报文件错误，
-          // 所以先把 tarball 解到临时目录，再复制过去
+          // Windows 上并行安装时(多个原生模块,很常见)tar 会报文件错误,
+          // 所以先把 tarball 解到临时目录,再复制过去
           tarExtractDir = win ? await fs.mkdtemp(path.join(os.tmpdir(), 'node-gyp-tmp-')) : devDir,
           downloadShasums = async () => {
             log.verbose('check download content checksum, need to download `SHASUMS256.txt`...');
@@ -159,7 +159,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
             await fs.mkdir(dir, { recursive: true }), log.verbose('streaming', name, 'to:', targetLibPath);
 
             const res = await download(gyp, libUrl);
-            // 只下载所需的 node.lib，若未拿到则抛错
+            // 只下载所需的 node.lib,若未拿到则抛错
             if (res.status !== 200) throw new Error(`${res.status} status code downloading ${name}`);
 
             return pipeline(
@@ -188,9 +188,10 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
                   tar.extract({ strip: 1, cwd: tarExtractDir, filter: isValid, onwarn })
                 )
               } catch (err) {
-                // tarball 下载出问题？
+                // tarball 下载出问题?
                 if (err.code === 'ENOTFOUND')
-                  throw new Error('这通常不是 node-gyp 或包本身的问题,而是网络问题;\n' + '通常是因为你在代理后,或网络设置异常;');
+      throw new Error('这通常不是 node-gyp 或包本身的问题,而是网络问题;\n' +
+                      '通常是因为你在代理后,或网络设置异常;');
                 throw err;
               }
             }
@@ -232,7 +233,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         }
       };
 
-    // 如果传了 --ensure，则不总是安装，只在需要时安装
+    // 如果传了 --ensure,则不总是安装,只在需要时安装
     if (gyp.opts.ensure) {
       log.verbose('install', '--ensure was passed, so won\'t reinstall if already installed');
       try {

package/lib/list.js

@@ -21,4 +21,4 @@ const fs = gracefulFs.promises,
   }
 
 list.usage = 'Prints a listing of the currently installed node development files';
-export { list }
+export { list }

package/lib/log.js

@@ -18,7 +18,7 @@ const logLevels = Object.keys(procLog.log).filter((k) => typeof procLog.log[k] =
     bg: { black: 40, red: 41, green: 42, yellow: 43, blue: 44, magenta: 45, cyan: 46, white: 47 }
   };
 
-// 日志器：负责缓冲、暂停/恢复、着色输出
+// 日志器:负责缓冲、暂停/恢复、着色输出
 class Logger {
   #buffer = [];
   #paused = null;
@@ -105,6 +105,6 @@ class Logger {
 // 用于测试时抑制日志
 const NULL_LOGGER = !!process.env.NODE_GYP_NULL_LOGGER, logger = new Logger(NULL_LOGGER ? null : process.stderr),
   stdout = NULL_LOGGER ? () => { } : (...args) => console.log(...args),
-  { notice, error, warn, info, verbose, http, silly, pause, resume } = procLog.log; // 解构 proc-log 的函数，供末尾统一导出
+  { notice, error, warn, info, verbose, http, silly, pause, resume } = procLog.log; // 解构 proc-log 的函数,供末尾统一导出
 
 export { logger, stdout, withPrefix, notice, error, warn, info, verbose, http, silly, pause, resume }

package/lib/node-gyp.js

@@ -15,11 +15,11 @@ import { list } from './list.js';
 import { remove } from './remove.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url)),
-  // 命令名到实现函数的静态映射（ESM 不支持动态 require）
+  // 命令名到实现函数的静态映射(ESM 不支持动态 require)
   commandModules = { build, clean, configure, rebuild, install, list, remove }, commands = Object.keys(commandModules);
 
 /**
- * node-gyp 主类：解析参数、分发命令、生成 usage
+ * node-gyp 主类:解析参数、分发命令、生成 usage
  */
 class Gyp extends EventEmitter {
   /**
@@ -39,7 +39,7 @@ class Gyp extends EventEmitter {
     make: String, // 'build'
     'msvs-version': String, // 'configure'
     ensure: Boolean, // 'install'
-    solution: String, // 'build'（仅 Windows）
+    solution: String, // 'build'(仅 Windows)
     proxy: String, // 'install'
     noproxy: String, // 'install'
     devdir: String, // 各处
@@ -83,7 +83,7 @@ class Gyp extends EventEmitter {
   }
 
   /**
-   * 解析传入的 argv 数组，设置 'opts'、'argv' 和 'command' 属性
+   * 解析传入的 argv 数组,设置 'opts'、'argv' 和 'command' 属性
    */
   parseArgv(argv) {
     this.opts = nopt(this.configDefs, this.shorthands, argv), this.argv = this.opts.argv.remain.slice();
@@ -91,12 +91,12 @@ class Gyp extends EventEmitter {
     const commands = this.todo = [];
     // 创建一份把别名映射后的 argv 副本
     argv = this.argv.map(arg => {
-      // 如果当前参数是命令别名（如 ls/rm）,就替换成真实命令名
+      // 如果当前参数是命令别名(如 ls/rm),就替换成真实命令名
       if (arg in this.aliases) arg = this.aliases[arg];
       return arg
     })
 
-    // 把映射后的参数处理成 "command" 对象（name 和 args 属性）
+    // 把映射后的参数处理成 "command" 对象(name 和 args 属性)
     argv.slice().forEach(arg => {
       if (arg in this.commands) {
         const args = argv.splice(0, argv.indexOf(arg));
@@ -115,7 +115,7 @@ class Gyp extends EventEmitter {
       if (name === npmConfigPrefix + 'loglevel') log.logger.level = val
       else {
         name = name.substring(npmConfigPrefix.length);  // 把用户定义的选项加入配置
-        // gyp@741b7f1 遇到零长度选项会死循环，确保过滤掉
+        // gyp@741b7f1 遇到零长度选项会死循环,确保过滤掉
         if (name) {
           // 把 force_process_config 这类名字转成 force-process-config
           if (name.includes('_')) name = name.replace(/_/g, '-');

package/lib/process-release.js

@@ -4,7 +4,7 @@ import semver from 'semver';
 import path from 'path';
 import * as log from './log.js';
 
-// 开始发布 -headers.tar.gz 的版本(io.js v3.x.x 里用的是 "ia32"，本应是 "x86")
+// 开始发布 -headers.tar.gz 的版本(io.js v3.x.x 里用的是 "ia32",本应是 "x86")
 const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42', bitsre = /\/win-(x86|x64|arm64)\//,
   bitsreV3 = /\/win-(x86|ia32|x64)\//, normalizePath = (p) => path.normalize(p).replace(/\\/g, '/'), // 统一分隔符为 /
   /**
@@ -17,16 +17,16 @@ const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42', bitsre = /\/win-
     if (!hasLibUrl) {
       // 假设传入的是 baseUrl
       if (versionMajor >= 1) return new URL('win-' + arch + '/' + name + '.lib', base).href;
-      // io.js@1.0.0 之前，32 位 node.lib 在根目录，64 位在 /x64/
+      // io.js@1.0.0 之前,32 位 node.lib 在根目录,64 位在 /x64/
       const prefix = arch === 'x86' ? '' : arch + '/';
       return new URL(prefix + name + '.lib', base).href;
     }
-    // 否则传入的已经是 .lib 地址，只需保证架构正确
+    // 否则传入的已经是 .lib 地址,只需保证架构正确
     return defaultUrl.replace(versionMajor === 3 ? bitsreV3 : bitsre, '/win-' + arch + '/');
   },
   /**
-   * 负责确定下载 URL、本地目录和文件名。
-   * 输入来自命令行开关（--target、--dist-url）、process.version 和 process.release。
+   * 负责确定下载 URL、本地目录和文件名;
+   * 输入来自命令行开关(--target、--dist-url)、process.version 和 process.release;
    */
   processRelease = (argv, gyp, defaultVersion, defaultRelease) => {
     let version = (semver.valid(argv[0]) && argv[0]) || gyp.opts.target || defaultVersion
@@ -37,18 +37,18 @@ const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42', bitsre = /\/win-
     if (!versionSemver) return { version }; // 如果 semver 不合法,那么原样返回 version
     version = versionSemver.version; // 把 version 拍平为字符串
 
-    // defaultVersion 来自 process.version，应当是合法 semver
+    // defaultVersion 来自 process.version,应当是合法 semver
     const isDefaultVersion = version === semver.parse(defaultVersion).version;
     if (!isDefaultVersion) defaultRelease = null;      // 用了 --target=x.y.z 就不能用 process.release
     if (defaultRelease) name = defaultRelease.name.replace(/io\.js/, 'iojs'); // 去掉 '.' 以便目录命名
     else {
       // 老版本 Node 或自定义 --target
-      // semver.satisfies() 不支持预发布标签，因此直接判断主版本
+      // semver.satisfies() 不支持预发布标签,因此直接判断主版本
       isNamedForLegacyIojs = versionSemver.major >= 1 && versionSemver.major < 4;
-      // isNamedForLegacyIojs 是为了支持 Electron < 4（特别是 Electron 3）
-      // 早期逻辑用它保证 iojs 版本下载 "iojs"，Node 版本下载 "node"。
-      // 但该逻辑过宽，导致 electron@3 的发布物命名为 "iojs" 才能让 node-gyp 正常工作。
-      // Electron@3 EOL 之后（2019 年底）应移除这个 hack。
+      // isNamedForLegacyIojs 是为了支持 Electron < 4(特别是 Electron 3)
+      // 早期逻辑用它保证 iojs 版本下载 "iojs",Node 版本下载 "node";
+      // 但该逻辑过宽,导致 electron@3 的发布物命名为 "iojs" 才能让 node-gyp 正常工作;
+      // Electron@3 EOL 之后(2019 年底)应移除这个 hack;
       name = isNamedForLegacyIojs ? 'iojs' : 'node';
     }
 
@@ -59,7 +59,7 @@ const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42', bitsre = /\/win-
     else distBaseUrl = 'https://nodejs.org/dist';
     distBaseUrl += '/v' + version + '/'
 
-    // 新式：基于 process.release，大部分数据已有
+    // 新式:基于 process.release,大部分数据已有
     if (defaultRelease?.headersUrl && !overrideDistUrl) {
       baseUrl = new URL('./', defaultRelease.headersUrl).href;
       libUrl32 = resolveLibUrl(name, defaultRelease.libUrl || baseUrl || distBaseUrl, 'x86', versionSemver.major);
@@ -67,14 +67,14 @@ const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42', bitsre = /\/win-
       libUrlArm64 = resolveLibUrl(name, defaultRelease.libUrl || baseUrl || distBaseUrl, 'arm64', versionSemver.major);
       tarballUrl = defaultRelease.headersUrl;
     } else {
-      // 没有 process.release 的老版本，需要做很多假设；
+      // 没有 process.release 的老版本,需要做很多假设;
       // 另外 --target=x.y.z 时也无法使用当前 process.release
       baseUrl = distBaseUrl;
       libUrl32 = resolveLibUrl(name, baseUrl, 'x86', versionSemver.major);
       libUrl64 = resolveLibUrl(name, baseUrl, 'x64', versionSemver.major);
       libUrlArm64 = resolveLibUrl(name, baseUrl, 'arm64', versionSemver.major);
 
-      // 大胆假设：任何版本号 >3.0.0 的版本，其 dist 目录都有 *-headers.tar.gz
+      // 大胆假设:任何版本号 >3.0.0 的版本,其 dist 目录都有 *-headers.tar.gz
       canGetHeaders = semver.satisfies(versionSemver, headersTarballRange);
       tarballUrl = new URL(name + '-v' + version + (canGetHeaders ? '-headers' : '') + '.tar.gz', baseUrl).href;
     }

package/lib/rebuild.js

@@ -6,4 +6,4 @@ const rebuild = async (gyp, argv) => {
 }
 
 rebuild.usage = 'Runs "clean", "configure" and "build" all at once';
-export { rebuild }
+export { rebuild }

package/lib/remove.js

@@ -14,7 +14,7 @@ const fs = gracefulFs.promises,
     // 获取用户指定的版本号
     let version = argv[0] || gyp.opts.target;
     log.verbose('remove', 'removing target version:', version);
-    if (!version) throw new Error('必须指定要删除的版本号，例如: "' + process.version + '"');
+    if (!version) throw new Error('必须指定要删除的版本号,例如: "' + process.version + '"');
 
     const versionSemver = semver.parse(version);
     if (versionSemver) version = versionSemver.version; // 把版本数组拍平为字符串
@@ -34,4 +34,4 @@ const fs = gracefulFs.promises,
   }
 
 remove.usage = 'Removes the node development files for the specified version';
-export { remove }
+export { remove }

package/lib/util.js

@@ -16,7 +16,8 @@ const { openSync, closeSync } = gracefulFs,
    */
   regGetValue = async (key, value, addOpts) => {
     const outReValue = value.replace(/\W/g, '.'), outRe = new RegExp(`^\\s+${outReValue}\\s+REG_\\w+\\s+(\\S.*)$`, 'im'),
-      reg = path.join(process.env.SystemRoot, 'System32', 'reg.exe'), regArgs = ['query', key, '/v', value].concat(addOpts);
+      reg = path.join(process.env.SystemRoot, 'System32', 'reg.exe'),
+          regArgs = ['query', key, '/v', value].concat(addOpts);
 
     log.silly('reg', 'running', reg, regArgs);
     const [err, stdout, stderr] = await execFile(reg, regArgs, { encoding: 'utf8' });
@@ -39,7 +40,7 @@ const { openSync, closeSync } = gracefulFs,
     return result[1];
   },
   /**
-   * 依次搜索多个注册表键，返回第一个可读的值
+   * 依次搜索多个注册表键,返回第一个可读的值
    */
   regSearchKeys = async (keys, value, addOpts) => {
     for (const key of keys) {
@@ -49,7 +50,7 @@ const { openSync, closeSync } = gracefulFs,
     }
   },
   /**
-   * 返回候选列表中第一个当前用户可读的文件或目录，都不存在则返回 undefined
+   * 返回候选列表中第一个当前用户可读的文件或目录,都不存在则返回 undefined
    */
   findAccessibleSync = (logprefix, dir, candidates) => {
     for (let next = 0; next < candidates.length; next++) {
@@ -58,7 +59,7 @@ const { openSync, closeSync } = gracefulFs,
       try {
         fd = openSync(candidate, 'r');
       } catch (e) {
-        // 该候选文件不存在或不可读，继续检查下一个
+        // 该候选文件不存在或不可读,继续检查下一个
         log.silly(logprefix, 'Could not open %s: %s', candidate, e.message);
         continue;
       }

package/package.json

@@ -11,7 +11,7 @@
     "bindings",
     "gyp"
   ],
-  "version": "1.1.3",
+  "version": "1.1.4",
   "installVersion": 11,
   "author": "flun <open@flun.top>",
   "bin": {

package/src/win_delay_load_hook.cc

@@ -36,4 +36,4 @@ decltype(__pfnDliNotifyHook2) __pfnDliNotifyHook2 = load_exe_hook;
 
 #pragma managed(pop)
 
-#endif
+#endif