@flun/node-mobile-app 2.0.7 → 2.1.0

package/CHANGELOG.md

@@ -1,4 +1,38 @@
 # 变更日志
+
+## [2.1.0] - 2026-09-29 10:39
+
+### 变更
+
+- **ESLint 插件换代**：`@babel/eslint-parser`、`eslint-plugin-react`、`eslint-plugin-react-native` 三个包的最新版均不支持 ESLint 10（分别止步于 9.0.0 / 9.7 / 9），导致安装 `eslint@10` 时被额外拉入一份 `eslint@9.39.5`（npm 的 peer 兼容回退），并触发 npm 的 deprecated 警告。现替换为：
+
+  | 原                                                   | 新                                                  |
+  | ---------------------------------------------------- | --------------------------------------------------- |
+  | `@babel/eslint-parser`                               | `@typescript-eslint/parser`（已支持 ESLint 10）     |
+  | `eslint-plugin-react` + `eslint-plugin-react-native` | `@eslint-react/eslint-plugin`（原生支持 ESLint 10） |
+
+  生成的 `eslint.config.js` 随之更新。`eslint-plugin-react-hooks` 保留（其 7.1.x 已支持 ESLint 10）。
+
+  > **注意**：lint 规则集与原先不同，升级后对同一份代码可能报出不同的检查结果。这只影响静态检查，不影响构建产物与运行。
+
+### 修复
+
+- **`DEP0190` 弃用警告**：`src/utils.js` 中的 `run` / `runQuiet` / `runSilent` 原先统一用 `spawnSync(bin, args, { shell: true })`。Node 20+ 对「参数数组 + shell」这种组合会提示参数未转义（`DEP0190`），每次执行 CLI 都会在输出末尾出现该警告。现改为：
+  - Windows：把命令与参数拼成单个字符串（参数按需加引号）后交给 shell——`.cmd` / `.bat` 仍能执行，且不再触发警告；
+  - 其它平台：不使用 shell，参数交由 Node 转义。
+## [2.0.8] - 2026-09-28 22:17
+### 修复
+
+- **中文路径构建失败**：三处联动修复。
+  - **AGP 拒绝非 ASCII 路径**：`template/android/gradle.properties` 增加 `android.overridePathCheck=true`，允许中文路径构建。
+  - **`gradle.properties` 中文乱码**：该文件按 ISO-8859-1 读取，非 ASCII 字符（如路径中的「桌面」）会被读成乱码，导致 keystore 找不到。`patcher.js` 现在把写入的非 ASCII 字符转成 `\uXXXX` 转义（Java Properties 规范）。
+  - 影响范围：项目路径含中文（或其它非 ASCII 字符）时，release 构建曾失败于 `Your project path contains non-ASCII characters` 与 `Keystore file ... not found`。
+- **签名配置缺项时报错含糊**：`android.signing.keystore` 已配置、但密码 / 别名 / 别名密码为空时，原先会一路跑到 Gradle 才报 `keystore password was incorrect`，容易误导排查方向。现在 `patcher.js` 在构建前即校验四项，缺项时抛出明确错误，并提示「仅本地测试可注释掉整个 signing 块」。
+
+### 变更
+
+- **`mobileAppConfig.js` 模板**：`signing` 块内每项标注「必填」，并说明「取消整块注释即视为启用签名」。
+
 ## [2.0.7] - 2026-09-28 16:05
 ### 更新
 - 更新有小问题依赖-> `@flun/nodejs-mobile-react-native` ;
@@ -28,6 +62,7 @@
 - 更新 `@flun/nodejs-mobile-react-native` 依赖;
 
 ---
+
 ## [2.0.2] - 2026-09-23 20:25
 
 ### 修复

package/README.md

@@ -243,10 +243,51 @@ adb install -r ./out/<appName>-<versionName>-debug.apk
 | `icon`                  | `string`         | `'./build/icon.png'` | 应用图标（建议 512×512 PNG）                                           |
 | `usesCleartextTraffic`  | `boolean`        | `true`               | 是否允许明文 HTTP                                                      |
 | `permissions`           | `string[]`       | `[]`                 | 额外权限（如 `'android.permission.CAMERA'`）                           |
