@flun/node-mobile-app 1.0.1

package/mobileAppConfig.js

@@ -0,0 +1,146 @@
+/**
+ * @flun/node-mobile-app 配置文件
+ * 放置在用户 Node.js 项目根目录，CLI 会自动读取
+ * 如不提供此文件，CLI 使用默认配置
+ * 所有路径相对于用户项目根目录
+ *
+ * ===== 常用命令 =====
+ *   npx node-mobile-app test            编译并安装到设备（需连 USB，走 Metro 热更新）
+ *   npx node-mobile-app test --ios      iOS 版（仅 macOS）
+ *   npx node-mobile-app build           打 debug APK（离线可用）
+ *   npx node-mobile-app build --release 打 release APK（发布用，需先配置 android.signing）
+ *   npx node-mobile-app build --ios     打 IPA（仅 macOS）
+ *   npx node-mobile-app clean           清理构建缓存
+ *
+ * ===== 服务地址说明 =====
+ *   CLI 会自动识别 server.js 实际监听的协议和端口（拦截 listen 调用），
+ *   App 使用该地址加载页面，无需在此配置。
+ *   若 5 秒内未能识别，App 显示启动失败并可在页面展开详情查看原因。
+ *   动态端口（listen(0)）会自动获取系统分配的真实端口。
+ */
+export default {
+  // ===== 必填 =====
+  serverPath: './server.js',            // Node.js 启动脚本路径
+
+  // ===== 应用信息 =====
+  appName: null,                        // 应用显示名称(默认从 package.json 的 name 读取)
+  outputDir: null,                      // APK 输出目录(默认 ./out,相对于用户项目根)
+  appId: 'com.example.app',             // 应用唯一标识(反向域名格式,Android/iOS 通用)
+  versionCode: 1,                       // 内部版本号(整数,Android versionCode / iOS CFBundleVersion,每次发版递增)
+  versionName: '1.0.0',                 // 用户可见版本名(Android versionName / iOS CFBundleShortVersionString)
+
+  // ===== WebView 配置 =====
+  webview: {
+    showLoading: true,                // 是否显示加载指示器
+    loadingText: '正在启动服务...',    // 加载提示文字
+    enableJavaScript: true,           // 是否启用 JavaScript
+    enableDomStorage: true,           // 是否启用 DOM Storage(localStorage 等)
+    allowFileAccess: true,            // 是否允许访问本地文件
+    mixedContentMode: 'always',       // 混合内容模式:never / always / compatibility
+    // WebView 背景色，支持三种写法：
+    //   '#ffffff' / 'white'              固定色
+    //   'system'                         跟随系统（内部用默认浅/深色）
+    //   { light: '#fff', dark: '#1a1a1a' }  按系统主题切换
+    backgroundColor: '#ffffff',
+    // 仅影响 HTTPS 场景下 App 是否加载自签证书的页面：
+    //   - 用 HTTP：与本开关无关
+    //   - 用 HTTPS + 真证书(如 Let's Encrypt)：与本开关无关
+    //   - 用 HTTPS + 自签证书 + 已装进设备信任库：与本开关无关
+    //   - 用 HTTPS + 自签证书 + 未装设备(本地测试最常见)：必须设为 true
+    // ⚠️ 开启后仅对 127.0.0.1 / localhost 放行不受信任的 HTTPS 证书，其他域名仍严格校验
+    //    用于本地自签证书测试，生产环境建议关闭
+    allowSelfSignedCert: false,
+  },
+
+  // ===== Android 平台配置 =====
+  android: {
+    sdkPath: null,                    // Android SDK 路径(默认自动查找)
+    adbPath: null,                    // adb.exe 路径(默认自动查找)
+    minSdkVersion: 29,                // 最低 SDK(29=Android 10.0)
+    targetSdkVersion: 36,             // 目标 SDK
+    compileSdkVersion: 37,            // 编译 SDK
+    buildToolsVersion: '37.0.0',      // 构建工具版本
+    abiFilters: ['arm64-v8a'],        // 打包架构(真机用 arm64-v8a, 模拟器加 x86_64)
+    icon: './build/icon.png',         // 应用图标(建议 512x512 PNG)
+    usesCleartextTraffic: true,       // 是否允许明文流量(http)
+    buildNativeModules: false,        // 是否在 nodejs-project 里编译原生模块(bcrypt 等)
+    permissions: [                    // 额外权限(按需添加)
+      // 'android.permission.INTERNET',   // INTERNET 始终包含,不需配置
+      // 'android.permission.ACCESS_NETWORK_STATE',
+      // 'android.permission.CAMERA',
+      // 'android.permission.READ_EXTERNAL_STORAGE',
+    ],
+    // 签名配置(发布 Release 版本时必填)
+    signing: {
+      // keystore: './build/release.keystore',
+      // storePassword: '',
+      // keyAlias: '',
+      // keyPassword: '',
+    },
+  },
+
+  // ===== iOS 平台配置 =====
+  // 说明: 当前仅支持 Node 18;Node 18+ 需自行适配 libnode.so
+  ios: {
+    deploymentTarget: '15.1',         // 最低 iOS 版本(RN 0.87 要求 15.1+)
+    icon: './build/icon.png',         // 应用图标(建议 1024x1024 PNG)
+    // 签名配置（仅 macOS，发布时必填）：
+    //   teamId              Apple Developer Team ID
+    //   provisioningProfile 描述文件路径（写入 exportOptions.plist）
+    //   certificate         P12 证书路径（导入临时 keychain 供 xcodebuild 签名用）
+    //   certificatePassword P12 密码
+    signing: {
+      // teamId: '',
+      // provisioningProfile: './build/profile.mobileprovision',
+      // certificate: './build/cert.p12',
+      // certificatePassword: '',
+    },
+  },
+
+  // ===== 高级选项 =====
+  advanced: {
+    keepAlive: true,                  // 是否发送心跳保持 Node.js 进程活跃
+    heartbeatInterval: 5000,          // 心跳间隔(毫秒)
+  },
+
+  // ===== 扩展点 =====
+  // 不重置的模板文件（路径相对于 node-mobile-app-build/，如 'android/app/src/main/AndroidManifest.xml'）
+  keepFiles: [],
+  // 额外 RN 原生依赖包名数组（用于 autolink 识别，含原生模块的包必须在此声明）
+  // 安装命令用 --save-dev，这些是开发依赖，不会进移动端 Node 环境
+  // 示例: npm install --save-dev react-native-camera
+  //       extraRnDependencies: ['react-native-camera']
+  // 未安装的包会在 test/build 时中断并提示安装命令
+  extraRnDependencies: [],
+
+  // ===== 排除文件/目录(复制到壳工程时排除) =====
+  excludeFiles: [
+    '.git/',
+    '.vscode/',
+    '.idea/',
+    '.vs/',
+    'node_modules/',                  // 如需保留请删除此行
+    'sessions/',
+    'users.json',
+    '.env',
+    '*.log',
+    '*.md',
+    '*.tgz',
+    '*.bak',
+    '.backup*',
+    'dist/',
+    'out/',
+    'build/',
+    'tests/',
+    './mobileAppConfig.js',           // 配置文件本身不打包
+    'nodejs-assets/',                 // 插件 postinstall 生成的示例骨架
+  ],
+
+  // ===== 允许执行安装脚本的包 =====
+  allowScripts: {
+    'node': true,
+    'unrs-resolver': true,
+    '@parcel/watcher': true,
+    'bcrypt': true,
+  },
+};

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@flun/node-mobile-app",
+  "version": "1.0.1",
+  "description": "将 Node.js 项目一键打包为 Android / iOS 移动应用（基于 nodejs-mobile-react-native）",
+  "author": "flun <open@flun.top>",
+  "keywords": [
+    "node-mobile",
+    "nodejs",
+    "nodejs-mobile",
+    "react-native",
+    "android",
+    "ios",
+    "mobile",
+    "mobile-app",
+    "apk",
+    "ipa",
+    "express",
+    "webview",
+    "cli"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "cli-assets/",
+    "scripts/",
+    "src/",
+    "template/",
+    "LICENSE",
+    "mobileAppConfig.js",
+    "README.md",
+    "自定义libnode指南.md",
+    "Android 构建指南.md",
+    "package.json"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/copy-files.js"
+  },
+  "dependencies": {
+    "@babel/core": "^8.0.6",
+    "@babel/preset-env": "^8.0.6",
+    "@babel/runtime": "^8.0.5",
+    "@react-native-community/cli": "^20.2.0",
+    "@react-native-community/cli-platform-android": "^20.2.0",
+    "@react-native-community/cli-platform-ios": "^20.2.0",
+    "@react-native/babel-preset": "^0.87.1",
+    "@react-native/eslint-config": "^0.87.1",
+    "@react-native/jest-preset": "^0.87.1",
+    "@react-native/metro-config": "^0.87.1",
+    "@react-native/new-app-screen": "^0.87.1",
+    "@react-native/typescript-config": "^0.87.1",
+    "jimp": "^1.6.0",
+    "nodejs-mobile-react-native": "^18.20.4",
+    "react": "^19.3.0",
+    "react-native": "^0.87.1",
+    "react-native-safe-area-context": "^5.10.0",
+    "react-native-webview": "^14.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "^19.3.0",
+    "prettier": "^3.9.8",
+    "typescript": "^7.0.2"
+  },
+  "allowScripts": {
+    "node": true,
+    "nodejs-mobile-react-native": true,
+    "unrs-resolver": true,
+    "@parcel/watcher": true
+  },
+  "homepage": "https://github.com/OpenFlun/node-mobile-app#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenFlun/node-mobile-app.git"
+  },
+  "gitee": "https://gitee.com/OpenFlun/node-mobile-app.git",
+  "bugs": {
+    "url": "https://github.com/OpenFlun/node-mobile-app/issues"
+  },
+  "license": "ISC",
+  "engines": {
+    "node": ">= 18.20.4"
+  },
+  "bin": {
+    "node-mobile-app": "./bin/cli.js"
+  }
+}

