@flun/node-mobile-app 3.1.3 → 3.1.5

package/CHANGELOG.md

@@ -1,12 +1,18 @@
-# 变更日志
-## [3.1.3] - 2026-10-15 23:10
-### 修复
-- **删除 `scripts` 字段的范围扩大**：原仅对被合并的包删除 `package.json` 的 `scripts`；跳过的包（如原生模块、JS 较少的包）仍保留，其安装期脚本会被 Gradle `npm rebuild` 触发，若脚本文件已被清理则报 `Cannot find module`、构建失败；现改为**对所有非原生包删除**（原生模块包保留，其 scripts 是编译必需）；
-
-## [3.1.2] - 2026-10-15 21:05
-### 修复
-- 修复了 "src\optimize-node-modules.js" 中 prunePlatform 函数一些边界问题;
-
-## [3.1.1] - 2026-10-15 20:29
-### 更新
-- 同步更新了一些依赖包;
+# 变更日志
+## [3.1.5] - 2026-10-18 10:04
+### 修复
+- **修复原生模块编译时 `node-addon-api` 的 gyp / 头文件被误删**：`pruneDevFiles` 原保护条件为 `COMPILE_EXTS && inNativePkg`，而 `node-addon-api` 自身没有 `binding.gyp`、不在原生模块包列表内，其 `node_addon_api.gyp` 与头文件被当作开发文件删除，导致依赖它的原生模块（如 `bcrypt`）在 Gradle `npm rebuild` 时报 `../node-addon-api/node_addon_api.gyp not found`、构建中断；现新增 `isSkippedPkg`，保护条件改为 `COMPILE_EXTS && (inNativePkg || isSkippedPkg)`，仅保留 `SKIP_PKGS` 包内的编译文件（`.gyp`/`.gypi`/`.h`/`.c` 等），`.md`/`.map`/`.ts` 等仍照常清理，不扩大保留范围；
+
+### 变更
+- **阶段 4 不再清理 `.d.ts`**：`.d.ts` 已由阶段 6 的 `TS_RE`（`/\.(ts|cts|mts)$/`）覆盖，阶段 4 重复清理属冗余；移除后 `.d.ts` 统一由阶段 6 处理，清理职责不重叠；
+
+## [3.1.4] - 2026-10-17 11:32
+### 修复
+- **修复 `react-native bundle` 报 `Cannot resolve @react-native/metro-config`**：个别场景下用户根 `node_modules` 中缺失该包（如历史安装残留、依赖布局异常），RN CLI 从其自身位置向上解析不到，导致 `test` / `build` 的 bundle 阶段中断；现由 `copyTemplate` 调用新增的 `linkNestedDeps`：遍历主包 `node_modules` 顶层全部条目（含 `@scope/` 子项，不列举包名），对从用户根解析不到的条目，在用户根 `node_modules` 下建 Junction（Windows）/ symlink（macOS/Linux）指向主包物理路径；用户根已能解析的条目跳过、不改 `package.json` / `package-lock.json`、建链接失败即中断；
+
+### 变更
+- **Android 模板仓库增加阿里云镜像兜底**：`settings.gradle` 的 `pluginManagement.repositories` 与 `build.gradle` 的 `buildscript.repositories` 在 `google()` / `mavenCentral()` 之前插入阿里云镜像（gradle-plugin / google / public），改善国内网络拉取 `react-android`、`hermes-android` 等 AAR 时卡在官方源的问题；镜像在前、官方源在后，海外网络镜像不命中会自动回退官方源，仅多一次往返，不影响功能；不写死镜像为唯一源，镜像故障时仍可由官方源兜住；
+
+## [3.1.3] - 2026-10-15 23:10
+### 修复
+- **删除 `scripts` 字段的范围扩大**：原仅对被合并的包删除 `package.json` 的 `scripts`；跳过的包（如原生模块、JS 较少的包）仍保留，其安装期脚本会被 Gradle `npm rebuild` 触发，若脚本文件已被清理则报 `Cannot find module`、构建失败；现改为**对所有非原生包删除**（原生模块包保留，其 scripts 是编译必需）；

package/README.md

@@ -124,8 +124,9 @@
 ```json
 {
   "allowScripts": {
-    "@flun/nodejs-mobile-react-native": true,
-    "@flun/node-mobile-app": true
+    "esbuild": true,
+    "@flun/node-mobile-app": true,
+    "@flun/nodejs-mobile-react-native":true
   }
 }
 ```
@@ -169,7 +170,7 @@ npx node-mobile-app build --release
 ### 常用选项
 
 | 选项            | 用途                                           |
-| --------------- | --------------------------------------------- |
+| --------------- | ---------------------------------------------- |
 | `--ios`         | 目标平台为 iOS（默认 Android）                 |
 | `--release`     | 打 release 包（仅 `build`）                    |
 | `--device <id>` | 指定设备（`test`）                             |
