@flun/nodejs-mobile-gyp 1.1.4 → 1.2.1

package/lib/install.js

@@ -1,4 +1,4 @@
-import gracefulFs from 'graceful-fs';
+import gracefulFs from 'graceful-fs';
 import os from 'os';
 import { backOff } from 'exponential-backoff';
 import * as tar from 'tar';
@@ -22,18 +22,18 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
     let shouldDownloadTarball = true; // 仅 Windows 下只需新 node.lib 时,避免下载 tarball
 
     // 确定要安装哪个版本的 Node 开发文件
-    log.verbose('install', 'input version string %j', release.version);
+    log.verbose('安装', '输入版本字符串 %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 (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');
-      log.verbose('--nodedir flag was passed; skipping install', gyp.opts.nodedir);
+      log.verbose('检测到 "pre" 版 node', release.version);
+      if (!gyp.opts.nodedir) throw new Error('无法安装 "pre" 版本的 node,请改用 --nodedir 参数');
+      log.verbose('传入了 --nodedir 参数;跳过安装', gyp.opts.nodedir);
       return;
     }
 
-    log.verbose('install', 'installing version: %s', release.versionDir); // 版本拍平为字符串
+    log.verbose('安装', '正在安装版本: %s', release.versionDir); // 版本拍平为字符串
     const devDir = path.resolve(gyp.devDir, release.versionDir),          // 开发文件安装目录
       valid = file => {
         // 头文件
@@ -44,7 +44,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         try {
           await fs.stat(src);
         } catch {
-          throw new Error(`Missing source directory for copy: ${src}`);
+          throw new Error(`找不到要复制的源目录: ${src}`);
         }
         await fs.mkdir(dest, { recursive: true });
         const entries = await fs.readdir(src, { withFileTypes: true });
@@ -72,7 +72,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         }
       },
       rollback = async err => {
-        log.warn('install', '发生错误,正在回滚安装')
+        log.warn('安装', '发生错误,正在回滚安装')
         await gyp.commands.remove([release.versionDir]);
         throw err;
       },
@@ -92,21 +92,21 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         try {
           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);
