@flun/node-mobile-app 4.0.6 → 4.0.8

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'),

package/src/utils.js

@@ -36,7 +36,7 @@ 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）重编
+   * 内容不同才写文件,避免不必要的 mtime 变化触发下游(Gradle/Metro)重编
    * 返回 true 表示写入了,false 表示内容相同跳过
    */
   writeIfChanged = (file, content) => {
@@ -62,17 +62,17 @@ const ensureDir = dir => {
     fs.copyFileSync(src, dst);
     return true;
   },
-  // 把单个参数转成适合 Windows cmd.exe 的形式：含空白或 shell 元字符时加双引号。
+  // 把单个参数转成适合 Windows cmd.exe 的形式:含空白或 shell 元字符时加双引号;
   quoteShellArg = (s) => {
     const str = String(s);
     if (str === '') return '""';
     return /[\s"&|<>^()]/.test(str) ? '"' + str.replace(/"/g, '""') + '"' : str;
   },
   /**
-   * 统一的子进程启动：
-   * - Windows：.cmd / .bat 需经 shell；把命令与参数拼成单字符串,
-   *   避免 spawnSync(bin, args, { shell: true }) 触发 DEP0190。
-   * - 其它平台：不用 shell,参数交由 Node 转义。
+   * 统一的子进程启动:
+   * - Windows:.cmd / .bat 需经 shell;把命令与参数拼成单字符串,
+   *   避免 spawnSync(bin, args, { shell: true }) 触发 DEP0190;
+   * - 其它平台:不用 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
@@ -148,7 +148,7 @@ const ensureDir = dir => {
     child.on('close', code => code === 0 ? resolve() : reject(new Error(`${bin} ${args.join(' ')} 退出码 ${code}`)));
   }),
   /**
-   * 定位 adb（配置 > 环境变量 > 默认路径 > PATH）
+   * 定位 adb(配置 > 环境变量 > 默认路径 > PATH)
    */
   findAdb = config => {
     // 1. 用户显式配置的路径优先
@@ -165,7 +165,7 @@ const ensureDir = dir => {
         if (fs.existsSync(p)) return p;
       }
     }
-    // 3. 默认路径猜测（Windows / macOS / Linux）
+    // 3. 默认路径猜测(Windows / macOS / Linux)
     const home = process.env.USERPROFILE || process.env.HOME || '', localAppData = process.env.LOCALAPPDATA || '',
       candidates = [
         path.join(localAppData, 'Android', 'Sdk', 'platform-tools', 'adb.exe'),
@@ -176,10 +176,10 @@ const ensureDir = dir => {
     return 'adb';
   },
   /**
-   * 定位 hermesc（Hermes 编译器,用于把 JS bundle 编成字节码）
+   * 定位 hermesc(Hermes 编译器,用于把 JS bundle 编成字节码)
    */
   /**
-   * 读取安装状态标志（记录上次由本工具安装的包与变体）
+   * 读取安装状态标志(记录上次由本工具安装的包与变体)
    * @param {string} buildDir 构建目录
    * @returns {{appId:string, variant:'debug'|'release'}|null} 状态或 null
    */
@@ -189,19 +189,22 @@ const ensureDir = dir => {
     try { return JSON.parse(fs.readFileSync(f, 'utf-8')); } catch { return null; }
   },
   /**
-   * 写入安装状态标志（安装成功后调用）
+   * 写入安装状态标志(安装成功后调用)
    * @param {string} buildDir 构建目录
    * @param {object} state 状态
    * @returns {void}
    */
   writeInstallState = (buildDir, state) => {
-    try { ensureDir(buildDir), fs.writeFileSync(path.join(buildDir, '.install-state.json'), JSON.stringify(state, null, 2)); } catch { }
+    try {
+      ensureDir(buildDir),
+        fs.writeFileSync(path.join(buildDir, '.install-state.json'), JSON.stringify(state, null, 2));
+    } catch { }
   },
   /**
    * 查询设备上已安装包的 DEBUGGABLE 标志
    * @param {string} adb adb 路径
    * @param {string} appId 包名
-   * @returns {'debug'|'release'|null} 变体或 null（未安装）
+   * @returns {'debug'|'release'|null} 变体或 null(未安装)
    */
   getInstalledVariant = (adb, appId, serial) => {
     const pre = serial ? ['-s', serial] : [],
@@ -210,12 +213,12 @@ const ensureDir = dir => {
     return /\bDEBUGGABLE\b/.test(r.stdout) ? 'debug' : 'release';
   },
   /**
-   * 确保待装包可覆盖安装：标志不一致或变体不符时卸载已装包
+   * 确保待装包可覆盖安装:标志不一致或变体不符时卸载已装包
    * @param {string} adb adb 路径
    * @param {string} appId 包名
    * @param {'debug'|'release'} want 待装变体
    * @param {string} buildDir 构建目录
-   * @param {string} [serial] 设备序列号（多设备时指定）
+   * @param {string} [serial] 设备序列号(多设备时指定)
    * @returns {void}
    */
   ensureInstallable = (adb, appId, want, buildDir, serial) => {
@@ -235,7 +238,7 @@ const ensureDir = dir => {
     return fs.existsSync(p) ? p : null;
   },
   /**
-   * 文件名安全化：去除文件系统非法字符（/ \ : * ? " < > |）
+   * 文件名安全化:去除文件系统非法字符(/ \ : * ? " < > |)
    * 空结果回退 'app'
    */
   sanitizeFileName = s => {
@@ -243,7 +246,7 @@ const ensureDir = dir => {
     return cleaned || 'app';
   },
   /**
-   * 生成 ESLint flat config 源码（替代 @react-native/eslint-config/flat）
+   * 生成 ESLint flat config 源码(替代 @react-native/eslint-config/flat)
    */
   buildEslintConfigSource = () => `import js from '@eslint/js';
     import tsParser from '@typescript-eslint/parser';
@@ -272,6 +275,7 @@ import chalk from 'chalk';
        rules: tsPlugin.configs.recommended.rules }, prettier];`;
 
 export {
-  ensureDir, removeDir, isExcluded, copyDir, readJson, writeJson, writeIfChanged, copyFileIfChanged, spawnCmdAsync, run, runQuiet, runStream,
-  runSilent, findAdb, readInstallState, writeInstallState, getInstalledVariant, ensureInstallable, findHermesc, sanitizeFileName, buildEslintConfigSource
+  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

@@ -4,9 +4,9 @@ import { WebView } from 'react-native-webview';
 import * as NodeMobile from '@flun/nodejs-mobile-react-native';
 import runtime from './mobileApp.runtime';
 
-// 背景色解析：支持以下三种配置
+// 背景色解析:支持以下三种配置
 //   '#ffffff' / 'white' 等字符串 → 固定色
-//   'system'                     → 跟随系统（内部用默认浅/深色）
+//   'system'                     → 跟随系统(内部用默认浅/深色)
 //   { light: '#fff', dark: '#000' } → 按系统主题切换
 const resolveBgColor = (bg: string | { light: string; dark: string }, theme: string | null | undefined): string => {
   if (typeof bg === 'object' && bg !== null)
@@ -58,7 +58,7 @@ const resolveBgColor = (bg: string | { light: string; dark: string }, theme: str
       return () => NodeMobile.channel.removeListener('message', listener);
     }, []);
 
-    // 失败：显示错误页（用户看提示,开发者点开看详情）
+    // 失败:显示错误页(用户看提示,开发者点开看详情)
     if (failedReason) {
       return (
         <View style={styles.errorContainer}>
@@ -77,7 +77,7 @@ const resolveBgColor = (bg: string | { light: string; dark: string }, theme: str
       );
     }
 
-    // 尚未就绪：loading
+    // 尚未就绪:loading
     if (!url) {
       if (!runtime.showLoading) return <View style={styles.fill} />;
       return (

package/template/Gemfile

@@ -14,4 +14,4 @@ gem 'bigdecimal'
 gem 'logger'
 gem 'benchmark'
 gem 'mutex_m'
-gem 'nkf'
+gem 'nkf'

package/template/android/app/build.gradle

@@ -124,4 +124,4 @@ dependencies {
     } else {
         implementation jscFlavor
     }
-}
+}

package/template/android/app/proguard-rules.pro

@@ -7,4 +7,4 @@
 # For more details, see
 #   http://developer.android.com/guide/developing/tools/proguard.html
 
-# Add any project specific keep options here:
+# Add any project specific keep options here:

package/template/android/app/src/main/java/com/myapp/MainActivity.kt

@@ -19,4 +19,4 @@ class MainActivity : ReactActivity() {
    */
   override fun createReactActivityDelegate(): ReactActivityDelegate =
       DefaultReactActivityDelegate(this, mainComponentName, fabricEnabled)
-}
+}

package/template/android/app/src/main/java/com/myapp/MainApplication.kt

@@ -24,4 +24,4 @@ class MainApplication : Application(), ReactApplication {
     super.onCreate()
     loadReactNative(this)
   }
-}
+}

package/template/android/app/src/main/res/drawable/rn_edit_text_material.xml

@@ -24,9 +24,12 @@
         <!--
           This file is a copy of abc_edit_text_material (https://bit.ly/3k8fX7I).
           The item below with state_pressed="false" and state_focused="false" causes a NullPointerException.
-          NullPointerException:tempt to invoke virtual method 'android.graphics.drawable.Drawable android.graphics.drawable.Drawable$ConstantState.newDrawable(android.content.res.Resources)'
+          NullPointerException:tempt to invoke virtual method
+          'android.graphics.drawable.Drawable android.graphics.drawable.Drawable$ConstantState.newDrawable(
+          android.content.res.Resources)'
 
-          <item android:state_pressed="false" android:state_focused="false" android:drawable="@drawable/abc_textfield_default_mtrl_alpha"/>
+          <item android:state_pressed="false" android:state_focused="false"
+              android:drawable="@drawable/abc_textfield_default_mtrl_alpha"/>
 
           For more info, see https://bit.ly/3CdLStv (react-native/pull/29452) and https://bit.ly/3nxOMoR.
         -->
@@ -34,4 +37,4 @@
         <item android:drawable="@drawable/abc_textfield_activated_mtrl_alpha"/>
     </selector>
 
-</inset>
+</inset>

package/template/android/app/src/main/res/raw/keep.xml

@@ -1 +1 @@
-<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_close,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_alerttriangle,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_loader,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_chevronleft,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_chevronright" />
+<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_close,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_alerttriangle,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_loader,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_chevronleft,@drawable/node_modules_reactnative_libraries_logbox_ui_logboximages_chevronright" />

package/template/android/app/src/main/res/values/strings.xml

@@ -1,3 +1,3 @@
 <resources>
     <string name="app_name">MyApp</string>
-</resources>
+</resources>

package/template/android/app/src/main/res/values/styles.xml

@@ -6,4 +6,4 @@
         <item name="android:editTextBackground">@drawable/rn_edit_text_material</item>
     </style>
 
-</resources>
+</resources>

package/template/android/build.gradle

@@ -20,4 +20,4 @@ buildscript {
     }
 }
 
-apply plugin: "com.facebook.react.rootproject"
+apply plugin: "com.facebook.react.rootproject"

package/template/android/gradle.properties

@@ -48,4 +48,4 @@ edgeToEdgeEnabled=true
 android.builtInKotlin=false
 android.newDsl=false
 # 允许非 ASCII 路径（如中文路径）构建；AGP 默认拒绝
-android.overridePathCheck=true
+android.overridePathCheck=true

package/template/android/gradlew

@@ -57,7 +57,8 @@
 #       Darwin, MinGW, and NonStop.
 #
 #   (3) This script is generated from the Groovy template
-#       https://github.com/gradle/gradle/blob/2d6327017519d23b96af35865dc997fcb544fb40/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       https://github.com/gradle/gradle/blob/2d6327017519d23b96af35865dc997fcb544fb40/
+#       platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
 #       within the Gradle project.
 #
 #       You can find Gradle at https://github.com/gradle/gradle/.
@@ -245,4 +246,4 @@ eval "set -- $(
         tr '\n' ' '
     )" '"$@"'
 
-exec "$JAVACMD" "$@"
+exec "$JAVACMD" "$@"

package/template/android/gradlew.bat

@@ -78,7 +78,8 @@ goto fail
 
 
 @rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% ^
+"-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
 
 :end
 @rem End local scope for the variables with windows NT shell
@@ -95,4 +96,4 @@ exit /b %EXIT_CODE%
 :mainEnd
 if "%OS%"=="Windows_NT" endlocal
 
-:omega
+:omega

package/template/android/settings.gradle

@@ -12,4 +12,4 @@ plugins { id("com.facebook.react.settings") }
 extensions.configure(com.facebook.react.ReactSettingsExtension){ ex -> ex.autolinkLibrariesFromCommand() }
 rootProject.name = 'MyApp'
 include ':app'
-includeBuild('../../node_modules/@react-native/gradle-plugin')
+includeBuild('../../node_modules/@react-native/gradle-plugin')

package/template/app.json

@@ -1,4 +1,4 @@
 {
   "name": "MyApp",
   "displayName": "MyApp"
-}
+}

package/template/index.js

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

package/template/ios/.xcode.env

@@ -8,4 +8,4 @@
 # Customize the NODE_BINARY variable here.
 # For example, to use nvm with brew, add the following line
 # . "$(brew --prefix nvm)/nvm.sh" --no-use
-export NODE_BINARY=$(command -v node)
+export NODE_BINARY=$(command -v node)

package/template/ios/MyApp/Images.xcassets/AppIcon.appiconset/Contents.json

@@ -50,4 +50,4 @@
     "author" : "xcode",
     "version" : 1
   }
-}
+}

package/template/ios/MyApp/Images.xcassets/Contents.json

@@ -3,4 +3,4 @@
     "version" : 1,
     "author" : "xcode"
   }
-}
+}