package/scripts/copy-files.js

@@ -0,0 +1,37 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// 要复制的文件位置和文件目标位置
+const __filename = fileURLToPath(import.meta.url), __dirname = path.dirname(__filename),
+    initCwd = process.env.INIT_CWD, fileName = 'mobileAppConfig.js', targetDir = initCwd ? path.resolve(initCwd) : '',
+    // 要拷贝的文件和目标文件路径
+    sourceFile = path.join(__dirname, '..', fileName), targetFile = path.join(targetDir, fileName);
+
+/**
+ * 复制文件到项目根目录
+ * >查看定义:@see {@link copyFile}
+ * @returns {boolean} - 复制是否成功
+ */
+const copyFile = () => {
+    console.log(`🔍 检查 ${fileName} 文件...`), console.log(`📁 项目根目录:${targetDir}`);
+    try {
+        // 无 INIT_CWD（非用户项目安装场景）|| 目标目录不是 Node 项目 || 包自身的 npm install（开发调试）→ 跳过
+        if (!targetDir) return true;
+        if (!fs.existsSync(path.join(targetDir, 'package.json'))) return true;
+        if (targetDir === path.resolve(__dirname, '..')) return true;
+        if (fs.existsSync(targetFile)) return true; // 目标文件已存在 → 直接返回
+        console.log(`⚠️ 在项目根目录未找到 ${fileName} 文件，正在创建...`);
+
+        fs.copyFileSync(sourceFile, targetFile);     // 复制源文件到项目根目录
+        console.log(`✓ 已创建 ${fileName} 示例文件:${targetFile}`);
+        return true;
+    } catch (error) {
+        console.error(`✗ 创建 ${fileName} 文件失败:`, error.message);
+        return false;
+    }
+}
+
+// 执行脚本并导出函数
+if (process.argv[1] === __filename) copyFile();
+export { copyFile };

