@flun/node-mobile-app 1.0.1

package/src/copy.js

@@ -0,0 +1,235 @@
+import path from 'path';
+import fs from 'fs';
+import { ensureDir, removeDir, readJson, isExcluded, copyFileIfChanged, writeIfChanged } from './utils.js';
+import { resolveSdkPath } from './config.js';
+
+const BUILD_DIR_NAME = 'node-mobile-app-build',
+  TEMPLATE_EXCLUDE = [
+    'build/', '.gradle/', '.cxx/', '.kotlin/',
+    'app/build/', 'app/.cxx/',
+    'Pods/', 'local.properties', '*.bak', 'gradle.properties.bak',
+  ],
+  /**
+   * 内部：递归覆盖式复制模板,跳过 keepSet 命中的文件
+   */
+  copyDirOverwrite = (src, dst, exclude, buildDir, keepSet) => {
+    ensureDir(dst);
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+      if (isExcluded(entry.name, exclude)) continue;
+      const s = path.join(src, entry.name), d = path.join(dst, entry.name);
+      if (entry.isDirectory()) copyDirOverwrite(s, d, exclude, buildDir, keepSet);
+      else if (entry.isFile()) {
+        const rel = path.relative(buildDir, d).replace(/\\/g, '/');
+        if (keepSet.has(rel)) continue;
+        copyFileIfChanged(s, d);
+      }
+    }
+  },
+  /**
+   * 内部：增量复制用户项目到 nodejs-project
+   * 保留 node_modules 等由其他步骤生成的产物
+   */
+  copyDirIncremental = (src, dst, exclude) => {
+    ensureDir(dst);
+
+    const dstKeep = new Set(['node_modules', '.deps-hash', 'main.js', 'package.json', 'package-lock.json']),
+      srcNames = new Set(fs.readdirSync(src));
+    // 1. 删除 dst 里不该存在的条目
+    for (const name of fs.readdirSync(dst)) {
+      if (dstKeep.has(name)) continue;
+      if (!srcNames.has(name) || isExcluded(name, exclude)) removeDir(path.join(dst, name));
+    }
+    // 2. 增量复制
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+      if (isExcluded(entry.name, exclude)) continue;
+      if (dstKeep.has(entry.name)) continue;
+      const s = path.join(src, entry.name), d = path.join(dst, entry.name);
+      if (entry.isDirectory()) copyDirIncremental(s, d, exclude);
+      else if (entry.isFile()) copyFileIfChanged(s, d);
+    }
+  },
+  /**
+   * 获取 build 目录路径：<userProject>/node-mobile-app-build
+   */
+  getBuildDir = userProjectDir => path.join(userProjectDir, BUILD_DIR_NAME),
+  /**
+   * 把 CLI 包里的 template/ 逐文件覆盖到 build 目录
+   * - 只覆盖模板里存在的文件，不删除 buildDir 里已有的其他内容（保留 Gradle 增量缓存）
+   * - 模板文件被改写时自动同步；新增文件自动添加
+   * - 若模板里删除了文件，旧副本残留由 CLI 版本指纹触发全量重建处理
+   */
+  copyTemplate = (pkgRoot, buildDir, config) => {
+    ensureDir(buildDir);
+
+    const templateDir = path.join(pkgRoot, 'template');
+    if (!fs.existsSync(templateDir)) throw new Error('CLI 包缺少 template/ 目录: ' + templateDir);
+
+    const keepSet = new Set((config && config.keepFiles) || []);
+    copyDirOverwrite(templateDir, buildDir, TEMPLATE_EXCLUDE, buildDir, keepSet);
+    console.log('  ✓ 模板已更新到', BUILD_DIR_NAME + '/');
+    if (keepSet.size > 0) console.log('    保留文件:', Array.from(keepSet).join(', '));
+  },
+  /**
+   * 复制用户 Node 项目到 <buildDir>/nodejs-assets/nodejs-project
+   * 复制后重写 package.json：只保留 dependencies，剔除 devDependencies；用 config 的 allowScripts
+   */
+  copyUserProject = (userProjectDir, buildDir, config) => {
+    const targetDir = path.join(buildDir, 'nodejs-assets', 'nodejs-project');
+    ensureDir(targetDir);
+
+    const exclude = [
+      ...config.excludeFiles, BUILD_DIR_NAME + '/',
+      'mobileAppConfig.js', 'mobileAppConfig.mjs', 'mobileAppConfig.cjs'
+    ];
+
+    // 增量复制：内容变化的文件才覆盖，保留 node_modules 和其他未变文件
+    copyDirIncremental(userProjectDir, targetDir, exclude);
+    // 黑名单式过滤：只删 devDependencies 和 allowScripts,其余字段原样保留
+    const userPkgPath = path.join(userProjectDir, 'package.json');
+    if (!fs.existsSync(userPkgPath)) throw new Error('用户项目缺少 package.json');
+    const pkg = readJson(userPkgPath), out = { ...pkg };
+    delete out.devDependencies;
+    out.allowScripts = (config.allowScripts && Object.keys(config.allowScripts).length) ? config.allowScripts : { node: true };
+    writeIfChanged(path.join(targetDir, 'package.json'), JSON.stringify(out, null, 2) + '\n');
+
+    console.log('  ✓ 已同步用户项目到 nodejs-assets/nodejs-project');
+    console.log('    模块类型:', out.type === 'module' ? 'ESM' : 'CJS');
+    console.log('    生产依赖:', Object.keys(out.dependencies || {}).length, '个');
+
+    return { pkg: out, moduleType: out.type === 'module' ? 'module' : 'commonjs', targetDir };
+  },
+  /**
+   * 生成 <buildDir>/android/local.properties（Gradle 需要 sdk.dir）
+   */
+  writeLocalProperties = (buildDir, config) => {
+    const sdkPath = resolveSdkPath(config);
+    if (!sdkPath) return console.warn('  ⚠️  未找到 Android SDK，请在 mobileAppConfig.js 里配置 android.sdkPath');
+
+    const localProps = path.join(buildDir, 'android', 'local.properties'),
+      escaped = sdkPath.replace(/\\/g, '\\\\').replace(/:/g, '\\:');
+    fs.writeFileSync(localProps, `sdk.dir=${escaped}\n`, 'utf-8');
+    console.log('  ✓ 写入 sdk.dir:', sdkPath);
+  },
+  /**
+   * 确保用户项目根存在 serverPath 指向的入口文件
+   * 不存在时从 CLI 内置 cli-assets/server.js 复制一份
+   */
+  ensureUserEntry = (userProjectDir, config, pkgRoot) => {
+    const entryPath = path.join(userProjectDir, config.serverPath);
+    if (fs.existsSync(entryPath)) return { created: false, path: entryPath };
+
+    const fallback = path.join(pkgRoot, 'cli-assets', 'server.js');
+    if (!fs.existsSync(fallback)) throw new Error('入口文件不存在: ' + config.serverPath + '（CLI 内置模板也缺失）');
+
+    ensureDir(path.dirname(entryPath));
+    fs.copyFileSync(fallback, entryPath);
+    console.log('  ✓ 生成默认入口文件:', config.serverPath);
+    console.log('    （因为用户项目里没有这个文件,从 CLI 内置模板复制）');
+
+    return { created: true, path: entryPath };
+  },
+  /**
+   * 确保用户项目根存在 mobileAppConfig.js
+   * 不存在时从 CLI 包根复制一份（带注释的模板）
+   */
+  ensureUserConfig = (userProjectDir, pkgRoot) => {
+    const configPath = path.join(userProjectDir, 'mobileAppConfig.js');
+    if (fs.existsSync(configPath)) return { created: false, path: configPath };
+
+    const fallback = path.join(pkgRoot, 'mobileAppConfig.js');
+    if (!fs.existsSync(fallback)) throw new Error('CLI 缺少 mobileAppConfig.js 模板');
+
+    fs.copyFileSync(fallback, configPath);
+    console.log('  ✓ 生成默认配置文件: mobileAppConfig.js');
+    console.log('    （因为用户项目里没有这个文件,从 CLI 内置模板复制）');
+
+    return { created: true, path: configPath };
+  },
+  /**
+   * 按 config.android.abiFilters 修改 buildDir 里的 app/build.gradle：
+   *   - defaultConfig.ndk.abiFilters
+   *   - gradle.properties 的 reactNativeArchitectures
+   * 插件 build.gradle 读的是 project(":app").android.defaultConfig.ndk.abiFilters，
+   * 所以必须改这里，改插件自身的 abiFilters 无效。
+   */
+  patchAndroidAbi = (buildDir, config) => {
+    const file = path.join(buildDir, 'android', 'app', 'build.gradle');
+    if (!fs.existsSync(file)) return console.warn('  ⚠️  未找到 app/build.gradle，跳过 ABI patch');
+
+    const abiList = (config.android.abiFilters || []).map((x) => `"${x}"`).join(', ');
+    let c = fs.readFileSync(file, 'utf-8');
+    const before = c;
+
+    // defaultConfig 里的 ndk { abiFilters ... }
+    c = c.replace(
+      /(defaultConfig\s*\{[\s\S]*?ndk\s*\{\s*abiFilters\s+)("[^"]*"(?:\s*,\s*"[^"]*")*)/,
+      `$1${abiList}`
+    );
+    // 兜底：没有 ndk {} 块时，插到 defaultConfig 里
+    if (!/ndk\s*\{\s*abiFilters/.test(c)) {
+      c = c.replace(
+        /(defaultConfig\s*\{)/,
+        `$1\n        ndk {\n            abiFilters ${abiList}\n        }`
+      );
+    }
+    // 不 patch splits.abi.include：AGP 禁止它和 ndk.abiFilters 同时存在
+    if (c !== before) writeIfChanged(file, c), console.log(`  ✓ 已设置 app ndk.abiFilters = [${abiList}]`);
+
+    // 同步 gradle.properties 的 reactNativeArchitectures
+    const propsFile = path.join(buildDir, 'android', 'gradle.properties');
+    if (fs.existsSync(propsFile)) {
+      let p = fs.readFileSync(propsFile, 'utf-8');
+      const abiPlain = (config.android.abiFilters || []).join(','), before2 = p;
+      p = p.replace(/^reactNativeArchitectures=.*/gm, `reactNativeArchitectures=${abiPlain}`);
+      if (p !== before2) writeIfChanged(propsFile, p), console.log(`  ✓ 已设置 reactNativeArchitectures = ${abiPlain}`);
+    }
+  },
+  /**
+   * 把用户在 mobileAppConfig.js 里声明的 extraRnDependencies 注入 buildDir/package.json
+   * 版本号从用户根 node_modules 读实际装的版本
+   * 用户没装的会中断并提示安装命令
+   */
+  patchExtraRnDependencies = (buildDir, userProjectDir, config) => {
+    const extras = config.extraRnDependencies || [];
+    if (extras.length === 0) return;
+
+    const buildPkgPath = path.join(buildDir, 'package.json');
+    if (!fs.existsSync(buildPkgPath)) return console.warn('  ⚠️  未找到 buildDir/package.json,跳过 extraRnDependencies');
+
+    const buildPkg = readJson(buildPkgPath);
+    if (!buildPkg.dependencies) buildPkg.dependencies = {};
+
+    const missing = [];
+    let added = 0;
+    for (const name of extras) {
+      const pkgJson = path.join(userProjectDir, 'node_modules', name, 'package.json');
+      if (!fs.existsSync(pkgJson)) {
+        missing.push(name);
+        continue;
+      }
+      try {
+        const v = JSON.parse(fs.readFileSync(pkgJson, 'utf-8')).version;
+        if (buildPkg.dependencies[name] !== v) buildPkg.dependencies[name] = v, added++;
+      } catch { missing.push(name); }
+    }
+
+    if (added > 0) {
+      writeIfChanged(buildPkgPath, JSON.stringify(buildPkg, null, 2) + '\n');
+      console.log(`  ✓ 已注入 ${added} 个额外 RN 依赖到 buildDir/package.json`);
+    }
+
+    if (missing.length > 0) {
+      throw new Error(
+        'extraRnDependencies 里以下包未安装:\n' +
+        '       ' + missing.join(', ') + '\n' +
+        '     请先在项目根执行:\n' +
+        '       npm install ' + missing.join(' ') + '\n' +
+        '     然后重新运行 node-mobile-app test'
+      );
+    }
+  };
+
+export {
+  getBuildDir, copyTemplate, copyUserProject, writeLocalProperties, ensureUserEntry, ensureUserConfig, patchAndroidAbi,
+  patchExtraRnDependencies
+};

package/src/fingerprint.js

@@ -0,0 +1,102 @@
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { ensureDir, removeDir } from './utils.js';
+
+const FINGERPRINT_FILE = '.build-fingerprint.json',
+  hashUserDeps = userProjectDir => {
+    const h = crypto.createHash('sha256'), pkgPath = path.join(userProjectDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        h.update(JSON.stringify(pkg.dependencies || {})), h.update('|'), h.update(pkg.type || '');
+      } catch { h.update('package.json-read-error'); }
+    }
+    else h.update('no-package');
+    return h.digest('hex');
+  },
+  writeFp = (file, fp) => fs.writeFileSync(file, JSON.stringify(fp, null, 2), 'utf-8'),
+  clearCommonCaches = (buildDir, userProjectDir) => {
+    removeDir(path.join(buildDir, 'android', 'build'));
+    removeDir(path.join(buildDir, 'android', 'app', 'build'));
+    removeDir(path.join(userProjectDir, 'node_modules', 'nodejs-mobile-react-native', 'android', 'build'));
+  },
+  computeFingerprint = (userProjectDir, config, pkgRoot) => {
+    const abiFilters = [...(config.android.abiFilters || [])].sort(), libnode = {},
+      pluginDir = path.join(userProjectDir, 'node_modules', 'nodejs-mobile-react-native'),
+      libnodeBin = path.join(pluginDir, 'android', 'libnode', 'bin');
+
+    if (fs.existsSync(libnodeBin)) {
+      for (const arch of fs.readdirSync(libnodeBin)) {
+        const so = path.join(libnodeBin, arch, 'libnode.so');
+        if (fs.existsSync(so)) {
+          const stat = fs.statSync(so);
+          libnode[arch] = { size: stat.size, mtime: Math.floor(stat.mtimeMs) };
+        }
+      }
+    }
+
+    let pluginVersion = null;
+    const pluginPkg = path.join(pluginDir, 'package.json');
+    if (fs.existsSync(pluginPkg)) try { pluginVersion = JSON.parse(fs.readFileSync(pluginPkg, 'utf-8')).version; } catch { };
+
+    let cliVersion = null;
+    const cliPkg = path.join(pkgRoot, 'package.json');
+    if (fs.existsSync(cliPkg)) try { cliVersion = JSON.parse(fs.readFileSync(cliPkg, 'utf-8')).version; } catch { };
+
+    const depsHash = hashUserDeps(userProjectDir), a = config.android || {},
+      appInfo = {
+        appName: config.appName || null,
+        appId: config.appId || null,
+        versionCode: config.versionCode || null,
+        versionName: config.versionName || null,
+        minSdkVersion: a.minSdkVersion || null,
+        targetSdkVersion: a.targetSdkVersion || null,
+        compileSdkVersion: a.compileSdkVersion || null,
+        buildToolsVersion: a.buildToolsVersion || null,
+        usesCleartextTraffic: a.usesCleartextTraffic !== false,
+        permissions: [...(a.permissions || [])].sort(),
+      };
+
+    return { abiFilters, libnode, pluginVersion, cliVersion, depsHash, appInfo };
+  },
+  checkAndResetCache = (buildDir, userProjectDir, config, pkgRoot) => {
+    ensureDir(buildDir);
+
+    const fpFile = path.join(buildDir, FINGERPRINT_FILE), newFp = computeFingerprint(userProjectDir, config, pkgRoot);
+    let oldFp = null;
+    if (fs.existsSync(fpFile)) try { oldFp = JSON.parse(fs.readFileSync(fpFile, 'utf-8')); } catch { };
+    if (!oldFp) return console.log('  ✓ 首次构建,无缓存可清'), writeFp(fpFile, newFp);
+
+    const abiChanged = JSON.stringify(oldFp.abiFilters) !== JSON.stringify(newFp.abiFilters),
+      libnodeChanged = JSON.stringify(oldFp.libnode) !== JSON.stringify(newFp.libnode),
+      pluginChanged = oldFp.pluginVersion !== newFp.pluginVersion,
+      cliChanged = oldFp.cliVersion !== newFp.cliVersion, depsChanged = oldFp.depsHash !== newFp.depsHash,
+      appInfoChanged = JSON.stringify(oldFp.appInfo) !== JSON.stringify(newFp.appInfo),
+      structural = abiChanged || libnodeChanged || pluginChanged || cliChanged;
+
+    if (structural) {
+      const reasons = [];
+      if (abiChanged) reasons.push('ABI 配置');
+      if (libnodeChanged) reasons.push('libnode.so');
+      if (pluginChanged) reasons.push('插件版本');
+      if (cliChanged) reasons.push('CLI 版本');
+      if (depsChanged) reasons.push('用户依赖');
+      if (appInfoChanged) reasons.push('应用信息');
+      console.log('  ⚠️  检测到变化（' + reasons.join('、') + '），清理全部缓存');
+      clearCommonCaches(buildDir, userProjectDir);
+      removeDir(path.join(userProjectDir, 'node_modules', 'nodejs-mobile-react-native', 'android', '.cxx'));
+    }
+    else if (depsChanged || appInfoChanged) {
+      const reasons = [];
+      if (depsChanged) reasons.push('用户依赖');
+      if (appInfoChanged) reasons.push('应用信息');
+      console.log('  ⚠️  检测到变化（' + reasons.join('、') + '），清理 nodejs-assets 缓存 + app/build');
+      clearCommonCaches(buildDir, userProjectDir);
+    }
+    else console.log('  ✓ 缓存有效，跳过清理');
+
+    writeFp(fpFile, newFp);
+  };
+
+export { computeFingerprint, checkAndResetCache };

package/src/generate.js

@@ -0,0 +1,102 @@
+import fs from 'fs';
+import path from 'path';
+import { writeIfChanged } from './utils.js';
+
+/**
+ * 生成 main.js（桥接代码，用户不需要手写）
+ *
+ * 上报机制（通过 rn-bridge channel 发消息给 App.tsx）：
+ *   - 'Node started on <URL>'  server.js 成功调用 listen
+ *   - 'Node failed: <原因>'    加载异常或 5 秒内未捕获 listen
+ */
+const generateMainJs = (targetDir, config, moduleType) => {
+  const entry = config.serverPath.startsWith('./') ? config.serverPath : './' + config.serverPath,
+    entryLabel = config.serverPath, hb = config.advanced.heartbeatInterval,
+    body = `const rn_bridge = require('rn-bridge');
+    const net = require('net'), https = require('https'), USER_ENTRY = ${JSON.stringify(entry)},
+     ENTRY_LABEL = ${JSON.stringify(entryLabel)}, START_TIMEOUT_MS = 5000;
+
+    let resolved = false;
+    function emitUrl(url) {
+      if (resolved) return;
+      resolved = true;
+      console.log('[node-mobile-app] server URL: ' + url);
+      rn_bridge.channel.send('Node started on ' + url);
+    }
+
+    function emitFailure(reason, detail) {
+      if (resolved) return;
+      resolved = true;
+      const msg = detail ? (reason + ' -- ' + detail) : reason;
+      console.log('[node-mobile-app] failed: ' + msg);
+      rn_bridge.channel.send('Node failed: ' + msg);
+    }
+
+    rn_bridge.channel.send('Node was initialized.');
+    process.on('uncaughtException', (err) => {
+      console.error('Uncaught Exception:', err);
+      emitFailure('未捕获异常', err && err.message);
+    });
+    process.on('unhandledRejection', (reason) => {
+      console.error('Unhandled Rejection:', reason);
+      emitFailure('未处理的 Promise rejection', String(reason));
+    });
+
+    // 拦截 net.Server.prototype.listen，捕获协议和真实端口
+    const origListen = net.Server.prototype.listen;
+    net.Server.prototype.listen = function (...args) {
+      const server = this;
+      if (!resolved) {
+        server.once('listening', () => {
+          try {
+            const addr = server.address(), port = (addr && typeof addr === 'object') ? addr.port : addr,
+             protocol = (server instanceof https.Server) ? 'https' : 'http';
+            emitUrl(protocol + '://127.0.0.1:' + port);
+          } catch (e) { /* 等超时 */ }
+        });
+      }
+      return origListen.apply(this, args);
+    };
+
+    // 5 秒超时兜底
+    setTimeout(() => {
+      if (resolved) return;
+      emitFailure('Node 服务 5 秒内未启动', '请检查 ' + ENTRY_LABEL + ' 是否调用了 listen()');
+    }, START_TIMEOUT_MS);
+
+    // 加载用户入口
+    (async () => {
+      try {
+        await import(USER_ENTRY);
+      } catch (err) {
+        emitFailure('加载 ' + ENTRY_LABEL + ' 失败', err && err.message);
+      }
+    })();
+
+    ${config.advanced.keepAlive === false ? '// keepAlive: false — 不发送心跳' : "setInterval(() => rn_bridge.channel.send('heartbeat'), " + hb + ");"}
+
+    rn_bridge.channel.on('message', (msg) => {
+      rn_bridge.channel.send('Echo: ' + msg);
+    });`,
+    header = moduleType === 'module'
+      ? `import { createRequire } from 'module';\nconst require = createRequire(import.meta.url);\n\n` : '',
+    file = path.join(targetDir, 'main.js'), changed = writeIfChanged(file, header + body);
+  console.log(changed ? '  ✓ 已生成 main.js' : '  ✓ main.js 无变化');
+},
+  generateRuntime = (buildDir, config) => {
+    const data = {
+      showLoading: config.webview.showLoading,
+      loadingText: config.webview.loadingText,
+      webview: {
+        enableJavaScript: config.webview.enableJavaScript,
+        enableDomStorage: config.webview.enableDomStorage,
+        allowFileAccess: config.webview.allowFileAccess,
+        mixedContentMode: config.webview.mixedContentMode,
+        backgroundColor: config.webview.backgroundColor,
+      },
+    }, content = `// 自动生成，请勿手改\nexport default ${JSON.stringify(data, null, 2)} as const;\n`,
+      changed = writeIfChanged(path.join(buildDir, 'mobileApp.runtime.ts'), content);
+    console.log(changed ? '  ✓ 已生成 mobileApp.runtime.ts' : '  ✓ mobileApp.runtime.ts 无变化');
+  }
+
+export { generateMainJs, generateRuntime };

package/src/install.js

@@ -0,0 +1,144 @@
+import path from 'path';
+import fs from 'fs';
+import crypto from 'crypto';
+import { run } from './utils.js';
+
+/**
+ * 内部：依赖 hash（dependencies + type）
+ */
+const hashDeps = pkgPath => {
+  const h = crypto.createHash('sha256');
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+      h.update(JSON.stringify(pkg.dependencies || {})), h.update('|'), h.update(pkg.type || '');
+    } catch { h.update('read-error') }
+  }
+  else h.update('no-package');
+  return h.digest('hex');
+},
+  /**
+   * 内部：定位 nodejs-mobile-react-native 插件目录
+   */
+  findPluginDir = userProjectDir => {
+    const candidates = [
+      path.join(userProjectDir, 'node_modules', 'nodejs-mobile-react-native'),
+    ];
+    for (const c of candidates) if (fs.existsSync(path.join(c, 'android', 'build.gradle'))) return c;
+    return null;
+  },
+  /**
+   * 内部：iOS 的 WebView SSL 补丁
+   */
+  patchWebViewSslIos = userProjectDir => {
+    const file = path.join(
+      userProjectDir, 'node_modules', 'react-native-webview', 'apple', 'RNCWebViewImpl.m'
+    );
+    if (!fs.existsSync(file)) return;
+
+    let c = fs.readFileSync(file, 'utf-8');
+    if (c.includes('LOCALHOST_SSL_BYPASS_IOS')) return console.log('  ✓ iOS WebView SSL 补丁已应用');
+
+    // 在 "NSString* host = nil;" 那一段之后插入 localhost 放行
+    const anchor = '  if ([[challenge protectionSpace] authenticationMethod] == NSURLAuthenticationMethodClientCertificate) {',
+      idx = c.indexOf(anchor);
+    if (idx === -1) return console.warn('  ⚠️  RNCWebViewImpl.m 里未找到锚点，跳过 iOS SSL 补丁');
+
+    const injected = [
+      '  // 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);',
+      '    return;',
+      '  }',
+      '',
+    ].join('\n');
+
+    c = c.substring(0, idx) + injected + c.substring(idx);
+    fs.writeFileSync(file, c, 'utf-8');
+    console.log('  ✓ 已应用 iOS WebView SSL 补丁（允许 localhost 自签证书）');
+  },
+  /**
+   * 装用户项目的生产依赖到 <buildDir>/nodejs-assets/nodejs-project/
+   * 只装 dependencies，不装 devDependencies
+   * 依赖未变化且 node_modules 存在时跳过（用 .deps-hash 记录）
+   */
+  installUserDeps = (targetDir, config) => {
+    const assetsDir = path.dirname(targetDir), bnmFile = path.join(assetsDir, 'BUILD_NATIVE_MODULES.txt'),
+      hashFile = path.join(targetDir, '.deps-hash'), buildNative = !!config.android.buildNativeModules;
+    fs.writeFileSync(bnmFile, buildNative ? '1' : '0');
+
+    // 计算当前依赖 hash
+    const pkgPath = path.join(targetDir, 'package.json'), currentHash = hashDeps(pkgPath),
+      nodeModulesDir = path.join(targetDir, 'node_modules'), hasModules = fs.existsSync(nodeModulesDir);
+    let oldHash = null;
+    if (fs.existsSync(hashFile)) try { oldHash = fs.readFileSync(hashFile, 'utf-8').trim(); } catch { };
+    if (hasModules && oldHash === currentHash) return console.log('  ✓ 依赖无变化，跳过安装');
+
+    const env = { ...process.env };
+    if (buildNative) env.NODEJS_MOBILE_BUILD_NATIVE_MODULES = '1';
+
+    console.log('  安装用户生产依赖（nodejs-assets/nodejs-project）...');
+    run('npm', ['install', '--omit=dev', '--no-audit', '--no-fund'], { cwd: targetDir, env });
+    fs.writeFileSync(hashFile, currentHash, 'utf-8');
+    console.log('  ✓ 用户依赖安装完成');
+  },
+  /**
+   * 修改 nodejs-mobile-react-native 插件 build.gradle 的 abiFilters
+   */
+  patchNodejsMobilePlugin = (userProjectDir, config) => {
+    const pluginDir = findPluginDir(userProjectDir);
+    if (!pluginDir) return console.warn('  ⚠️  未找到 nodejs-mobile-react-native 插件，跳过 patch');
+
+    const file = path.join(pluginDir, 'android', 'build.gradle'),
+      abiList = config.android.abiFilters.map((x) => `"${x}"`).join(', ');
+
+    let c = fs.readFileSync(file, 'utf-8');
+    const before = c;
+    c = c.replace(/abiFilters\s*=\s*\[[^\]]*\]/, `abiFilters = [${abiList}]`);
+
+    if (c !== before) fs.writeFileSync(file, c, 'utf-8'), console.log(`  ✓ 已设置插件 abiFilters = [${abiList}]`);
+  },
+
+  /**
+   * 让 react-native-webview 对 localhost 自签名证书放行
+   * Android: patch RNCWebViewClient.java
+   * iOS:     patch RNCWebViewImpl.m
+   * 仅在 config.webview.allowSelfSignedCert === true 时应用
+   * 每次 test/build 都检查（npm 重装 webview 后会覆盖补丁）
+   */
+  patchWebViewSsl = (userProjectDir, config) => {
+    if (!config.webview || config.webview.allowSelfSignedCert !== true) return;
+
+    const file = path.join(
+      userProjectDir, 'node_modules', 'react-native-webview', 'android', 'src', 'main', 'java', 'com',
+      'reactnativecommunity', 'webview', 'RNCWebViewClient.java'
+    );
+
+    if (fs.existsSync(file)) {
+      let c = fs.readFileSync(file, 'utf-8');
+      if (c.includes('LOCALHOST_SSL_BYPASS')) console.log('  ✓ Android WebView SSL 补丁已应用');
+      else {
+        const old = 'handler.cancel();', methodIndex = c.indexOf('onReceivedSslError');
+        if (methodIndex !== -1) {
+          const cancelIndex = c.indexOf(old, methodIndex);
+          if (cancelIndex !== -1) {
+            const newCode = [
+              '// LOCALHOST_SSL_BYPASS: 对 localhost/127.0.0.1 放行自签名证书（仅本地测试用）',
+              '        if (failingUrl != null && (failingUrl.startsWith("https://127.0.0.1") || failingUrl.startsWith("https://localhost"))) {',
+              '            handler.proceed();',
+              '            return;',
+              '        }',
+              '        handler.cancel();',
+            ].join('\n');
+            c = c.substring(0, cancelIndex) + newCode + c.substring(cancelIndex + old.length);
+            fs.writeFileSync(file, c, 'utf-8');
+            console.log('  ✓ 已应用 Android WebView SSL 补丁（允许 localhost 自签证书）');
+          }
+        }
+      }
+    }
+    patchWebViewSslIos(userProjectDir); // iOS 分支
+  };
+
+export { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl };