@flun/node-mobile-app 4.0.5 → 4.0.7

package/src/install.js

@@ -8,8 +8,8 @@ import { resolveSdkPath } from './config.js';
 import { createHash } from 'crypto';
 const
   /**
-   * 内部：从 libnode 的 node_version.h 读取运行时 Node 主版本号
-   * 读不到直接报错退出（说明 libnode 目录不完整,继续执行必失败）
+   * 内部:从 libnode 的 node_version.h 读取运行时 Node 主版本号
+   * 读不到直接报错退出(说明 libnode 目录不完整,继续执行必失败)
    */
   resolveRuntimeMajor = (userProjectDir, targetPlatform) => {
     const sub = targetPlatform === 'ios' ? 'ios' : 'android',
@@ -17,16 +17,16 @@ const
         sub, 'libnode', 'include', 'node', 'node_version.h');
     if (!fs.existsSync(header)) {
       console.error(chalk.red('  [错误] 未找到 node_version.h: ' + header));
-      console.error(chalk.red('         说明 libnode 目录不完整,请重新安装依赖。')), process.exit(1);
+      console.error(chalk.red('         说明 libnode 目录不完整,请重新安装依赖;')), process.exit(1);
     }
     const m = fs.readFileSync(header, 'utf-8').match(/#define\s+NODE_MAJOR_VERSION\s+(\d+)/);
     if (!m) console.error(chalk.red('  [错误] 无法解析 node_version.h 中的 NODE_MAJOR_VERSION')), process.exit(1);
     return m[1];
   },
   /**
-   * 内部：判断用户项目的生产依赖里是否含原生模块（binding.gyp）
+   * 内部:判断用户项目的生产依赖里是否含原生模块(binding.gyp)
    * 按用户根 package.json 的 dependencies 键名,去 userProjectDir/node_modules 下逐个查
-   * 不用扫 nodejs-project/node_modules：全新构建时它还不存在
+   * 不用扫 nodejs-project/node_modules:全新构建时它还不存在
    */
   hasNativeModules = userProjectDir => {
     const pkgPath = path.join(userProjectDir, 'package.json');
@@ -42,7 +42,7 @@ const
     return false;
   },
   /**
-   * 内部：定位 @flun/nodejs-mobile-react-native 插件目录
+   * 内部:定位 @flun/nodejs-mobile-react-native 插件目录
    */
   findPluginDir = userProjectDir => {
     const candidates = [path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native')];
@@ -56,7 +56,8 @@ const
   },
   resolveNdkVersion = buildDir => {
     const gradle = path.join(buildDir, 'android', 'build.gradle');
-    if (!fs.existsSync(gradle)) console.error(chalk.red('  [错误] 未找到 android/build.gradle: ' + gradle)), process.exit(1);
+    if (!fs.existsSync(gradle))
+      console.error(chalk.red('  [错误] 未找到 android/build.gradle: ' + gradle)), process.exit(1);
     const m = fs.readFileSync(gradle, 'utf-8').match(/ndkVersion\s*=\s*"([^"]+)"/);
     if (!m) console.error(chalk.red('  [错误] 无法从 android/build.gradle 解析 ndkVersion')), process.exit(1);
     return m[1];
@@ -76,7 +77,8 @@ const
       if (entry.startsWith('@')) {
         for (const sub of fs.readdirSync(full)) {
           const pkgDir = path.join(full, sub);
-          if (fs.statSync(pkgDir).isDirectory() && fs.existsSync(path.join(pkgDir, 'binding.gyp'))) result.push(entry + '/' + sub);
+          if (fs.statSync(pkgDir).isDirectory()
+              && fs.existsSync(path.join(pkgDir, 'binding.gyp'))) result.push(entry + '/' + sub);
         }
       } else if (fs.existsSync(path.join(full, 'binding.gyp'))) result.push(entry);
     }
@@ -87,7 +89,8 @@ const
     if (!sdkPath) console.error(chalk.red('  [错误] 未找到 Android SDK,无法编译原生模块')), process.exit(1);
     const ndkVersion = resolveNdkVersion(buildDir), compileSdk = resolveCompileSdk(buildDir),
       ndkPath = path.join(sdkPath, 'ndk', ndkVersion);
