@flun/node-mobile-app 1.0.1

package/src/patcher.js

@@ -0,0 +1,374 @@
+import path from 'path';
+import fs from 'fs';
+import { writeIfChanged } from './utils.js';
+
+/**
+ * 解析最终 appName：
+ *   1. config.appName
+ *   2. 用户项目 package.json 的 name
+ *   3. 'MyApp'
+ */
+const resolveAppName = (userProjectDir, config) => {
+  if (config.appName) return String(config.appName);
+  const pkgPath = path.join(userProjectDir, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+      if (pkg.name) return String(pkg.name);
+    } catch { }
+  }
+  return 'MyApp';
+},
+  /** 通用字符串转义基础：\\, ", \n, \r, \t */
+  escapeStringBase = s => String(s)
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\n/g, '\\n')
+    .replace(/\r/g, '\\r')
+    .replace(/\t/g, '\\t'),
+  /** Kotlin 字符串字面量转义：基础 + 转义 $ */
+  escapeKotlinString = s => escapeStringBase(s).replace(/\$/g, '\\$'),
+  /** Swift 字符串字面量转义：基础 + 转义 \( */
+  escapeSwiftString = s => escapeStringBase(s).replace(/\(/g, '\\('),
+  escapeXml = s => {
+    return String(s)
+      .replace(/&/g, '&')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&apos;');
+  },
+  /**
+   * 把 mobileAppConfig.js 里的应用信息写入 buildDir 的 RN 工程
+   *   - android/app/build.gradle: namespace / applicationId / versionCode / versionName
+   *   - app.json: name / displayName
+   *   - res/values/strings.xml: app_name
+   *   - MainActivity.kt / MainApplication.kt: package 声明
+   */
+  patchAppConfig = (buildDir, userProjectDir, config) => {
+    const appName = resolveAppName(userProjectDir, config), appId = config.appId,
+      versionCode = config.versionCode, versionName = config.versionName,
+      gradleFile = path.join(buildDir, 'android', 'app', 'build.gradle'),
+      appJsonFile = path.join(buildDir, 'app.json'),
+      stringsFile = path.join(buildDir, 'android', 'app', 'src', 'main', 'res', 'values', 'strings.xml'),
+      ktFiles = [
+        path.join(buildDir, 'android', 'app', 'src', 'main', 'java', 'com', 'myapp', 'MainActivity.kt'),
+        path.join(buildDir, 'android', 'app', 'src', 'main', 'java', 'com', 'myapp', 'MainApplication.kt'),
+      ];
+    // 1. build.gradle
+    if (fs.existsSync(gradleFile)) {
+      let c = fs.readFileSync(gradleFile, 'utf-8');
+      c = c.replace(/namespace\s+"[^"]+"/, 'namespace "' + appId + '"');
+      c = c.replace(/applicationId\s+"[^"]+"/, 'applicationId "' + appId + '"');
+      c = c.replace(/versionCode\s+\d+/, 'versionCode ' + versionCode);
+      c = c.replace(/versionName\s+"[^"]+"/, 'versionName "' + versionName + '"');
+      writeIfChanged(gradleFile, c);
+    }
+    // 2. app.json
+    if (fs.existsSync(appJsonFile)) {
+      const obj = { name: appName, displayName: appName };
+      writeIfChanged(appJsonFile, JSON.stringify(obj, null, 2) + '\n');
+    }
+    // 3. strings.xml
+    if (fs.existsSync(stringsFile)) {
+      let c = fs.readFileSync(stringsFile, 'utf-8');
+      c = c.replace(/(<string name="app_name">)[^<]*(<\/string>)/, '$1' + escapeXml(appName) + '$2');
+      writeIfChanged(stringsFile, c);
+    }
+    // 4. MainActivity.kt / MainApplication.kt 的 package 声明
+    for (const f of ktFiles) {
+      if (!fs.existsSync(f)) continue;
+      let c = fs.readFileSync(f, 'utf-8');
+      c = c.replace(/^package\s+[\w.]+/m, 'package ' + appId);
+      // MainActivity.kt: getMainComponentName 要和 app.json.name 一致
+      c = c.replace(
+        /(override\s+fun\s+getMainComponentName\(\)\s*:\s*String\s*=\s*)"[^"]*"/, `$1"${escapeKotlinString(appName)}"`
+      );
+      writeIfChanged(f, c);
+    }
+
+    console.log(`  ✓ 应用信息：${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）
+   */
+  patchAndroidConfig = (buildDir, config) => {
+    const a = config.android || {}, rootGradle = path.join(buildDir, 'android', 'build.gradle'),
+      manifestFile = path.join(buildDir, 'android', 'app', 'src', 'main', 'AndroidManifest.xml');
+    // 1. 根 build.gradle 的 ext 块
+    if (fs.existsSync(rootGradle)) {
+      let c = fs.readFileSync(rootGradle, 'utf-8');
+      if (Number.isInteger(a.minSdkVersion))
+        c = c.replace(/minSdkVersion\s*=\s*\d+/, 'minSdkVersion = ' + a.minSdkVersion);
+      if (Number.isInteger(a.targetSdkVersion))
+        c = c.replace(/targetSdkVersion\s*=\s*\d+/, 'targetSdkVersion = ' + a.targetSdkVersion);
+      if (Number.isInteger(a.compileSdkVersion))
+        c = c.replace(/compileSdkVersion\s*=\s*\d+/, 'compileSdkVersion = ' + a.compileSdkVersion);
+      if (a.buildToolsVersion)
+        c = c.replace(/buildToolsVersion\s*=\s*"[^"]+"/, 'buildToolsVersion = "' + a.buildToolsVersion + '"');
+      writeIfChanged(rootGradle, c);
+    }
+    // 2. AndroidManifest.xml: 直接写死 usesCleartextTraffic + tools:replace
+    //    不用占位符，因为 AGP release 构建在 targetSdk>=28 时会强制 false
+    if (fs.existsSync(manifestFile)) {
+      let c = fs.readFileSync(manifestFile, 'utf-8');
+      const ct = a.usesCleartextTraffic !== false ? 'true' : 'false';
+
+      // manifest 根标签加 xmlns:tools
+      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"'
+        );
+      }
+      // 替换占位符值为实际值
+      c = c.replace(/android:usesCleartextTraffic="\$\{usesCleartextTraffic\}"/, `android:usesCleartextTraffic="${ct}"`);
+      // application 标签加 tools:replace
+      if (!/tools:replace="[^"]*android:usesCleartextTraffic/.test(c))
+        c = c.replace(/(<application)/, '$1\n    tools:replace="android:usesCleartextTraffic"');
+
+      writeIfChanged(manifestFile, c);
+    }
+    // 3. AndroidManifest.xml 权限
+    if (fs.existsSync(manifestFile)) {
+      let c = fs.readFileSync(manifestFile, 'utf-8');
+      const perms = new Set(['android.permission.INTERNET']);
+      for (const p of a.permissions || []) perms.add(p);
+
+      // 删掉现有的所有 <uses-permission ... /> 行
+      c = c.replace(/^\s*<uses-permission[^>]*\/>\s*\r?\n/gm, '');
+      // 在 <application 前插入
+      const block = Array.from(perms).map((p) => `  <uses-permission android:name="${p}" />`).join('\n');
+      c = c.replace(/(\r?\n)(\s*<application)/, `\n${block}\n\n$2`);
+      writeIfChanged(manifestFile, c);
+    }
+
+    console.log(`  ✓ 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，可装但不可发布）
+   *
+   * keystore 路径以用户项目根为基准。
+   */
+  patchSigning = (buildDir, userProjectDir, config) => {
+    const signing = config.android && config.android.signing;
+    if (!signing || !signing.keystore) return; // 未配置签名 → 保持默认
+
+    const keystoreAbs = path.resolve(userProjectDir, signing.keystore);
+    if (!fs.existsSync(keystoreAbs)) return console.warn('  ⚠️  签名 keystore 不存在，跳过签名配置:', keystoreAbs);
+
+    // 1. 写 gradle.properties（追加或覆盖 MYAPP_RELEASE_*）
+    const propsFile = path.join(buildDir, 'android', 'gradle.properties');
+    if (fs.existsSync(propsFile)) {
+      let c = fs.readFileSync(propsFile, 'utf-8');
+      // 删掉旧的 4 行
+      c = c.replace(/^\s*MYAPP_RELEASE_STORE_FILE=.*\r?\n/gm, '');
+      c = c.replace(/^\s*MYAPP_RELEASE_STORE_PASSWORD=.*\r?\n/gm, '');
+      c = c.replace(/^\s*MYAPP_RELEASE_KEY_ALIAS=.*\r?\n/gm, '');
+      c = c.replace(/^\s*MYAPP_RELEASE_KEY_PASSWORD=.*\r?\n/gm, '');
+      // 追加新的
+      const esc = keystoreAbs.replace(/\\/g, '/');
+      c += `\nMYAPP_RELEASE_STORE_FILE=${esc}\n`;
+      c += `MYAPP_RELEASE_STORE_PASSWORD=${signing.storePassword || ''}\n`;
+      c += `MYAPP_RELEASE_KEY_ALIAS=${signing.keyAlias || ''}\n`;
+      c += `MYAPP_RELEASE_KEY_PASSWORD=${signing.keyPassword || ''}\n`;
+      writeIfChanged(propsFile, c);
+    }
+
+    // 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 签名块（先删旧的，避免重复）
+      c = c.replace(/\s*release\s*\{\s*storeFile[\s\S]*?\}\r?\n(\s*\}\s*\r?\n)/, '$1');
+      // 在 signingConfigs { 之后插入
+      c = c.replace(/(signingConfigs\s*\{)/,
+        `$1
+        release {
+            storeFile file(MYAPP_RELEASE_STORE_FILE)
+            storePassword MYAPP_RELEASE_STORE_PASSWORD
+            keyAlias MYAPP_RELEASE_KEY_ALIAS
+            keyPassword MYAPP_RELEASE_KEY_PASSWORD
+        }`
+      );
+
+      // 让 release buildType 用 signingConfigs.release
+      // 只替换 release { 之后的第一个 signingConfig signingConfigs.debug
+      c = c.replace(/(release\s*\{\s*\n\s*signingConfig\s+)signingConfigs\.debug/, '$1signingConfigs.release');
+      writeIfChanged(gradleFile, c);
+    }
+
+    console.log('  ✓ Release 签名已配置:', path.basename(keystoreAbs));
+  },
+  /**
+   * 应用图标：把用户提供的 PNG 缩放到 5 个 Android 密度，覆盖各 mipmap 目录下的 ic_launcher 与 ic_launcher_round
+   * 未配置或文件不存在时保持默认
+   */
+  patchIcon = async (buildDir, userProjectDir, config) => {
+    const iconPath = config.android && config.android.icon;
+    if (!iconPath) return;
+
+    const iconAbs = path.resolve(userProjectDir, iconPath);
+    if (!fs.existsSync(iconAbs)) return console.warn('  ⚠️  图标文件不存在，保持默认:', iconAbs);
+
+    const { Jimp } = await import('jimp'),
+      densities = [
+        { dir: 'mipmap-mdpi', size: 48 },
+        { dir: 'mipmap-hdpi', size: 72 },
+        { dir: 'mipmap-xhdpi', size: 96 },
+        { dir: 'mipmap-xxhdpi', size: 144 },
+        { dir: 'mipmap-xxxhdpi', size: 192 }
+      ], resDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'res'), source = await Jimp.read(iconAbs);
+
+    for (const { dir, size } of densities) {
+      const targetDir = path.join(resDir, dir);
+      if (!fs.existsSync(targetDir)) continue;
+
+      const img = source.clone();
+      img.resize({ w: size, h: size });
+      const buf = await img.getBuffer('image/png');
+
+      fs.writeFileSync(path.join(targetDir, 'ic_launcher.png'), buf);
+      fs.writeFileSync(path.join(targetDir, 'ic_launcher_round.png'), buf);
+    }
+
+    console.log(`  ✓ 图标已应用: ${path.basename(iconAbs)}`);
+  },
+  /**
+   * 写入 iOS 工程配置：
+   *   - Info.plist: CFBundleDisplayName
+   *   - 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');
+    if (!fs.existsSync(iosDir)) return;
+
+    const appName = resolveAppName(userProjectDir, config), appId = config.appId, versionName = config.versionName,
+      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)
+    if (fs.existsSync(plist)) {
+      let c = fs.readFileSync(plist, 'utf-8');
+
+      // CFBundleDisplayName
+      c = c.replace(/(<key>CFBundleDisplayName<\/key>\s*<string>)[^<]*(<\/string>)/, '$1' + escapeXml(appName) + '$2');
+      // ATS: usesCleartextTraffic=true → 放行本地 HTTP; false → 全部禁用
+      const allowCleartext = config.android.usesCleartextTraffic !== false, tab = '\t', atsBlock = allowCleartext
+        ? [
+          '<key>NSAppTransportSecurity</key>',
+          tab + '<dict>',
+          tab + tab + '<key>NSAllowsArbitraryLoads</key>',
+          tab + tab + '<false/>',
+          tab + tab + '<key>NSAllowsLocalNetworking</key>',
+          tab + tab + '<true/>',
+          tab + tab + '<key>NSExceptionDomains</key>',
+          tab + tab + '<dict>',
+          tab + tab + tab + '<key>localhost</key>',
+          tab + tab + tab + '<dict>',
+          tab + tab + tab + tab + '<key>NSExceptionAllowsInsecureHTTPLoads</key>',
+          tab + tab + tab + tab + '<true/>',
+          tab + tab + tab + tab + '<key>NSIncludesSubdomains</key>',
+          tab + tab + tab + tab + '<true/>',
+          tab + tab + tab + '</dict>',
+          tab + tab + tab + '<key>127.0.0.1</key>',
+          tab + tab + tab + '<dict>',
+          tab + tab + tab + tab + '<key>NSExceptionAllowsInsecureHTTPLoads</key>',
+          tab + tab + tab + tab + '<true/>',
+          tab + tab + tab + '</dict>',
+          tab + tab + '</dict>',
+          tab + '</dict>',
+        ].join('\n')
+        : [
+          '<key>NSAppTransportSecurity</key>',
+          tab + '<dict>',
+          tab + tab + '<key>NSAllowsArbitraryLoads</key>',
+          tab + tab + '<false/>',
+          tab + tab + '<key>NSAllowsLocalNetworking</key>',
+          tab + tab + '<false/>',
+          tab + '</dict>',
+        ].join('\n');
+
+      c = c.replace(
+        /<key>NSAppTransportSecurity<\/key>[\s\S]*?(?=<key>NSLocationWhenInUseUsageDescription<\/key>)/, atsBlock + '\n\t'
+      );
+      writeIfChanged(plist, c);
+    }
+
+    // 2. project.pbxproj
+    if (fs.existsSync(pbx)) {
+      let c = fs.readFileSync(pbx, 'utf-8');
+      c = c.replace(/PRODUCT_BUNDLE_IDENTIFIER = "[^"]+";/g, `PRODUCT_BUNDLE_IDENTIFIER = "${appId}";`);
+      c = c.replace(/MARKETING_VERSION = [^;]+;/g, `MARKETING_VERSION = ${versionName};`);
+      c = c.replace(/CURRENT_PROJECT_VERSION = [^;]+;/g, `CURRENT_PROJECT_VERSION = ${versionCode};`);
+      c = c.replace(/IPHONEOS_DEPLOYMENT_TARGET = [^;]+;/g, `IPHONEOS_DEPLOYMENT_TARGET = ${deploymentTarget};`);
+      writeIfChanged(pbx, c);
+    }
+
+    // 3. AppDelegate.swift: withModuleName 要和 app.json.name 一致
+    if (fs.existsSync(appDelegate)) {
+      let c = fs.readFileSync(appDelegate, 'utf-8');
+      c = c.replace(/(withModuleName:\s*)"[^"]*"/, `$1"${escapeSwiftString(appName)}"`);
+      writeIfChanged(appDelegate, c);
+    }
+
+    console.log(`  ✓ iOS 配置：${appName} (${appId}) v${versionName}(${versionCode}), target ${deploymentTarget}`);
+  },
+  /**
+   * iOS 应用图标：把用户提供的 PNG 缩放到 9 个尺寸，写入 AppIcon.appiconset
+   * 同时改写 Contents.json 加 filename 字段
+   * 未配置或文件不存在时保持默认（无图标，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('  ⚠️  iOS 图标文件不存在，保持默认:', iconAbs);
+
+    const iconDir = path.join(buildDir, 'ios', 'MyApp', 'Images.xcassets', 'AppIcon.appiconset');
+    if (!fs.existsSync(iconDir)) return;
+
+    const { Jimp } = await import('jimp'), source = await Jimp.read(iconAbs),
+      // 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' },
+        { idiom: 'iphone', size: '29x29', scale: '2x', px: 58, name: 'Icon-App-29x29@2x.png' },
+        { idiom: 'iphone', size: '29x29', scale: '3x', px: 87, name: 'Icon-App-29x29@3x.png' },
+        { idiom: 'iphone', size: '40x40', scale: '2x', px: 80, name: 'Icon-App-40x40@2x.png' },
+        { idiom: 'iphone', size: '40x40', scale: '3x', px: 120, name: 'Icon-App-40x40@3x.png' },
+        { idiom: 'iphone', size: '60x60', scale: '2x', px: 120, name: 'Icon-App-60x60@2x.png' },
+        { idiom: 'iphone', size: '60x60', scale: '3x', px: 180, name: 'Icon-App-60x60@3x.png' },
+        { idiom: 'ios-marketing', size: '1024x1024', scale: '1x', px: 1024, name: 'Icon-App-1024x1024@1x.png' },
+      ], contentsFile = path.join(iconDir, 'Contents.json'),
+      contents = {
+        images: variants.map(v => ({ idiom: v.idiom, scale: v.scale, size: v.size, filename: v.name, })),
+        info: { author: 'xcode', version: 1 }
+      };
+
+    for (const v of variants) {
+      const img = source.clone();
+      img.resize({ w: v.px, h: v.px });
+      const buf = await img.getBuffer('image/png');
+      fs.writeFileSync(path.join(iconDir, v.name), buf);
+    }
+
+    // 改写 Contents.json，给每项加 filename
+    writeIfChanged(contentsFile, JSON.stringify(contents, null, 2) + '\n');
+    console.log(`  ✓ iOS 图标已应用: ${path.basename(iconAbs)}`);
+  }
+
+// ===== 导出 =====
+export {
+  resolveAppName, escapeKotlinString, escapeSwiftString, patchAppConfig, patchAndroidConfig, patchSigning,
+  patchIcon, patchIosConfig, patchIosIcon,
+};

package/src/platform-ios.js

@@ -0,0 +1,142 @@
+import path from 'path';
+import fs from 'fs';
+import { run, ensureDir } from './utils.js';
+
+const SCHEME = 'MyApp',
+  /** iOS 相关命令只能在 macOS 上跑 */
+  ensureMac = () => {
+    if (process.platform !== 'darwin') throw new Error('iOS 构建只能在 macOS 上执行（当前平台: ' + process.platform + '）');
+  },
+  /** 检查 xcodebuild 是否存在 */
+  checkIosTools = () => {
+    const r = run('which', ['xcodebuild'], { stdio: 'pipe' });
+    if (r.status !== 0) throw new Error('未找到 xcodebuild，请安装 Xcode 并运行 xcode-select --install');
+  },
+  /**
+   * 执行 pod install（若 Pods/ 已存在且 Podfile.lock 未变，cocoapods 会自动跳过）
+   */
+  podInstall = iosDir => {
+    console.log('  pod install ...'), run('pod', ['install'], { cwd: iosDir });
+  },
+  /**
+   * 把 config.ios.signing.certificate 导入临时 keychain，供 xcodebuild 签名用
+   * 返回 { keychainPath, keychainPassword } 或 null（未配置 / 文件缺失）
+   */
+  setupSigningKeychain = (buildDir, userProjectDir, config) => {
+    const signing = config.ios && config.ios.signing;
+    if (!signing || !signing.certificate) return null;
+
+    const certPath = path.resolve(userProjectDir, signing.certificate);
+    if (!fs.existsSync(certPath)) {
+      console.warn('  ⚠️  iOS 签名证书不存在，跳过:', certPath);
+      return null;
+    }
+
+    const keychainDir = path.join(buildDir, 'ios', 'build', 'signing');
+    ensureDir(keychainDir);
+    const keychainPath = path.join(keychainDir, 'build.keychain-db'), keychainPassword = 'nmapp' + Date.now();
+
+    // 清掉同名的旧 keychain（重复构建时）
+    if (fs.existsSync(keychainPath)) fs.rmSync(keychainPath, { force: true });
+    console.log('  创建临时 keychain 并导入证书 ...');
+    run('security', ['create-keychain', '-p', keychainPassword, keychainPath]);
+    run('security', ['set-keychain-settings', '-lut', '3600', keychainPath]);
+    run('security', ['unlock-keychain', '-p', keychainPassword, keychainPath]);
+    run('security', [
+      'import', certPath,
+      '-k', keychainPath,
+      '-P', signing.certificatePassword || '',
+      '-T', '/usr/bin/codesign',
+      '-T', '/usr/bin/security',
+    ]);
+    run('security', [
+      'set-key-partition-list',
+      '-S', 'apple-tool:,apple:,codesign:',
+      '-s',
+      '-k', keychainPassword,
+      keychainPath,
+    ]);
+
+    return { keychainPath, keychainPassword };
+  },
+  /**
+   * xcodebuild archive
+   * 返回 xcarchive 路径
+   */
+  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 是否成功？）');
+
+    const archiveDir = path.join(iosDir, 'build');
+    ensureDir(archiveDir);
+    const archivePath = path.join(archiveDir, SCHEME + '.xcarchive'), configName = release ? 'Release' : 'Debug',
+      teamId = (config.ios && config.ios.signing && config.ios.signing.teamId) || '',
+      args = [
+        '-workspace', workspace,
+        '-scheme', SCHEME,
+        '-configuration', configName,
+        '-destination', 'generic/platform=iOS',
+        '-archivePath', archivePath,
+        'archive',
+      ];
+
+    if (teamId) args.push('DEVELOPMENT_TEAM=' + teamId);
+
+    // 若配置了 certificate，导入临时 keychain 并让 xcodebuild 使用
+    const keychain = setupSigningKeychain(buildDir, userProjectDir, config);
+    if (keychain) args.push('OTHER_CODE_SIGN_FLAGS=--keychain ' + keychain.keychainPath);
+
+    console.log('  xcodebuild archive ...'), run('xcodebuild', args, { cwd: iosDir });
+    return archivePath;
+  },
+  /**
+   * xcodebuild -exportArchive，导出 .ipa
+   * 返回 .ipa 路径
+   */
+  xcodebuildExport = (buildDir, config, release, outDir, userProjectDir) => {
+    const iosDir = path.join(buildDir, 'ios'), exportDir = path.join(iosDir, 'build', 'export');
+    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
+      profilePath = signing.provisioningProfile ? path.resolve(userProjectDir, signing.provisioningProfile) : '',
+      profileName = profilePath ? path.basename(profilePath).replace(/\.mobileprovision$/i, '') : '',
+      plistPath = path.join(iosDir, 'build', 'exportOptions.plist'),
+      plist = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+        '<plist version="1.0">',
+        '<dict>',
+        '  <key>method</key>',
+        '  <string>' + method + '</string>',
+        '  <key>stripSwiftSymbols</key>',
+        '  <true/>',
+        '  <key>compileBitcode</key>',
+        '  <false/>',
+        teamId ? '  <key>teamID</key>' : '',
+        teamId ? '  <string>' + teamId + '</string>' : '',
+        profileName ? '  <key>provisioningProfiles</key>' : '',
+        profileName ? '  <dict>' : '',
+        profileName ? '    <key>' + config.appId + '</key>' : '',
+        profileName ? '    <string>' + profileName + '</string>' : '',
+        profileName ? '  </dict>' : '',
+        '</dict>',
+        '</plist>',
+      ].filter(Boolean).join('\n');
+    fs.writeFileSync(plistPath, plist, 'utf-8'); // 生成 exportOptions.plist
+
+    console.log('  xcodebuild -exportArchive ...');
+    run('xcodebuild', [
+      '-exportArchive',
+      '-archivePath', archivePath,
+      '-exportOptionsPlist', plistPath,
+      '-exportPath', exportDir,
+    ], { cwd: iosDir });
+
+    // 找 .ipa
+    const files = fs.readdirSync(exportDir).filter(f => f.endsWith('.ipa'));
+    if (files.length === 0) throw new Error('导出目录里没有 .ipa: ' + exportDir);
+    return path.join(exportDir, files[0]);
+  };
+
+export { ensureMac, checkIosTools, podInstall, xcodebuildArchive, xcodebuildExport };

