expo-harmony-toolkit 1.8.1 → 1.8.3

package/docs/signing-and-release.md

@@ -11,6 +11,36 @@
 - `harmony/build-profile.json5` 中存在可用的 `signingConfigs`
 - AppGallery Connect / 本地签名材料与工程配置一致
 
+`.expo-harmony/signing.local.json` 的最小结构与 `.expo-harmony/signing.local.example.json` 一致：
+
+```json
+{
+  "signingConfigs": [
+    {
+      "name": "default",
+      "type": "HarmonyOS",
+      "material": {
+        "storeFile": "./signing/release.p12",
+        "storePassword": "<replace-with-store-password>",
+        "keyAlias": "<replace-with-key-alias>",
+        "keyPassword": "<replace-with-key-password>",
+        "signAlg": "SHA256withECDSA",
+        "profile": "./signing/release.p7b",
+        "certpath": "./signing/release.cer"
+      }
+    }
+  ],
+  "products": [
+    {
+      "name": "default",
+      "signingConfig": "default"
+    }
+  ]
+}
+```
+
+真实发布时，这些材料应来自 DevEco / AppGallery Connect。OpenHarmony 本地自签材料只适合模拟器或内部验证，不能当作生产发布凭据。
+
 ## 如何检查
 
 在项目根目录执行：
@@ -51,6 +81,22 @@ expo-harmony build-hap --mode release
 
 - `env-report.json` 不再提示 `env.signing.missing`
 - DevEco / AppGallery Connect 的 release profile 已准备完成
+- release profile 覆盖了 HAP 中申请的 restricted permission；否则模拟器或设备可能在安装阶段报 `grant request permissions failed`
+
+## v1.8.2 本地模拟器证据
+
+`v1.8.2` 已在 ccnubox 本地验证目标上记录：
+
+- `expo-harmony env`：`Signing: configured`
+- `expo-harmony build-hap --mode release`：release signed HAP 构建成功
+- `hdc install -r <release-hap>`：模拟器安装成功
+- `aa start -a EntryAbility -b com.muxixyz.ccnubox`：启动成功
+
+这条记录只说明 release HAP 的本地签名、安装、启动链路可走通。它不代表 AppGallery 生产签名、不代表真机通过，也不关闭 preview capability 的 release runtime acceptance。
+
+## v1.8.3 矩阵 patch 说明
+
+`v1.8.3` 将 RNOH runtime 与 CLI 从 `0.82.18` 刷新到 `0.82.29`。npm 上当前仍没有可用的 RNOH `0.83.x` 包，因此公开矩阵继续要求 `react-native@0.82.1`；下游项目如需 Harmony build-chain，应按该矩阵锁定 React Native，而不是把模拟器构建证据扩写成 RN `0.83.x` verified。
 
 ## 关系说明
 

package/docs/support-matrix.md

@@ -27,8 +27,8 @@
 | Expo SDK | `55` |
 | React | `19.1.1` |
 | React Native | `0.82.1` |
-| `@react-native-oh/react-native-harmony` | `0.82.18` |
-| `@react-native-oh/react-native-harmony-cli` | `0.82.18` |
+| `@react-native-oh/react-native-harmony` | `0.82.29` |
+| `@react-native-oh/react-native-harmony-cli` | `0.82.29` |
 | `@react-native-community/cli` | `20.x` |
 | `metro` | `0.83.x` |
 | App Shell 依赖 | `expo-router` `55.x`、`expo-linking` `55.x`、`expo-constants` `55.x`、`@expo/metro-runtime` `55.x`、`react-dom` `19.1.1` |
@@ -113,6 +113,7 @@
 - 当前四项 preview capability 都已经完成 preview baseline 的 bundle / debug build / route walkthrough
 - 四项 preview capability 都已经进入 `adapter` 路径；`device=yes[manual-doc]` 只表示已有人工设备验收记录，仍不代表 verified 或 release-ready
 - 当前 preview baseline 的默认 evidenceSource 固定为：`bundle/debugBuild=automated`、`device=manual-doc`、`release=none`
+- `v1.8.2` 的 ccnubox release HAP 模拟器安装/启动记录只证明 app-shell release 构建链路，不改变上述 per-capability `release=no[none]`
 - `v1.8.x` 开始，combined sample smoke 只负责总回归；每项 capability 还必须单独维护 device / release acceptance 记录，见 [acceptance/v1.8.x-capability-board.md](../acceptance/v1.8.x-capability-board.md)
 - `expo-file-system`
   - `🟡` 当前主路径是 UTF-8/base64 sandbox I/O、append/partial read、`getInfoAsync({ md5: true })` 与 `downloadAsync`
@@ -252,6 +253,8 @@ toolkit 受管的核心产物仍包括：
 - release signing / release HAP 验收完成
 - 文档、矩阵、roadmap、acceptance 记录同 PR 更新
 
+`v1.8.2` 记录的 simulator release-HAP evidence 只覆盖 ccnubox app-shell 的 signed HAP 构建、安装和启动；单 capability 的 release acceptance 仍必须按各自记录单独关闭。
+
 ## 当前仍未进入正式公开承诺
 
 - bare Expo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-harmony-toolkit",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "description": "面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链",
   "main": "app.plugin.js",
   "types": "build/index.d.ts",

package/templates/harmony/entry/build-profile.json5

@@ -4,6 +4,17 @@
     "externalNativeOptions": {
       "path": "./src/main/cpp/CMakeLists.txt",
       "arguments": ""
+    },
+    "nativeLib": {
+      "filter": {
+        "pickFirsts": [
+          "**/libhermestooling.so",
+          "**/libjsi.so",
+          "**/libreactnative.so",
+          "**/librnoh_core.so",
+          "**/librnoh_core_package.so"
+        ]
+      }
     }
   },
   "targets": [