-    if (!fs.existsSync(ndkPath)) console.error(chalk.red('  [错误] 未找到 NDK ' + ndkVersion + ': ' + ndkPath)), process.exit(1);
+    if (!fs.existsSync(ndkPath))
+      console.error(chalk.red('  [错误] 未找到 NDK ' + ndkVersion + ': ' + ndkPath)), process.exit(1);
     const pluginDir = findPluginDir(userProjectDir);
     if (!pluginDir) console.error(chalk.red('  [错误] 未找到 @flun/nodejs-mobile-react-native 插件')), process.exit(1);
     const libnodeDir = path.join(pluginDir, 'android', 'libnode'),
@@ -124,7 +127,9 @@ const
           path.join(targetDir, 'node_modules', '.bin'), process.env.PATH].filter(Boolean).join(path.delimiter)
         };
       console.log(chalk.cyan('  ℹ️  编译原生模块 (' + abi + ')...'));
-      try { run('npm', ['rebuild', '--build-from-source', '--no-audit', '--no-fund'], { cwd: targetDir, env, quiet: true }); }
+      try {
+        run('npm', ['rebuild', '--build-from-source', '--no-audit', '--no-fund'], { cwd: targetDir, env, quiet: true });
+      }
       catch (e) { console.error(chalk.red('  [错误] 原生模块编译失败 (' + abi + '): ' + e.message)), process.exit(1); }
       const missing = findNativePackages(targetDir).filter(name => {
         const pkgDir = path.join(targetDir, 'node_modules', name),
@@ -144,7 +149,7 @@ const
     }
   },
   /**
-   * 内部：iOS 的 WebView SSL 补丁
+   * 内部:iOS 的 WebView SSL 补丁
    */
   patchWebViewSslIos = userProjectDir => {
     const file = path.join(userProjectDir, 'node_modules', 'react-native-webview', 'apple', 'RNCWebViewImpl.m');
@@ -154,12 +159,13 @@ const
     if (c.includes('LOCALHOST_SSL_BYPASS_IOS')) return console.log(chalk.green('    ✓ iOS WebView SSL 补丁已应用'));
 
     // 在 "NSString* host = nil;" 那一段之后插入 localhost 放行
-    const anchor = '  if ([[challenge protectionSpace] authenticationMethod] == NSURLAuthenticationMethodClientCertificate) {',
+    const anchor =
+      '  if ([[challenge protectionSpace] authenticationMethod] == NSURLAuthenticationMethodClientCertificate) {',
       idx = c.indexOf(anchor);
     if (idx === -1) return console.warn(chalk.yellow('  ⚠️  RNCWebViewImpl.m 里未找到锚点,跳过 iOS SSL 补丁'));
 
     const injected = [
-      '  // LOCALHOST_SSL_BYPASS_IOS: 对 localhost/127.0.0.1 放行自签名证书（仅本地测试用）',
+      '  // LOCALHOST_SSL_BYPASS_IOS: 对 localhost/127.0.0.1 放行自签名证书(仅本地测试用)',
       '  if (host != nil && ([host isEqualToString:@"127.0.0.1"] || [host isEqualToString:@"localhost"])) {',
       '    NSURLCredential *cred = [NSURLCredential credentialForTrust:challenge.protectionSpace.serverTrust];',
       '    completionHandler(NSURLSessionAuthChallengeUseCredential, cred);',
@@ -170,13 +176,13 @@ const
 
     c = c.substring(0, idx) + injected + c.substring(idx);
     fs.writeFileSync(file, c, 'utf-8');
-    console.log(chalk.green('    ✓ 已应用 iOS WebView SSL 补丁（允许 localhost 自签证书）'));
+    console.log(chalk.green('    ✓ 已应用 iOS WebView SSL 补丁(允许 localhost 自签证书)'));
   },
   /**
    * 装用户项目的生产依赖到 <buildDir>/nodejs-assets/nodejs-project/
    * 只装 dependencies,不装 devDependencies
    * 依赖 + 环境未变化且上次构建完成时跳过,否则按需重装 / 仅优化
-   * 快照记录在 buildDir/.deps-snapshot.json（与桌面版一致）
+   * 快照记录在 buildDir/.deps-snapshot.json(与桌面版一致)
    */
   installUserDeps = async (targetDir, userProjectDir, config, buildDir, targetPlatform) => {
     const assetsDir = path.dirname(targetDir), bnmFile = path.join(assetsDir, 'BUILD_NATIVE_MODULES.txt'),
@@ -187,11 +193,12 @@ const
       runtimeMajor = resolveRuntimeMajor(userProjectDir, targetPlatform);
 
     fs.writeFileSync(bnmFile, hasNative ? '1' : '0');
-    if (hasNative) console.log(chalk.gray('  ℹ️  检测到原生模块（binding.gyp）'));
+    if (hasNative) console.log(chalk.gray('  ℹ️  检测到原生模块(binding.gyp)'));
 
     const pkg = JSON.parse(fs.readFileSync(path.join(targetDir, 'package.json'), 'utf-8')), deps = pkg.dependencies || {},
       sortedDeps = Object.keys(deps).sort().reduce((acc, k) => { acc[k] = deps[k]; return acc; }, {}),
-      installerHash = createHash('sha256').update(fs.readFileSync(new URL(import.meta.url), 'utf-8')).digest('hex').slice(0, 16),
+      installerHash = createHash('sha256').update(fs.readFileSync(new URL(import.meta.url), 'utf-8'))
+          .digest('hex').slice(0, 16),
       snapshotData = { deps: sortedDeps, type: pkg.type || '', hasNative, forceRebuild };
 
     let shouldInstall = true, shouldOptimize = thisOptimize, reasons = [];
@@ -213,7 +220,8 @@ const
       if (!installerSame) reasons.push('安装器已更新');
       if (reasons.length > 0) {
         shouldInstall = true, shouldOptimize = thisOptimize;
-        console.log(chalk.gray('  ℹ️  ' + (thisOptimize ? '重新安装依赖+优化' : '重新安装依赖') + '(原因: ' + reasons.join(', ') + ')'));
+        console.log(chalk.gray('  ℹ️  ' + (thisOptimize ? '重新安装依赖+优化' : '重新安装依赖')
+            + '(原因: ' + reasons.join(', ') + ')'));
       }
       else if (thisOptimize && !lastOptimized)
         shouldInstall = false, shouldOptimize = true, console.log(chalk.gray('  ℹ️  依赖与环境未变化,仅需优化'));
@@ -222,7 +230,8 @@ const
         await clearVerified(buildDir);
         return;
       }
-    } else console.log(chalk.gray('  ℹ️  ' + (thisOptimize ? '重新安装依赖+优化' : '重新安装依赖') + '(原因: 缓存快照缺失)'));
+    } else
+      console.log(chalk.gray('  ℹ️  ' + (thisOptimize ? '重新安装依赖+优化' : '重新安装依赖') + '(原因: 缓存快照缺失)'));
 
     if (shouldInstall) {
       if (fs.existsSync(nodeModulesDir))
@@ -231,7 +240,7 @@ const
       try { fs.rmSync(snapshotPath, { force: true }); } catch { }
       const env = { ...process.env };
       if (hasNative) env.NODEJS_MOBILE_BUILD_NATIVE_MODULES = '1';
-      console.log(chalk.cyan('  安装用户生产依赖（nodejs-assets/nodejs-project）...'));
+      console.log(chalk.cyan('  安装用户生产依赖(nodejs-assets/nodejs-project)...'));
       run('npm', ['install', '--omit=dev', '--no-audit', '--no-fund'], { cwd: targetDir, env, quiet: true });
       const snap = {
         ...snapshotData, platform: targetPlatform, abiFilters, runtimeMajor,
@@ -250,9 +259,9 @@ const
           targetPlatform, abiFilters, runtimeMajor, exclude: optimizeCfg.exclude || [], snapshotDir: buildDir
         });
       } catch (err) {
-        console.error(chalk.red('  [错误] node_modules 优化失败：' + err.message));
+        console.error(chalk.red('  [错误] node_modules 优化失败:' + err.message));
         console.error(chalk.red('  [提示] 可在 mobileAppConfig.js 中设置 optimize: { enabled: false } 关闭优化,'));
-        console.error(chalk.red('         或用 optimize: { exclude: ["包名"] } 排除问题包。')), process.exit(1);
+        console.error(chalk.red('         或用 optimize: { exclude: ["包名"] } 排除问题包;')), process.exit(1);
       }
     }
   },