package/src/commands/build.js

@@ -0,0 +1,109 @@
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import { loadConfig, validateConfig } from '../config.js';
+import {
+  getBuildDir, copyTemplate, copyUserProject, writeLocalProperties, ensureUserEntry, ensureUserConfig, patchAndroidAbi,
+  patchExtraRnDependencies
+} from '../copy.js';
+import { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl } from '../install.js';
+import { generateMainJs, generateRuntime } from '../generate.js';
+import { checkAndResetCache } from '../fingerprint.js';
+import {
+  patchAppConfig, patchAndroidConfig, patchSigning, patchIcon, patchIosConfig, patchIosIcon, resolveAppName
+} from '../patcher.js';
+import { ensureMac, checkIosTools, podInstall, xcodebuildArchive, xcodebuildExport } from '../platform-ios.js';
+import { run, ensureDir, sanitizeFileName } from '../utils.js';
+
+const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..'),
+  runBuild = async (flags) => {
+    const userProjectDir = process.cwd(), release = !!flags.release, isIos = !!flags.ios;
+    console.log(`\n=== node-mobile-app build (${isIos ? 'iOS' : 'Android'}, ${release ? 'release' : 'debug'}) ===\n`);
+    console.log('用户项目:', userProjectDir);
+
+    if (isIos) ensureMac(), checkIosTools();
+    console.log('\n[0/7] 检查用户配置与入口文件'), ensureUserConfig(userProjectDir, PKG_ROOT);
+
+    const config = await loadConfig(userProjectDir);
+    ensureUserEntry(userProjectDir, config, PKG_ROOT), validateConfig(config, userProjectDir);
+
+    const buildDir = getBuildDir(userProjectDir);
+    console.log('\n[1/7] 重置 RN 工程模板');
+    copyTemplate(PKG_ROOT, buildDir, config);
+    patchAndroidAbi(buildDir, config);
+    patchExtraRnDependencies(buildDir, userProjectDir, config);
+    patchAppConfig(buildDir, userProjectDir, config);
+    patchAndroidConfig(buildDir, config);
+    patchSigning(buildDir, userProjectDir, config);
+    await patchIcon(buildDir, userProjectDir, config);
+    patchIosConfig(buildDir, userProjectDir, config);
+    await patchIosIcon(buildDir, userProjectDir, config);
+
+    console.log('\n[2/7] 检查缓存指纹'), checkAndResetCache(buildDir, userProjectDir, config, PKG_ROOT);
+    console.log('\n[3/7] 复制用户项目');
+    const { moduleType, targetDir } = copyUserProject(userProjectDir, buildDir, config);
+    console.log('\n[4/7] 安装依赖'), installUserDeps(targetDir, config);
+    patchNodejsMobilePlugin(userProjectDir, config);
+    patchWebViewSsl(userProjectDir, config);
+    writeLocalProperties(buildDir, config);
+
+    console.log('\n[5/7] 生成桥接文件');
+    generateMainJs(targetDir, config, moduleType), generateRuntime(buildDir, config);
+
+    const appName = resolveAppName(userProjectDir, config), safeName = sanitizeFileName(appName),
+      outDir = path.resolve(userProjectDir, config.outputDir || './out');
+    ensureDir(outDir);
+
+    if (isIos) {
+      console.log('\n[6/7] pod install'), podInstall(path.join(buildDir, 'ios'));
+      console.log('\n[7/7] xcodebuild archive + export'), xcodebuildArchive(buildDir, config, release, userProjectDir);
+
+      const ipaPath = xcodebuildExport(buildDir, config, release, outDir, userProjectDir),
+        dstName = `${safeName}-${config.versionName}-${release ? 'release' : 'debug'}.ipa`, dst = path.join(outDir, dstName);
+      fs.copyFileSync(ipaPath, dst), console.log('\n✅ 打包完成');
+
+      const mb = (fs.statSync(dst).size / 1024 / 1024).toFixed(1);
+      console.log(`  ${dst}  (${mb} MB)`);
+      return;
+    }
+
+    console.log('\n[6/7] 打包 APK');
+    const assetsDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'assets'),
+      resDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'res');
+
+    ensureDir(assetsDir);
+    run('npx', [
+      'react-native', 'bundle',
+      '--platform', 'android',
+      '--dev', release ? 'false' : 'true',
+      '--entry-file', 'index.js',
+      '--bundle-output', path.join(assetsDir, 'index.android.bundle'),
+      '--assets-dest', resDir,
+    ], { cwd: buildDir });
+
+    const task = release ? 'assembleRelease' : 'assembleDebug', gradleArgs = [task];
+    if (flags.arch) gradleArgs.push(`-PreactNativeArchitectures=${flags.arch}`);
+
+    const gradlew = process.platform === 'win32' ? 'gradlew.bat' : './gradlew';
+    run(gradlew, gradleArgs, { cwd: path.join(buildDir, 'android') });
+
+    const apkDir = path.join(buildDir, 'android', 'app', 'build', 'outputs', 'apk', release ? 'release' : 'debug');
+    console.log('\n✅ 打包完成');
+
+    if (fs.existsSync(apkDir)) {
+      const apks = fs.readdirSync(apkDir).filter((f) => f.endsWith('.apk'));
+      if (apks.length === 0) console.log('  ⚠️  未找到 APK');
+
+      for (const f of apks) {
+        const src = path.join(apkDir, f), dstName = `${safeName}-${config.versionName}-${release ? 'release' : 'debug'}.apk`,
+          dst = path.join(outDir, dstName);
+
+        fs.copyFileSync(src, dst);
+        const mb = (fs.statSync(dst).size / 1024 / 1024).toFixed(1);
+        console.log(`  ${dst}  (${mb} MB)`);
+      }
+    }
+    else console.log('  ⚠️  未找到 APK 输出目录:', apkDir);
+  }
+
+export { runBuild };

