@flun/nodejs-mobile-gyp 1.1.4 → 1.2.1

package/bin/node-gyp.js

@@ -3,11 +3,11 @@
 import envPaths from 'env-paths';
 import os from 'os';
 import fs from 'fs';
+import chalk from 'chalk';
 import { Gyp } from '../lib/node-gyp.js';
 import * as log from '../lib/log.js';
 
-process.title = 'node-gyp';
-
+process.title = 'nodejs-mobile-gyp';
 /**
  * 处理并执行选中的命令;
  */
@@ -19,21 +19,25 @@ prog.parseArgv(process.argv), prog.devDir = prog.opts.devdir;
 if (prog.devDir) prog.devDir = prog.devDir.replace(/^~/, homeDir);
 else if (homeDir) prog.devDir = envPaths('node-gyp', { suffix: '' }).cache;
 else {
-  throw new Error(
-    "node-gyp requires that the user's home directory is specified " +
-    'in either of the environmental variables HOME or USERPROFILE. ' +
-    'Overide with: --devdir /path/to/.node-gyp');
+  throw new Error('nodejs-mobile-gyp 需要指定用户主目录,请设置环境变量 HOME 或 USERPROFILE;'
+    + '也可用 --devdir /path/to/.node-gyp 覆盖');
 }
 
 if (prog.todo.length === 0) {
+  const helpArgs = ['help', '-h', '--help'], hasHelp = process.argv.some(a => helpArgs.includes(a)),
+    unknown = prog.argv.filter(a => !helpArgs.includes(a));
   if (~process.argv.indexOf('-v') || ~process.argv.indexOf('--version')) log.stdout('v%s', prog.version);
-  else log.stdout('%s', prog.usage());
+  else if (hasHelp || unknown.length === 0) log.stdout('%s', prog.usage());
+  else {
+    console.error(`${chalk.red('✗ 未知命令: ')}${chalk.yellow(unknown[0])}`), console.error('');
+    console.log(prog.usage()), process.exit(1);
+  }
   process.exit(0);
 }
 