@@ -343,10 +344,10 @@ signing: {
 
 构建时自动优化 `node_modules`（默认开启，无需配置），减少打包文件数与体积、加速启动。
 
-| 字段      | 类型       | 默认   | 说明                                                          |
-| --------- | ---------- | ------ | ------------------------------------------------------------- |
-| `enabled` | `boolean`  | `true` | 是否启用优化                                                  |
-| `exclude` | `string[]` | `[]`   | 排除优化时异常或不想优化的包（写 `package.json` 的 `name`）   |
+| 字段      | 类型       | 默认   | 说明                                                        |
+| --------- | ---------- | ------ | ----------------------------------------------------------- |
+| `enabled` | `boolean`  | `true` | 是否启用优化                                                |
+| `exclude` | `string[]` | `[]`   | 排除优化时异常或不想优化的包（写 `package.json` 的 `name`） |
 
 **六阶段流程**：
 
@@ -476,6 +477,16 @@ adb logcat | grep -E "NODEJS-MOBILE|ReactNativeJS"
 - 请检查 你的 'package.json' 中 "allowScripts" 字段
 
 
+### Q：Android 构建卡在拉取依赖（`react-android` / `hermes-android` 等）？
+
+Android 模板的 `settings.gradle` 与 `build.gradle` 已在 `google()` / `mavenCentral()` 之前插入阿里云镜像，国内网络优先走镜像；海外网络镜像不命中会自动回退官方源，不影响功能。
+
+若仍卡住：
+
+- 检查镜像可达：浏览器打开 `https://maven.aliyun.com/repository/public` 是否正常；
+- 检查本机 `~/.gradle/init.gradle` 是否有与仓库顺序冲突的配置（如强制替换仓库），有则临时移除以排除干扰；
+- 停掉残留 Daemon 后重试：在 `node-mobile-app-build/android/` 下执行 `gradlew --stop`，再重跑 `test` / `build`。
+
 ### Q：Express 版本怎么选？
 
 - **Android**：内置完整 ICU（full-icu）→ 可以用 Express 5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flun/node-mobile-app",
-  "version": "3.1.3",
+  "version": "3.1.5",
   "description": "将 Node.js 项目一键打包为 Android / iOS 移动应用,运行时由 @flun/nodejs-mobile-react-native 提供,无需修改你的 Node 代码;",
   "author": "flun <open@flun.top>",
   "keywords": [

package/src/copy.js

@@ -4,6 +4,7 @@ import {
   ensureDir, removeDir, readJson, isExcluded, copyFileIfChanged, writeIfChanged, buildEslintConfigSource
 } from './utils.js';
 import { resolveSdkPath } from './config.js';
+import { createRequire } from 'module';
 
 const BUILD_DIR_NAME = 'node-mobile-app-build',
   TEMPLATE_EXCLUDE = [
@@ -94,6 +95,54 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
       );
     }
   },
