@flun/node-mobile-app 4.1.2 → 4.2.0

package/src/fingerprint.js

@@ -1,8 +1,9 @@
+import chalk from 'chalk';
+import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
-import crypto from 'crypto';
 import { ensureDir, removeDir } from './utils.js';
-import chalk from 'chalk';
+
 
 const FINGERPRINT_FILE = '.build-fingerprint.json',
   hashUserDeps = userProjectDir => {
@@ -15,8 +16,7 @@ const FINGERPRINT_FILE = '.build-fingerprint.json',
     }
     else h.update('no-package');
     return h.digest('hex');
-  },
-  writeFp = (file, fp) => fs.writeFileSync(file, JSON.stringify(fp, null, 2), 'utf-8'),
+  }, writeFp = (file, fp) => fs.writeFileSync(file, JSON.stringify(fp, null, 2), 'utf-8'),
   clearGradleCaches = (buildDir, userProjectDir) => {
     removeDir(path.join(buildDir, 'android', 'build'));
     removeDir(path.join(buildDir, 'android', 'app', 'build'));
@@ -45,86 +45,105 @@ const FINGERPRINT_FILE = '.build-fingerprint.json',
       };
     walk(templateDir);
     return h.digest('hex');
-  },
-  computeFingerprint = (userProjectDir, config, pkgRoot) => {
-    const abiFilters = [...(config.android.abiFilters || [])].sort(), libnode = {},
-      pluginDir = path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native'),
-      libnodeBin = path.join(pluginDir, 'android', 'libnode', 'bin');
+  };
 
