react-native-flux-desktop-packer 0.1.5 → 0.1.7

package/lib/brand.js

@@ -111,15 +111,16 @@ async function brandRuntime(exePath, { projectRoot, iconPngPaths, name, descript
     args.push('--set-file-version', v, '--set-product-version', v);
   }
   if (ico) args.push('--set-icon', ico);
+  let branded = false;
   try {
     const r = cp.spawnSync(bin, args, { windowsHide: true, encoding: 'utf8', timeout: 60000 });
     if (r.error) throw r.error;
     if (r.status !== 0) throw new Error(String(r.stderr || r.stdout || '').trim() || 'exit ' + r.status);
     ok(`exe 已注入品牌：${path.basename(exePath)}${ico ? ' + 图标' : ''}`);
-    return true;
+    branded = true;
   } catch (e) {
     warn(`rcedit 注入失败（忽略）：${(e && e.message) || e}`);
-    return false;
+    branded = false;
   } finally {
     if (ico) {
       try {
@@ -129,6 +130,38 @@ async function brandRuntime(exePath, { projectRoot, iconPngPaths, name, descript
       }
     }
   }
+  if (!branded) return false;
+  // 回读硬校验：FileDescription 决定任务栏/Alt-Tab 分组名。历史上曾因「打包用的是陈旧 file: 拷贝、
+  // 该行被注释」而反复静默翻车（rcedit 跑了、ProductName 改了，唯独 FileDescription 仍是 Node 默认）。
+  // 故注入成功后回读确认：若仍为 node.exe 默认名 → 抛 brandFatal，让打包直接失败而非静默出货。
+  const got = readFileDescription(exePath);
+  if (got === null) {
+    warn('未能回读 FileDescription 校验（非 Windows 或 PowerShell 不可用）——请人工确认任务栏分组名已品牌化');
+  } else if (got === '' || /node\.?js javascript runtime/i.test(got)) {
+    const err = new Error(
+      `FileDescription 注入未生效：回读为「${got || '(空)'}」，任务栏/进程名仍会显示 Node.js 默认。` +
+        `（若本地打包反复出现此错，多半是消费方 node_modules 里的 packer 为陈旧 file: 拷贝，需同步 lib/）\nrcedit args=${JSON.stringify(args)}`
+    );
+    err.brandFatal = true;
+    throw err;
+  } else {
+    ok(`FileDescription 回读校验通过：${got}`);
+  }
+  return true;
+}
+
+/** 读回 exe 内嵌的 FileDescription（Windows 经 PowerShell 的 VersionInfo）；无法读取返回 null。 */
+function readFileDescription(exePath) {
+  if (process.platform !== 'win32') return null;
+  try {
+    const lit = "'" + String(exePath).replace(/'/g, "''") + "'"; // PowerShell 单引号字面量转义
+    const cmd = `(Get-Item -LiteralPath ${lit}).VersionInfo.FileDescription`;
+    const r = cp.spawnSync('powershell', ['-NoProfile', '-Command', cmd], { windowsHide: true, encoding: 'utf8', timeout: 15000 });
+    if (r.error || r.status !== 0) return null;
+    return String(r.stdout || '').trim();
+  } catch {
+    return null;
+  }
 }
 
-module.exports = { brandRuntime, buildIcoFromPngs, resolveRcedit, resolveRceditBin };
+module.exports = { brandRuntime, buildIcoFromPngs, resolveRcedit, resolveRceditBin, readFileDescription };

package/lib/config.js

@@ -53,6 +53,10 @@ function loadConfig(projectRoot) {
     : Array.isArray(app.nativeLibs)
     ? app.nativeLibs
     : [];
+  // 第三方原生包（sea 模式）：nativePackages 强制纳入整包落盘；skipNative 排除自动扫描命中的包。
+  // 二者均可缺省——sea 会自动扫描 node_modules 下含 .node 的第三方包，这里仅作兑底。
+  const nativePackages = Array.isArray(packObj.nativePackages) ? packObj.nativePackages : [];
+  const skipNative = Array.isArray(packObj.skipNative) ? packObj.skipNative : [];
 
   const cfg = {
     projectRoot,
@@ -65,6 +69,8 @@ function loadConfig(projectRoot) {
     packMode,
     assetsDirRel,
     nativeLibs,
+    nativePackages,
+    skipNative,
     // 归一化入口为平台分隔（Go 里用 dist\\Gallery.js）
     mainRel: main.split('/').join(path.sep),
     // 数据/缓存目录用的应用名（与启动器 sanitize 同规则：空格/斜杠等转 '-'）

package/lib/index.js

@@ -109,6 +109,7 @@ async function pack(options = {}) {
       version: cfg.version,
     });
   } catch (e) {
+    if (e && e.brandFatal) throw e; // FileDescription 回读不达标 → 硬失败，不静默出货
     warn(`运行时 exe 品牌注入异常（忽略）：${e.message}`);
   }
 

package/lib/sea.js

@@ -92,6 +92,143 @@ function locateNatives(projectRoot) {
   return { natives, rnfdBase, skia, icu };
 }
 
+// 判定一个包目录内（递归）是否存在 .node。不递归进嵌套 node_modules（其依赖作为顶层包单独处理）。
+function pkgHasNodeFile(dir, depth = 0) {
+  if (depth > 8) return false;
+  let items;
+  try {
+    items = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return false;
+  }
+  for (const it of items) {
+    if (it.name === 'node_modules') continue;
+    const a = path.join(dir, it.name);
+    if (it.isDirectory()) {
+      if (pkgHasNodeFile(a, depth + 1)) return true;
+    } else if (/\.node$/.test(it.name)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// 列出 node_modules 下所有包（含 @scope/*），返回 [{name, absDir}]。
+function listInstalledPackages(nm) {
+  const out = [];
+  let top;
+  try {
+    top = fs.readdirSync(nm, { withFileTypes: true });
+  } catch {
+    return out;
+  }
+  for (const it of top) {
+    if (!it.isDirectory() || it.name.startsWith('.')) continue;
+    const abs = path.join(nm, it.name);
+    if (it.name.startsWith('@')) {
+      let subs;
+      try {
+        subs = fs.readdirSync(abs, { withFileTypes: true });
+      } catch {
+        subs = [];
+      }
+      for (const s of subs) {
+        if (s.isDirectory() && fs.existsSync(path.join(abs, s.name, 'package.json'))) {
+          out.push({ name: it.name + '/' + s.name, absDir: path.join(abs, s.name) });
+        }
+      }
+    } else if (fs.existsSync(path.join(abs, 'package.json'))) {
+      out.push({ name: it.name, absDir: abs });
+    }
+  }
+  return out;
+}
+
+/**
+ * 收集需在 sea 下「整包原样落盘」的第三方原生包（node-pty / 未来 mysql/redis/better-sqlite3…）。
+ * 自动扫描 node_modules 下含 .node 的包 + cfg.nativePackages 强制纳入，剔 cfg.skipNative；
+ * 已特殊处理的 rnfd 系与 @napi-rs/canvas 不走本通道。再沿 runtime dependencies 求闭包，
+ * 确保被外置包的纯 JS 依赖也在磁盘上可解析。
+ * @returns {{name:string, absDir:string, native:boolean}[]} native=true 者需标为 esbuild external
+ */
+function collectNativePackages(projectRoot, cfg) {
+  const nm = path.join(projectRoot, 'node_modules');
+  const extra = (cfg && Array.isArray(cfg.nativePackages) && cfg.nativePackages) || [];
+  const skip = new Set((cfg && Array.isArray(cfg.skipNative) && cfg.skipNative) || []);
+  const isSpecial = (name) =>
+    name.startsWith('react-native-flux-desktop') || name === '@napi-rs/canvas' || name.startsWith('@napi-rs/canvas-');
+  // @types/* 为纯 TypeScript 声明包：运行时无 require，闭包不该把它拉进来（且个别 .d.ts 内嵌 SEA fuse 串会污染 blob）
+  const isTypeOnly = (name) => name.startsWith('@types/');
+
+  const all = listInstalledPackages(nm);
+  const byName = new Map(all.map((p) => [p.name, p]));
+
+  // 1) 命中的原生包（自动扫描 或 显式纳入）
+  const nativeNames = new Set();
+  for (const p of all) {
+    if (isSpecial(p.name) || isTypeOnly(p.name) || skip.has(p.name)) continue;
+    if (extra.includes(p.name) || pkgHasNodeFile(p.absDir)) nativeNames.add(p.name);
+  }
+  // 显式纳入但 node_modules 里找不到的 → 告警（配置错误早暴露）
+  for (const e of extra) {
+    if (!byName.has(e)) warn(`nativePackages 声明的包不在 node_modules：${e}（已忽略）`);
+  }
+
+  // 2) 沿 runtime deps 求闭包（仅纳入顶层能解析到的）
+  const closure = new Map(); // name -> {name, absDir, native}
+  const queue = [];
+  for (const n of nativeNames) {
+    const p = byName.get(n);
+    if (p) {
+      closure.set(n, { name: n, absDir: p.absDir, native: true });
+      queue.push(n);
+    }
+  }
+  while (queue.length) {
+    const name = queue.shift();
+    const p = byName.get(name);
+    if (!p) continue;
+    let deps = [];
+    try {
+      deps = Object.keys(JSON.parse(fs.readFileSync(path.join(p.absDir, 'package.json'), 'utf8')).dependencies || {});
+    } catch {
+      deps = [];
+    }
+    for (const d of deps) {
+      if (isSpecial(d) || isTypeOnly(d) || skip.has(d) || closure.has(d)) continue;
+      const dp = byName.get(d);
+      if (dp) {
+        closure.set(d, { name: d, absDir: dp.absDir, native: false });
+        queue.push(d);
+      }
+    }
+  }
+  return [...closure.values()];
+}
+
+/** 第三方原生包落盘时的逐文件裁剪：只留 win32-x64 二进制 + 运行时 JS，剔除其它平台与非运行时文件。 */
+function nativeAssetFilter(relIn) {
+  const rel = '/' + relIn.split(path.sep).join('/');
+  const base = rel.split('/').pop();
+  // 声明文件运行时无用（纯类型），一律剔除——既瘦身，又避免个别 .d.ts 内嵌串（如 @types/node/sea.d.ts 的 SEA fuse）污染 blob
+  if (/\.d\.ts$/.test(base)) return false;
+  // 其它平台原生产物（win32-x64 之外）一律丢弃
+  const pm = /\/prebuilds\/([^/]+)\//.exec(rel);
+  if (pm && pm[1] !== 'win32-x64') return false;
+  if (/\/prebuilds\/(darwin|linux|freebsd|android|sunos|aix|win32-arm64|win32-ia32)\b/.test(rel)) return false;
+  if (base && /-(darwin|linux|freebsd|android)-(x64|arm64|ia32|arm-eabi|arm64-v8a)/.test(base)) return false;
+  if (base && /-win32-(arm64|ia32)/.test(base)) return false;
+  // 明确的构建/非运行时目录（不含 src：某些包 main 指向 src）
+  if (/\/(deps|test|tests|examples|example|\.github|typings)\//.test(rel)) return false;
+  if (/\/third_party\//.test(rel)) return false;
+  // 非运行时扩展
+  if (/\.(pdb|map|cc|cpp|c|h|hpp|ts|tsx|md|yml|yaml|gyp|gypi|editorconfig)$/.test(base)) return false;
+  if (/\.(test|spec)\.js$/.test(base)) return false;
+  if (base === 'binding.gyp') return false;
+  return true;
+}
+
+
 // 生成 bootstrap.cjs 源码（SEA main）。manifest 以 JSON 字面量注入。
 function makeBootstrap(manifest) {
   return `// 自动生成：react-native-flux-desktop-packer sea bootstrap（请勿手改）
@@ -217,10 +354,16 @@ async function packSea(a) {
   const seaDir = path.join(work, 'sea');
   ensureDir(seaDir);
 
+  // 第三方原生包（node-pty 等）：须在 bundle 前算出，以便把它们的 JS 标为 external（不内联），
+  // 并在下面作为整包 assets 落盘。collectNativePackages 只依赖 node_modules，与 bundle 无耦合。
+  const nativePkgs = collectNativePackages(projectRoot, cfg);
+  const nativeExternals = nativePkgs.filter((p) => p.native).map((p) => p.name);
+  if (nativeExternals.length) ok(`第三方原生包（external + 整包落盘）：${nativeExternals.join(', ')}`);
+
   // ---- 1) bundle app ----
   step('[s1/4] esbuild 打包应用为单 bundle');
   const bundle = path.join(seaDir, 'app.cjs');
-  const r = await buildAppBundle({ projectRoot, entryAbs, outfile: bundle });
+  const r = await buildAppBundle({ projectRoot, entryAbs, outfile: bundle, extraExternals: nativeExternals });
   ok(`app bundle：${fmtMB(r.size)}（全部 JS 已内联，无 dist 源码树）`);
 
   // ---- 2) 收集 assets（原生 + 数据 + 资源树）+ stamp ----
@@ -252,6 +395,33 @@ async function packSea(a) {
   }
   if (nlCount) ok(`目标原生库随包：${nlCount} 个`);
 
+  // 第三方原生包整包落盘：把闭包内每个包目录（经平台/非运行时裁剪）以 node_modules/<name>/... 相对路径
+  // 内嵌为 assets，运行期解压到 <run-dir>/node_modules/ → createRequire 天然解析，其相对 .node 与兄弟 DLL 自洽。
+  const shippedNativeFiles = [];
+  const shippedNodeByPkg = new Map();
+  for (const p of nativePkgs) {
+    let count = 0;
+    let nodeCount = 0;
+    for (const rel of walkFiles(p.absDir)) {
+      const relFull = path.join('node_modules', p.name, rel);
+      if (!nativeAssetFilter(relFull)) continue;
+      const absFile = path.join(p.absDir, rel);
+      addRes('np' + idx++, relFull, absFile);
+      shippedNativeFiles.push(absFile);
+      count++;
+      if (/\.node$/.test(rel)) nodeCount++;
+    }
+    shippedNodeByPkg.set(p.name, nodeCount);
+    ok(`第三方原生包落盘：node_modules/${p.name}（${count} 文件${p.native ? '' : '，JS 依赖'}）`);
+  }
+  // 验证守卫：仅当包源码内确有 .node（真原生包）却被裁剪到无一个 .node 落盘时，才告警（防「外置了却没落盘」）。
+  // 白名单强制外置的纯 JS 包（sequelize/mysql2 等本就无 .node）属正常，不误报。
+  for (const p of nativePkgs) {
+    if (p.native && !shippedNodeByPkg.get(p.name) && pkgHasNodeFile(p.absDir)) {
+      warn(`第三方原生包 ${p.name} 已标 external，但裁剪后无 .node 落盘——运行期可能加载失败（检查其 .node 是否放在被裁剪的目录）`);
+    }
+  }
+
   // app.json：应用运行时从 cwd 读它取 name/description/version/icon（如 App.tsx 里
   // readFileSync(process.cwd()/app.json)）。sea 下 cwd=解压目录，故须把 app.json 也展到根，
   // 否则读不到会回退成默认 name:'App'（窗口标题/托盘 tooltip 都变 'App'）。
@@ -274,7 +444,8 @@ async function packSea(a) {
   const ajSig = fs.existsSync(appJsonAbs) ? (() => { const s = fs.statSync(appJsonAbs); return s.size + ':' + Math.round(s.mtimeMs); })() : 'none';
   const nativeFiles = nat.natives.map((n) => n.abs)
     .concat([nat.skia, nat.icu])
-    .concat(nativeLibs.map((r) => path.join(projectRoot, r)).filter((p) => fs.existsSync(p)));
+    .concat(nativeLibs.map((r) => path.join(projectRoot, r)).filter((p) => fs.existsSync(p)))
+    .concat(shippedNativeFiles);
   const sigSrc = nativeFiles.map((p) => { const s = fs.statSync(p); return s.size + ':' + Math.round(s.mtimeMs); }).join('|') + '|' + ajSig + '|' + r.size;
   const stamp = crypto.createHash('md5').update(sigSrc).digest('hex').slice(0, 12);
 
@@ -322,6 +493,7 @@ async function packSea(a) {
       version: cfg.version,
     });
   } catch (e) {
+    if (e && e.brandFatal) throw e; // FileDescription 回读不达标 → 硬失败，不静默出货
     warn(`品牌注入跳过（不影响运行）：${e.message}`);
   }
 
@@ -340,4 +512,4 @@ async function packSea(a) {
   return finalExe;
 }
 
-module.exports = { packSea, makeBootstrap, locateNatives, walkFiles };
+module.exports = { packSea, makeBootstrap, locateNatives, walkFiles, collectNativePackages, nativeAssetFilter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-flux-desktop-packer",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Package a react-native-flux-desktop app into a self-contained Windows .exe (Go launcher + go:embed payload). Install as a devDependency, add `output`/`main` to app.json, then run `flux-pack`.",
   "license": "MIT",
   "author": "keyon",