package/src/commands/clean.js

@@ -0,0 +1,25 @@
+import path from 'path';
+import fs from 'fs';
+import { removeDir } from '../utils.js';
+import { getBuildDir } from '../copy.js';
+
+const runClean = async () => {
+  const userProjectDir = process.cwd(), buildDir = getBuildDir(userProjectDir),
+    targets = [
+      { label: '构建目录', path: buildDir },
+      {
+        label: '插件 CMake 缓存', path: path.join(userProjectDir, 'node_modules', 'nodejs-mobile-react-native', 'android',
+          '.cxx')
+      },
+    ];
+
+  for (const t of targets) {
+    if (fs.existsSync(t.path))
+      removeDir(t.path), console.log('已清理:', t.label, '->', path.relative(userProjectDir, t.path) || t.path);
+    else console.log('跳过（不存在）:', t.label);
+  }
+
+  console.log('\n✅ 清理完成');
+};
+
+export { runClean };

package/src/commands/test.js

@@ -0,0 +1,108 @@
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import { loadConfig, validateConfig } from '../config.js';
+import {
+  getBuildDir, copyTemplate, copyUserProject, writeLocalProperties, ensureUserEntry, ensureUserConfig, patchAndroidAbi,
+  patchExtraRnDependencies
+} from '../copy.js';
+import { installUserDeps, patchNodejsMobilePlugin, patchWebViewSsl } from '../install.js';
+import { generateMainJs, generateRuntime } from '../generate.js';
+import { checkAndResetCache } from '../fingerprint.js';
+import { patchAppConfig, patchAndroidConfig, patchSigning, patchIcon, patchIosConfig, patchIosIcon } from '../patcher.js';
+import { ensureMac, checkIosTools, podInstall } from '../platform-ios.js';
+import { run, runSilent, findAdb, ensureDir, findHermesc } from '../utils.js';
+
+const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..'),
+  runTest = async flags => {
+    const userProjectDir = process.cwd(), isIos = !!flags.ios;
+    console.log(`\n=== node-mobile-app test (${isIos ? 'iOS' : 'Android'}) ===\n`), console.log('用户项目:', userProjectDir);
+
+    if (isIos) ensureMac(), checkIosTools();
+    console.log('\n[0/9] 检查用户配置与入口文件'), ensureUserConfig(userProjectDir, PKG_ROOT);
+
+    const config = await loadConfig(userProjectDir);
+    ensureUserEntry(userProjectDir, config, PKG_ROOT), validateConfig(config, userProjectDir);
+
+    const buildDir = getBuildDir(userProjectDir);
+    console.log('\n[1/9] 重置 RN 工程模板');
+    copyTemplate(PKG_ROOT, buildDir, config);
+    patchAndroidAbi(buildDir, config);
+    patchExtraRnDependencies(buildDir, userProjectDir, config);
+    patchAppConfig(buildDir, userProjectDir, config);
+    patchAndroidConfig(buildDir, config);
+    patchSigning(buildDir, userProjectDir, config);
+    await patchIcon(buildDir, userProjectDir, config);
+    patchIosConfig(buildDir, userProjectDir, config);
+    await patchIosIcon(buildDir, userProjectDir, config);
+
+    console.log('\n[2/9] 检查缓存指纹'), checkAndResetCache(buildDir, userProjectDir, config, PKG_ROOT);
+    console.log('\n[3/9] 复制用户项目');
+    const { moduleType, targetDir } = copyUserProject(userProjectDir, buildDir, config);
+
+    console.log('\n[4/9] 安装依赖'), installUserDeps(targetDir, config);
+    patchNodejsMobilePlugin(userProjectDir, config);
+    patchWebViewSsl(userProjectDir, config);
+    writeLocalProperties(buildDir, config);
+
+    console.log('\n[5/9] 生成桥接文件');
+    generateMainJs(targetDir, config, moduleType), generateRuntime(buildDir, config);
+
+    if (isIos) {
+      console.log('\n[6/9] pod install'), podInstall(path.join(buildDir, 'ios'));
+      console.log('\n[7/9] 生成 JS bundle + Hermes 字节码（由 Xcode Run Script 自动）');
+      const bundlePath = path.join(buildDir, 'ios', 'main.jsbundle');
+      runSilent('npx', [
+        'react-native', 'bundle',
+        '--platform', 'ios',
+        '--dev', 'false',
+        '--entry-file', 'index.js',
+        '--bundle-output', bundlePath,
+      ], { cwd: buildDir });
+      console.log('  ✓ bundle 已生成');
+
+      console.log('\n[8/9] 编译并安装到模拟器/设备');
+      const args = ['react-native', 'run-ios'];
+      if (flags.device) args.push('--device', flags.device);
+      // FORCE_BUNDLING=1：即使 Debug+模拟器也把 main.jsbundle 打进 App
+      const env = { ...process.env, FORCE_BUNDLING: '1' };
+      run('npx', args, { cwd: buildDir, env });
+    } else {
+      console.log('\n[6/9] 生成 JS bundle（离线可用）');
+      const assetsDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'assets'),
+        resDir = path.join(buildDir, 'android', 'app', 'src', 'main', 'res');
+      ensureDir(assetsDir);
+
+      const bundlePath = path.join(assetsDir, 'index.android.bundle');
+      runSilent('npx', [
+        'react-native', 'bundle',
+        '--platform', 'android',
+        '--dev', 'false',
+        '--entry-file', 'index.js',
+        '--bundle-output', bundlePath,
+        '--assets-dest', resDir,
+      ], { cwd: buildDir });
+      console.log('  ✓ bundle 已生成');
+
+      console.log('\n[7/9] 编译 Hermes 字节码（加速离线启动）');
+      const hermesc = findHermesc(userProjectDir);
+      if (hermesc) {
+        const hbcPath = bundlePath + '.hbc';
+        runSilent(hermesc, ['-emit-binary', '-out', hbcPath, bundlePath]);
+        fs.copyFileSync(hbcPath, bundlePath), fs.unlinkSync(hbcPath);
+        console.log('  ✓ 已替换为 Hermes 字节码');
+      }
+      else console.warn('  ⚠️  未找到 hermesc，跳过字节码编译（离线启动会较慢）');
+
+      console.log('\n[8/9] 配置 adb 端口转发');
+      const adb = findAdb(config);
+      console.log('  adb:', adb), run(adb, ['reverse', 'tcp:8081', 'tcp:8081']);
+
+      console.log('\n[9/9] 编译并安装到设备');
+      const args = ['react-native', 'run-android'];
+      if (flags.device) args.push('--deviceId', flags.device);
+      run('npx', args, { cwd: buildDir });
+    }
+  };
+
+export { runTest };