+        log.warn('EACCES', '当前用户%s 没有权限访问开发文件目录 "%s"', userString, devDir);
+        log.warn('EACCES', '尝试用临时开发文件目录重新安装 "%s"', gyp.devDir);
         if (process.cwd() === tmpdir) {
-          log.verbose('tmpdir == cwd', 'automatically will remove dev files after to save disk space');
+          log.verbose('tmpdir 等于 cwd', '将自动删除开发文件以节省磁盘空间');
           gyp.todo.push({ name: 'remove', args: argv });
         }
         return gyp.commands.install([noretry].concat(argv));
       },
       go = async () => {
-        log.verbose('ensuring devDir is created', devDir);
+        log.verbose('正在确保 devDir 已创建', devDir);
 
         // 先创建 Node 开发文件所在目录
         try {
           const created = await fs.mkdir(devDir, { recursive: true });
-          if (created) log.verbose('created devDir', created);
+          if (created) log.verbose('已创建 devDir', created);
         } catch (err) {
           if (err.code === 'EACCES') return eaccesFallback(err);
           throw err;
@@ -119,13 +119,13 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
           // 只有 .h 头文件和 gyp 文件会被解出
           isValid = path => {
             const isValid = valid(path);
-            if (isValid) log.verbose('extracted file from tarball', path), extractCount++;
-            else log.silly('ignoring from tarball', path); // 无效
+            if (isValid) log.verbose('已从 tarball 解出文件', path), extractCount++;
+            else log.silly('忽略 tarball 中的该项', path); // 无效
 
             return isValid;
           },
           onwarn = (code, message) => {
-            extractErrors = true, log.error('error while extracting tarball', code, message);
+            extractErrors = true, log.error('解压 tarball 出错', code, message);
           },
           // 下载并解压 tarball!
           // 仅 Windows 上只需新 node.lib 时跳过
@@ -133,11 +133,11 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
           // 所以先把 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`...');
-            log.verbose('checksum url', release.shasumsUrl);
+            log.verbose('检查下载内容校验值,需要下载 `SHASUMS256.txt`...');
+            log.verbose('校验文件地址', release.shasumsUrl);
 
             const res = await download(gyp, release.shasumsUrl);
-            if (res.status !== 200) throw new Error(`${res.status}  status code downloading checksum`);
+            if (res.status !== 200) throw new Error(`下载校验文件时返回状态码 ${res.status}`);
 
             for (const line of (await res.text()).trim().split('\n')) {
               const items = line.trim().split(/\s+/);
@@ -148,24 +148,24 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
               expectShasums[name] = items[0];
             }
 
-            log.verbose('checksum data', JSON.stringify(expectShasums));
+            log.verbose('校验数据', JSON.stringify(expectShasums));
           },
           downloadNodeLib = async () => {
-            log.verbose('on Windows; need to download `' + release.name + '.lib`...');
+            log.verbose('Windows 上;需要下载 `' + release.name + '.lib`...');
             const dir = path.resolve(tarExtractDir, arch), targetLibPath = path.resolve(dir, release.name + '.lib'),
               { libUrl, libPath } = release[arch], name = `${arch} ${release.name}.lib`;
 
-            log.verbose(name, 'dir', dir), log.verbose(name, 'url', libUrl);
-            await fs.mkdir(dir, { recursive: true }), log.verbose('streaming', name, 'to:', targetLibPath);
+            log.verbose(name, '目录', dir), log.verbose(name, '地址', libUrl);
+            await fs.mkdir(dir, { recursive: true }), log.verbose('正在流式写入', name, '到:', targetLibPath);
 
             const res = await download(gyp, libUrl);
             // 只下载所需的 node.lib,若未拿到则抛错
-            if (res.status !== 200) throw new Error(`${res.status} status code downloading ${name}`);
+            if (res.status !== 200) throw new Error(`下载 ${name} 时返回状态码 ${res.status}`);
 
             return pipeline(
               res.body,
               new ShaSum((_, checksum) => {
-                contentShasums[libPath] = checksum, log.verbose('content checksum', libPath, checksum)
+                contentShasums[libPath] = checksum, log.verbose('内容校验值', libPath, checksum)
               }), createWriteStream(targetLibPath)
             );
           };
@@ -177,20 +177,20 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
               try {
                 const res = await download(gyp, release.tarballUrl);
 
-                if (res.status !== 200) throw new Error(`${res.status} response downloading ${release.tarballUrl}`);
+                if (res.status !== 200) throw new Error(`下载 ${release.tarballUrl} 时返回状态码 ${res.status}`);
                 await pipeline(
                   res.body,
                   // 内容校验和
                   new ShaSum((_, checksum) => {
                     const filename = path.basename(release.tarballUrl).trim();
-                    contentShasums[filename] = checksum, log.verbose('content checksum', filename, checksum);
+                    contentShasums[filename] = checksum, log.verbose('内容校验值', filename, checksum);
                   }),
                   tar.extract({ strip: 1, cwd: tarExtractDir, filter: isValid, onwarn })
                 )
               } catch (err) {
                 // tarball 下载出问题?
                 if (err.code === 'ENOTFOUND')
-      throw new Error('这通常不是 node-gyp 或包本身的问题,而是网络问题;\n' +
+      throw new Error('这通常不是 nodejs-mobile-gyp 或包本身的问题,而是网络问题;\n' +
                       '通常是因为你在代理后,或网络设置异常;');
                 throw err;
               }
@@ -198,7 +198,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
 
             // tarball 解压完成后调用
             if (extractErrors || extractCount === 0) throw new Error('下载/解压 tarball 时发生致命错误');
-            log.verbose('tarball', 'done parsing tarball');
+            log.verbose('tarball', '解析 tarball 完成');
           }
 
           const installVersionPath = path.resolve(tarExtractDir, 'installVersion');
@@ -211,12 +211,12 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
             ...(!tarPath || win ? [downloadShasums()] : [])
           ])
 
-          log.verbose('download contents checksum', JSON.stringify(contentShasums));
+          log.verbose('下载内容校验值', JSON.stringify(contentShasums));
           // 校验内容 shasum
           for (const k in contentShasums) {
-            log.verbose('validating download checksum for ' + k, '(%s == %s)', contentShasums[k], expectShasums[k]);
+            log.verbose('正在校验 ' + k + ' 的下载校验值', '(%s == %s)', contentShasums[k], expectShasums[k]);
             if (contentShasums[k] !== expectShasums[k]) {
-              throw new Error(k + ' local checksum ' + contentShasums[k] + ' not match remote ' + expectShasums[k]);
+              throw new Error(k + ' 本地校验值与远程不一致: ' + contentShasums[k] + ' != ' + expectShasums[k]);
             }
           }
 
