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

package/lib/bundle.js

@@ -21,6 +21,8 @@ const EXTERNALS = [
   'react-native-flux-desktop-linux-*',
   'react-native-flux-desktop-android-*',
   'react-native-flux-desktop-freebsd-*',
+  // 各原生扩展分支包的裸平台包名（ffi / webview / 未来新增）：保持 external，运行期由 bootstrap 钩子重定向到自解压目录
+  'react-native-flux-desktop-*-win32-x64-msvc',
   // @napi-rs/canvas 的平台预编译包（skia .node 由 bootstrap 经 env 指向解压副本）
   '@napi-rs/canvas-win32-x64-msvc',
   '@napi-rs/canvas-win32-x64-gnu',

package/lib/config.js

@@ -47,6 +47,12 @@ function loadConfig(projectRoot) {
   const packMode = packObj.mode === 'sea' ? 'sea' : 'folder';
   // 资源目录（相对项目根），sea 模式内嵌进 exe、运行时解压到 cwd；folder 模式整目录拷贝
   const assetsDirRel = typeof packObj.assets === 'string' ? packObj.assets : 'assets';
+  // 目标原生库（相对项目根路径数组）：随包拷进运行目录，运行期 ffi.open(相对路径) 按 cwd 命中。
+  const nativeLibs = Array.isArray(packObj.nativeLibs)
+    ? packObj.nativeLibs
+    : Array.isArray(app.nativeLibs)
+    ? app.nativeLibs
+    : [];
 
   const cfg = {
     projectRoot,
@@ -58,6 +64,7 @@ function loadConfig(projectRoot) {
     outputRel: output,
     packMode,
     assetsDirRel,
+    nativeLibs,
     // 归一化入口为平台分隔（Go 里用 dist\\Gallery.js）
     mainRel: main.split('/').join(path.sep),
     // 数据/缓存目录用的应用名（与启动器 sanitize 同规则：空格/斜杠等转 '-'）

package/lib/index.js

@@ -79,6 +79,17 @@ async function pack(options = {}) {
       fs.copyFileSync(src, path.join(stage, item));
     }
   }
+  // 目标原生库（ffi）：按相对路径拷进负载根，运行期 ffi.open(相对) 按 cwd 命中。
+  for (const rel of (cfg.nativeLibs || [])) {
+    const src = path.join(projectRoot, rel);
+    if (!fs.existsSync(src)) {
+      warn(`nativeLibs 跳过（不存在）：${rel}`);
+      continue;
+    }
+    const dst = path.join(stage, rel);
+    ensureDir(path.dirname(dst));
+    fs.copyFileSync(src, dst);
+  }
   // 捆绑当前 node.exe，但以应用名落盘（napi ABI 稳定，跨大版本可加载）。
   // 运行时进程改名 → 任务管理器「详细信息」页的名称列不再显示 node.exe（node 不校验自身文件名，改名照常运行）。
   const runtimeName = exeBase + '.exe';

package/lib/sea.js

@@ -61,27 +61,35 @@ function walkFiles(base, rel = '') {
 
 /**
  * 收集需内嵌为 SEA assets 的原生/数据文件。
- * @returns {{rnfd:string,skia:string,icu:string}} 绝对路径
+ * 通用发现：node_modules 下所有 react-native-flux-desktop* 包根的 *.win32-x64-msvc.node
+ * ——覆盖主包 + 各原生扩展分支包（ffi / webview / 未来新增），不再逐包硬编码。
+ * @returns {{natives:{base:string,abs:string}[],rnfdBase:string,skia:string,icu:string}}
  */
 function locateNatives(projectRoot) {
-  const roots = [path.join(projectRoot, 'node_modules')];
-  const pick = (rel) => {
-    for (const r of roots) {
-      const f = findFirst(r, rel);
-      if (f) return f;
+  const nm = path.join(projectRoot, 'node_modules');
+  // @napi-rs/canvas 平台包：命名特殊（skia.node + icudtl.dat 同目录），单独处理
+  const canvasPkg = path.join(nm, '@napi-rs', 'canvas-win32-x64-msvc');
+  const skia = findFirst(canvasPkg, ['skia.win32-x64-msvc.node']);
+  const icu = findFirst(canvasPkg, ['icudtl.dat']);
+  // 通用扫 flux 系原生 .node（主包与所有扩展分支包一视同仁）
+  const natives = [];
+  let dirs = [];
+  try { dirs = fs.readdirSync(nm); } catch { dirs = []; }
+  for (const d of dirs) {
+    if (!d.startsWith('react-native-flux-desktop')) continue;
+    let files = [];
+    try { files = fs.readdirSync(path.join(nm, d)); } catch { continue; }
+    for (const f of files) {
+      if (/\.win32-x64-msvc\.node$/.test(f)) natives.push({ base: f, abs: path.join(nm, d, f) });
     }
-    // 兜底：全局扫 node_modules（同名 .node 可能嵌在 pkg 副本里）
-    return null;
-  };
-  const rnfd = pick(['react-native-flux-desktop', 'react-native-flux-desktop.win32-x64-msvc.node']);
-  const skia = pick(['@napi-rs', 'canvas-win32-x64-msvc', 'skia.win32-x64-msvc.node']);
-  const icu = pick(['@napi-rs', 'canvas-win32-x64-msvc', 'icudtl.dat']);
+  }
+  const rnfdBase = 'react-native-flux-desktop.win32-x64-msvc.node';
   const miss = [];
-  if (!rnfd) miss.push('react-native-flux-desktop.win32-x64-msvc.node');
+  if (!natives.some((n) => n.base === rnfdBase)) miss.push(rnfdBase);
   if (!skia) miss.push('skia.win32-x64-msvc.node');
   if (!icu) miss.push('icudtl.dat');
   if (miss.length) throw new Error(`未找到原生依赖：${miss.join(', ')}\n（sea 模式需在项目 node_modules 里存在这些 .node/dat）`);
-  return { rnfd, skia, icu };
+  return { natives, rnfdBase, skia, icu };
 }
 
 // 生成 bootstrap.cjs 源码（SEA main）。manifest 以 JSON 字面量注入。
@@ -121,14 +129,21 @@ if (!fs.existsSync(appMarker) || fs.readFileSync(appMarker).toString() !== sig)
 // 3) @napi-rs/canvas：绝对路径直指解压后的 skia（最高优先级）
 process.env.NAPI_RS_NATIVE_LIBRARY_PATH = path.join(dir, MANIFEST.skiaRel);
 
-// 4) 自研原生：bare/相对 .node 重定向到 dir（全局钩子，对 createRequire 加载的模块同样生效）
-const RNFD = 'react-native-flux-desktop.win32-x64-msvc.node';
-const RNFD_ABS = path.join(dir, RNFD);
+// 4) 自研原生（主包 + 各扩展分支包 ffi/webview/…）：相对 .node 与 bare 平台包名一律重定向到 dir。
+//    通用规则，新增扩展包无需改此处——只要它的 .node 被 locateNatives 收集进 MANIFEST.natives。
+const NATIVE_LIST = MANIFEST.natives || [];
+const NATIVE_SET = new Set(NATIVE_LIST);
 const origResolve = Module._resolveFilename;
 Module._resolveFilename = function (request) {
   if (typeof request === 'string') {
-    if (request === 'react-native-flux-desktop-win32-x64-msvc') return RNFD_ABS;
-    if (request.indexOf(RNFD) >= 0) return RNFD_ABS;
+    for (let i = 0; i < NATIVE_LIST.length; i++) {
+      if (request.indexOf(NATIVE_LIST[i]) >= 0) return path.join(dir, NATIVE_LIST[i]);
+    }
+    const m = /^(react-native-flux-desktop(?:-[a-z0-9]+)*?)-win32-x64-msvc$/.exec(request);
+    if (m) {
+      const file = m[1] + '.win32-x64-msvc.node';
+      if (NATIVE_SET.has(file)) return path.join(dir, file);
+    }
   }
   return origResolve.apply(this, arguments);
 };
@@ -139,7 +154,18 @@ if (MANIFEST.appDirEnv) process.env.FLUX_APP_DIR = MANIFEST.appDirEnv;
 try { process.chdir(dir); } catch (e) {}
 
 // 6) 用 createRequire 正常加载 app（普通 require，绕开 embedderRequire）
-Module.createRequire(path.join(dir, 'boot.js'))(appPath);
+//    GUI 子系统无控制台：启动期任何抛错（如可选原生 .node 加载失败）都会静默闪退，
+//    故兜底把堆栈写到 LOCALAPPDATA 下 APPDIR 的 startup-error.log，便于诊断“双击打不开”。
+try {
+  Module.createRequire(path.join(dir, 'boot.js'))(appPath);
+} catch (err) {
+  try {
+    const errLog = path.join(process.env.LOCALAPPDATA || os.tmpdir(), APPDIR, 'startup-error.log');
+    fs.mkdirSync(path.dirname(errLog), { recursive: true });
+    fs.writeFileSync(errLog, '[' + new Date().toISOString() + '] stamp=' + MANIFEST.stamp + '\\n' + ((err && err.stack) || err) + '\\n', 'utf8');
+  } catch (e2) {}
+  throw err;
+}
 `;
 }
 
@@ -207,9 +233,24 @@ async function packSea(a) {
     resources.push({ key, rel });
     assetsMap[key] = abs;
   };
-  addRes('rnfd', 'react-native-flux-desktop.win32-x64-msvc.node', nat.rnfd);
+  // 通用内嵌所有 flux 原生 .node（主包 + ffi + webview + 未来扩展），按文件名落盘到 dir 根
+  for (const n of nat.natives) addRes('nat' + idx++, n.base, n.abs);
+  ok(`flux 原生绑定：${nat.natives.map((n) => n.base).join(', ')}`);
   addRes('skia', 'skia.win32-x64-msvc.node', nat.skia);
   addRes('icu', 'icudtl.dat', nat.icu);
+  // 目标原生库（app.json.pack.nativeLibs / app.nativeLibs）：按相对路径内嵌，运行期 ffi.open(相对) 命中 cwd。
+  const nativeLibs = Array.isArray(cfg.nativeLibs) ? cfg.nativeLibs : [];
+  let nlCount = 0;
+  for (const rel of nativeLibs) {
+    const abs = path.join(projectRoot, rel);
+    if (!fs.existsSync(abs)) {
+      warn(`nativeLibs 跳过（不存在）：${rel}`);
+      continue;
+    }
+    addRes('nl' + idx++, rel.split('/').join(path.sep), abs);
+    nlCount++;
+  }
+  if (nlCount) ok(`目标原生库随包：${nlCount} 个`);
 
   // app.json：应用运行时从 cwd 读它取 name/description/version/icon（如 App.tsx 里
   // readFileSync(process.cwd()/app.json)）。sea 下 cwd=解压目录，故须把 app.json 也展到根，
@@ -231,7 +272,10 @@ async function packSea(a) {
 
   // stamp：内容变化才重解压（含 app.json，改名字/描述也能刷新）
   const ajSig = fs.existsSync(appJsonAbs) ? (() => { const s = fs.statSync(appJsonAbs); return s.size + ':' + Math.round(s.mtimeMs); })() : 'none';
-  const sigSrc = [nat.rnfd, nat.skia, nat.icu].map((p) => { const s = fs.statSync(p); return s.size + ':' + Math.round(s.mtimeMs); }).join('|') + '|' + ajSig + '|' + r.size;
+  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)));
+  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);
 
   const appDirEnv = cfg.safeAppName || 'Flux';
@@ -241,6 +285,7 @@ async function packSea(a) {
     appDirEnv,
     appKey: 'app',
     skiaRel: 'skia.win32-x64-msvc.node',
+    natives: nat.natives.map((n) => n.base),
     resources,
   };
   const bootstrapPath = path.join(seaDir, 'bootstrap.cjs');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-flux-desktop-packer",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "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",