+  /**
+   * 把主包 node_modules 里被 npm 嵌套（未提升到用户根）的依赖，按需链接到用户根 node_modules 下，
+   * 让 RN CLI / Metro 从用户根也能解析到它们。
+   * - 判据：从用户根视角解析不到，才建链接；能解析则跳过；
+   * - 范围：遍历主包 node_modules 顶层全部条目（含 @scope/ 下每个子项），不列举任何包名；
+   * - 落点：只在用户根 node_modules 缺失条目时建 symlink，不覆盖已有内容、不碰 package.json / package-lock.json；
+   * - 建链接失败：中断报错，不静默。
+   */
+  linkNestedDeps = (pkgRoot, buildDir) => {
+    const pkgNm = path.join(pkgRoot, 'node_modules');
+    if (!fs.existsSync(pkgNm)) return;
+
+    const userProjectDir = path.dirname(buildDir),
+      userNm = path.join(userProjectDir, 'node_modules'),
+      req = createRequire(path.join(userProjectDir, 'index.js')),
+      candidates = [];
+    for (const entry of fs.readdirSync(pkgNm, { withFileTypes: true })) {
+      if (!entry.isDirectory() || entry.name.startsWith('.')) continue;
+      if (entry.name.startsWith('@')) {
+        const scopeDir = path.join(pkgNm, entry.name);
+        for (const sub of fs.readdirSync(scopeDir, { withFileTypes: true }))
+          if (sub.isDirectory()) candidates.push(entry.name + '/' + sub.name);
+      } else candidates.push(entry.name);
+    }
+
+    let linked = 0;
+    for (const name of candidates) {
+      try { req.resolve(name); continue; } catch { /* 解析不到，进入兜底 */ }
+      const src = path.join(pkgNm, name);
+      if (!fs.existsSync(src)) continue;
+      const realSrc = fs.realpathSync(src), dst = path.join(userNm, name);
+      let occupied = false;
+      try { fs.lstatSync(dst); occupied = true; } catch { /* 不存在 */ }
+      if (occupied) continue;
+      ensureDir(path.dirname(dst));
+      try {
+        fs.symlinkSync(realSrc, dst, 'junction');
+        linked++;
+      } catch (err) {
+        throw new Error(
+          '建立兜底链接失败：' + dst + ' -> ' + realSrc + '\n' +
+          '      原因：' + err.message + '\n' +
+          '      请检查 node_modules 是否被其它程序占用后重试'
+        );
+      }
+    }
+    if (linked > 0) console.log('  ✓ 已兜底链接 ' + linked + ' 个嵌套依赖到用户根 node_modules');
+  },
   /**
    * 把 CLI 包里的 template/ 逐文件覆盖到 build 目录
    * - 只覆盖模板里存在的文件，不删除 buildDir 里已有的其他内容（保留 Gradle 增量缓存）
@@ -110,6 +159,7 @@ const BUILD_DIR_NAME = 'node-mobile-app-build',
     copyDirOverwrite(templateDir, buildDir, TEMPLATE_EXCLUDE, buildDir, keepSet);
     fs.writeFileSync(path.join(buildDir, 'eslint.config.js'), buildEslintConfigSource(), 'utf-8');
     syncTemplateDependencies(pkgRoot, buildDir);
+    linkNestedDeps(pkgRoot, buildDir);
     console.log('  ✓ 模板已更新到', BUILD_DIR_NAME + '/');
     if (keepSet.size > 0) console.log('    保留文件:', Array.from(keepSet).join(', '));
   },

package/src/optimize-node-modules.js

@@ -15,6 +15,10 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
     IOS_ARCHES = ['arm64', 'x64'], INDEX_FILES = ['index.js', 'index.cjs', 'index.mjs'],
     // ==================== 通用工具 ====================
     toPosix = p => p.replace(POSIX_RE, '/'),
+    isSkippedPkg = rel => {
+        const seg = rel.split('/'), name = seg[0].startsWith('@') ? seg[0] + '/' + (seg[1] || '') : seg[0];
+        return SKIP_PKGS.has(name) || SKIP_PKGS.has(seg[0]);
+    },
     pickCond = (v, prefer) => {
         if (typeof v === 'string') return v;
         if (v && typeof v === 'object') {
@@ -500,7 +504,7 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
             /(^|\/)\.editorconfig$/, /(^|\/)\.prettierignore$/, /(^|\/)\.eslintignore$/,
             /(^|\/)\.dockerignore$/, /(^|\/)\.gitignore$/, /(^|\/)\.gitattributes$/, /(^|\/)\.npmignore$/,
             /\.(md|markdown)$/i, /\.(gyp|gypi)$/i, /\.(yml|yaml)$/i, /\.(h|c)$/,
-            /\.d\.ts$/, /\.map$/, /metafile-.*\.json$/,
+            /\.map$/, /metafile-.*\.json$/,
             /(^|\/)\.eslintrc(\.(json|yml|js|cjs))?$/, /(^|\/)\.babelrc(\.(json|js))?$/,
             /(^|\/)package-lock\.json$/, /(^|\/)\.package-lock\.json$/, /(^|\/)yarn\.lock$/,
             /(^|\/)package-support\.json$/,
@@ -519,7 +523,7 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
                         walk(full);
                     } else {
                         const rel = toPosix(path.relative(nmDir, full));
-                        if (PATTERNS.some(re => re.test(rel)) && !(COMPILE_EXTS.test(f.name) && inNativePkg(full)))
+                        if (PATTERNS.some(re => re.test(rel)) && !(COMPILE_EXTS.test(f.name) && (inNativePkg(full) || isSkippedPkg(rel))))
                             try { fs.unlinkSync(full), deleted++; } catch { }
                     }
                 }
@@ -699,4 +703,4 @@ const SELF_HASH = (() => {
     } catch { return 'unknown'; }
 })();
 
-export { clearVerified, markVerified, optimizeNodeModules, SELF_HASH };
+export { clearVerified, markVerified, optimizeNodeModules, SELF_HASH };

package/template/android/build.gradle

@@ -8,6 +8,8 @@ buildscript {
         kotlinVersion = "2.2.0"
     }
     repositories {
+        maven { url 'https://maven.aliyun.com/repository/google' }
+        maven { url 'https://maven.aliyun.com/repository/public' }
         google()
         mavenCentral()
     }

package/template/android/settings.gradle

@@ -1,4 +1,13 @@
-pluginManagement { includeBuild("../../node_modules/@react-native/gradle-plugin") }
+pluginManagement {
+    repositories {
+        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
+        maven { url 'https://maven.aliyun.com/repository/google' }
+        maven { url 'https://maven.aliyun.com/repository/public' }
+        google()
+        mavenCentral()
+    }
+    includeBuild("../../node_modules/@react-native/gradle-plugin")
+}
 plugins { id("com.facebook.react.settings") }
 extensions.configure(com.facebook.react.ReactSettingsExtension){ ex -> ex.autolinkLibrariesFromCommand() }
 rootProject.name = 'MyApp'