-log.info('it worked if it ends with', 'ok'), log.verbose('cli', process.argv),
-    log.info('using', 'node-gyp@%s', prog.version);
-log.info('using', 'node@%s | %s | %s', process.versions.node, process.platform, process.arch);
+log.info('以 ok 结尾即执行成功', 'ok'), log.verbose('cli', process.argv);
+log.info('使用', 'nodejs-mobile-gyp@%s', prog.version);
+log.info('使用', 'node@%s | %s | %s', process.versions.node, process.platform, process.arch);
 
 /**
  * 如果传了 -C/--directory,切换到该目录;
@@ -42,11 +46,11 @@ const dir = prog.opts.directory;
 if (dir) {
   try {
     const stat = fs.statSync(dir);
-    if (stat.isDirectory()) log.info('chdir', dir), process.chdir(dir);
-    else log.warn('chdir', dir + ' 不是目录');
+    if (stat.isDirectory()) log.info('切换目录', dir), process.chdir(dir);
+    else log.warn('切换目录', dir + ' 不是目录');
   } catch (e) {
-    if (e.code === 'ENOENT') log.warn('chdir', dir + ' 不是目录');
-    else log.warn('chdir', 'chdir() 出错 "%s"', e.message);
+    if (e.code === 'ENOENT') log.warn('切换目录', dir + ' 不是目录');
+    else log.warn('切换目录', '切换目录失败 "%s"', e.message);
   }
 }
 
@@ -55,16 +59,18 @@ if (dir) {
  */
 const errorMessage = () => {
   // 复制自 npm 的 lib/utils/error-handler.js
-  log.error('System', os.type() + ' ' + os.release());
-  log.error('command', process.argv.map(JSON.stringify).join(' ')), log.error('cwd', process.cwd());
-  log.error('node -v', process.version), log.error('node-gyp -v', 'v' + prog.package.version);
+  log.error('系统', os.type() + ' ' + os.release());
+  log.error('命令', process.argv.map(JSON.stringify).join(' ')), log.error('工作目录', process.cwd());
+  log.error('node 版本', process.version), log.error('nodejs-mobile-gyp 版本', 'v' + prog.package.version);
 },
   /**
    * 打印最终诊断信息
    */
   issueMessage = () => {
     errorMessage();
-    log.error('', ['node-gyp 构建你的包失败!', '请尝试更新 npm 和/或 node-gyp;若仍无法解决,请向包作者反馈;'].join('\n'));
+    log.error('', [
+      'nodejs-mobile-gyp 构建你的包失败!', '请尝试更新 npm 和/或 nodejs-mobile-gyp;若仍无法解决,请向作者反馈;'
+    ].join('\n'));
   },
   /**
    * 依次执行队列中的命令
@@ -82,12 +88,12 @@ const errorMessage = () => {
 
       if (command.name === 'list') {
         if (args.length) args.forEach((version) => log.stdout(version));
-        else log.stdout('尚未安装任何 Node 开发文件;可用 `node-gyp install` 安装指定版本;')
+        else log.stdout('尚未安装任何 Node 开发文件;可用 `nodejs-mobile-gyp install` 安装指定版本;')
       }
       else if (args.length >= 1) log.stdout(...args.slice(1))
       return run(); // 继续执行队列中的下一条命令
     } catch (err) {
-      log.error(command.name + ' error'), log.error('stack', err.stack), errorMessage(), log.error('not ok');
+      log.error(command.name + ' 命令执行出错'), log.error('堆栈', err.stack), errorMessage(), log.error('not ok');
       return process.exit(1);
     }
   };
@@ -96,7 +102,7 @@ process.on('exit', code => {
   if (!completed && !code) log.error('完成回调未被调用!'), issueMessage(), process.exit(6);
 });
 process.on('uncaughtException', err => {
-  log.error('未捕获的异常'), log.error('stack', err.stack), issueMessage(), process.exit(7);
+  log.error('未捕获的异常'), log.error('堆栈', err.stack), issueMessage(), process.exit(7);
 });
 
 run(); // 开始执行给定命令!

package/lib/Find-VisualStudio.cs

@@ -3,7 +3,8 @@
 // See accompanying file LICENSE at https://github.com/node4good/windows-autoconf
 
 // Usage:
-// powershell -ExecutionPolicy Unrestricted -Command "Add-Type -Path Find-VisualStudio.cs; [VisualStudioConfiguration.Main]::PrintJson()"
+// powershell -ExecutionPolicy Unrestricted -Command "Add-Type -Path Find-VisualStudio.cs;
+// [VisualStudioConfiguration.Main]::PrintJson()"
 // This script needs to be compatible with PowerShell v2 to run on Windows 2008R2 and Windows 7.
 
 using System;

package/lib/build.js

@@ -1,4 +1,4 @@
-import gracefulFs from 'graceful-fs';
+import gracefulFs from 'graceful-fs';
 import path from 'path';
 import { glob } from 'glob';
 import * as log from './log.js';
@@ -7,8 +7,7 @@ import os from 'os';
 import { spawnSync } from 'child_process';
 import fsSync from 'fs';
 
-const fs = gracefulFs.promises,
-  _hostIsWindows = process.platform === 'win32',
+const fs = gracefulFs.promises, _hostIsWindows = process.platform === 'win32',
   // Android 交叉编译即使宿主是 Windows,也必须走 make(make-android 生成器)
   _isAndroidCrossBuild = process.env.npm_config_platform === 'android' || process.env.npm_config_format === 'make-android',
   // win 在此文件中语义为"使用 MSBuild":仅 Windows 宿主且非 Android 交叉编译
@@ -20,12 +19,11 @@ const fs = gracefulFs.promises,
    */
   findWindowsShellDir = () => {
     if (process.platform !== 'win32') return null;
-    const tryShDir = (dir) => {
+    const tryShDir = dir => {
       try { return fsSync.existsSync(path.join(dir, 'sh.exe')) ? dir : null } catch { return null }
-    };
-    const toShDir = (gitRoot) => tryShDir(path.join(gitRoot, 'usr', 'bin'));
-    // 1) 注册表:Git for Windows 安装时必写,与 PATH 无关(最可靠)
-    const reg = process.env.SystemRoot ? path.join(process.env.SystemRoot, 'System32', 'reg.exe') : 'reg.exe';
+    }, toShDir = (gitRoot) => tryShDir(path.join(gitRoot, 'usr', 'bin')),
+      // 1) 注册表:Git for Windows 安装时必写,与 PATH 无关(最可靠)
+      reg = process.env.SystemRoot ? path.join(process.env.SystemRoot, 'System32', 'reg.exe') : 'reg.exe';
     for (const hive of ['HKLM', 'HKCU']) {
       for (const key of ['SOFTWARE\\GitForWindows', 'SOFTWARE\\WOW6432Node\\GitForWindows']) {
         try {
@@ -44,8 +42,7 @@ const fs = gracefulFs.promises,
     try {
       const gitPath = which.sync('git');
       if (gitPath) {
-        const dir = path.resolve(path.dirname(gitPath), '..', 'usr', 'bin');
-        const r = tryShDir(dir);
+        const dir = path.resolve(path.dirname(gitPath), '..', 'usr', 'bin'), r = tryShDir(dir);
         if (r) return r;
       }
     } catch { }
@@ -54,16 +51,13 @@ const fs = gracefulFs.promises,
       if (!pd) continue;
       try {
         if (fsSync.existsSync(path.join(pd, 'git.exe'))) {
-          const dir = path.resolve(pd, '..', 'usr', 'bin');
-          const r = tryShDir(dir);
+          const dir = path.resolve(pd, '..', 'usr', 'bin'), r = tryShDir(dir);
           if (r) return r;
         }
       } catch { }
     }
     // 4) 全盘符常见位置兜底
-    const suffixes = [
-      'Program Files\\Git', 'Program Files (x86)\\Git', 'Git', 'msys64',
-    ];
+    const suffixes = ['Program Files\\Git', 'Program Files (x86)\\Git', 'Git', 'msys64'];
     for (const drv of ['C:', 'D:', 'E:', 'F:']) {
       for (const sfx of suffixes) {
         const dir = tryShDir(drv + '\\' + sfx);
@@ -104,7 +98,7 @@ const fs = gracefulFs.promises,
         // 注意:msbuild 的 Condition 字符串相等比较不区分大小写
         const archLower = arch.toLowerCase(), p = archLower === 'x64' ? 'x64' : (archLower === 'arm' ? 'ARM'
           : (archLower === 'arm64' ? 'ARM64' : 'Win32'));
-        argv.push('/p:Configuration=' + buildType + ';Platform=' + p)
+        argv.push('/p:Configuration=' + buildType + ';Platform=' + p);
         if (jobs) {
           j = parseInt(jobs, 10)
           if (!isNaN(j) && j > 0) argv.push('/m:' + j);
@@ -134,21 +128,18 @@ const fs = gracefulFs.promises,
           const shellDir = findWindowsShellDir();
           if (shellDir) {
             process.env.PATH = `${shellDir};${process.env.PATH}`;
-            log.verbose('bin shell', `prepended ${shellDir} to PATH for make`);
-          } else {
-            log.warn('bin shell', 'no sh.exe found; GNU make 的 Unix 命令可能失败;建议安装 Git for Windows');
+            log.verbose('bin 环境', `已将 ${shellDir} 加入 PATH,供 make 使用`);
           }
+          else log.warn('shell 环境', '未找到 sh.exe;GNU make 的 Unix 命令可能失败;建议安装 Git for Windows');
         }
-        process.env.PATH = _hostIsWindows
-          ? `${buildBinsDir};${process.env.PATH}`
-          : `${buildBinsDir}:${process.env.PATH}`;
+        process.env.PATH = _hostIsWindows ? `${buildBinsDir};${process.env.PATH}` : `${buildBinsDir}:${process.env.PATH}`;
         await fs.mkdir(buildBinsDir, { recursive: true });
 
         if (_hostIsWindows) {
           // Windows 无 python3 名称,且创建符号链接需要管理员权限;改用 .cmd 桥接
           const shimPath = path.join(buildBinsDir, 'python3.cmd');
           await fs.writeFile(shimPath, `@echo off\r\n"${python}" %*\r\n`);
-          log.verbose('bin shims', `created python3.cmd shim to "${python}" and added to PATH`);
+          log.verbose('bin 垫片', `已创建 python3.cmd 指向 "${python}" 并加入 PATH`);
         } else {
           const symlinkDestination = path.join(buildBinsDir, 'python3');
           try {
@@ -157,16 +148,15 @@ const fs = gracefulFs.promises,
             if (err.code !== 'ENOENT') throw err;
           }
           await fs.symlink(python, symlinkDestination);
-          log.verbose('bin symlinks', `created symlink to "${python}" in "${buildBinsDir}" and added to PATH`);
+          log.verbose('bin 符号链接', `已在 "${buildBinsDir}" 创建指向 "${python}" 的符号链接并加入 PATH`);
         }
       }
 
       const proc = gyp.spawn(command, argv);
       await new Promise((resolve, reject) => proc.on('exit', async (code, signal) => {
         if (buildBinsDir) await fs.rm(buildBinsDir, { recursive: true }); // 清理构建期依赖的符号链接
-
-        if (code !== 0) return reject(new Error('`' + command + '` failed with exit code: ' + code));
-        if (signal) return reject(new Error('`' + command + '` got signal: ' + signal));
+        if (code !== 0) return reject(new Error('`' + command + '` 执行失败,退出码: ' + code));
+        if (signal) return reject(new Error('`' + command + '` 收到信号: ' + signal));
         resolve();
       }))
     },
@@ -174,16 +164,16 @@ const fs = gracefulFs.promises,
        * 用 node-which 定位 msbuild / make 可执行文件
        */
       doWhich = async () => {
-        // Windows 使用 node-gyp configure 提供的 msbuild
+        // Windows 使用 nodejs-mobile-gyp configure 提供的 msbuild
         if (win) {
-          if (!config.variables.msbuild_path) throw new Error('MSBuild 未设置,请先运行 `node-gyp configure`');
-          command = config.variables.msbuild_path, log.verbose('using MSBuild:', command), await doBuild();
+          if (!config.variables.msbuild_path) throw new Error('MSBuild 未设置,请先运行 `nodejs-mobile-gyp configure`');
+          command = config.variables.msbuild_path, log.verbose('使用 MSBuild:', command), await doBuild();
           return;
         }
 
         // 先确认构建命令在 PATH 中
         const execPath = await which(command);
-        log.verbose('`which` succeeded for `' + command + '`', execPath), await doBuild();
+        log.verbose('`which` 成功解析 `' + command + '`', execPath), await doBuild();
       },
       /**
        * Windows 下查找第一个 build/*.sln 文件
@@ -191,7 +181,7 @@ const fs = gracefulFs.promises,
       findSolutionFile = async () => {
         const files = await glob('build/*.sln')
         if (files.length === 0) throw new Error('未找到 *.sln 文件,是否运行过 configure?');
-        guessedSolution = files[0], log.verbose('found first Solution file', guessedSolution), await doWhich();
+        guessedSolution = files[0], log.verbose('找到首个解决方案文件', guessedSolution), await doWhich();
       },
       /**
        * 加载 configure 阶段生成的 config.gypi
@@ -202,7 +192,7 @@ const fs = gracefulFs.promises,
           const configPath = path.resolve('build', 'config.gypi');
           data = await fs.readFile(configPath, 'utf8');
         } catch (err) {
-          if (err.code === 'ENOENT') throw new Error('请先运行 `node-gyp configure`');
+          if (err.code === 'ENOENT') throw new Error('请先运行 `nodejs-mobile-gyp configure`');
           else throw err;
         }
 
@@ -213,13 +203,13 @@ const fs = gracefulFs.promises,
         if ('debug' in gyp.opts) buildType = gyp.opts.debug ? 'Debug' : 'Release';
         if (!buildType) buildType = 'Release';
 
-        log.verbose('build type', buildType), log.verbose('architecture', arch), log.verbose('node dev dir', nodeDir);
-        log.verbose('python', python);
+        log.verbose('构建类型', buildType), log.verbose('架构', arch), log.verbose('node 开发目录', nodeDir);
+        log.verbose('Python', python);
 
         win ? await findSolutionFile() : await doWhich();
       };
     await loadConfigGypi();
   };
 
-build.usage = 'Invokes `' + (win ? 'msbuild' : 'make') + '` and builds the module';
+build.usage = '调用 `' + (win ? 'msbuild' : 'make') + '` 构建模块';
 export { build };

package/lib/clean.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,
@@ -8,9 +8,9 @@ const fs = gracefulFs.promises,
   clean = async (gyp, argv) => {
     const buildDir = 'build';
 
-    log.verbose('clean', 'removing "%s" directory', buildDir);
+    log.verbose('清理', '正在删除 "%s" 目录', buildDir);
     await fs.rm(buildDir, { recursive: true, force: true });
   }
 
-clean.usage = 'Removes any generated build files and the "out" dir';
+clean.usage = '删除生成的构建文件与 "out" 目录';
 export { clean };

package/lib/configure.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 os from 'os';
@@ -30,11 +30,11 @@ const configure = async (gyp, argv) => {
     runGyp = async () => {
       if (!~argv.indexOf('-f') && !~argv.indexOf('--format')) {
         if (win) {
-          log.verbose('gyp', 'gyp format was not specified; forcing "msvs"');
+          log.verbose('gyp', '未指定 gyp 格式,强制使用 "msvs"');
           // 非 Windows 强制使用 make 目标
           argv.push('-f', ('format' in gyp.opts) ? gyp.opts.format : 'msvs');
         } else {
-          log.verbose('gyp', 'gyp format was not specified; forcing "make"');
+          log.verbose('gyp', '未指定 gyp 格式,强制使用 "make"');
           // 非 Windows 强制使用 make 目标
           argv.push('-f', ('format' in gyp.opts) ? gyp.opts.format : 'make');
         }
@@ -42,7 +42,7 @@ const configure = async (gyp, argv) => {
 
       configs.forEach(config => argv.push('-I', config)); // 引入所有找到的 .gypi 文件
       // AIX 和 z/OS 需要设置导出文件路径,其中包含链接所需符号
-      let nodeExpFile, nodeRootDir, candidates, logprefix = 'find exports file';
+      let nodeExpFile, nodeRootDir, candidates, logprefix = '查找导出文件';
       if (process.platform === 'aix' || process.platform === 'os390' || process.platform === 'os400') {
         const ext = process.platform === 'os390' ? 'x' : 'exp';
         nodeRootDir = findNodeDirectory();
@@ -55,10 +55,10 @@ const configure = async (gyp, argv) => {
             'out/Debug/obj.target/libnode', 'lib/libnode'].map(file => file + '.' + ext);
 
         nodeExpFile = findAccessibleSync(logprefix, nodeRootDir, candidates);
-        if (nodeExpFile !== undefined) log.verbose(logprefix, 'Found exports file: %s', nodeExpFile);
+        if (nodeExpFile !== undefined) log.verbose(logprefix, '已找到导出文件: %s', nodeExpFile);
         else {
-          const msg = msgFormat('Could not find node.%s file in %s', ext, nodeRootDir);
-          log.error(logprefix, 'Could not find exports file');
+          const msg = msgFormat('未找到 node.%s 文件,目录: %s', ext, nodeRootDir);
+          log.error(logprefix, '未找到导出文件');
           throw new Error(msg);
         }
       }
@@ -66,14 +66,14 @@ const configure = async (gyp, argv) => {
       // z/OS 需要设置 zoslib 头文件目录,其中包含 v8config.h 引用的头文件
       let zoslibIncDir;
       if (process.platform === 'os390') {
-        logprefix = "find zoslib's zos-base.h:";
+        logprefix = "查找 zoslib 的 zos-base.h:";
         let msg, zoslibIncPath = process.env.ZOSLIB_INCLUDES;
         if (zoslibIncPath) {
           zoslibIncPath = findAccessibleSync(logprefix, zoslibIncPath, ['zos-base.h']);
           if (zoslibIncPath === undefined) {
-            msg = msgFormat('Could not find zos-base.h file in the directory set ' +
-              'in ZOSLIB_INCLUDES environment variable: %s; set it ' +
-              'to the correct path, or unset it to search %s', process.env.ZOSLIB_INCLUDES, nodeRootDir)
+            msg = msgFormat('在 ZOSLIB_INCLUDES 指定的目录中未找到 zos-base.h 文件: ' +
+              '%s; 请将其设为正确路径,或取消设置以便在 ' +
+              '%s 中搜索', process.env.ZOSLIB_INCLUDES, nodeRootDir)
           }
         } else {
           candidates = [
@@ -82,14 +82,14 @@ const configure = async (gyp, argv) => {
           ]
           zoslibIncPath = findAccessibleSync(logprefix, nodeRootDir, candidates);
           if (zoslibIncPath === undefined) {
-            msg = msgFormat('Could not find any of %s in directory %s; set ' +
-              'environmant variable ZOSLIB_INCLUDES to the path ' +
-              'that contains zos-base.h', candidates.toString(), nodeRootDir)
+            msg = msgFormat('未找到 %s 中列出的任意一项(目录: %s); ' +
+              '请设置环境变量 ZOSLIB_INCLUDES 指向包含 zos-base.h 的路径',
+              candidates.toString(), nodeRootDir);
           }
         }
         if (zoslibIncPath !== undefined) {
           zoslibIncDir = path.dirname(zoslibIncPath);
-          log.verbose(logprefix, "Found zoslib's zos-base.h in: %s", zoslibIncDir);
+          log.verbose(logprefix, "在 %s 中找到 zoslib 的 zos-base.h", zoslibIncDir);
         } else if (release.version.split('.')[0] >= 16) {
           // zoslib 只随 Node v16 及以上发布
           log.error(logprefix, msg);
@@ -148,7 +148,7 @@ const configure = async (gyp, argv) => {
       await new Promise((resolve, reject) => {
         const cp = gyp.spawn(python, argv);
         cp.on('exit', code => {
-          if (code !== 0) reject(new Error('`gyp` failed with exit code: ' + code));
+          if (code !== 0) reject(new Error('`gyp` 执行失败,退出码: ' + code));
           else resolve(); // 完成
         })
       })
@@ -158,9 +158,9 @@ const configure = async (gyp, argv) => {
       if (!name) return runGyp();
 
       const fullPath = path.resolve(name);
-      log.verbose(name, 'checking for gypi file: %s', fullPath);
+      log.verbose(name, '正在检查 gypi 文件: %s', fullPath);
       try {
-        await fs.stat(fullPath), log.verbose(name, 'found gypi file'), configs.push(fullPath);
+        await fs.stat(fullPath), log.verbose(name, '已找到 gypi 文件'), configs.push(fullPath);
       } catch (err) {
         if (err.code !== 'ENOENT') throw err; // ENOENT 时继续检查下一个 gypi 文件名
       }
@@ -177,10 +177,10 @@ const configure = async (gyp, argv) => {
       return findConfigs();
     },
     createBuildDir = async () => {
-      log.verbose('build dir', 'attempting to create "build" dir: %s', buildDir);
+      log.verbose('build 目录', '正在创建 "build" 目录: %s', buildDir);
 
       const isNew = await fs.mkdir(buildDir, { recursive: true });
-      log.verbose('build dir', '"build" dir needed to be created?', isNew ? 'Yes' : 'No');
+      log.verbose('build 目录', '"build" 目录是否需要创建?', isNew ? '是' : '否');
       vsInfo = win ? await findVisualStudio(release.semver, gyp.opts['msvs-version']) : null;
       return createConfigFile();
     },
@@ -191,23 +191,23 @@ const configure = async (gyp, argv) => {
       if (gyp.opts.nodedir) {
         // 指定了 --nodedir,用它作为开发文件目录
         nodeDir = gyp.opts.nodedir.replace(/^~/, os.homedir());
-        log.verbose('get node dir', 'compiling against specified --nodedir dev files: %s', nodeDir);
+        log.verbose('获取 node 目录', '使用指定的 --nodedir 开发文件编译: %s', nodeDir);
       } else {
         // 未指定 --nodedir,先确保 Node 依赖已安装
         if ('v' + release.version !== process.version) {
           // 指定了 --target,确定目标版本
-          log.verbose('get node dir', 'compiling against --target node version: %s', release.version);
+          log.verbose('获取 node 目录', '按 --target 指定的 node 版本编译: %s', release.version);
         } else {
           // 未指定 --target,使用当前主机 Node 版本
-          log.verbose('get node dir',
-              'no --target version specified, falling back to host node version: %s', release.version);
+          log.verbose('获取 node 目录',
+              '未指定 --target 版本,回退到宿主 node 版本: %s', release.version);
         }
 
         if (!release.semver) throw new Error('版本号无效: ' + release.version); // 无法用 semver 解析版本字符串
         // 如果指定了 tarball 选项,总是删除并重装 headers 到 devdir,
         // 否则只在不存在时安装
         gyp.opts.ensure = !gyp.opts.tarball, await gyp.commands.install([release.version]);
-        log.verbose('get node dir', 'target node version installed:', release.versionDir);
+        log.verbose('获取 node 目录', '目标 node 版本已安装:', release.versionDir);
         nodeDir = path.resolve(gyp.devDir, release.versionDir);
       }
 
@@ -216,5 +216,5 @@ const configure = async (gyp, argv) => {
   return getNodeDir();
 };
 
-configure.usage = 'Generates ' + (win ? 'MSVC project files' : 'a Makefile') + ' for the current module';
+configure.usage = '为当前模块生成 ' + (win ? 'MSVC 项目文件' : 'Makefile') + ';';
 export { configure };

package/lib/create-config-gypi.js

@@ -1,4 +1,4 @@
-import gracefulFs from 'graceful-fs';
+import gracefulFs from 'graceful-fs';
 import * as log from './log.js';
 import path from 'path';
 
@@ -25,7 +25,7 @@ const fs = gracefulFs.promises,
       try {
         const baseConfigGypi = await fs.readFile(path.resolve(nodeDir, 'include/node/config.gypi'));
         return parseConfigGypi(baseConfigGypi.toString());
-      } catch (err) { log.warn('read config.gypi', err.message) }
+      } catch (err) { log.warn('读取 config.gypi', err.message) }
     }
 
     return JSON.parse(JSON.stringify(process.config)); // 回退到 process.config
@@ -89,7 +89,7 @@ const fs = gracefulFs.promises,
   createConfigGypi = async ({ gyp, buildDir, nodeDir, vsInfo, python }) => {
     const configFilename = 'config.gypi', configPath = path.resolve(buildDir, configFilename);
 
-    log.verbose('build/' + configFilename, 'creating config file');
+    log.verbose('build/' + configFilename, '正在创建配置文件');
     const config = await getCurrentConfigGypi({ gyp, nodeDir, vsInfo, python }),
       // 保证 config.gypi 中的布尔值都转成字符串
       boolsToString = (k, v) => {
@@ -101,7 +101,7 @@ const fs = gracefulFs.promises,
     // 把 config.gypi 写入 build/ 目录
     const prefix = '# Do not edit. File was generated by node-gyp\'s "configure" step',
       json = JSON.stringify(config, boolsToString, 2);
-    log.verbose('build/' + configFilename, 'writing out config file: %s', configPath);
+    log.verbose('build/' + configFilename, '正在写出配置文件: %s', configPath);
     await fs.writeFile(configPath, [prefix, json, ''].join('\n'));
     return configPath;
   };

package/lib/download.js

@@ -1,4 +1,4 @@
-import fetch from 'make-fetch-happen';
+import fetch from 'make-fetch-happen';
 import gracefulFs from 'graceful-fs';
 import * as log from './log.js';
 

package/lib/find-node-directory.js

@@ -1,4 +1,4 @@
-import path from 'path';
+import path from 'path';
 import { fileURLToPath } from 'url';
 import * as log from './log.js';
 
@@ -13,20 +13,20 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url)),
 
     // 看看上层目录结构,判断当前所处位置
     const npmParentDirectory = path.join(scriptLocation, '../../../..');
-    log.verbose('node-gyp root', 'npm_parent_directory is ' + path.basename(npmParentDirectory));
-    log.verbose('node-gyp root', 'Finding node root directory');
+    log.verbose('nodejs-mobile-gyp 根目录', 'npm 上级目录为 ' + path.basename(npmParentDirectory));
+    log.verbose('nodejs-mobile-gyp 根目录', '正在查找 node 根目录');
     let nodeRootDir = '';
     if (path.basename(npmParentDirectory) === 'deps') {
       // 处于构建目录中,脚本位于 deps/npm/node_modules/node-gyp/lib
       nodeRootDir = path.join(npmParentDirectory, '..');
-      log.verbose('node-gyp root', 'in build directory, root = ' + nodeRootDir);
+      log.verbose('nodejs-mobile-gyp 根目录', '在构建目录中,根目录 = ' + nodeRootDir);
     } else if (path.basename(npmParentDirectory) === 'node_modules') {
       // 处于 Node 安装目录中,脚本位于
       // lib/node_modules/npm/node_modules/node-gyp/lib 或
       // node_modules/npm/node_modules/node-gyp/lib(视平台而定)
       if (processObj.platform === 'win32') nodeRootDir = path.join(npmParentDirectory, '..');
       else nodeRootDir = path.join(npmParentDirectory, '../..');
-      log.verbose('node-gyp root', 'in install directory, root = ' + nodeRootDir);
+      log.verbose('nodejs-mobile-gyp 根目录', '在安装目录中,根目录 = ' + nodeRootDir);
     } else {
       // 无法判断,尝试从 node 可执行文件的位置推断
       const nodeDir = path.dirname(processObj.execPath), directoryUp = path.basename(nodeDir);