package/src/utils.js

@@ -0,0 +1,131 @@
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+
+const ensureDir = dir => {
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+},
+  removeDir = dir => {
+    if (fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
+  },
+  isExcluded = (name, patterns) => {
+    for (let p of patterns) {
+      p = p.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/$/, '');
+      if (p === name) return true;
+      if (p.includes('*')) {
+        const escaped = p.replace(/[.+?^${}()|[\]\\/]/g, '\\$&').replace(/\*/g, '.*');
+        if (new RegExp('^' + escaped + '$').test(name)) return true;
+      }
+    }
+    return false;
+  },
+  /**
+   * 递归复制，exclude 支持 'node_modules/'、'*.log'、'.git/'
+   */
+  copyDir = (src, dest, exclude = []) => {
+    ensureDir(dest);
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+      const name = entry.name;
+      if (isExcluded(name, exclude)) continue;
+      const s = path.join(src, name), d = path.join(dest, name);
+      if (entry.isDirectory()) copyDir(s, d, exclude);
+      else if (entry.isFile()) fs.copyFileSync(s, d);
+    }
+  },
+  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 表示内容相同跳过
+   */
+  writeIfChanged = (file, content) => {
+    if (fs.existsSync(file)) {
+      try {
+        if (fs.readFileSync(file, 'utf-8') === content) return false;
+      } catch { /* 读失败就当需要写 */ }
+    }
+    fs.writeFileSync(file, content, 'utf-8');
+    return true;
+  },
+  /**
+   * 大小和 mtime 都一致才跳过复制，否则复制
+   * 用于用户项目 → nodejs-project 的增量复制
+   */
+  copyFileIfChanged = (src, dst) => {
+    if (fs.existsSync(dst)) {
+      try {
+        const s = fs.statSync(src), d = fs.statSync(dst);
+        if (s.size === d.size && Math.floor(s.mtimeMs) <= Math.floor(d.mtimeMs)) return false;
+      } catch { /* 出错就复制 */ }
+    }
+    fs.copyFileSync(src, dst);
+    return true;
+  },
+  run = (bin, args, opts = {}) => {
+    const r = spawnSync(bin, args, { stdio: 'inherit', shell: true, ...opts });
+    if (r.status !== 0) throw new Error(`${bin} ${args.join(' ')} 退出码 ${r.status}`);
+    return r;
+  },
+  runQuiet = (bin, args, opts = {}) => spawnSync(bin, args, { encoding: 'utf-8', shell: true, ...opts }),
+  runSilent = (bin, args, opts = {}) => {
+    const r = spawnSync(bin, args, { encoding: 'utf-8', shell: true, ...opts });
+    if (r.status !== 0) {
+      if (r.stdout) process.stderr.write(r.stdout);
+      if (r.stderr) process.stderr.write(r.stderr);
+      throw new Error(`${bin} ${args.join(' ')} 退出码 ${r.status}`);
+    }
+    return r;
+  },
+  /**
+   * 定位 adb（配置 > 环境变量 > 默认路径 > PATH）
+   */
+  findAdb = config => {
+    // 1. 用户显式配置的路径优先
+    const configured = config?.android?.adbPath;
+    if (configured) {
+      if (fs.existsSync(configured)) return configured;
+      console.warn('⚠️  config.android.adbPath 不存在，回退到自动查找: ' + configured);
+    }
+    // 2. 环境变量 ANDROID_HOME / ANDROID_SDK_ROOT
+    for (const env of ['ANDROID_HOME', 'ANDROID_SDK_ROOT']) {
+      const base = process.env[env];
+      if (base) {
+        const p = path.join(base, 'platform-tools', process.platform === 'win32' ? 'adb.exe' : 'adb');
+        if (fs.existsSync(p)) return p;
+      }
+    }
+    // 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'),
+        path.join(home, 'Library', 'Android', 'sdk', 'platform-tools', 'adb'),
+        path.join(home, 'Android', 'Sdk', 'platform-tools', 'adb'),
+      ];
+    for (const c of candidates) if (c && fs.existsSync(c)) return c;
+    return 'adb';
+  },
+  /**
+   * 定位 hermesc（Hermes 编译器，用于把 JS bundle 编成字节码）
+   */
+  findHermesc = userProjectDir => {
+    const base = path.join(userProjectDir, 'node_modules', 'hermes-compiler', 'hermesc'), platform = process.platform;
+    let sub;
+    if (platform === 'win32') sub = ['win64-bin', 'hermesc.exe'];
+    else if (platform === 'darwin') sub = ['osx-bin', 'hermesc'];
+    else sub = ['linux64-bin', 'hermesc'];
+    const p = path.join(base, ...sub);
+    return fs.existsSync(p) ? p : null;
+  },
+  /**
+   * 文件名安全化：去除文件系统非法字符（/ \ : * ? " < > |）
+   * 空结果回退 'app'
+   */
+  sanitizeFileName = s => {
+    const cleaned = String(s).replace(/[\\/:*?"<>|]/g, '_').trim();
+    return cleaned || 'app';
+  };
+
+export {
+  ensureDir, removeDir, isExcluded, copyDir, readJson, writeJson, writeIfChanged, copyFileIfChanged,
+  run, runQuiet, runSilent, findAdb, findHermesc, sanitizeFileName
+};

package/template/.prettierrc.js

@@ -0,0 +1,5 @@
+export default {
+  arrowParens: 'avoid',
+  singleQuote: true,
+  trailingComma: 'all',
+};