@@ -270,14 +279,15 @@ const
     const before = c;
     c = c.replace(/abiFilters\s*=\s*\[[^\]]*\]/, `abiFilters = [${abiList}]`);
 
-    if (c !== before) fs.writeFileSync(file, c, 'utf-8'), console.log(chalk.green(`  ✓ 已设置插件 abiFilters = [${abiList}]`));
+    if (c !== before) fs.writeFileSync(file, c, 'utf-8'),
+      console.log(chalk.green(`  ✓ 已设置插件 abiFilters = [${abiList}]`));
   },
   /**
    * 让 react-native-webview 对 localhost 自签名证书放行
    * Android: patch RNCWebViewClient.java
    * iOS:     patch RNCWebViewImpl.m
    * 仅在 config.webview.allowSelfSignedCert === true 时应用
-   * 每次 test/build 都检查（npm 重装 webview 后会覆盖补丁）
+   * 每次 test/build 都检查(npm 重装 webview 后会覆盖补丁)
    */
   patchWebViewSsl = (userProjectDir, config) => {
     if (!config.webview || config.webview.allowSelfSignedCert !== true) return;
@@ -296,9 +306,10 @@ const
           const cancelIndex = c.indexOf(old, methodIndex);
           if (cancelIndex !== -1) {
             const newCode = [
-              '// LOCALHOST_SSL_BYPASS: 对 localhost/127.0.0.1 放行自签名证书（仅本地测试用）',
+              '// LOCALHOST_SSL_BYPASS: 对 localhost/127.0.0.1 放行自签名证书(仅本地测试用)',
               '        if (failingUrl != null',
-              '            && (failingUrl.startsWith("https://127.0.0.1") || failingUrl.startsWith("https://localhost"))) {',
+              '            && (failingUrl.startsWith("https://127.0.0.1") || ' +
+              '            failingUrl.startsWith("https://localhost"))) {',
               '            handler.proceed();',
               '            return;',
               '        }',
@@ -306,7 +317,7 @@ const
             ].join('\n');
             c = c.substring(0, cancelIndex) + newCode + c.substring(cancelIndex + old.length);
             fs.writeFileSync(file, c, 'utf-8');
-            console.log(chalk.green('    ✓ 已应用 Android WebView SSL 补丁（允许 localhost 自签证书）'));
+            console.log(chalk.green('    ✓ 已应用 Android WebView SSL 补丁(允许 localhost 自签证书)'));
           }
         }
       }