package/src/config.js

@@ -0,0 +1,112 @@
+import path from 'path';
+import fs from 'fs';
+import { pathToFileURL } from 'url';
+
+const DEFAULT_CONFIG = {
+  serverPath: './server.js',
+  appName: null,
+  outputDir: null,
+  appId: 'com.example.app',
+  versionCode: 1,
+  versionName: '1.0.0',
+  webview: {
+    showLoading: true,
+    loadingText: '正在启动服务...',
+    enableJavaScript: true,
+    enableDomStorage: true,
+    allowFileAccess: true,
+    mixedContentMode: 'always',
+    backgroundColor: '#ffffff',
+    allowSelfSignedCert: false,
+  },
+  android: {
+    sdkPath: null,
+    adbPath: null,
+    minSdkVersion: 29,
+    targetSdkVersion: 36,
+    compileSdkVersion: 37,
+    buildToolsVersion: '37.0.0',
+    abiFilters: ['arm64-v8a'],
+    icon: './build/icon.png',
+    usesCleartextTraffic: true,
+    permissions: [],
+    buildNativeModules: false,
+    signing: {},
+  },
+  ios: {
+    deploymentTarget: '15.1',
+    icon: './build/icon.png',
+    signing: {},
+  },
+  advanced: {
+    keepAlive: true,
+    heartbeatInterval: 5000,
+  },
+  keepFiles: [],
+  extraRnDependencies: [],
+  excludeFiles: [
+    '.git/', '.vscode/', '.idea/', '.vs/',
+    'node_modules/', 'sessions/', 'users.json', '.env',
+    '*.log', '*.md', '*.tgz', '*.bak', '.backup*', 'dist/', 'out/', 'build/', 'tests/',
+    'node-mobile-app-build/', 'nodejs-assets/',
+  ],
+  allowScripts: {
+    'node': true,
+  }
+},
+  merge = (def, user) => {
+    const out = { ...def };
+    for (const k of Object.keys(user)) {
+      if (user[k] && typeof user[k] === 'object' && !Array.isArray(user[k])) out[k] = merge(def[k] || {}, user[k]);
+      else if (user[k] !== undefined && user[k] !== null) out[k] = user[k];
+    }
+    return out;
+  },
+  loadConfig = async userProjectDir => {
+    for (const name of ['mobileAppConfig.js', 'mobileAppConfig.mjs', 'mobileAppConfig.cjs']) {
+      const p = path.join(userProjectDir, name);
+      if (fs.existsSync(p)) {
+        console.log('读取配置:', name);
+        const mod = await import(pathToFileURL(p).href);
+        return merge(DEFAULT_CONFIG, mod.default || mod);
+      }
+    }
+    console.log('未找到 mobileAppConfig.js，使用默认配置');
+    return DEFAULT_CONFIG;
+  },
+  validateConfig = (config, userProjectDir) => {
+    const errors = [], entry = path.join(userProjectDir, config.serverPath);
+    if (!fs.existsSync(entry)) errors.push('serverPath 不存在: ' + config.serverPath);
+
+    const pkg = path.join(userProjectDir, 'package.json');
+    if (!fs.existsSync(pkg)) errors.push('用户项目缺少 package.json');
+    // 极简防呆：至少 2 段、每段非空、只含 [a-zA-Z0-9_-]，不允许首尾点或连续点
+    // 具体平台是否合法交给 Gradle / Xcode 报错（Android 不允许 -，iOS 允许）
+    if (
+      typeof config.appId !== 'string' ||
+      !/^[a-zA-Z0-9_-]+(\.[a-zA-Z0-9_-]+)+$/.test(config.appId)
+    )
+      errors.push('appId 格式不合法（需反向域名格式，如 com.example.app）: ' + config.appId);
+    if (!Number.isInteger(config.versionCode) || config.versionCode < 1) errors.push('versionCode 必须是正整数');
+    if (!config.android.abiFilters?.length) errors.push('android.abiFilters 不能为空');
+    if (errors.length) {
+      errors.forEach((e) => console.error('  - ' + e));
+      throw new Error('配置校验失败');
+    }
+    console.log('配置校验通过');
+  },
+  resolveSdkPath = (config) => {
+    if (config.android && config.android.sdkPath) return config.android.sdkPath;
+    for (const env of ['ANDROID_HOME', 'ANDROID_SDK_ROOT']) {
+      const base = process.env[env];
+      if (base && fs.existsSync(base)) return base;
+    }
+    const localAppData = process.env.LOCALAPPDATA || '', home = process.env.USERPROFILE || process.env.HOME || '',
+      candidates = [path.join(localAppData, 'Android', 'Sdk'), path.join(home, 'Library', 'Android', 'sdk'),
+      path.join(home, 'Android', 'Sdk')];
+
+    for (const c of candidates) if (c && fs.existsSync(path.join(c, 'platform-tools'))) return c;
+    return null;
+  };
+
+export { DEFAULT_CONFIG, loadConfig, validateConfig, resolveSdkPath };