@flun/node-mobile-app 4.0.3 → 4.0.5

package/src/install.js

@@ -25,7 +25,7 @@ const
   },
   /**
    * 内部：判断用户项目的生产依赖里是否含原生模块（binding.gyp）
-   * 按用户根 package.json 的 dependencies 键名，去 userProjectDir/node_modules 下逐个查
+   * 按用户根 package.json 的 dependencies 键名,去 userProjectDir/node_modules 下逐个查
    * 不用扫 nodejs-project/node_modules：全新构建时它还不存在
    */
   hasNativeModules = userProjectDir => {
@@ -100,7 +100,8 @@ const
     const toolchain = path.join(ndkPath, 'toolchains', 'llvm', 'prebuilt', hostTag),
       assetsDir = path.dirname(targetDir), gradleProjectDir = path.join(buildDir, 'android');
     const patchScript = path.join(pluginDir, 'scripts', 'patch-package.js');
-    if (fs.existsSync(patchScript)) run(process.execPath, [patchScript, path.join(targetDir, 'node_modules')], { cwd: targetDir, inherit: true });
+    if (fs.existsSync(patchScript)) run(process.execPath, [patchScript, path.join(targetDir, 'node_modules')],
+      { cwd: targetDir, inherit: true });
     for (const abi of abiFilters) {
       const map = ABI_MAP[abi];
       if (!map) console.error(chalk.red('  [错误] 不支持的 ABI: ' + abi)), process.exit(1);
@@ -119,7 +120,8 @@ const
           RANLIB: path.join(toolchain, 'bin', 'llvm-ranlib' + binSuffix),
           GYP_DEFINES: 'target_arch=' + map.arch + ' v8_target_arch=' + map.arch + ' android_target_arch=' + map.arch +
             ' host_os=' + hostOs + ' OS=android android_ndk_path=' + ndkPath.replace(/\\/g, '/'),
-          PATH: [path.join(ndkPath, 'prebuilt', hostTag, 'bin'), path.join(toolchain, 'bin'), path.join(targetDir, 'node_modules', '.bin'), process.env.PATH].filter(Boolean).join(path.delimiter)
+          PATH: [path.join(ndkPath, 'prebuilt', hostTag, 'bin'), path.join(toolchain, 'bin'),
+          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 }); }
@@ -154,7 +156,7 @@ const
     // 在 "NSString* host = nil;" 那一段之后插入 localhost 放行
     const anchor = '  if ([[challenge protectionSpace] authenticationMethod] == NSURLAuthenticationMethodClientCertificate) {',
       idx = c.indexOf(anchor);
-    if (idx === -1) return console.warn(chalk.yellow('  ⚠️  RNCWebViewImpl.m 里未找到锚点，跳过 iOS SSL 补丁'));
+    if (idx === -1) return console.warn(chalk.yellow('  ⚠️  RNCWebViewImpl.m 里未找到锚点,跳过 iOS SSL 补丁'));
 
     const injected = [
       '  // LOCALHOST_SSL_BYPASS_IOS: 对 localhost/127.0.0.1 放行自签名证书（仅本地测试用）',
@@ -172,8 +174,8 @@ const
   },
   /**
    * 装用户项目的生产依赖到 <buildDir>/nodejs-assets/nodejs-project/
-   * 只装 dependencies，不装 devDependencies
-   * 依赖 + 环境未变化且上次构建完成时跳过；否则按需重装 / 仅优化
+   * 只装 dependencies,不装 devDependencies
+   * 依赖 + 环境未变化且上次构建完成时跳过,否则按需重装 / 仅优化
    * 快照记录在 buildDir/.deps-snapshot.json（与桌面版一致）
    */
   installUserDeps = async (targetDir, userProjectDir, config, buildDir, targetPlatform) => {
@@ -201,8 +203,7 @@ const
         envSame = old.platform === targetPlatform && JSON.stringify(old.abiFilters) === JSON.stringify(abiFilters) &&
           old.runtimeMajor === runtimeMajor,
         lastOptimized = old.optimized !== false, selfHashSame = old.optimizeHash === SELF_HASH,
-        installerSame = old.installerHash === installerHash,
-        nmExists = fs.existsSync(nodeModulesDir);
+        installerSame = old.installerHash === installerHash, nmExists = fs.existsSync(nodeModulesDir);
       if (!depsSame) reasons.push('依赖清单已变化');
       if (!verifiedOk) reasons.push('上次构建未完成');
       if (!envSame) reasons.push('运行环境已变化');
@@ -240,8 +241,8 @@ const
       console.log(chalk.green('    ✓ 用户依赖安装完成'));
     }
 
-    if (hasNative && targetPlatform === 'android' && shouldInstall) compileNativeModules(targetDir, userProjectDir, config, buildDir, abiFilters);
-
+    if (hasNative && targetPlatform === 'android' && shouldInstall)
+      compileNativeModules(targetDir, userProjectDir, config, buildDir, abiFilters);
     if (shouldOptimize) {
       console.log(chalk.cyan('  [信息] 正在执行优化...'));
       try {
@@ -260,7 +261,7 @@ const
    */
   patchNodejsMobilePlugin = (userProjectDir, config) => {
     const pluginDir = findPluginDir(userProjectDir);
-    if (!pluginDir) return console.warn(chalk.yellow('  ⚠️  未找到 @flun/nodejs-mobile-react-native 插件，跳过 patch'));
+    if (!pluginDir) return console.warn(chalk.yellow('  ⚠️  未找到 @flun/nodejs-mobile-react-native 插件,跳过 patch'));
 
     const file = path.join(pluginDir, 'android', 'build.gradle'),
       abiList = config.android.abiFilters.map((x) => `"${x}"`).join(', ');
@@ -271,7 +272,6 @@ const
 
     if (c !== before) fs.writeFileSync(file, c, 'utf-8'), console.log(chalk.green(`  ✓ 已设置插件 abiFilters = [${abiList}]`));
   },
-
   /**
    * 让 react-native-webview 对 localhost 自签名证书放行
    * Android: patch RNCWebViewClient.java
@@ -314,4 +314,4 @@ const
     patchWebViewSslIos(userProjectDir); // iOS 分支
   };
 
-export { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl };
+export { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl };

package/src/optimize-node-modules.js

@@ -464,15 +464,17 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
                 return null;
             },
             delFile = p => {
-                try { fs.statSync(p).isDirectory() ? fs.rmSync(p, { recursive: true, force: true }) : fs.unlinkSync(p), removed++; } catch { }
+                try {
+                    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);
-                    const 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 (e.isDirectory()) { processDir(full); continue; }
                     if (JS_RE.test(e.name)) continue;
@@ -496,7 +498,7 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
         return removed;
     },
     // ==================== 清开发文件 ====================
-    pruneDevFiles = async (nmDir) => {
+    pruneDevFiles = async nmDir => {
         let deleted = 0;
         const PATTERNS = [
             /(^|\/)tsconfig\.json$/,
@@ -521,8 +523,7 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
                         walk(full);
                     } else {
                         const rel = toPosix(path.relative(nmDir, full));
-                        if (PATTERNS.some(re => re.test(rel)))
-                            try { fs.unlinkSync(full), deleted++; } catch { }
+                        if (PATTERNS.some(re => re.test(rel))) try { fs.unlinkSync(full), deleted++; } catch { }
                     }
                 }
             };
@@ -536,7 +537,8 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
                 for (const f of fs.readdirSync(d, { withFileTypes: true })) {
                     const full = path.join(d, f.name);
                     if (f.isDirectory()) walk(full);
-                    else if (full.includes(path.sep + 'obj.target' + path.sep) || f.name === 'Makefile' || f.name.endsWith('.orig') || MID_RE.test(f.name)) try { fs.unlinkSync(full), deleted++; } catch { }
+                    else if (full.includes(path.sep + 'obj.target' + path.sep) || f.name === 'Makefile' ||
+                        f.name.endsWith('.orig') || MID_RE.test(f.name)) try { fs.unlinkSync(full), deleted++; } catch { }
                 }
             };
         walk(nmDir);
@@ -702,4 +704,4 @@ const SELF_HASH = (() => {
     } catch { return 'unknown'; }
 })();
 
-export { clearVerified, markVerified, optimizeNodeModules, SELF_HASH };
+export { clearVerified, markVerified, optimizeNodeModules, SELF_HASH };

package/src/patcher.js

@@ -4,7 +4,7 @@ import { writeIfChanged } from './utils.js';
 import chalk from 'chalk';
 
 // 把字符串中所有非 ASCII 字符转成 \uXXXX（Java Properties 规范）
-// gradle.properties 按 ISO-8859-1 读取，无法改为 UTF-8
+// 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')),
   /**
@@ -97,7 +97,7 @@ const escapeProps = s =>
    * 把 mobileAppConfig.js 里的 Android 编译配置写入 buildDir：
    *   - android/build.gradle 的 ext 块：minSdkVersion / targetSdkVersion / compileSdkVersion / buildToolsVersion
    *   - android/app/build.gradle 的 manifestPlaceholders：usesCleartextTraffic
-   *   - AndroidManifest.xml：permissions（去重，始终含 INTERNET）
+   *   - AndroidManifest.xml：permissions（去重,始终含 INTERNET）
    */
   patchAndroidConfig = (buildDir, config) => {
     const a = config.android || {}, rootGradle = path.join(buildDir, 'android', 'build.gradle'),
@@ -116,7 +116,7 @@ const escapeProps = s =>
       writeIfChanged(rootGradle, c);
     }
     // 2. AndroidManifest.xml: 直接写死 usesCleartextTraffic + tools:replace
-    //    不用占位符，因为 AGP release 构建在 targetSdk>=28 时会强制 false
+    //    不用占位符,因为 AGP release 构建在 targetSdk>=28 时会强制 false
     if (fs.existsSync(manifestFile)) {
       let c = fs.readFileSync(manifestFile, 'utf-8');
       const ct = a.usesCleartextTraffic !== false ? 'true' : 'false';
@@ -155,8 +155,8 @@ const escapeProps = s =>
   },
   /**
    * 处理 Release 签名：
-   *   - config.android.signing 有值 → 写 keystore 路径到 gradle.properties，加 signingConfigs.release 块，release buildType 用它
-   *   - 没值 → 不动（release 沿用 debug，可装但不可发布）
+   *   - config.android.signing 有值 → 写 keystore 路径到 gradle.properties,加 signingConfigs.release 块,release buildType 用它
+   *   - 没值 → 不动（release 沿用 debug,可装但不可发布）
    *
    * keystore 路径以用户项目根为基准。
    */
@@ -164,18 +164,18 @@ const escapeProps = s =>
     const signing = config.android && config.android.signing;
     if (!signing || !signing.keystore) return; // 未配置签名 → 保持默认
 
-    // 启用签名后 4 项均为必填；缺项时提前报错，避免 Gradle 报"password incorrect"误导排查
+    // 启用签名后 4 项均为必填,缺项时提前报错,避免 Gradle 报"password incorrect"误导排查
     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_*）
     const propsFile = path.join(buildDir, 'android', 'gradle.properties');
@@ -187,8 +187,8 @@ const escapeProps = s =>
       c = c.replace(/^\s*MYAPP_RELEASE_KEY_ALIAS=.*\r?\n/gm, '');
       c = c.replace(/^\s*MYAPP_RELEASE_KEY_PASSWORD=.*\r?\n/gm, '');
       // 追加新的
-      // gradle.properties 按 ISO-8859-1 读取，非 ASCII 字符必须转 \uXXXX 转义，
-      // 否则中文路径（如「桌面」）会被读成乱码，导致 keystore 找不到。
+      // gradle.properties 按 ISO-8859-1 读取,非 ASCII 字符必须转 \uXXXX 转义,
+      // 否则中文路径（如「桌面」）会被读成乱码,导致 keystore 找不到。
       const esc = escapeProps(keystoreAbs.replace(/\\/g, '/'));
       c += `\nMYAPP_RELEASE_STORE_FILE=${esc}\n`;
       c += `MYAPP_RELEASE_STORE_PASSWORD=${escapeProps(signing.storePassword || '')}\n`;
@@ -197,12 +197,12 @@ const escapeProps = s =>
       writeIfChanged(propsFile, c);
     }
 
-    // 2. app/build.gradle: 加 signingConfigs.release，并让 buildTypes.release 用它
+    // 2. app/build.gradle: 加 signingConfigs.release,并让 buildTypes.release 用它
     const gradleFile = path.join(buildDir, 'android', 'app', 'build.gradle');
     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 +224,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) => {
@@ -232,7 +232,7 @@ const escapeProps = s =>
     if (!iconPath) return;
 
     const iconAbs = path.resolve(userProjectDir, iconPath);
-    if (!fs.existsSync(iconAbs)) return console.warn(chalk.yellow('  ⚠️  图标文件不存在，保持默认: ' + iconAbs));
+    if (!fs.existsSync(iconAbs)) return console.warn(chalk.yellow('  ⚠️  图标文件不存在,保持默认: ' + iconAbs));
 
     const { Jimp } = await import('jimp'),
       densities = [
@@ -339,16 +339,16 @@ const escapeProps = s =>
     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;
     if (!iconPath) return;
 
     const iconAbs = path.resolve(userProjectDir, iconPath);
-    if (!fs.existsSync(iconAbs)) return console.warn(chalk.yellow('  ⚠️  iOS 图标文件不存在，保持默认: ' + iconAbs));
+    if (!fs.existsSync(iconAbs)) return console.warn(chalk.yellow('  ⚠️  iOS 图标文件不存在,保持默认: ' + iconAbs));
 
     const iconDir = path.join(buildDir, 'ios', 'MyApp', 'Images.xcassets', 'AppIcon.appiconset');
     if (!fs.existsSync(iconDir)) return;
@@ -378,7 +378,7 @@ const escapeProps = s =>
       fs.writeFileSync(path.join(iconDir, v.name), buf);
     }
 
-    // 改写 Contents.json，给每项加 filename
+    // 改写 Contents.json,给每项加 filename
     writeIfChanged(contentsFile, JSON.stringify(contents, null, 2) + '\n');
     console.log(chalk.green(`    ✓ iOS 图标已应用: ${path.basename(iconAbs)}`));
   }