-    if (fs.existsSync(libnodeBin)) {
-      for (const arch of fs.readdirSync(libnodeBin)) {
-        const so = path.join(libnodeBin, arch, 'libnode.so');
-        if (fs.existsSync(so)) {
-          const stat = fs.statSync(so);
-          libnode[arch] = { size: stat.size, mtime: Math.floor(stat.mtimeMs) };
-        }
-      }
-    }
+/**
+ * 对比构建指纹,变化时清理对应缓存;指纹写入 buildDir
+ * >查看定义:@see {@link checkAndResetCache}
+ * @param {string} buildDir 构建目录
+ * @param {string} userProjectDir 用户项目目录
+ * @param {object} config 用户配置
+ * @param {string} pkgRoot CLI 包根目录
+ * @returns {void}
+ */
+const checkAndResetCache = (buildDir, userProjectDir, config, pkgRoot) => {
+  ensureDir(buildDir);
 
-    let pluginVersion = null, cliVersion = null;
-    const pluginPkg = path.join(pluginDir, 'package.json'), cliPkg = path.join(pkgRoot, 'package.json');
-    if (fs.existsSync(pluginPkg))
-        try { pluginVersion = JSON.parse(fs.readFileSync(pluginPkg, 'utf-8')).version; } catch { };
-    if (fs.existsSync(cliPkg)) try { cliVersion = JSON.parse(fs.readFileSync(cliPkg, 'utf-8')).version; } catch { };
+  const fpFile = path.join(buildDir, FINGERPRINT_FILE), newFp = computeFingerprint(userProjectDir, config, pkgRoot);
+  let oldFp = null;
+  if (fs.existsSync(fpFile)) try { oldFp = JSON.parse(fs.readFileSync(fpFile, 'utf-8')); } catch { };
+  if (!oldFp) return console.log(chalk.green('    ✓ 全新构建,无缓存可清')), writeFp(fpFile, newFp);
 
-    const depsHash = hashUserDeps(userProjectDir), a = config.android || {},
-      appInfo = {
-        appName: config.appName || null,
-        appId: config.appId || null,
-        versionCode: config.versionCode || null,
-        versionName: config.versionName || null,
-        minSdkVersion: a.minSdkVersion || null,
-        targetSdkVersion: a.targetSdkVersion || null,
-        compileSdkVersion: a.compileSdkVersion || null,
-        buildToolsVersion: a.buildToolsVersion || null,
-        usesCleartextTraffic: a.usesCleartextTraffic !== false,
-        permissions: [...(a.permissions || [])].sort(),
-      };
+  const abiChanged = JSON.stringify(oldFp.abiFilters) !== JSON.stringify(newFp.abiFilters),
+    libnodeChanged = JSON.stringify(oldFp.libnode) !== JSON.stringify(newFp.libnode),
+    pluginChanged = oldFp.pluginVersion !== newFp.pluginVersion,
+    cliChanged = oldFp.cliVersion !== newFp.cliVersion, depsChanged = oldFp.depsHash !== newFp.depsHash,
+    appInfoChanged = JSON.stringify(oldFp.appInfo) !== JSON.stringify(newFp.appInfo),
+    templateChanged = oldFp.templateHash !== newFp.templateHash,
+    structural = abiChanged || libnodeChanged || pluginChanged || cliChanged || templateChanged;
 
-    const templateHash = hashTemplate(path.join(pkgRoot, 'template'));
-    return { abiFilters, libnode, pluginVersion, cliVersion, depsHash, appInfo, templateHash };
-  },
-  checkAndResetCache = (buildDir, userProjectDir, config, pkgRoot) => {
-    ensureDir(buildDir);
+  if (structural) {
+    const reasons = [];
+    if (abiChanged) reasons.push('ABI 配置');
+    if (libnodeChanged) reasons.push('libnode.so');
+    if (pluginChanged) reasons.push('插件版本');
+    if (cliChanged) reasons.push('CLI 版本');
+    if (templateChanged) reasons.push('模板文件');
+    if (depsChanged) reasons.push('用户依赖');
+    if (appInfoChanged) reasons.push('应用信息');
+    console.log(chalk.yellow('  ⚠️  检测到变化(' + reasons.join('、') + '),清理 Gradle 缓存、CMake 缓存与依赖缓存'));
+    clearGradleCaches(buildDir, userProjectDir);
+    removeDir(path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native', 'android', '.cxx'));
+    clearDepsCaches(buildDir);
+  }
+  else if (depsChanged || appInfoChanged) {
+    const reasons = [], targets = [];
+    if (depsChanged) reasons.push('用户依赖'), targets.push('依赖缓存', 'Gradle 缓存');
+    if (appInfoChanged) reasons.push('应用信息'), targets.push('Gradle 缓存');
+    console.log(chalk.yellow('  ⚠️  检测到变化(' + reasons.join('、') + '),清理 ' + [...new Set(targets)].join('、')));
+    clearGradleCaches(buildDir, userProjectDir);
+    if (depsChanged) clearDepsCaches(buildDir);
+  }
+  else console.log(chalk.gray('    ✓ 缓存有效,跳过清理'));
 
-    const fpFile = path.join(buildDir, FINGERPRINT_FILE), newFp = computeFingerprint(userProjectDir, config, pkgRoot);
-    let oldFp = null;
-    if (fs.existsSync(fpFile)) try { oldFp = JSON.parse(fs.readFileSync(fpFile, 'utf-8')); } catch { };
-    if (!oldFp) return console.log(chalk.green('    ✓ 全新构建,无缓存可清')), writeFp(fpFile, newFp);
+  writeFp(fpFile, newFp);
+};
 
-    const abiChanged = JSON.stringify(oldFp.abiFilters) !== JSON.stringify(newFp.abiFilters),
-      libnodeChanged = JSON.stringify(oldFp.libnode) !== JSON.stringify(newFp.libnode),
-      pluginChanged = oldFp.pluginVersion !== newFp.pluginVersion,
-      cliChanged = oldFp.cliVersion !== newFp.cliVersion, depsChanged = oldFp.depsHash !== newFp.depsHash,
-      appInfoChanged = JSON.stringify(oldFp.appInfo) !== JSON.stringify(newFp.appInfo),
-      templateChanged = oldFp.templateHash !== newFp.templateHash,
-      structural = abiChanged || libnodeChanged || pluginChanged || cliChanged || templateChanged;
+/**
+ * 计算当前构建指纹,用于判断是否需要清理缓存
+ * >查看定义:@see {@link computeFingerprint}
+ * @param {string} userProjectDir 用户项目目录
+ * @param {object} config 用户配置
+ * @param {string} pkgRoot CLI 包根目录
+ * @returns {object} 含 abiFilters、libnode、pluginVersion、cliVersion、depsHash、appInfo、templateHash
+ */
+const computeFingerprint = (userProjectDir, config, pkgRoot) => {
+  const abiFilters = [...(config.android.abiFilters || [])].sort(), libnode = {},
+    pluginDir = path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native'),
+    libnodeBin = path.join(pluginDir, 'android', 'libnode', 'bin');
 
-    if (structural) {
-      const reasons = [];
-      if (abiChanged) reasons.push('ABI 配置');
-      if (libnodeChanged) reasons.push('libnode.so');
-      if (pluginChanged) reasons.push('插件版本');
-      if (cliChanged) reasons.push('CLI 版本');
-      if (templateChanged) reasons.push('模板文件');
-      if (depsChanged) reasons.push('用户依赖');
-      if (appInfoChanged) reasons.push('应用信息');
-      console.log(chalk.yellow('  ⚠️  检测到变化(' + reasons.join('、') + '),清理 Gradle 缓存、CMake 缓存与依赖缓存'));
-      clearGradleCaches(buildDir, userProjectDir);
-      removeDir(path.join(userProjectDir, 'node_modules', '@flun', 'nodejs-mobile-react-native', 'android', '.cxx'));
-      clearDepsCaches(buildDir);
-    }
-    else if (depsChanged || appInfoChanged) {
-      const reasons = [], targets = [];
-      if (depsChanged) reasons.push('用户依赖'), targets.push('依赖缓存', 'Gradle 缓存');
-      if (appInfoChanged) reasons.push('应用信息'), targets.push('Gradle 缓存');
-      console.log(chalk.yellow('  ⚠️  检测到变化(' + reasons.join('、') + '),清理 ' + [...new Set(targets)].join('、')));
-      clearGradleCaches(buildDir, userProjectDir);
-      if (depsChanged) clearDepsCaches(buildDir);
+  if (fs.existsSync(libnodeBin)) {
+    for (const arch of fs.readdirSync(libnodeBin)) {
+      const so = path.join(libnodeBin, arch, 'libnode.so');
+      if (fs.existsSync(so)) {
+        const stat = fs.statSync(so);
+        libnode[arch] = { size: stat.size, mtime: Math.floor(stat.mtimeMs) };
+      }
     }
-    else console.log(chalk.gray('    ✓ 缓存有效,跳过清理'));
+  }
 
-    writeFp(fpFile, newFp);
-  };
+  let pluginVersion = null, cliVersion = null;
+  const pluginPkg = path.join(pluginDir, 'package.json'), cliPkg = path.join(pkgRoot, 'package.json');
+  if (fs.existsSync(pluginPkg))
+    try { pluginVersion = JSON.parse(fs.readFileSync(pluginPkg, 'utf-8')).version; } catch { };
+  if (fs.existsSync(cliPkg)) try { cliVersion = JSON.parse(fs.readFileSync(cliPkg, 'utf-8')).version; } catch { };
+
+  const depsHash = hashUserDeps(userProjectDir), a = config.android || {},
+    appInfo = {
+      appName: config.appName || null,
+      appId: config.appId || null,
+      versionCode: config.versionCode || null,
+      versionName: config.versionName || null,
+      minSdkVersion: a.minSdkVersion || null,
+      targetSdkVersion: a.targetSdkVersion || null,
+      compileSdkVersion: a.compileSdkVersion || null,
+      buildToolsVersion: a.buildToolsVersion || null,
+      usesCleartextTraffic: a.usesCleartextTraffic !== false,
+      permissions: [...(a.permissions || [])].sort(),
+    };
+
+  const templateHash = hashTemplate(path.join(pkgRoot, 'template'));
+  return { abiFilters, libnode, pluginVersion, cliVersion, depsHash, appInfo, templateHash };
+};
 
-export { computeFingerprint, checkAndResetCache };
+export { checkAndResetCache, computeFingerprint };

package/src/generate.js

@@ -1,7 +1,6 @@
-import fs from 'fs';
+import chalk from 'chalk';
 import path from 'path';
 import { writeIfChanged } from './utils.js';
-import chalk from 'chalk';
 
 /**
  * 生成 main.js(桥接代码,用户不需要手写)
@@ -9,6 +8,11 @@ import chalk from 'chalk';
  * 上报机制(通过 rn-bridge channel 发消息给 App.tsx):
  *   - 'Node started on <URL>'  server.js 成功调用 listen
  *   - 'Node failed: <原因>'    加载异常或 5 秒内未捕获 listen
+ * >查看定义:@see {@link generateMainJs}
+ * @param {string} targetDir 生成目录
+ * @param {object} config 用户配置
+ * @param {string} moduleType 'module' 时注入 createRequire 头
+ * @returns {void}
  */
 const generateMainJs = (targetDir, config, moduleType) => {
   const entry = config.serverPath.startsWith('./') ? config.serverPath : './' + config.serverPath,
@@ -75,8 +79,8 @@ const generateMainJs = (targetDir, config, moduleType) => {
     })();
 
     ${config.advanced.keepAlive === false
-      ? '// keepAlive: false - 不发送心跳'
-      : "setInterval(() => rn_bridge.channel.send('heartbeat'), " + hb + ");"}
+        ? '// keepAlive: false - 不发送心跳'
+        : "setInterval(() => rn_bridge.channel.send('heartbeat'), " + hb + ");"}
 
     rn_bridge.channel.on('message', msg => rn_bridge.channel.send('Echo: ' + msg));
     })();`,
@@ -84,21 +88,29 @@ const generateMainJs = (targetDir, config, moduleType) => {
       ? `import { createRequire } from 'module';\nconst require = createRequire(import.meta.url);\n\n` : '',
     file = path.join(targetDir, 'main.js'), changed = writeIfChanged(file, header + body);
   console.log(chalk.green(changed ? '    ✓ 已生成 main.js' : '    ✓ main.js 无变化'));
-},
-  generateRuntime = (buildDir, config) => {
-    const data = {
-      showLoading: config.webview.showLoading,
-      loadingText: config.webview.loadingText,
-      webview: {
-        enableJavaScript: config.webview.enableJavaScript,
-        enableDomStorage: config.webview.enableDomStorage,
-        allowFileAccess: config.webview.allowFileAccess,
-        mixedContentMode: config.webview.mixedContentMode,
-        backgroundColor: config.webview.backgroundColor
-      },
-    }, content = `// 自动生成,请勿手改\nexport default ${JSON.stringify(data, null, 2)} as const;\n`,
-      changed = writeIfChanged(path.join(buildDir, 'mobileApp.runtime.ts'), content);
-    console.log(chalk.green(changed ? '    ✓ 已生成 mobileApp.runtime.ts' : '    ✓ mobileApp.runtime.ts 无变化'));
-  };
+};
+
+/**
+ * 生成 mobileApp.runtime.ts,写入 WebView 运行时配置
+ * >查看定义:@see {@link generateRuntime}
+ * @param {string} buildDir 构建目录
+ * @param {object} config 用户配置
+ * @returns {void}
+ */
+const generateRuntime = (buildDir, config) => {
+  const data = {
+    showLoading: config.webview.showLoading,
+    loadingText: config.webview.loadingText,
+    webview: {
+      enableJavaScript: config.webview.enableJavaScript,
+      enableDomStorage: config.webview.enableDomStorage,
+      allowFileAccess: config.webview.allowFileAccess,
+      mixedContentMode: config.webview.mixedContentMode,
+      backgroundColor: config.webview.backgroundColor
+    },
+  }, content = `// 自动生成,请勿手改\nexport default ${JSON.stringify(data, null, 2)} as const;\n`,
+    changed = writeIfChanged(path.join(buildDir, 'mobileApp.runtime.ts'), content);
+  console.log(chalk.green(changed ? '    ✓ 已生成 mobileApp.runtime.ts' : '    ✓ mobileApp.runtime.ts 无变化'));
+};
 
-export { generateMainJs, generateRuntime }
+export { generateMainJs, generateRuntime };