@@ -235,12 +235,12 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
 
     // 如果传了 --ensure,则不总是安装,只在需要时安装
     if (gyp.opts.ensure) {
-      log.verbose('install', '--ensure was passed, so won\'t reinstall if already installed');
+      log.verbose('安装', '传入了 --ensure,已安装时不再重装');
       try {
         await fs.stat(devDir);
       } catch (err) {
         if (err.code === 'ENOENT') {
-          log.verbose('install', 'version not already installed, continuing with install', release.version);
+          log.verbose('安装', '版本尚未安装,继续安装', release.version);
           try {
             return await go();
           } catch (err) { return rollback(err) }
@@ -248,7 +248,7 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
         else if (err.code === 'EACCES') return eaccesFallback(err);
         throw err;
       }
-      log.verbose('install', 'version is already installed, need to check "installVersion"');
+      log.verbose('安装', '版本已安装,需要检查 "installVersion"');
       const installVersionFile = path.resolve(devDir, 'installVersion');
       let installVersion = 0;
       try {
@@ -257,23 +257,23 @@ const { createWriteStream, promises: fs } = gracefulFs, { pipeline } = streamPro
       } catch (err) {
         if (err.code !== 'ENOENT') throw err;
       }
-      log.verbose('got "installVersion"', installVersion);
-      log.verbose('needs "installVersion"', gyp.package.installVersion);
+      log.verbose('得到 "installVersion"', installVersion);
+      log.verbose('需要 "installVersion"', gyp.package.installVersion);
       if (installVersion < gyp.package.installVersion) {
-        log.verbose('install', 'version is no good; reinstalling');
+        log.verbose('安装', '版本不可用;重新安装');
         try {
           return await go();
         } catch (err) { return rollback(err) }
       }
-      log.verbose('install', 'version is good');
+      log.verbose('安装', '版本可用');
       if (win) {
-        log.verbose('on Windows; need to check node.lib');
+        log.verbose('Windows 上;需要检查 node.lib');
         const nodeLibPath = path.resolve(devDir, arch, 'node.lib');
         try {
           await fs.stat(nodeLibPath);
         } catch (err) {
           if (err.code === 'ENOENT') {
-            log.verbose('install', `version not already installed for ${arch}, continuing with install`, release.version);
+            log.verbose('安装', `版本尚未为 ${arch} 安装,继续安装`, release.version);
             try {
               shouldDownloadTarball = false;
               return await go();
@@ -307,5 +307,5 @@ class ShaSum extends Transform {
   }
 }
 
-install.usage = 'Install node development files for the specified node version.';
+install.usage = '安装指定 node 版本的 node 开发文件;';
 export { install }

package/lib/list.js

@@ -1,4 +1,4 @@
-import gracefulFs from 'graceful-fs';
+import gracefulFs from 'graceful-fs';
 import * as log from './log.js';
 
 const fs = gracefulFs.promises,
@@ -9,7 +9,7 @@ const fs = gracefulFs.promises,
     const devDir = gyp.devDir;
     let versions = [];
 
-    log.verbose('list', 'using node-gyp dir:', devDir);
+    log.verbose('列表', '使用 node-gyp 目录:', devDir);
     try {
       const dir = await fs.readdir(devDir);
       if (Array.isArray(dir)) versions = dir.filter((v) => v !== 'current');
@@ -20,5 +20,5 @@ const fs = gracefulFs.promises,
     return versions;
   }
 
-list.usage = 'Prints a listing of the currently installed node development files';
+list.usage = '列出当前已安装的 node 开发文件';
 export { list }

package/lib/node-gyp.js

@@ -1,5 +1,6 @@
-import path from 'path';
+import path from 'path';
 import nopt from 'nopt';
+import chalk from 'chalk';
 import * as log from './log.js';
 import childProcess from 'child_process';
 import { EventEmitter } from 'events';
@@ -50,6 +51,7 @@ class Gyp extends EventEmitter {
     tarball: String, // 'install'
     jobs: String, // 'build'
     thin: String, // 'configure'
+    target: String, // 'rebuild'、'remove'、'install' 等处
     'force-process-config': Boolean // 'configure'
   }
 
@@ -135,7 +137,7 @@ class Gyp extends EventEmitter {
     if (!opts) opts = {};
     if (!opts.silent && !opts.stdio) opts.stdio = [0, 1, 2];
     const cp = childProcess.spawn(command, args, opts);
-    log.info('spawn', command), log.info('spawn args', args);
+    log.info('启动命令', command), log.info('命令参数', args);
     return cp;
   }
 
@@ -143,10 +145,34 @@ class Gyp extends EventEmitter {
    * 返回 node-gyp 的用法说明
    */
   usage() {
+    const gold = chalk.hex('#B8860B'),
+      wide = cp => (cp >= 0x1100 && cp <= 0x115F) || (cp >= 0x2E80 && cp <= 0xA4CF) ||
+        (cp >= 0xAC00 && cp <= 0xD7A3) || (cp >= 0xF900 && cp <= 0xFAFF) ||
+        (cp >= 0xFE30 && cp <= 0xFE4F) || (cp >= 0xFF00 && cp <= 0xFF60) || (cp >= 0xFFE0 && cp <= 0xFFE6),
+      width = s => [...s].reduce((n, ch) => n + (wide(ch.codePointAt(0)) ? 2 : 1), 0),
+      pad = (s, n) => s + ' '.repeat(Math.max(0, n - width(s))),
+      row = (name, desc) => `      ${chalk.cyanBright(pad(name, 19))}${chalk.gray(desc)}`,
+      grp = name => `    ${chalk.cyan(name)}`;
     return [
-      '', '  Usage: node-gyp <command> [options]', '', '  where <command> is one of:',
-      commands.map((c) => '    - ' + c + ' - ' + commandModules[c].usage).join('\n'), '',
-      'node-gyp@' + this.version + '  ' + path.resolve(__dirname, '..'), 'node@' + process.versions.node
+      `  ${chalk.blueBright('用法:')} nodejs-mobile-gyp <命令> [选项]`, '',
+      grp('命令'),
+      row('build', '构建模块(Windows 调 msbuild,其它平台调 make)'),
+      row('clean', '清理生成文件与 out 目录'),
+      row('configure', '为当前模块生成项目文件(Windows 为 MSVC 项目,其它平台为 Makefile)'),
+      row('rebuild', '依次执行 clean、configure、build'),
+      row('install', '安装指定 Node 版本的开发文件'),
+      row('list', '列出已安装的 Node 开发文件;别名 ls'),
+      row('remove', '移除指定版本的 Node 开发文件;别名 rm'), '',
+      grp('选项'),
+      row('-C <path>', '切换到该目录后执行;完整写法 --directory'),
+      row('--devdir <path>', '指定开发文件缓存目录,默认取系统缓存目录'),
+      row('-j <count>', '并行构建任务数,仅 build;完整写法 --jobs'),
+      row('--target <version>', '目标 Node.js 版本,默认当前主机版本'),
+      row('--arch <arch>', '目标架构,如 arm64、ia32'),
+      row('--debug', '输出详细日志'),
+      row('-v', '输出版本号;完整写法 --version'), '',
+      `  ${chalk.gray('无参数、help、-h、--help 输出本帮助;')}`, '',
+      `  ${gold('nodejs-mobile-gyp@' + this.version)}  ${gold('node@' + process.versions.node)}`
     ].join('\n');
   }
 }

package/lib/process-release.js

@@ -54,7 +54,7 @@ const headersTarballRange = '>= 3.0.0 || ~0.12.10 || ~0.10.42', bitsre = /\/win-
 
     // 检查 nvm.sh 标准镜像环境变量
     if (!overrideDistUrl && process.env.NODEJS_ORG_MIRROR) overrideDistUrl = process.env.NODEJS_ORG_MIRROR;
-    if (overrideDistUrl) log.verbose('download', 'using dist-url', overrideDistUrl);
+    if (overrideDistUrl) log.verbose('下载', '使用 dist-url', overrideDistUrl);
     if (overrideDistUrl) distBaseUrl = overrideDistUrl.replace(/\/+$/, '');
     else distBaseUrl = 'https://nodejs.org/dist';
     distBaseUrl += '/v' + version + '/'

package/lib/rebuild.js

@@ -1,9 +1,9 @@
-/**
+/**
  * 依次执行 clean、configure、build
  */
 const rebuild = async (gyp, argv) => {
   gyp.todo.push({ name: 'clean', args: [] }, { name: 'configure', args: argv }, { name: 'build', args: [] });
 }
 
-rebuild.usage = 'Runs "clean", "configure" and "build" all at once';
+rebuild.usage = '依次执行 "clean"、"configure" 和 "build"';
 export { rebuild }

package/lib/remove.js

@@ -1,4 +1,4 @@
-import gracefulFs from 'graceful-fs';
+import gracefulFs from 'graceful-fs';
 import path from 'path';
 import * as log from './log.js';
 import semver from 'semver';
@@ -9,29 +9,29 @@ const fs = gracefulFs.promises,
    */
   remove = async (gyp, argv) => {
     const devDir = gyp.devDir;
-    log.verbose('remove', 'using node-gyp dir:', devDir);
+    log.verbose('移除', '使用 node-gyp 目录:', devDir);
 
     // 获取用户指定的版本号
     let version = argv[0] || gyp.opts.target;
-    log.verbose('remove', 'removing target version:', version);
+    log.verbose('移除', '正在移除目标版本:', version);
     if (!version) throw new Error('必须指定要删除的版本号,例如: "' + process.version + '"');
 
     const versionSemver = semver.parse(version);
     if (versionSemver) version = versionSemver.version; // 把版本数组拍平为字符串
 
     const versionPath = path.resolve(gyp.devDir, version);
-    log.verbose('remove', 'removing development files for version:', version);
+    log.verbose('移除', '正在移除该版本的开发文件:', version);
 
     // 先检查是否安装过
     try {
       await fs.stat(versionPath);
     } catch (err) {
-      if (err.code === 'ENOENT') return 'version was already uninstalled: ' + version;
+      if (err.code === 'ENOENT') return '该版本已卸载: ' + version;
       throw err;
     }
 
     await fs.rm(versionPath, { recursive: true, force: true });
   }
 
-remove.usage = 'Removes the node development files for the specified version';
+remove.usage = '移除指定版本的 node 开发文件';
 export { remove }

package/lib/util.js

@@ -1,73 +1,73 @@
-import cp from 'child_process';
-import path from 'path';
-import gracefulFs from 'graceful-fs';
-import * as log from './log.js';
-
-const { openSync, closeSync } = gracefulFs,
-  /**
-   * 执行外部命令并返回 [err, stdout, stderr]
-   */
-  execFile = async (...args) => new Promise(resolve => {
-    const child = cp.execFile(...args, (...a) => resolve(a));
-    child.stdin.end();
-  }),
-  /**
-   * 读取 Windows 注册表指定键的值
-   */
-  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);
-
-    log.silly('reg', 'running', reg, regArgs);
-    const [err, stdout, stderr] = await execFile(reg, regArgs, { encoding: 'utf8' });
-
-    log.silly('reg', 'reg.exe stdout = %j', stdout);
-    if (err || stderr.trim() !== '') {
-      log.silly('reg', 'reg.exe err = %j', err && (err.stack || err));
-      log.silly('reg', 'reg.exe stderr = %j', stderr);
-      if (err) throw err;
-      throw new Error(stderr);
-    }
-
-    const result = outRe.exec(stdout)
-    if (!result) {
-      log.silly('reg', 'error parsing stdout');
-      throw new Error('无法解析 reg.exe 的输出');
-    }
-
-    log.silly('reg', 'found: %j', result[1]);
-    return result[1];
-  },
-  /**
-   * 依次搜索多个注册表键,返回第一个可读的值
-   */
-  regSearchKeys = async (keys, value, addOpts) => {
-    for (const key of keys) {
-      try {
-        return await regGetValue(key, value, addOpts);
-      } catch { continue }
-    }
-  },
-  /**
-   * 返回候选列表中第一个当前用户可读的文件或目录,都不存在则返回 undefined
-   */
-  findAccessibleSync = (logprefix, dir, candidates) => {
-    for (let next = 0; next < candidates.length; next++) {
-      const candidate = path.resolve(dir, candidates[next]);
-      let fd;
-      try {
-        fd = openSync(candidate, 'r');
-      } catch (e) {
-        // 该候选文件不存在或不可读,继续检查下一个
-        log.silly(logprefix, 'Could not open %s: %s', candidate, e.message);
-        continue;
-      }
-      closeSync(fd), log.silly(logprefix, 'Found readable %s', candidate);
-      return candidate;
-    }
-
-    return undefined;
-  }
-
+import cp from 'child_process';
+import path from 'path';
+import gracefulFs from 'graceful-fs';
+import * as log from './log.js';
+
+const { openSync, closeSync } = gracefulFs,
+  /**
+   * 执行外部命令并返回 [err, stdout, stderr]
+   */
+  execFile = async (...args) => new Promise(resolve => {
+    const child = cp.execFile(...args, (...a) => resolve(a));
+    child.stdin.end();
+  }),
+  /**
+   * 读取 Windows 注册表指定键的值
+   */
+  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);
+
+    log.silly('reg', '正在执行', reg, regArgs);
+    const [err, stdout, stderr] = await execFile(reg, regArgs, { encoding: 'utf8' });
+
+    log.silly('reg', 'reg.exe stdout = %j', stdout);
+    if (err || stderr.trim() !== '') {
+      log.silly('reg', 'reg.exe err = %j', err && (err.stack || err));
+      log.silly('reg', 'reg.exe stderr = %j', stderr);
+      if (err) throw err;
+      throw new Error(stderr);
+    }
+
+    const result = outRe.exec(stdout)
+    if (!result) {
+      log.silly('reg', '解析 stdout 出错');
+      throw new Error('无法解析 reg.exe 的输出');
+    }
+
+    log.silly('reg', '找到: %j', result[1]);
+    return result[1];
+  },
+  /**
+   * 依次搜索多个注册表键,返回第一个可读的值
+   */
+  regSearchKeys = async (keys, value, addOpts) => {
+    for (const key of keys) {
+      try {
+        return await regGetValue(key, value, addOpts);
+      } catch { continue }
+    }
+  },
+  /**
+   * 返回候选列表中第一个当前用户可读的文件或目录,都不存在则返回 undefined
+   */
+  findAccessibleSync = (logprefix, dir, candidates) => {
+    for (let next = 0; next < candidates.length; next++) {
+      const candidate = path.resolve(dir, candidates[next]);
+      let fd;
+      try {
+        fd = openSync(candidate, 'r');
+      } catch (e) {
+        // 该候选文件不存在或不可读,继续检查下一个
+        log.silly(logprefix, '无法打开 %s: %s', candidate, e.message);
+        continue;
+      }
+      closeSync(fd), log.silly(logprefix, '可读取: %s', candidate);
+      return candidate;
+    }
+
+    return undefined;
+  }
+
 export { execFile, regGetValue, regSearchKeys, findAccessibleSync }

package/package.json

@@ -11,7 +11,7 @@
     "bindings",
     "gyp"
   ],
