@flun/node-mobile-app 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 变更日志
 
+## [3.1.0] - 2026-10-15 20:15
+### 修复
+- **优化阶段步骤顺序调整（重要）**：构建时原优化顺序是「先合并 JS、后清空资源」——合并会删除 postinstall 脚本文件，导致清空阶段读不到脚本、无法提取资源目录，报「清空 0 项」、资源目录残留；现改为**先清空资源、后合并**：
+  - 清空资源时**跳过 js 文件**，留待合并阶段处理；
+  - 日志如实反映：「清空 N 个文件（js 文件保留，留待合并阶段处理）」；
+- **`clearItem` 单文件分支漏判 js（重要）**：目录分支已有「跳过 js」判断，单文件分支遗漏，导致资源目录中的**单个 js 文件**被清空为 0 字节，合并阶段读到空文件、产物损坏；现补充 js 判断，js 一律保留给合并阶段；
+- **合并阶段日志标题**：由「处理 JS 资源(用到则合并,未用到则提前清除)」改为「处理保留的资源 JS（被引用则合并，否则删除）」，与新流程呼应；
+- **Gradle 原生编译报 postinstall 失败（重要）**：Gradle 编译原生模块时执行 `npm rebuild`，会触发各包 postinstall；而合并阶段已删除脚本文件，导致 `Cannot find module ... copy-files.js`、构建失败；现合并阶段同步**删除 `package.json` 的 `scripts` 字段**（运行时无安装期，scripts 无用），rebuild 不再触发；
+- **`--debug` 下 `quiet` 命令仍被静默**：`run` 的 quiet 分支未判断 debug，导致 `--debug` 时 `gradlew` / `xcodebuild` 等命令输出仍被吞；现改为「debug 时忽略 quiet，全量输出」（不影响默认模式下 test 的精简行为）；
+
 ## [3.0.0] - 2026-10-13 21:19
 ### 新增
 - **node_modules 优化系统（默认开启）**：构建时自动执行六阶段优化，大幅减少打包文件数、加速启动。不改变项目源码，对任意 Node.js 项目通用；
@@ -32,8 +42,4 @@
 
 ## [2.1.2] - 2026-09-29 19:53
 ### 更改
-- 加固了拷贝文件的一些逻辑;
-
-## [2.1.1] - 2026-09-29 13:55
-### 优化
-- 优化了 'README.md' 文档;
+- 加固了拷贝文件的一些逻辑;

package/README.md

@@ -17,7 +17,7 @@
 - **增量构建**：文件指纹判断缓存,无变化时 10 秒级重跑
 - **跨平台**：Android（Windows / macOS / Linux）+ iOS（仅 macOS）
 - **离线可用**：`build` 打出的 APK / IPA 内置 JS,无需连电脑也能跑
-- **node_modules 优化（默认开启）**：构建时自动合并 JS、清平台二进制、清开发文件等，大幅减少打包文件数与体积、加速启动；无需配置
+- **node_modules 优化（默认开启）**：构建时自动执行六阶段优化——先清空 postinstall 资源（保留 js 供合并）、再合并 JS、清平台二进制、清开发文件（原生模块编译必需文件保留）、清中间产物、清冗余与空目录；大幅减少打包文件数与体积、加速启动，无需配置
 
 ---
 
@@ -54,7 +54,7 @@
 │   ├── fingerprint.js            # 缓存指纹（判断是否需要清理构建缓存）
 │   ├── generate.js               # 生成 main.js（桥接）+ mobileApp.runtime.ts（运行时配置）
 │   ├── install.js                # 依赖安装 + 插件 abiFilters patch + WebView SSL patch
-│   ├── optimize-node-modules.js  # node_modules 优化（六阶段：合并 JS / 清资源 / 清平台二进制 / 清开发文件 / 清中间产物 / 清冗余）
+│   ├── optimize-node-modules.js  # node_modules 优化（六阶段：清资源 / 合并 JS / 清平台二进制 / 清开发文件 / 清中间产物 / 清冗余）
 │   ├── patcher.js                # 应用信息 / Android / iOS 配置 patch
 │   ├── platform-ios.js           # iOS 构建（pod install / xcodebuild archive / export）
 │   ├── utils.js                  # 通用工具（文件操作 / 进程调用 / adb / hermesc 定位）