@@ -386,4 +386,4 @@ const escapeProps = s =>
 export {
   resolveAppName, escapeKotlinString, escapeSwiftString, patchAppConfig, patchAndroidConfig, patchSigning,
   patchIcon, patchIosConfig, patchIosIcon
-};
+};

package/src/platform-ios.js

@@ -11,16 +11,16 @@ const SCHEME = 'MyApp',
   /** 检查 xcodebuild 是否存在 */
   checkIosTools = () => {
     const r = run('which', ['xcodebuild'], { stdio: 'pipe' });
-    if (r.status !== 0) throw new Error('未找到 xcodebuild，请安装 Xcode 并运行 xcode-select --install');
+    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 签名用
+   * 把 config.ios.signing.certificate 导入临时 keychain,供 xcodebuild 签名用
    * 返回 { keychainPath, keychainPassword } 或 null（未配置 / 文件缺失）
    */
   setupSigningKeychain = (buildDir, userProjectDir, config) => {
@@ -29,7 +29,7 @@ const SCHEME = 'MyApp',
 
     const certPath = path.resolve(userProjectDir, signing.certificate);
     if (!fs.existsSync(certPath)) {
-      console.warn(chalk.yellow('  ⚠️  iOS 签名证书不存在，跳过: ' + certPath));
+      console.warn(chalk.yellow('  ⚠️  iOS 签名证书不存在,跳过: ' + certPath));
       return null;
     }
 
@@ -81,7 +81,7 @@ const SCHEME = 'MyApp',
 
     if (teamId) args.push('DEVELOPMENT_TEAM=' + teamId);
 
-    // 若配置了 certificate，导入临时 keychain 并让 xcodebuild 使用
+    // 若配置了 certificate,导入临时 keychain 并让 xcodebuild 使用
     const keychain = setupSigningKeychain(buildDir, userProjectDir, config);
     if (keychain) args.push('OTHER_CODE_SIGN_FLAGS=--keychain ' + keychain.keychainPath);
 
@@ -89,7 +89,7 @@ const SCHEME = 'MyApp',
     return archivePath;
   },
   /**
-   * xcodebuild -exportArchive，导出 .ipa
+   * xcodebuild -exportArchive,导出 .ipa
    * 返回 .ipa 路径
    */
   xcodebuildExport = (buildDir, config, release, outDir, userProjectDir) => {
@@ -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'),

package/src/utils.js

@@ -21,7 +21,7 @@ const ensureDir = dir => {
     return false;
   },
   /**
-   * 递归复制，exclude 支持 'node_modules/'、'*.log'、'.git/'
+   * 递归复制,exclude 支持 'node_modules/'、'*.log'、'.git/'
    */
   copyDir = (src, dest, exclude = []) => {
     ensureDir(dest);
@@ -36,8 +36,8 @@ const ensureDir = dir => {
   readJson = file => JSON.parse(fs.readFileSync(file, 'utf-8')),
   writeJson = (file, obj) => fs.writeFileSync(file, JSON.stringify(obj, null, 2) + '\n', 'utf-8'),
   /**
-   * 内容不同才写文件，避免不必要的 mtime 变化触发下游（Gradle/Metro）重编
-   * 返回 true 表示写入了，false 表示内容相同跳过
+   * 内容不同才写文件,避免不必要的 mtime 变化触发下游（Gradle/Metro）重编
+   * 返回 true 表示写入了,false 表示内容相同跳过
    */
   writeIfChanged = (file, content) => {
     if (fs.existsSync(file)) {
@@ -49,7 +49,7 @@ const ensureDir = dir => {
     return true;
   },
   /**
-   * 大小和 mtime 都一致才跳过复制，否则复制
+   * 大小和 mtime 都一致才跳过复制,否则复制
    * 用于用户项目 → nodejs-project 的增量复制
    */
   copyFileIfChanged = (src, dst) => {
@@ -70,9 +70,9 @@ const ensureDir = dir => {
   },
   /**
    * 统一的子进程启动：
-   * - Windows：.cmd / .bat 需经 shell；把命令与参数拼成单字符串，
+   * - Windows：.cmd / .bat 需经 shell；把命令与参数拼成单字符串,
    *   避免 spawnSync(bin, args, { shell: true }) 触发 DEP0190。
-   * - 其它平台：不用 shell，参数交由 Node 转义。
+   * - 其它平台：不用 shell,参数交由 Node 转义。
    */
   spawnCmd = (bin, args, baseOpts = {}) => {
     if (process.platform === 'win32') {
@@ -82,7 +82,7 @@ const ensureDir = dir => {
     return spawnSync(bin, args, { ...baseOpts, shell: false });
   },
   /**
-   * 异步 spawn：参数同 spawnCmd，返回 ChildProcess
+   * 异步 spawn：参数同 spawnCmd,返回 ChildProcess
    * @param {string} bin 命令
    * @param {string[]} args 参数
    * @param {object} [baseOpts] spawn 选项
@@ -96,7 +96,7 @@ const ensureDir = dir => {
     return spawn(bin, args, { ...baseOpts, shell: false });
   },
   /**
-   * 执行命令：默认实时输出（inherit）；quiet=true 时捕获输出，成功静默、失败才打印
+   * 执行命令：默认实时输出（inherit）；quiet=true 时捕获输出,成功静默、失败才打印
    */
   run = (bin, args, opts = {}) => {
     const { quiet, ...restOpts } = opts;
@@ -124,7 +124,7 @@ const ensureDir = dir => {
     return r;
   },
   /**
-   * 执行命令：实时输出，仅首行加缩进前缀，其余行原样
+   * 执行命令：实时输出,仅首行加缩进前缀,其余行原样
    * @param {string} bin 命令
    * @param {string[]} args 参数
    * @param {object} [opts] spawn 选项 + prefix
@@ -155,7 +155,7 @@ const ensureDir = dir => {
     const configured = config?.android?.adbPath;
     if (configured) {
       if (fs.existsSync(configured)) return configured;
-      console.warn(chalk.yellow('⚠️  config.android.adbPath 不存在，回退到自动查找: ' + configured));
+      console.warn(chalk.yellow('⚠️  config.android.adbPath 不存在,回退到自动查找: ' + configured));
     }
     // 2. 环境变量 ANDROID_HOME / ANDROID_SDK_ROOT
     for (const env of ['ANDROID_HOME', 'ANDROID_SDK_ROOT']) {
@@ -176,7 +176,7 @@ const ensureDir = dir => {
     return 'adb';
   },
   /**
-   * 定位 hermesc（Hermes 编译器，用于把 JS bundle 编成字节码）
+   * 定位 hermesc（Hermes 编译器,用于把 JS bundle 编成字节码）
    */
   /**
    * 读取安装状态标志（记录上次由本工具安装的包与变体）
@@ -221,7 +221,7 @@ const ensureDir = dir => {
   ensureInstallable = (adb, appId, want, buildDir, serial) => {
     const installed = getInstalledVariant(adb, appId, serial);
     if (installed && installed !== want) {
-      console.log(chalk.yellow(`  已安装 ${installed} 包与待装 ${want} 包签名不同，先卸载`));
+      console.log(chalk.yellow(`  已安装 ${installed} 包与待装 ${want} 包签名不同,先卸载`));
       spawnCmd(adb, [...(serial ? ['-s', serial] : []), 'uninstall', appId], { encoding: 'utf-8' });
     }
   },
@@ -274,4 +274,4 @@ import chalk from 'chalk';
 export {
   ensureDir, removeDir, isExcluded, copyDir, readJson, writeJson, writeIfChanged, copyFileIfChanged, spawnCmdAsync, run, runQuiet, runStream,
   runSilent, findAdb, readInstallState, writeInstallState, getInstalledVariant, ensureInstallable, findHermesc, sanitizeFileName, buildEslintConfigSource
-};
+};

package/template/App.tsx

@@ -9,101 +9,97 @@ import runtime from './mobileApp.runtime';
 //   'system'                     → 跟随系统（内部用默认浅/深色）
 //   { light: '#fff', dark: '#000' } → 按系统主题切换
 const resolveBgColor = (bg: string | { light: string; dark: string }, theme: string | null | undefined): string => {
-  if (typeof bg === 'object' && bg !== null) {
+  if (typeof bg === 'object' && bg !== null)
     return (theme === 'dark' ? bg.dark : bg.light) || bg.light || '#ffffff';
-  }
-  if (bg === 'system') {
-    return theme === 'dark' ? '#121212' : '#ffffff';
-  }
+  if (bg === 'system') return theme === 'dark' ? '#121212' : '#ffffff';
   return bg || '#ffffff';
-};
+},
+  App = () => {
+    const systemTheme = useColorScheme(),
+      [url, setUrl] = useState<string | null>(null), [failedReason, setFailedReason] = useState<string | null>(null),
+      [showDetail, setShowDetail] = useState(false),
+      styles = StyleSheet.create({
+        fill: { flex: 1 },
+        loading: { flex: 1, justifyContent: 'center', alignItems: 'center' },
+        errorContainer: {
+          flex: 1,
+          justifyContent: 'center',
+          alignItems: 'center',
+          padding: 24,
+        },
+        errorTitle: { fontSize: 20, fontWeight: '600', marginBottom: 16, color: '#c00' },
+        errorHint: { fontSize: 14, textAlign: 'center', color: '#888' },
+        detailToggle: { fontSize: 13, marginTop: 24, color: '#06c' },
+        detailText: {
+          fontSize: 12,
+          marginTop: 12,
+          paddingHorizontal: 16,
+          color: '#666',
+          fontFamily: 'monospace',
+          textAlign: 'center',
+        },
+      });
+    useEffect(() => {
+      NodeMobile.start('main.js');
 
-const App = () => {
-  const systemTheme = useColorScheme(),
-    [url, setUrl] = useState<string | null>(null), [failedReason, setFailedReason] = useState<string | null>(null),
-    [showDetail, setShowDetail] = useState(false),
-    styles = StyleSheet.create({
-      fill: { flex: 1 },
-      loading: { flex: 1, justifyContent: 'center', alignItems: 'center' },
-      errorContainer: {
-        flex: 1,
-        justifyContent: 'center',
-        alignItems: 'center',
-        padding: 24,
-      },
-      errorTitle: { fontSize: 20, fontWeight: '600', marginBottom: 16, color: '#c00' },
-      errorHint: { fontSize: 14, textAlign: 'center', color: '#888' },
-      detailToggle: { fontSize: 13, marginTop: 24, color: '#06c' },
-      detailText: {
-        fontSize: 12,
-        marginTop: 12,
-        paddingHorizontal: 16,
-        color: '#666',
-        fontFamily: 'monospace',
-        textAlign: 'center',
-      },
-    });
-  useEffect(() => {
-    NodeMobile.start('main.js');
+      const listener = (msg: unknown) => {
+        if (typeof msg !== 'string') return;
+        if (msg.startsWith('Node started on ')) {
+          const target = msg.slice('Node started on '.length).trim();
+          setFailedReason(null);
+          setUrl(target);
+        } else if (msg.startsWith('Node failed: ')) {
+          const reason = msg.slice('Node failed: '.length).trim();
+          setFailedReason(reason);
+        }
+      };
 
-    const listener = (msg: unknown) => {
-      if (typeof msg !== 'string') return;
-      if (msg.startsWith('Node started on ')) {
-        const target = msg.slice('Node started on '.length).trim();
-        setFailedReason(null);
-        setUrl(target);
-      } else if (msg.startsWith('Node failed: ')) {
-        const reason = msg.slice('Node failed: '.length).trim();
-        setFailedReason(reason);
-      }
-    };
+      NodeMobile.channel.addListener('message', listener);
+      return () => NodeMobile.channel.removeListener('message', listener);
+    }, []);
 
-    NodeMobile.channel.addListener('message', listener);
-    return () => NodeMobile.channel.removeListener('message', listener);
-  }, []);
+    // 失败：显示错误页（用户看提示,开发者点开看详情）
+    if (failedReason) {
+      return (
+        <View style={styles.errorContainer}>
+          <Text style={styles.errorTitle}>应用启动失败</Text>
+          <Text style={styles.errorHint}>请稍后重试,或联系应用发布者</Text>
+          <Text
+            style={styles.detailToggle}
+            onPress={() => setShowDetail((v) => !v)}
+          >
+            {showDetail ? '▼ 收起详细信息' : '▶ 查看详细信息'}
+          </Text>
+          {showDetail && (
+            <Text style={styles.detailText}>{failedReason}</Text>
+          )}
+        </View>
+      );
+    }
 
-  // 失败：显示错误页（用户看提示，开发者点开看详情）
-  if (failedReason) {
-    return (
-      <View style={styles.errorContainer}>
-        <Text style={styles.errorTitle}>应用启动失败</Text>
-        <Text style={styles.errorHint}>请稍后重试，或联系应用发布者</Text>
-        <Text
-          style={styles.detailToggle}
-          onPress={() => setShowDetail((v) => !v)}
-        >
-          {showDetail ? '▼ 收起详细信息' : '▶ 查看详细信息'}
-        </Text>
-        {showDetail && (
-          <Text style={styles.detailText}>{failedReason}</Text>
-        )}
-      </View>
-    );
-  }
+    // 尚未就绪：loading
+    if (!url) {
+      if (!runtime.showLoading) return <View style={styles.fill} />;
+      return (
+        <View style={styles.loading}>
+          <ActivityIndicator size="large" />
+          <Text>{runtime.loadingText}</Text>
+        </View>
+      );
+    }
 
-  // 尚未就绪：loading
-  if (!url) {
-    if (!runtime.showLoading) return <View style={styles.fill} />;
     return (
-      <View style={styles.loading}>
-        <ActivityIndicator size="large" />
-        <Text>{runtime.loadingText}</Text>
-      </View>
+      <WebView
+        source={{ uri: url }}
+        style={[styles.fill, { backgroundColor: resolveBgColor(runtime.webview.backgroundColor, systemTheme) }]}
+        originWhitelist={['*']}
+        javaScriptEnabled={runtime.webview.enableJavaScript}
+        domStorageEnabled={runtime.webview.enableDomStorage}
+        allowFileAccess={runtime.webview.allowFileAccess}
+        allowUniversalAccessFromFileURLs={true}
+        mixedContentMode={runtime.webview.mixedContentMode}
+      />
     );
-  }
-
-  return (
-    <WebView
-      source={{ uri: url }}
-      style={[styles.fill, { backgroundColor: resolveBgColor(runtime.webview.backgroundColor, systemTheme) }]}
-      originWhitelist={['*']}
-      javaScriptEnabled={runtime.webview.enableJavaScript}
-      domStorageEnabled={runtime.webview.enableDomStorage}
-      allowFileAccess={runtime.webview.allowFileAccess}
-      allowUniversalAccessFromFileURLs={true}
-      mixedContentMode={runtime.webview.mixedContentMode}
-    />
-  );
-};
+  };
 
 export { App };

package/template/index.js

@@ -1,6 +1,6 @@
 /**
  * React Native 应用入口
- * 挂载根组件 App（见 App.tsx）到 AppRegistry，
+ * 挂载根组件 App（见 App.tsx）到 AppRegistry,
  * 组件名取自 app.json 的 name（由 CLI 根据 appName 自动生成）
  *
  * 用户一般不需要修改这个文件

package/template/metro.config.js

@@ -9,9 +9,7 @@ const exclusionList = exclusionListModule.default,
     watchFolders: [__dirname, resolve(workspaceRoot, 'node_modules')],
     resolver: {
       nodeModulesPaths: [resolve(__dirname, 'node_modules'), resolve(workspaceRoot, 'node_modules')],
-      blockList: exclusionList([
-        /[/\\]nodejs-assets[/\\].*/
-      ])
+      blockList: exclusionList([/[/\\]nodejs-assets[/\\].*/])
     }
   };