docs: Update documentation for OHOS build and native integration details

2026-09-02 23:32:55 +08:00
parent f2dabe6b91
commit d786fc31ff
4 changed files with 64 additions and 18 deletions
@@ -93,6 +93,18 @@ melos run format      # dart format --set-exit-if-changed
 melos run test        # flutter test --coverage
 ```

+### OHOS（`harmony` 分支）构建
+
+`enable-ohos.ps1` 只为当前 PowerShell 会话注入 Flutter_OH、ohpm、hvigor 与 DevEco 环境变量，不修改用户或系统 PATH。先在仓库根目录执行，再进入 `app` 使用已有的开发环境入口构建：
+
+```powershell
+. .\enable-ohos.ps1
+cd app
+flutter build hap --debug -t lib\main_dev.dart
+```
+
+构建产物为未签名 debug HAP：`app/ohos/entry/build/default/outputs/default/entry-default-unsigned.hap`。这不会创建新的 Dart `main` 文件；现有环境入口仍是 `lib/main_dev.dart`、`lib/main_uat.dart` 和 `lib/main_prod.dart`。HAP 编译通过不代表 ArkTS 原生桥接、扫码或真机安装已经完成，边界见 [docs/07-native-integration.md](docs/07-native-integration.md)。
+
 `analyze` 带 `--fatal-infos`。不加等于没加 lint——绝大多数 riverpod_lint 规则
 报的是 info 级。