@@ -350,8 +350,8 @@ signing: {
 
 **六阶段流程**：
 
-1. **合并 JS**：按包入口 bundle，多个 JS 文件合并为单文件（`bundled/` 目录）；
-2. **清空资源**：扫描各包 `postinstall` 引用的目录/文件，保留目录结构、清空内容；被 import/require 的保留；
+1. **清空资源**：扫描各包 `postinstall` 引用的目录/文件，保留目录结构、清空内容；js 文件一律保留，留待合并阶段处理；
+2. **合并 JS**：按包入口 bundle，多个 JS 文件合并为单文件（`bundled/` 目录）；合并后同步删除 `package.json` 的 `scripts` 字段（运行时无安装期，且 Gradle `npm rebuild` 会触发脚本导致失败）；
 3. **清平台二进制**：按目标平台 + `abiFilters` 逐文件判定，删除非本机二进制；
 4. **清开发文件**：删除 `.md` / `.map` / `.d.ts` / `.h` / `.c` 等非运行文件；**原生模块包（含 `binding.gyp`）内的编译必需文件保留**；
 5. **清中间产物**；
@@ -363,7 +363,7 @@ signing: {
 
 - `optimize: { enabled: false }` 整体关闭优化；
 - `optimize: { exclude: ['包名'] }` 排除优化时异常或不想优化的包；
-- 加 `--debug` 查看优化各阶段明细。
+- 加 `--debug` 查看优化各阶段明细与各命令完整输出。
 
 ## 服务地址说明
 

package/package.json

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

package/src/install.js

@@ -1,7 +1,7 @@
 import path from 'path';
 import fs from 'fs';
 import { run } from './utils.js';
-import { optimizeNodeModules, clearVerified, SELF_HASH } from './optimize-node-modules.js';
+import { clearVerified, optimizeNodeModules, SELF_HASH } from './optimize-node-modules.js';
 const
   /**
    * 内部：从 libnode 的 node_version.h 读取运行时 Node 主版本号

package/src/optimize-node-modules.js

@@ -33,35 +33,33 @@ const require = createRequire(import.meta.url), subpath = (...parts) => './' + p
         old.platform = targetPlatform, old.abiFilters = abiFilters, old.runtimeMajor = runtimeMajor;
         old.optimizeHash = SELF_HASH, old.verified = false, old.optimized = true;
         fs.writeFileSync(p, JSON.stringify(old, null, 2));
-    };
-
-
-// ==================== 扫描工具 ====================
-const findPackages = dir => {
-    const result = [];
-    if (!fs.existsSync(dir)) return result;
-    for (const entry of fs.readdirSync(dir)) {
-        if (entry === '.bin' || entry.startsWith('.')) continue;
-        const full = path.join(dir, entry);
-        if (!fs.statSync(full).isDirectory()) continue;
-        if (entry === NM_DIR) { result.push(...findPackages(full)); continue; }
-        if (entry.startsWith('@')) {
-            for (const sub of fs.readdirSync(full)) {
-                const pkgDir = path.join(full, sub);
-                if (fs.statSync(pkgDir).isDirectory()) {
-                    result.push(pkgDir);
-                    const nested = path.join(pkgDir, NM_DIR);
-                    if (fs.existsSync(nested)) result.push(...findPackages(nested));
+    },
+    // ==================== 扫描工具 ====================
+    findPackages = dir => {
+        const result = [];
+        if (!fs.existsSync(dir)) return result;
+        for (const entry of fs.readdirSync(dir)) {
+            if (entry === '.bin' || entry.startsWith('.')) continue;
+            const full = path.join(dir, entry);
+            if (!fs.statSync(full).isDirectory()) continue;
+            if (entry === NM_DIR) { result.push(...findPackages(full)); continue; }
+            if (entry.startsWith('@')) {
+                for (const sub of fs.readdirSync(full)) {
+                    const pkgDir = path.join(full, sub);
+                    if (fs.statSync(pkgDir).isDirectory()) {
+                        result.push(pkgDir);
+                        const nested = path.join(pkgDir, NM_DIR);
+                        if (fs.existsSync(nested)) result.push(...findPackages(nested));
+                    }
                 }
+            } else {
+                result.push(full);
+                const nested = path.join(full, NM_DIR);
+                if (fs.existsSync(nested)) result.push(...findPackages(nested));
             }
-        } else {
-            result.push(full);
-            const nested = path.join(full, NM_DIR);
-            if (fs.existsSync(nested)) result.push(...findPackages(nested));
         }
-    }
-    return result;
-},
+        return result;
+    },
     hasNativeModule = dir => {
         let found = false;
         const walk = d => {
@@ -287,6 +285,8 @@ const findPackages = dir => {
                 j.main = isESM ? newExports['.'] : (newExports['.'].require || newExports['.'].default || newExports['.']);
             else delete j.main;
             if (isESM && j.main) j.module = j.main;
+            // 删除安装期脚本字段：移动端 Gradle 会 npm rebuild，触发 postinstall；运行时无安装期，scripts 无用
+            delete j.scripts;
             fs.writeFileSync(pj, JSON.stringify(j, null, 2));
 
             // 删除原 JS
@@ -315,7 +315,7 @@ const findPackages = dir => {
         }
 
         if (resLog && resLog.length > 0) {
-            console.log('  处理 JS 资源(用到则合并,未用到则提前清除):');
+            console.log('  处理保留的资源 JS（被引用则合并，否则删除）:');
             for (const line of resLog) console.log(line);
         }
         return { merged, skipped, totalDeleted };
@@ -363,20 +363,17 @@ const findPackages = dir => {
         return [...new Set(items)];
     },
     clearItem = (p, refs) => {
+        let n = 0;
         const st = fs.statSync(p);
         if (st.isDirectory()) {
             for (const f of fs.readdirSync(p)) {
                 const full = path.join(p, f), sub = fs.statSync(full);
-                if (sub.isDirectory()) clearItem(full, refs);
-                else {
-                    if (refs.has(full)) continue;
-                    fs.rmSync(full, { force: true });
-                }
+                if (sub.isDirectory()) n += clearItem(full, refs);
+                else if (!JS_RE.test(f) && !refs.has(full)) try { fs.rmSync(full, { force: true }), n++; } catch { }
             }
-        } else {
-            if (refs.has(p)) return;
-            fs.writeFileSync(p, '');
         }
+        else if (!JS_RE.test(path.basename(p)) && !refs.has(p)) fs.writeFileSync(p, ''), n++;
+        return n;
     },
     clearResources = async (nmDir, excludePkgs) => {
         const refs = collectReferencedFiles(nmDir);
@@ -396,8 +393,10 @@ const findPackages = dir => {
                 const scriptAbs = path.resolve(pkgDir, scriptRel);
                 if (!fs.existsSync(scriptAbs)) continue;
                 const code = fs.readFileSync(scriptAbs, 'utf8'), items = extractResources(pkgDir, code);
-                for (const item of items)
-                    try { clearItem(path.join(pkgDir, item), refs), cleared++, pkgItems.push(item); } catch { }
+                for (const item of items) {
+                    const cnt = clearItem(path.join(pkgDir, item), refs);
+                    if (cnt > 0) cleared += cnt, pkgItems.push(`${item}(${cnt})`);
+                }
             }
             if (process.env.OPTIMIZE_DEBUG && pkgItems.length > 0) console.log(`  ✓ ${pkgRel}: ${pkgItems.join(', ')}`);
         }
@@ -586,11 +585,25 @@ const findPackages = dir => {
 
 // ==================== 导出函数 ====================
 /**
- * 标记快照 verified=true（构建全流程成功后由 build.js / test.js 调用）
+ * 清除快照中的 verified 标记（优化开始或构建失败时调用）
  * >查看定义:@see {@link clearVerified}
  * @param {string} snapshotDir 快照目录
  * @returns {Promise<void>}
  */
+const clearVerified = async snapshotDir => {
+    const p = path.join(snapshotDir, SNAPSHOT_FILE);
+    if (!fs.existsSync(p)) return;
+    try {
+        const old = JSON.parse(fs.readFileSync(p, 'utf-8'));
+        if (old.verified !== false) old.verified = false, fs.writeFileSync(p, JSON.stringify(old, null, 2));
+    } catch { }
+};
+/**
+ * 标记快照 verified=true（构建全流程成功后由 build.js / test.js 调用）
+ * >查看定义:@see {@link markVerified}
+ * @param {string} snapshotDir 快照目录
+ * @returns {Promise<void>}
+ */
 const markVerified = async snapshotDir => {
     const p = path.join(snapshotDir, SNAPSHOT_FILE);
     if (!fs.existsSync(p)) return;
@@ -601,7 +614,7 @@ const markVerified = async snapshotDir => {
 };
 /**
  * 执行 node_modules 六阶段优化
- * >查看定义:@see {@link SELF_HASH}
+ * >查看定义:@see {@link optimizeNodeModules}
  * @param {string} tempDir node_modules 所在目录（nodejs-assets/nodejs-project）
  * @param {object} [config] 优化配置
  * @param {string} [config.snapshotDir] 快照目录（默认同 tempDir）
@@ -615,29 +628,28 @@ const optimizeNodeModules = async (tempDir, config = {}) => {
     const targetPlatform = config.targetPlatform || 'android', abiFilters = config.abiFilters || ['arm64-v8a'],
         runtimeMajor = config.runtimeMajor, excludePkgs = new Set(config.exclude || []),
         nmDir = path.join(tempDir, NM_DIR), snapshotDir = config.snapshotDir || tempDir,
-        snapPath = path.join(snapshotDir, SNAPSHOT_FILE),
-        myPlat = TARGET_PLAT_MAP[targetPlatform] || [],
+        snapPath = path.join(snapshotDir, SNAPSHOT_FILE), myPlat = TARGET_PLAT_MAP[targetPlatform] || [],
         myArch = targetPlatform === 'ios' ? IOS_ARCHES : (abiFilters || []).map(a => ABI_ARCH_MAP[a]).filter(Boolean);
-    if (!runtimeMajor) throw new Error('optimizeNodeModules 缺少 config.runtimeMajor（应从 libnode/node_version.h 读取）');
 
+    if (!runtimeMajor) throw new Error('optimizeNodeModules 缺少 config.runtimeMajor（应从 libnode/node_version.h 读取）');
     if (!fs.existsSync(nmDir)) {
         console.log('[优化] node_modules 不存在,跳过');
         return { skipped: true };
     }
+
     await clearVerified(snapshotDir);  // 执行优化前清 verified,构建成功后再由 build.js / test.js 写回 true
-    const t0 = Date.now(),
-        nativePkgs = findPackages(nmDir).filter(p => fs.existsSync(path.join(p, 'binding.gyp')));
+    const t0 = Date.now(), nativePkgs = findPackages(nmDir).filter(p => fs.existsSync(path.join(p, 'binding.gyp')));
     try {
-        // 阶段1: 合并
-        console.log('  [1/6] 合并 JS...');
+        // 阶段1: 清空资源（跳过 js，留待合并阶段处理）
+        console.log('  [1/6] 清空复制到项目根的资源...');
+        const c = await clearResources(nmDir, excludePkgs);
+        console.log(`    清空 ${c} 个文件（js 文件保留，留待合并阶段处理）`);
+
+        // 阶段2: 合并
+        console.log('  [2/6] 合并 JS...');
         const m = await mergeAll(nmDir, excludePkgs, runtimeMajor);
         console.log(`    合并 ${m.merged} 包,跳过 ${m.skipped},删 ${m.totalDeleted} 个 JS`);
 
-        // 阶段2: 清空资源
-        console.log('  [2/6] 清空复制到项目根的资源...');
-        const c = await clearResources(nmDir, excludePkgs);
-        console.log(`    清空 ${c} 项`);
-
         // 阶段3: 清平台二进制
         console.log('  [3/6] 清理非当前平台二进制...');
         const p = await prunePlatform(nmDir, myPlat, myArch);
@@ -670,23 +682,9 @@ const optimizeNodeModules = async (tempDir, config = {}) => {
         throw err;
     }
 };
-/**
- * 清除快照中的 verified 标记（优化开始或构建失败时调用）
- * >查看定义:@see {@link markVerified}
- * @param {string} snapshotDir 快照目录
- * @returns {Promise<void>}
- */
-const clearVerified = async snapshotDir => {
-    const p = path.join(snapshotDir, SNAPSHOT_FILE);
-    if (!fs.existsSync(p)) return;
-    try {
-        const old = JSON.parse(fs.readFileSync(p, 'utf-8'));
-        if (old.verified !== false) old.verified = false, fs.writeFileSync(p, JSON.stringify(old, null, 2));
-    } catch { }
-};
 /**
  * 当前优化文件的 SHA256 前 16 位（缓存指纹:优化代码一改,缓存自动失效）
- * >查看定义:@see {@link optimizeNodeModules}
+ * >查看定义:@see {@link SELF_HASH}
  */
 const SELF_HASH = (() => {
     try {
@@ -695,4 +693,4 @@ const SELF_HASH = (() => {
     } catch { return 'unknown'; }
 })();
 
-export { markVerified, optimizeNodeModules, clearVerified, SELF_HASH };
+export { clearVerified, markVerified, optimizeNodeModules, SELF_HASH };

package/src/utils.js

@@ -85,7 +85,7 @@ const ensureDir = dir => {
    */
   run = (bin, args, opts = {}) => {
     const { quiet, ...restOpts } = opts;
-    if (!quiet) {
+    if (!quiet || process.env.OPTIMIZE_DEBUG) {
       const r = spawnCmd(bin, args, { stdio: 'inherit', ...restOpts });
       if (r.status !== 0) throw new Error(`${bin} ${args.join(' ')} 退出码 ${r.status}`);
       return r;