package/src/optimize-node-modules.js

@@ -400,7 +400,8 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
                     if (cnt > 0) cleared += cnt, pkgItems.push(`${item}(${cnt})`);
                 }
             }
-            if (process.env.OPTIMIZE_DEBUG && pkgItems.length > 0) console.log(chalk.gray(`  ✓ ${pkgRel}: ${pkgItems.join(', ')}`));
+            if (process.env.OPTIMIZE_DEBUG && pkgItems.length > 0)
+              console.log(chalk.gray(`  ✓ ${pkgRel}: ${pkgItems.join(', ')}`));
         }
         return cleared;
     },
@@ -465,17 +466,20 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
             },
             delFile = p => {
                 try {
-                    fs.statSync(p).isDirectory() ? fs.rmSync(p, { recursive: true, force: true }) : fs.unlinkSync(p), removed++;
+                    fs.statSync(p).isDirectory() ? fs.rmSync(p, { recursive: true, force: true }) 
+                        : fs.unlinkSync(p), removed++;
                 } catch { }
             },
             processDir = d => {
                 let entries;
                 try { entries = fs.readdirSync(d, { withFileTypes: true }); } catch { return; }
                 for (const e of entries) {
-                    const full = path.join(d, e.name), expectedPrebuilds = targetPlatform === 'ios' ? ['darwin'] : ['android'],
+                    const full = path.join(d, e.name),
+                        expectedPrebuilds = targetPlatform === 'ios' ? ['darwin'] : ['android'],
                         prebuildMatch = full.match(/[\\/]prebuilds[\\/](linux|darwin|win32|android)-/i);
 
-                    if (prebuildMatch && !expectedPrebuilds.includes(prebuildMatch[1].toLowerCase())) { delFile(full); continue; }
+                    if (prebuildMatch && !expectedPrebuilds.includes(prebuildMatch[1].toLowerCase()))
+                      { delFile(full); continue; }
                     if (e.isDirectory()) { processDir(full); continue; }
                     if (JS_RE.test(e.name)) continue;
                     let plat = suffixPlat(e.name), arch = null;
@@ -532,7 +536,8 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
     },
     pruneIntermediates = async nmDir => {
         let deleted = 0;
-        const MID_RE = /\.(o|d|mk|stamp|Makefile|iobj|ipdb|pdb|exp|lib|obj|vcxproj|tlog|recipe|lastbuildstate|nativecodeanalysis\.xml)$/i,
+        const MID_RE =
+        /\.(o|d|mk|stamp|Makefile|iobj|ipdb|pdb|exp|lib|obj|vcxproj|tlog|recipe|lastbuildstate|nativecodeanalysis\.xml)$/i,
             walk = d => {
                 for (const f of fs.readdirSync(d, { withFileTypes: true })) {
                     const full = path.join(d, f.name);

package/src/patcher.js

@@ -3,12 +3,12 @@ import fs from 'fs';
 import { writeIfChanged } from './utils.js';
 import chalk from 'chalk';
 
-// 把字符串中所有非 ASCII 字符转成 \uXXXX（Java Properties 规范）
+// 把字符串中所有非 ASCII 字符转成 \uXXXX(Java Properties 规范)
 // gradle.properties 按 ISO-8859-1 读取,无法改为 UTF-8
 const escapeProps = s =>
   String(s).replace(/[^\x00-\x7F]/g, ch => '\\u' + ch.charCodeAt(0).toString(16).padStart(4, '0')),
   /**
-   * 解析最终 appName：
+   * 解析最终 appName:
    *   1. config.appName
    *   2. 用户项目 package.json 的 name
    *   3. 'MyApp'
@@ -24,16 +24,16 @@ const escapeProps = s =>
     }
     return 'MyApp';
   },
-  /** 通用字符串转义基础：\\, ", \n, \r, \t */
+  /** 通用字符串转义基础:\\, ", \n, \r, \t */
   escapeStringBase = s => String(s)
     .replace(/\\/g, '\\\\')
     .replace(/"/g, '\\"')
     .replace(/\n/g, '\\n')
     .replace(/\r/g, '\\r')
     .replace(/\t/g, '\\t'),
-  /** Kotlin 字符串字面量转义：基础 + 转义 $ */
+  /** Kotlin 字符串字面量转义:基础 + 转义 $ */
   escapeKotlinString = s => escapeStringBase(s).replace(/\$/g, '\\$'),
-  /** Swift 字符串字面量转义：基础 + 转义 \( */
+  /** Swift 字符串字面量转义:基础 + 转义 \( */
   escapeSwiftString = s => escapeStringBase(s).replace(/\(/g, '\\('),
   escapeXml = s => {
     return String(s)
@@ -91,13 +91,13 @@ const escapeProps = s =>
       writeIfChanged(f, c);
     }
 
-    console.log(chalk.green(`    ✓ 应用信息：${appName} (${appId}) v${versionName}(${versionCode})`));
+    console.log(chalk.green(`    ✓ 应用信息:${appName} (${appId}) v${versionName}(${versionCode})`));
   },
   /**
-   * 把 mobileAppConfig.js 里的 Android 编译配置写入 buildDir：
-   *   - android/build.gradle 的 ext 块：minSdkVersion / targetSdkVersion / compileSdkVersion / buildToolsVersion
-   *   - android/app/build.gradle 的 manifestPlaceholders：usesCleartextTraffic
-   *   - AndroidManifest.xml：permissions（去重,始终含 INTERNET）
+   * 把 mobileAppConfig.js 里的 Android 编译配置写入 buildDir:
+   *   - android/build.gradle 的 ext 块:minSdkVersion / targetSdkVersion / compileSdkVersion / buildToolsVersion
+   *   - android/app/build.gradle 的 manifestPlaceholders:usesCleartextTraffic
+   *   - AndroidManifest.xml:permissions(去重,始终含 INTERNET)
    */
   patchAndroidConfig = (buildDir, config) => {
     const a = config.android || {}, rootGradle = path.join(buildDir, 'android', 'build.gradle'),
@@ -125,7 +125,8 @@ const escapeProps = s =>
       if (!c.includes('xmlns:tools=')) {
         c = c.replace(
           /<manifest\s+xmlns:android="[^"]*"/,
-          '<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"'
+          '<manifest xmlns:android="http://schemas.android.com/apk/res/android" ' +
+          'xmlns:tools="http://schemas.android.com/tools"'
         );
       }
       // 替换占位符值为实际值
@@ -150,15 +151,16 @@ const escapeProps = s =>
       writeIfChanged(manifestFile, c);
     }
 
-    console.log(chalk.green(`    ✓ Android 配置：SDK ${a.minSdkVersion}/${a.targetSdkVersion}/${a.compileSdkVersion},
+    console.log(chalk.green(`    ✓ Android 配置:SDK ${a.minSdkVersion}/${a.targetSdkVersion}/${a.compileSdkVersion},
       权限 ${new Set(['android.permission.INTERNET', ...(a.permissions || [])]).size} 项`));
   },
   /**
-   * 处理 Release 签名：
-   *   - config.android.signing 有值 → 写 keystore 路径到 gradle.properties,加 signingConfigs.release 块,release buildType 用它
-   *   - 没值 → 不动（release 沿用 debug,可装但不可发布）
+   * 处理 Release 签名:
+   * - config.android.signing 有值 → 写 keystore 路径到 gradle.properties,
+   * 加 signingConfigs.release 块,release buildType 用它
+   *   - 没值 → 不动(release 沿用 debug,可装但不可发布)
    *
-   * keystore 路径以用户项目根为基准。
+   * keystore 路径以用户项目根为基准;
    */
   patchSigning = (buildDir, userProjectDir, config) => {
     const signing = config.android && config.android.signing;
@@ -168,16 +170,17 @@ const escapeProps = s =>
     const _missing = ['storePassword', 'keyAlias', 'keyPassword'].filter((k) => !signing[k]);
     if (_missing.length > 0) {
       throw new Error(
-        'android.signing.keystore 已配置,但以下字段为空：' + _missing.join(', ') + '\n' +
-        '  启用签名后,keystore / storePassword / keyAlias / keyPassword 四项均为必填。\n' +
-        '  如仅需本地测试（不签名上架）,可注释掉整个 signing 块——模板默认用 debug keystore 签名。'
+        'android.signing.keystore 已配置,但以下字段为空:' + _missing.join(', ') + '\n' +
+        '  启用签名后,keystore / storePassword / keyAlias / keyPassword 四项均为必填;\n' +
+        '  如仅需本地测试(不签名上架),可注释掉整个 signing 块--模板默认用 debug keystore 签名;'
       );
     }
 
     const keystoreAbs = path.resolve(userProjectDir, signing.keystore);
-    if (!fs.existsSync(keystoreAbs)) return console.warn(chalk.yellow('  ⚠️  签名 keystore 不存在,跳过签名配置: ' + keystoreAbs));
+    if (!fs.existsSync(keystoreAbs))
+      return console.warn(chalk.yellow('  ⚠️  签名 keystore 不存在,跳过签名配置: ' + keystoreAbs));
 
-    // 1. 写 gradle.properties（追加或覆盖 MYAPP_RELEASE_*）
+    // 1. 写 gradle.properties(追加或覆盖 MYAPP_RELEASE_*)
     const propsFile = path.join(buildDir, 'android', 'gradle.properties');
     if (fs.existsSync(propsFile)) {
       let c = fs.readFileSync(propsFile, 'utf-8');
@@ -188,7 +191,7 @@ const escapeProps = s =>
       c = c.replace(/^\s*MYAPP_RELEASE_KEY_PASSWORD=.*\r?\n/gm, '');
       // 追加新的
       // gradle.properties 按 ISO-8859-1 读取,非 ASCII 字符必须转 \uXXXX 转义,
-      // 否则中文路径（如「桌面」）会被读成乱码,导致 keystore 找不到。
+      // 否则中文路径(如"桌面")会被读成乱码,导致 keystore 找不到;
       const esc = escapeProps(keystoreAbs.replace(/\\/g, '/'));
       c += `\nMYAPP_RELEASE_STORE_FILE=${esc}\n`;
       c += `MYAPP_RELEASE_STORE_PASSWORD=${escapeProps(signing.storePassword || '')}\n`;
@@ -202,7 +205,7 @@ const escapeProps = s =>
     if (fs.existsSync(gradleFile)) {
       let c = fs.readFileSync(gradleFile, 'utf-8');
 
-      // 加 release 签名块（先删旧的,避免重复）
+      // 加 release 签名块(先删旧的,避免重复)
       c = c.replace(/\s*release\s*\{\s*storeFile[\s\S]*?\}\r?\n(\s*\}\s*\r?\n)/, '$1');
       // 在 signingConfigs { 之后插入
       c = c.replace(/(signingConfigs\s*\{)/,
@@ -224,7 +227,7 @@ const escapeProps = s =>
     console.log(chalk.green('    ✓ Release 签名已配置: ' + path.basename(keystoreAbs)));
   },
   /**
-   * 应用图标：把用户提供的 PNG 缩放到 5 个 Android 密度,覆盖各 mipmap 目录下的 ic_launcher 与 ic_launcher_round
+   * 应用图标:把用户提供的 PNG 缩放到 5 个 Android 密度,覆盖各 mipmap 目录下的 ic_launcher 与 ic_launcher_round
    * 未配置或文件不存在时保持默认
    */
   patchIcon = async (buildDir, userProjectDir, config) => {
@@ -258,10 +261,11 @@ const escapeProps = s =>
     console.log(chalk.green(`    ✓ 图标已应用: ${path.basename(iconAbs)}`));
   },
   /**
-   * 写入 iOS 工程配置：
+   * 写入 iOS 工程配置:
    *   - Info.plist: CFBundleDisplayName
-   *   - project.pbxproj: PRODUCT_BUNDLE_IDENTIFIER / MARKETING_VERSION / CURRENT_PROJECT_VERSION / IPHONEOS_DEPLOYMENT_TARGET
-   * 只在 buildDir 里存在 ios/ 时执行（其余平台跳过）。
+   * - project.pbxproj: PRODUCT_BUNDLE_IDENTIFIER /
+   * MARKETING_VERSION / CURRENT_PROJECT_VERSION / IPHONEOS_DEPLOYMENT_TARGET
+   * 只在 buildDir 里存在 ios/ 时执行(其余平台跳过);
    */
   patchIosConfig = (buildDir, userProjectDir, config) => {
     const iosDir = path.join(buildDir, 'ios');
@@ -271,7 +275,7 @@ const escapeProps = s =>
       versionCode = config.versionCode, deploymentTarget = (config.ios?.deploymentTarget) || '15.1',
       plist = path.join(iosDir, 'MyApp', 'Info.plist'), pbx = path.join(iosDir, 'MyApp.xcodeproj', 'project.pbxproj'),
       appDelegate = path.join(iosDir, 'MyApp', 'AppDelegate.swift');
-    // 1. Info.plist：CFBundleDisplayName + ATS (对应 Android 的 usesCleartextTraffic)
+    // 1. Info.plist:CFBundleDisplayName + ATS (对应 Android 的 usesCleartextTraffic)
     if (fs.existsSync(plist)) {
       let c = fs.readFileSync(plist, 'utf-8');
 
@@ -336,12 +340,13 @@ const escapeProps = s =>
       writeIfChanged(appDelegate, c);
     }
 
-    console.log(chalk.green(`    ✓ iOS 配置：${appName} (${appId}) v${versionName}(${versionCode}), target ${deploymentTarget}`));
+    console.log(chalk.green(`    ✓ iOS 配置:${appName} (${appId}) v${versionName}(${versionCode})` +
+        `, target ${deploymentTarget}`));
   },
   /**
-   * iOS 应用图标：把用户提供的 PNG 缩放到 9 个尺寸,写入 AppIcon.appiconset
+   * iOS 应用图标:把用户提供的 PNG 缩放到 9 个尺寸,写入 AppIcon.appiconset
    * 同时改写 Contents.json 加 filename 字段
-   * 未配置或文件不存在时保持默认（无图标,Xcode 会用系统占位）
+   * 未配置或文件不存在时保持默认(无图标,Xcode 会用系统占位)
    */
   patchIosIcon = async (buildDir, userProjectDir, config) => {
     const iconPath = config.ios && config.ios.icon;
@@ -354,7 +359,7 @@ const escapeProps = s =>
     if (!fs.existsSync(iconDir)) return;
 
     const { Jimp } = await import('jimp'), source = await Jimp.read(iconAbs),
-      // Apple 规范：每项 (idiom, size, scale) 对应的像素尺寸与文件名
+      // Apple 规范:每项 (idiom, size, scale) 对应的像素尺寸与文件名
       variants = [
         { idiom: 'iphone', size: '20x20', scale: '2x', px: 40, name: 'Icon-App-20x20@2x.png' },
         { idiom: 'iphone', size: '20x20', scale: '3x', px: 60, name: 'Icon-App-20x20@3x.png' },

package/src/platform-ios.js

@@ -6,7 +6,7 @@ import chalk from 'chalk';
 const SCHEME = 'MyApp',
   /** iOS 相关命令只能在 macOS 上跑 */
   ensureMac = () => {
-    if (process.platform !== 'darwin') throw new Error('iOS 构建只能在 macOS 上执行（当前平台: ' + process.platform + '）');
+    if (process.platform !== 'darwin') throw new Error('iOS 构建只能在 macOS 上执行(当前平台: ' + process.platform + ')');
   },
   /** 检查 xcodebuild 是否存在 */
   checkIosTools = () => {
@@ -14,14 +14,14 @@ const SCHEME = 'MyApp',
     if (r.status !== 0) throw new Error('未找到 xcodebuild,请安装 Xcode 并运行 xcode-select --install');
   },
   /**
-   * 执行 pod install（若 Pods/ 已存在且 Podfile.lock 未变,cocoapods 会自动跳过）
+   * 执行 pod install(若 Pods/ 已存在且 Podfile.lock 未变,cocoapods 会自动跳过)
    */
   podInstall = iosDir => {
     console.log(chalk.cyan('  pod install ...')), run('pod', ['install'], { cwd: iosDir, inherit: true });
   },
   /**
    * 把 config.ios.signing.certificate 导入临时 keychain,供 xcodebuild 签名用
-   * 返回 { keychainPath, keychainPassword } 或 null（未配置 / 文件缺失）
+   * 返回 { keychainPath, keychainPassword } 或 null(未配置 / 文件缺失)
    */
   setupSigningKeychain = (buildDir, userProjectDir, config) => {
     const signing = config.ios && config.ios.signing;
@@ -37,7 +37,7 @@ const SCHEME = 'MyApp',
     ensureDir(keychainDir);
     const keychainPath = path.join(keychainDir, 'build.keychain-db'), keychainPassword = 'nmapp' + Date.now();
 
-    // 清掉同名的旧 keychain（重复构建时）
+    // 清掉同名的旧 keychain(重复构建时)
     if (fs.existsSync(keychainPath)) fs.rmSync(keychainPath, { force: true });
     console.log(chalk.cyan('  创建临时 keychain 并导入证书 ...'));
     run('security', ['create-keychain', '-p', keychainPassword, keychainPath], { quiet: true });
@@ -64,7 +64,7 @@ const SCHEME = 'MyApp',
    */
   xcodebuildArchive = (buildDir, config, release, userProjectDir) => {
     const iosDir = path.join(buildDir, 'ios'), workspace = path.join(iosDir, SCHEME + '.xcworkspace');
-    if (!fs.existsSync(workspace)) throw new Error('未找到 ' + workspace + '（pod install 是否成功？）');
+    if (!fs.existsSync(workspace)) throw new Error('未找到 ' + workspace + '(pod install 是否成功?)');
 
     const archiveDir = path.join(iosDir, 'build');
     ensureDir(archiveDir);
@@ -97,7 +97,7 @@ const SCHEME = 'MyApp',
     ensureDir(exportDir);
     const archivePath = path.join(iosDir, 'build', SCHEME + '.xcarchive'), method = release ? 'ad-hoc' : 'development',
       signing = (config.ios && config.ios.signing) || {}, teamId = signing.teamId || '',
-      // provisioningProfile 路径 → 取 basename（去扩展名）,写进 exportOptions.plist
+      // provisioningProfile 路径 → 取 basename(去扩展名),写进 exportOptions.plist
       profilePath = signing.provisioningProfile ? path.resolve(userProjectDir, signing.provisioningProfile) : '',
       profileName = profilePath ? path.basename(profilePath).replace(/\.mobileprovision$/i, '') : '',
       plistPath = path.join(iosDir, 'build', 'exportOptions.plist'),