@flun/nodejs-mobile-gyp 1.2.0 → 1.2.1

package/lib/find-visualstudio.js

@@ -11,7 +11,7 @@ const path = nodePath.win32, __dirname = nodePath.dirname(fileURLToPath(import.m
 class VisualStudioFinder {
   static findVisualStudio = (...args) => new VisualStudioFinder(...args).findVisualStudio();
 
-  log = log.withPrefix('find VS');
+  log = log.withPrefix('查找 VS');
   regSearchKeys = regSearchKeys;
   constructor(nodeSemver, configMsvsVersion) {
     this.nodeSemver = nodeSemver, this.configMsvsVersion = configMsvsVersion, this.errorLog = [], this.validVersions = [];
@@ -25,23 +25,23 @@ class VisualStudioFinder {
   async findVisualStudio() {
     this.configVersionYear = null, this.configPath = null;
     if (this.configMsvsVersion) {
-      this.addLog('msvs_version was set from command line or npm config');
+      this.addLog('已从命令行或 npm 配置设置 msvs_version');
       if (this.configMsvsVersion.match(/^\d{4}$/)) {
         this.configVersionYear = parseInt(this.configMsvsVersion, 10);
-        this.addLog(`- looking for Visual Studio version ${this.configVersionYear}`);
+        this.addLog(`- 正在查找 Visual Studio ${this.configVersionYear} 版本`);
       } else {
         this.configPath = path.resolve(this.configMsvsVersion);
-        this.addLog(`- looking for Visual Studio installed in "${this.configPath}"`);
+        this.addLog(`- 正在查找安装在 "${this.configPath}" 的 Visual Studio`);
       }
     }
-    else this.addLog('msvs_version not set from command line or npm config');
+    else this.addLog('未从命令行或 npm 配置设置 msvs_version');
 
     if (process.env.VCINSTALLDIR) {
       this.envVcInstallDir = path.resolve(process.env.VCINSTALLDIR, '..');
-      this.addLog('running in VS Command Prompt, installation path is:\n' +
+      this.addLog('运行在 VS 命令提示符中,安装路径为:\n' +
         `"${this.envVcInstallDir}"\n- will only use this version`);
     }
-    else this.addLog('VCINSTALLDIR not set, not running in VS Command Prompt');
+    else this.addLog('未设置 VCINSTALLDIR,不在 VS 命令提示符中运行');
 
     const checks = [
       () => this.findVisualStudio2017OrNewer(), () => this.findVisualStudio2015(), () => this.findVisualStudio2013()
@@ -56,32 +56,32 @@ class VisualStudioFinder {
   }
 
   succeed(info) {
-    this.log.info(`using VS${info.versionYear} (${info.version}) found at:` +
-      `\n"${info.path}"` + '\nrun with --verbose for detailed information');
+    this.log.info(`使用 VS${info.versionYear} (${info.version}),路径:` +
+      `\n"${info.path}"` + '\n加 --verbose 可查看详细信息');
     return info;
   }
 
   fail() {
     if (this.configMsvsVersion && this.envVcInstallDir)
       this.errorLog.push(
-        'msvs_version does not match this VS Command Prompt or the', 'installation cannot be used.');
+        'msvs_version 与当前 VS 命令提示符不匹配,或该安装不可用');
     else if (this.configMsvsVersion) {
       // 指定了 msvs_version 但没找到 VS,输出可接受的版本
       this.errorLog.push('');
       if (this.validVersions) {
-        this.errorLog.push('valid versions for msvs_version:');
+        this.errorLog.push('msvs_version 可用的版本:');
         this.validVersions.forEach(version => this.errorLog.push(`- "${version}"`));
       }
-      else this.errorLog.push('no valid versions for msvs_version were found');
+      else this.errorLog.push('未找到 msvs_version 可用的版本');
     }
 
     const errorLog = this.errorLog.join('\n'),
       // Windows 80 列控制台,用到 X 标记列之前(含日志前缀共 79 字符,可用 62 字符):
       infoLog = [
         '**************************************************************',
-        'You need to install the latest version of Visual Studio',
-        'including the "Desktop development with C++" workload.',
-        'For more information consult the documentation at:',
+        '需要安装最新版本的 Visual Studio,并包含',
+        '"使用 C++ 的桌面开发"工作负载;',
+        '更多说明见文档:',
         'https://github.com/nodejs/node-gyp#on-windows',
         '**************************************************************'
       ].join('\n');
@@ -97,23 +97,23 @@ class VisualStudioFinder {
       psArgs = ['-ExecutionPolicy', 'Unrestricted', '-NoProfile', '-Command',
         '&{Add-Type -Path \'' + csFile + '\';' + '[VisualStudioConfiguration.Main]::PrintJson()}'];
 
-    this.log.silly('Running', ps, psArgs);
+    this.log.silly('正在执行', ps, psArgs);
     const [err, stdout, stderr] = await execFile(ps, psArgs, { encoding: 'utf8' });
     return this.parseData(err, stdout, stderr);
   }
 
   // 解析 PowerShell 脚本输出,寻找可用的 Visual Studio 2017 或更新版本
   parseData(err, stdout, stderr) {
-    this.log.silly('PS stderr = %j', stderr)
+    this.log.silly('PS 标准错误 = %j', stderr)
 
     const failPowershell = () => {
-      this.addLog(`could not use PowerShell to find Visual Studio 2017 or newer,
-         try re-running with \'--loglevel silly\' for more details`);
+      this.addLog(`无法用 PowerShell 找到 Visual Studio 2017 或更新版本,
+         可加 '--loglevel silly' 重新运行以获取更多细节`);
       return null;
     }
 
     if (err) {
-      this.log.silly('PS err = %j', err && (err.stack || err));
+      this.log.silly('PS 错误 = %j', err && (err.stack || err));
       return failPowershell();
     }
 
@@ -121,12 +121,12 @@ class VisualStudioFinder {
     try {
       vsInfo = JSON.parse(stdout);
     } catch (e) {
-      this.log.silly('PS stdout = %j', stdout), this.log.silly(e);
+      this.log.silly('PS 标准输出 = %j', stdout), this.log.silly(e);
       return failPowershell();
     }
 
     if (!Array.isArray(vsInfo)) {
-      this.log.silly('PS stdout = %j', stdout);
+      this.log.silly('PS 标准输出 = %j', stdout);
       return failPowershell();
     }
 
@@ -145,7 +145,7 @@ class VisualStudioFinder {
     // 去掉未来版本或版本号解析失败的项
     vsInfo = vsInfo.filter(info => {
       if (info.versionYear) return true;
-      this.addLog(`unknown version "${info.version}" found at "${info.path}"`);
+      this.addLog(`在 "${info.path}" 发现未知版本 "${info.version}"`);
       return false;
     })
 
@@ -154,23 +154,23 @@ class VisualStudioFinder {
 
     for (let i = 0; i < vsInfo.length; ++i) {
       const info = vsInfo[i];
-      this.addLog(`checking VS${info.versionYear} (${info.version}) found ` + `at:\n"${info.path}"`);
+      this.addLog(`正在检查 VS${info.versionYear} (${info.version}),发现于:\n"${info.path}"`);
 
-      if (info.msBuild) this.addLog('- found "Visual Studio C++ core features"');
+      if (info.msBuild) this.addLog('- 找到 "Visual Studio C++ 核心功能"');
       else {
-        this.addLog('- "Visual Studio C++ core features" missing');
+        this.addLog('- 缺少 "Visual Studio C++ 核心功能"');
         continue;
       }
 
-      if (info.toolset) this.addLog(`- found VC++ toolset: ${info.toolset}`);
+      if (info.toolset) this.addLog(`- 找到 VC++ 工具集: ${info.toolset}`);
       else {
-        this.addLog('- missing any VC++ toolset');
+        this.addLog('- 缺少任何 VC++ 工具集');
         continue;
       }
 
-      if (info.sdk) this.addLog(`- found Windows SDK: ${info.sdk}`);
+      if (info.sdk) this.addLog(`- 找到 Windows SDK: ${info.sdk}`);
       else {
-        this.addLog('- missing any Windows SDK');
+        this.addLog('- 缺少任何 Windows SDK');
         continue;
       }
 
@@ -178,7 +178,7 @@ class VisualStudioFinder {
       return info
     }
 
-    this.addLog('could not find a version of Visual Studio 2017 or newer to use');
+    this.addLog('未找到可用的 Visual Studio 2017 或更新版本');
     return null;
   }
 
@@ -186,16 +186,16 @@ class VisualStudioFinder {
   getVersionInfo(info) {
     const match = /^(\d+)\.(\d+)\./.exec(info.version);
     if (!match) {
-      this.log.silly('- failed to parse version:', info.version);
+      this.log.silly('- 解析版本失败:', info.version);
       return {};
     }
 
-    this.log.silly('- version match = %j', match);
+    this.log.silly('- 版本匹配 = %j', match);
     const versionMajor = parseInt(match[1], 10), versionMinor = parseInt(match[2], 10),
       VERSION_YEAR = { 15: 2017, 16: 2019, 17: 2022, 18: 2026, }, versionYear = VERSION_YEAR[versionMajor];
 
     if (!versionYear) {
-      this.log.silly('- unsupported version:', versionMajor);
+      this.log.silly('- 不支持的版本:', versionMajor);
       return {};
     }
 
@@ -212,7 +212,7 @@ class VisualStudioFinder {
       msbuildPath = path.join(info.path, 'MSBuild', 'Current', 'Bin', 'MSBuild.exe'),
       msbuildPathArm64 = path.join(info.path, 'MSBuild', 'Current', 'Bin', 'arm64', 'MSBuild.exe');
     if (info.packages.indexOf(pkg) !== -1) {
-      this.log.silly('- found VC.MSBuild.Base')
+      this.log.silly('- 找到 VC.MSBuild.Base')
       if (versionYear === 2017) return path.join(info.path, 'MSBuild', '15.0', 'Bin', 'MSBuild.exe');
       if (versionYear === 2019) return msbuildPath;
     }
@@ -229,15 +229,15 @@ class VisualStudioFinder {
   // 辅助:解析 toolset 信息
   getToolset(info, versionYear) {
     const pkg = 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64', express = 'Microsoft.VisualStudio.WDExpress';
-    if (info.packages.indexOf(pkg) !== -1) this.log.silly('- found VC.Tools.x86.x64');
-    else if (info.packages.indexOf(express) !== -1) this.log.silly('- found Visual Studio Express (looking for toolset)');
+    if (info.packages.indexOf(pkg) !== -1) this.log.silly('- 找到 VC.Tools.x86.x64');
+    else if (info.packages.indexOf(express) !== -1) this.log.silly('- 找到 Visual Studio Express(正在查找工具集)');
     else return null;
 
     if (versionYear === 2017) return 'v141'
     else if (versionYear === 2019) return 'v142';
     else if (versionYear === 2022) return 'v143';
     else if (versionYear === 2026) return 'v145';
-    this.log.silly('- invalid versionYear:', versionYear);
+    this.log.silly('- versionYear 无效:', versionYear);
     return null;
   }
 
@@ -252,22 +252,22 @@ class VisualStudioFinder {
       if (!pkg.startsWith(win10SDKPrefix) && !pkg.startsWith(win11SDKPrefix)) return;
       const parts = pkg.split('.')
       if (parts.length > 5 && parts[5] !== 'Desktop') {
-        this.log.silly('- ignoring non-Desktop Win10/11SDK:', pkg);
+        this.log.silly('- 忽略非桌面版 Win10/11SDK:', pkg);
         return;
       }
       const foundSdkVer = parseInt(parts[4], 10);
       if (isNaN(foundSdkVer)) {
         // Microsoft.VisualStudio.Component.Windows10SDK.IpOverUsb
-        this.log.silly('- failed to parse Win10/11SDK number:', pkg);
+        this.log.silly('- 解析 Win10/11SDK 编号失败:', pkg);
         return;
       }
-      this.log.silly('- found Win10/11SDK:', foundSdkVer);
+      this.log.silly('- 找到 Win10/11SDK:', foundSdkVer);
       Win10or11SDKVer = Math.max(Win10or11SDKVer, foundSdkVer);
     })
 
     if (Win10or11SDKVer !== 0) return `10.0.${Win10or11SDKVer}.0`;
     else if (info.packages.indexOf(win8SDK) !== -1) {
-      this.log.silly('- found Win8SDK');
+      this.log.silly('- 找到 Win8SDK');
       return '8.1';
     }
     return null;
@@ -276,7 +276,7 @@ class VisualStudioFinder {
   // 查找可用的 Visual Studio 2015
   async findVisualStudio2015() {
     if (this.nodeSemver.major >= 19) {
-      this.addLog('not looking for VS2015 as it is only supported up to Node.js 18');
+      this.addLog('不查找 VS2015,它只支持到 Node.js 18');
       return null;
     }
     return this.findOldVS({ version: '14.0', versionMajor: 14, versionMinor: 0, versionYear: 2015, toolset: 'v140' });
@@ -285,7 +285,7 @@ class VisualStudioFinder {
   // 查找可用的 Visual Studio 2013
   async findVisualStudio2013() {
     if (this.nodeSemver.major >= 9) {
-      this.addLog('not looking for VS2013 as it is only supported up to Node.js 8')
+      this.addLog('不查找 VS2013,它只支持到 Node.js 8')
       return null;
     }
     return this.findOldVS({ version: '12.0', versionMajor: 12, versionMinor: 0, versionYear: 2013, toolset: 'v120' });
@@ -297,27 +297,27 @@ class VisualStudioFinder {
       'HKLM\\Software\\Wow6432Node\\Microsoft\\VisualStudio\\SxS\\VC7'],
       regMSBuild = 'HKLM\\Software\\Microsoft\\MSBuild\\ToolsVersions';
 
-    this.addLog(`looking for Visual Studio ${info.versionYear}`);
+    this.addLog(`正在查找 Visual Studio ${info.versionYear}`);
     try {
       let res = await this.regSearchKeys(regVC7, info.version, []);
       const msBuildRegOpts = process.arch === 'ia32' ? [] : ['/reg:32'], vsPath = path.resolve(res, '..');
-      this.addLog(`- found in "${vsPath}"`);
+      this.addLog(`- 发现于 "${vsPath}"`);
 
       try {
         res = await this.regSearchKeys([`${regMSBuild}\\${info.version}`], 'MSBuildToolsPath', msBuildRegOpts);
       } catch (err) {
-        this.addLog('- could not find MSBuild in registry for this version');
+        this.addLog('- 在注册表中未找到此版本的 MSBuild');
         return null;
       }
 
       const msBuild = path.join(res, 'MSBuild.exe');
-      this.addLog(`- MSBuild in "${msBuild}"`);
+      this.addLog(`- MSBuild 位于 "${msBuild}"`);
 
       if (!this.checkConfigVersion(info.versionYear, vsPath)) return null;
       info.path = vsPath, info.msBuild = msBuild, info.sdk = null;
       return info;
     } catch (err) {
-      this.addLog('- not found');
+      this.addLog('- 未找到');
       return null;
     }
   }
@@ -330,15 +330,15 @@ class VisualStudioFinder {
     this.validVersions.push(versionYear), this.validVersions.push(vsPath);
 
     if (this.configVersionYear && this.configVersionYear !== versionYear) {
-      this.addLog('- msvs_version does not match this version');
+      this.addLog('- msvs_version 与此版本不匹配');
       return false;
     }
     if (this.configPath && path.relative(this.configPath, vsPath) !== '') {
-      this.addLog('- msvs_version does not point to this installation');
+      this.addLog('- msvs_version 未指向此安装');
       return false;
     }
     if (this.envVcInstallDir && path.relative(this.envVcInstallDir, vsPath) !== '') {
-      this.addLog('- does not match this Visual Studio Command Prompt');
+      this.addLog('- 与当前 Visual Studio 命令提示符不匹配');
       return false;
     }
 

package/lib/install.js

@@ -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

@@ -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

@@ -137,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;
   }
 
@@ -151,28 +151,28 @@ class Gyp extends EventEmitter {
         (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))),
-      cmd = (name, desc) => `    ${chalk.cyanBright(pad(name, 19))}${chalk.gray(desc)}`,
-      opt = (flag, desc) => `    ${chalk.cyanBright(pad(flag, 19))}${chalk.gray(desc)}`;
+      row = (name, desc) => `      ${chalk.cyanBright(pad(name, 19))}${chalk.gray(desc)}`,
+      grp = name => `    ${chalk.cyan(name)}`;
     return [
-      `${chalk.blueBright('用法:')} nodejs-mobile-gyp <命令> [选项]`, '',
-      `  ${chalk.cyan('命令:')}`,
-      cmd('build', '构建模块(Windows 调 msbuild,其它平台调 make)'),
-      cmd('clean', '清理生成文件与 out 目录'),
-      cmd('configure', '为当前模块生成项目文件(Windows 为 MSVC 项目,其它平台为 Makefile)'),
-      cmd('rebuild', '依次执行 clean、configure、build'),
-      cmd('install', '安装指定 Node 版本的开发文件'),
-      cmd('list', '列出已安装的 Node 开发文件;别名 ls'),
-      cmd('remove', '移除指定版本的 Node 开发文件;别名 rm'), '',
-      `  ${chalk.cyan('选项:')}`,
-      opt('-C <路径>', '切换到该目录后执行;完整写法 --directory'),
-      opt('--devdir <路径>', '指定开发文件缓存目录,默认取系统缓存目录'),
-      opt('-j <数量>', '并行构建任务数,仅 build;完整写法 --jobs'),
-      opt('--target <版本>', '目标 Node.js 版本,默认当前主机版本'),
-      opt('--arch <架构>', '目标架构,如 arm64、ia32'),
-      opt('--debug', '输出详细日志'),
-      opt('-v', '输出版本号;完整写法 --version'), '',
-      `  ${chalk.gray('无参数、help、-h、--help 输出本帮助。')}`, '',
-      `${gold('nodejs-mobile-gyp@' + this.version)}  ${gold('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 + '/'