-| `signing.keystore`      | `string`         | —                    | 签名 keystore 路径（相对你的项目根）;不填则用模板自带的 debug keystore |
+| `signing`               | `object`         | —                    | 自定义签名配置。**不填则用模板自带的 debug keystore 签名**（可安装测试，不可上架）；填则以下 4 项均为必填 |
+| `signing.keystore`      | `string`         | —                    | keystore 路径（相对你的项目根）                                        |
 | `signing.storePassword` | `string`         | —                    | keystore 密码                                                          |
-| `signing.keyAlias`      | `string`         | —                    | key 别名                                                               |
-| `signing.keyPassword`   | `string`         | —                    | key 密码                                                               |
+| `signing.keyAlias`      | `string`         | —                    | 密钥别名                                                               |
+| `signing.keyPassword`   | `string`         | —                    | 密钥密码（通常与 `storePassword` 相同）                                |
+
+#### 生成自签名 keystore
+
+如需自定义签名（上架或长期使用），先生成 keystore 文件。`keytool` 随 JDK 提供：
+
+- 若已设 `JAVA_HOME`：`& "$env:JAVA_HOME\bin\keytool.exe"`
+- 否则用 JDK 安装目录下的完整路径，例如 `C:\Program Files\Java\jdk-17.0.20\bin\keytool.exe`
+
+```powershell
+# Windows PowerShell
+& "<JDK 安装目录>\bin\keytool.exe" -genkeypair -v `
+  -keystore "<你的项目根>\build\release.keystore" `
+  -alias testkey `
+  -keyalg RSA -keysize 2048 -validity 10000 `
+  -storepass <keystore 密码> -keypass <密钥密码> `
+  -dname "CN=Test, OU=Dev, O=Test, L=City, S=State, C=CN"
+```
+
+```bash
+# macOS / Linux
+keytool -genkeypair -v \
+  -keystore "<你的项目根>/build/release.keystore" \
+  -alias testkey \
+  -keyalg RSA -keysize 2048 -validity 10000 \
+  -storepass <keystore 密码> -keypass <密钥密码> \
+  -dname "CN=Test, OU=Dev, O=Test, L=City, S=State, C=CN"
+```
+
+生成后，把路径、密码、别名填入 `mobileAppConfig.js` 的 `android.signing`：
+
+```js
+signing: {
+  keystore: './build/release.keystore',  // 相对你的项目根
+  storePassword: '<keystore 密码>',
+  keyAlias: 'testkey',
+  keyPassword: '<密钥密码>',
+},
+```
+
+> **提示**：`storepass` / `keypass` 可填相同值，对应配置里 `storePassword` / `keyPassword` 也填相同值。四项缺一不可，缺项时构建前会报错。
 
 ### iOS
 

package/mobileAppConfig.js

@@ -81,12 +81,12 @@ export default {
     //   keyAlias:       'androiddebugkey'
     //   keyPassword:    'android'
     //
-    // 自定义签名：取消下面注释，填入你的 keystore 信息
+    // 取消下方整块注释即视为「启用签名」，此时 4 项均为必填（缺项会在构建前报错）
     signing: {
-      // keystore: './build/release.keystore',
-      // storePassword: '',
-      // keyAlias: '',
-      // keyPassword: '',
+      // keystore:      './build/release.keystore', // 必填：keystore 路径（相对用户项目根）
+      // storePassword: '',                         // 必填：keystore 密码
+      // keyAlias:      '',                         // 必填：密钥别名
+      // keyPassword:   '',                         // 必填：密钥密码（与 storePassword 相同可填同值）
     },
   },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flun/node-mobile-app",
-  "version": "2.0.7",
+  "version": "2.1.0",
   "description": "将 Node.js 项目一键打包为 Android / iOS 移动应用,运行时由 @flun/nodejs-mobile-react-native 提供,无需修改你的 Node 代码;",
   "author": "flun <open@flun.top>",
   "keywords": [
@@ -54,15 +54,13 @@
     "prettier": "^3.9.8",
     "eslint": "^10.11.0",
     "@eslint/js": "^10.0.1",
-    "@babel/eslint-parser": "^7.29.9",
-    "@typescript-eslint/eslint-plugin": "^8.70.1",
-    "@typescript-eslint/parser": "^8.70.1",
+    "@typescript-eslint/eslint-plugin": "^8.71.0",
+    "@typescript-eslint/parser": "^8.71.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-eslint-comments": "^3.2.0",
-    "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
-    "eslint-plugin-react-native": "^5.0.0",
-    "@flun/nodejs-mobile-react-native": "^2.0.5"
+    "@eslint-react/eslint-plugin": "^5.21.3",
+    "@flun/nodejs-mobile-react-native": "^2.0.6"
   },
   "allowScripts": {
     "node": true,

package/src/patcher.js

@@ -2,6 +2,11 @@ import path from 'path';
 import fs from 'fs';
 import { writeIfChanged } from './utils.js';
 
+// 把字符串中所有非 ASCII 字符转成 \uXXXX（Java Properties 规范）
+// gradle.properties 按 ISO-8859-1 读取，无法改为 UTF-8
+const escapeProps = (s) =>
+  String(s).replace(/[^\x00-\x7F]/g, (ch) => '\\u' + ch.charCodeAt(0).toString(16).padStart(4, '0'));
+
 /**
  * 解析最终 appName：
  *   1. config.appName
@@ -160,6 +165,16 @@ const resolveAppName = (userProjectDir, config) => {
     const signing = config.android && config.android.signing;
     if (!signing || !signing.keystore) return; // 未配置签名 → 保持默认
 
+    // 启用签名后 4 项均为必填；缺项时提前报错，避免 Gradle 报"password incorrect"误导排查
+    const _missing = ['storePassword', 'keyAlias', 'keyPassword'].filter((k) => !signing[k]);
+    if (_missing.length > 0) {
+      throw new Error(
+        'android.signing.keystore 已配置，但以下字段为空：' + _missing.join(', ') + '\n' +
+        '  启用签名后，keystore / storePassword / keyAlias / keyPassword 四项均为必填。\n' +
+        '  如仅需本地测试（不签名上架），可注释掉整个 signing 块——模板默认用 debug keystore 签名。'
+      );
+    }
+
     const keystoreAbs = path.resolve(userProjectDir, signing.keystore);
     if (!fs.existsSync(keystoreAbs)) return console.warn('  ⚠️  签名 keystore 不存在，跳过签名配置:', keystoreAbs);
 
@@ -173,11 +188,13 @@ const resolveAppName = (userProjectDir, config) => {
       c = c.replace(/^\s*MYAPP_RELEASE_KEY_ALIAS=.*\r?\n/gm, '');
       c = c.replace(/^\s*MYAPP_RELEASE_KEY_PASSWORD=.*\r?\n/gm, '');
       // 追加新的
-      const esc = keystoreAbs.replace(/\\/g, '/');
+      // gradle.properties 按 ISO-8859-1 读取，非 ASCII 字符必须转 \uXXXX 转义，
+      // 否则中文路径（如「桌面」）会被读成乱码，导致 keystore 找不到。
+      const esc = escapeProps(keystoreAbs.replace(/\\/g, '/'));
       c += `\nMYAPP_RELEASE_STORE_FILE=${esc}\n`;
-      c += `MYAPP_RELEASE_STORE_PASSWORD=${signing.storePassword || ''}\n`;
-      c += `MYAPP_RELEASE_KEY_ALIAS=${signing.keyAlias || ''}\n`;
-      c += `MYAPP_RELEASE_KEY_PASSWORD=${signing.keyPassword || ''}\n`;
+      c += `MYAPP_RELEASE_STORE_PASSWORD=${escapeProps(signing.storePassword || '')}\n`;
+      c += `MYAPP_RELEASE_KEY_ALIAS=${escapeProps(signing.keyAlias || '')}\n`;
+      c += `MYAPP_RELEASE_KEY_PASSWORD=${escapeProps(signing.keyPassword || '')}\n`;
       writeIfChanged(propsFile, c);
     }
 

package/src/utils.js

@@ -61,14 +61,33 @@ const ensureDir = dir => {
     fs.copyFileSync(src, dst);
     return true;
   },
+  // 把单个参数转成适合 Windows cmd.exe 的形式：含空白或 shell 元字符时加双引号。
+  quoteShellArg = (s) => {
+    const str = String(s);
+    if (str === '') return '""';
+    return /[\s"&|<>^()]/.test(str) ? '"' + str.replace(/"/g, '""') + '"' : str;
+  },
+  /**
+   * 统一的子进程启动：
+   * - Windows：.cmd / .bat 需经 shell；把命令与参数拼成单字符串，
+   *   避免 spawnSync(bin, args, { shell: true }) 触发 DEP0190。
+   * - 其它平台：不用 shell，参数交由 Node 转义。
+   */
+  spawnCmd = (bin, args, baseOpts = {}) => {
+    if (process.platform === 'win32') {
+      const cmd = [bin, ...args].map(quoteShellArg).join(' ');
+      return spawnSync(cmd, { ...baseOpts, shell: true });
+    }
+    return spawnSync(bin, args, { ...baseOpts, shell: false });
+  },
   run = (bin, args, opts = {}) => {
-    const r = spawnSync(bin, args, { stdio: 'inherit', shell: true, ...opts });
+    const r = spawnCmd(bin, args, { stdio: 'inherit', ...opts });
     if (r.status !== 0) throw new Error(`${bin} ${args.join(' ')} 退出码 ${r.status}`);
     return r;
   },
-  runQuiet = (bin, args, opts = {}) => spawnSync(bin, args, { encoding: 'utf-8', shell: true, ...opts }),
+  runQuiet = (bin, args, opts = {}) => spawnCmd(bin, args, { encoding: 'utf-8', ...opts }),
   runSilent = (bin, args, opts = {}) => {
-    const r = spawnSync(bin, args, { encoding: 'utf-8', shell: true, ...opts });
+    const r = spawnCmd(bin, args, { encoding: 'utf-8', ...opts });
     if (r.status !== 0) {
       if (r.stdout) process.stderr.write(r.stdout);
       if (r.stderr) process.stderr.write(r.stderr);
@@ -128,12 +147,10 @@ const ensureDir = dir => {
    * 生成 ESLint flat config 源码（替代 @react-native/eslint-config/flat）
    */
   buildEslintConfigSource = () => `import js from '@eslint/js';
