@flun/node-mobile-app 3.1.3 → 3.1.4

package/CHANGELOG.md

@@ -1,12 +1,15 @@
 # 变更日志
+## [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 是编译必需）；
 
 ## [3.1.2] - 2026-10-15 21:05
 ### 修复
-- 修复了 "src\optimize-node-modules.js" 中 prunePlatform 函数一些边界问题;
-
-## [3.1.1] - 2026-10-15 20:29
-### 更新
-- 同步更新了一些依赖包;
+- 修复了 "src\optimize-node-modules.js" 中 prunePlatform 函数一些边界问题;

package/README.md

@@ -476,6 +476,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.4",
   "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/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'