-  "version": "1.1.4",
+  "version": "1.2.1",
   "installVersion": 11,
   "author": "flun <open@flun.top>",
   "bin": {
@@ -20,33 +20,33 @@
   "main": "./lib/node-gyp.js",
   "files": [
     "bin/",
-    "gyp/gyp",
-    "gyp/gyp.bat",
-    "gyp/gyp_main.py",
-    "gyp/LICENSE",
+    "gyp/data/",
     "gyp/pylib/gyp/",
     "gyp/pylib/packaging/",
-    "gyp/data/",
     "!gyp/pylib/gyp/__pycache__/",
     "!gyp/pylib/gyp/generator/__pycache__/",
     "!gyp/pylib/gyp/**/*_test.py",
     "!gyp/pylib/packaging/__pycache__/",
+    "gyp/gyp",
+    "gyp/gyp_main.py",
+    "gyp/gyp.bat",
     "lib/",
     "src/",
     "addon.gypi",
-    "README.md",
     "CHANGELOG.md",
+    "README.md",
     "LICENSE"
   ],
   "dependencies": {
+    "chalk": "^6.0.1",
     "env-paths": "^4.0.0",
     "exponential-backoff": "^3.1.3",
-    "glob": "^13.0.6",
+    "glob": "^14.0.3",
     "graceful-fs": "^4.2.11",
     "make-fetch-happen": "^16.0.1",
     "nopt": "^10.0.1",
     "proc-log": "^7.0.0",
-    "semver": "^7.8.5",
+    "semver": "^7.8.6",
     "tar": "^7.5.22",
     "which": "^7.0.0"
   },