-    import babelParser from '@babel/eslint-parser';
     import tsParser from '@typescript-eslint/parser';
     import tsPlugin from '@typescript-eslint/eslint-plugin';
-    import reactPlugin from 'eslint-plugin-react';
+    import reactPlugin from '@eslint-react/eslint-plugin';
     import reactHooks from 'eslint-plugin-react-hooks';
-    import reactNative from 'eslint-plugin-react-native';
     import prettier from 'eslint-config-prettier';
 
     export default [
@@ -141,19 +158,17 @@ const ensureDir = dir => {
       {
         files: ['**/*.{js,jsx,ts,tsx}'],
         languageOptions: {
-          parser: babelParser,
-          parserOptions: { requireConfigFile: false, babelOptions: { presets: ['module:@react-native/babel-preset'] } },
+          parser: tsParser,
+          parserOptions: { ecmaFeatures: { jsx: true }, sourceType: 'module' },
         },
-        plugins: { react: reactPlugin, 'react-hooks': reactHooks, 'react-native': reactNative },
-        settings: { react: { version: 'detect' } },
+        plugins: { ...reactPlugin.configs.recommended.plugins, 'react-hooks': reactHooks },
+        settings: { ...reactPlugin.configs.recommended.settings },
         rules: {
           ...reactPlugin.configs.recommended.rules,
           ...reactHooks.configs.recommended.rules,
-          'react/react-in-jsx-scope': 'off',
-          'react/prop-types': 'off',
         },
       },
-      { files: ['**/*.{ts,tsx}'], languageOptions: { parser: tsParser }, plugins: { '@typescript-eslint': tsPlugin },
+      { files: ['**/*.{ts,tsx}'], plugins: { '@typescript-eslint': tsPlugin },
        rules: tsPlugin.configs.recommended.rules }, prettier];`;
 
 export {

package/template/android/gradle.properties

@@ -46,4 +46,6 @@ edgeToEdgeEnabled=true
 # Opt out of built-in kotlin and new DSL behavior that ships with AGP 9.
 # Starting from AGP 10.x these opt outs will be removed.
 android.builtInKotlin=false
-android.newDsl=false
+android.newDsl=false
+# 允许非 ASCII 路径（如中文路径）构建；AGP 默认拒绝
+android.overridePathCheck=true