expo-harmony-toolkit 1.7.1 → 1.7.3

package/docs/v1.5.1-acceptance.md

@@ -1,385 +0,0 @@
-# v1.5.1 验收记录
-
-日期：2026-03-27
-
-基线：
-
-- 仓库：`Expo-Harmony-Toolkit`
-- tag：`v1.5.1`
-- commit：`1a51b0c10f08f5228c2918da3d7722d29c8be95b`
-
-## 结论
-
-这次 `v1.5.1` 收尾验收只完成了部分目标。
-
-- 已确认 npm 包与 Git tag 对齐，`official-ui-stack-sample` 的 `doctor -> init -> sync-template -> bundle -> env` 链路可跑通。
-- `Build Debug Hap(s)` 仍未通过。阻塞点已经从本地工具链缺失与 `ohpm` 无法安装 `.har`，收敛到 ArkTS 编译阶段的 adapter / RNOH 不匹配。
-- 因为没有产出可安装的 debug HAP，所以本次未完成设备侧 SVG、gesture 动画、动画后路由跳转的最终人工运行时验收。
-- npm 已发布 README 的原文内容可读性正常；npm 网页端的实时渲染未能在本次自动化环境中完成最终可视确认。
-
-## 环境
-
-- macOS `26.3` (`25D125`)
-- Node `v20.19.6`
-- pnpm `10.32.1`
-- npm `10.8.2`
-- DevEco Studio：`/Applications/DevEco-Studio.app`
-- Harmony SDK：`/Applications/DevEco-Studio.app/Contents/sdk`
-- Java：`/usr/bin/java`
-- ohpm：`/Applications/DevEco-Studio.app/Contents/tools/ohpm/bin/ohpm`
-- hvigor：`/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js`
-- hdc：`/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc`
-- 在线目标：`127.0.0.1:5555`
-
-## 命令结果
-
-### 1. Sample 安装
-
-执行：
-
-```bash
-cd examples/official-ui-stack-sample
-pnpm install --ignore-scripts
-```
-
-结果：
-
-- 成功。
-- 继续沿用当前仓库推荐的 `--ignore-scripts` 安装方式。
-
-### 2. CLI 验证
-
-执行：
-
-```bash
-pnpm run harmony:doctor:strict
-pnpm run harmony:init
-pnpm run harmony:sync-template
-pnpm run harmony:bundle
-pnpm run harmony:env
-```
-
-结果：
-
-- `doctor --strict`：通过，矩阵识别为 `expo55-rnoh082-ui-stack`。
-- `init`：通过。
-- `sync-template`：通过。
-- `bundle`：初次失败，报 `Cannot find module 'babel-preset-expo'`；修正 sample Babel 解析后复跑通过。
-- `env`：`ready`，本机可定位 DevEco / SDK / ohpm / hvigor / hdc；`signingConfigs` 仍为空，只影响 release HAP，不阻塞 debug 验证。
-
-### 3. Debug HAP 构建
-
-执行：
-
-```bash
-pnpm run harmony:build:debug
-```
-
-结果：
-
-- 未通过。
-- 问题拆成了两个阶段：
-
-1. 初始失败点
-
-- `ohpm install` 无法直接安装 npm 包内分发的本地 `*.har`。
-- 原因是这些 `*.har` 实际上是带 `package/` 前缀的 tarball，`ohpm` 本地安装时期望根目录直接存在 `oh-package.json5`。
-
-2. 修正后失败点
-
-- toolkit 现在会在 `build-hap` 前先把本地 `*.har` 规范化展开到 `harmony/.expo-harmony/ohpm-local-deps/`，`ohpm install` 随后可通过。
-- `hvigor assembleHap` 继续失败，进入 ArkTS 编译阶段后出现 adapter / RNOH 接口不匹配。
-- 关键现象：
-  - `@react-native-oh-tpl/react-native-gesture-handler` 当前包内 `oh-package.json5` 依赖的是 `@rnoh/react-native-openharmony: ^0.72.32`
-  - 本仓库公开矩阵固定的是 `@react-native-oh/react-native-harmony@0.82.18`
-  - 编译错误集中在 `RNGestureHandlerButton.ts`、`RNGestureHandlerRootView.ts`、`RNGestureHandlerModule.ts` 与 `RNOHPackagesFactory.ets`
-
-当前判断：
-
-- `Build Debug Hap(s)` 的最终阻塞已经不是本机环境问题，而是当前公开 matrix 下 UI-stack adapter 与 RNOH 运行时的兼容性问题。
-
-## 运行时人工验收结论
-
-已完成：
-
-- `open -a /Applications/DevEco-Studio.app examples/official-ui-stack-sample/harmony` 成功。
-- `hdc list targets` 能列出 `127.0.0.1:5555`。
-
-未完成：
-
-- 首页启动
-- `Constants.expoConfig?.name` 显示
-- SVG 圆环渲染
-- gesture 触发位移 / 旋转 / 回弹
-- `/details` 路由跳转与返回
-- 动画后路由仍正常
-
-原因：
-
-- 没有可安装的 debug HAP 产物，无法继续设备侧运行时验收。
-
-## npm README 检查
-
-### 已确认
-
-通过：
-
-```bash
-npm view expo-harmony-toolkit readme --json
-```
-
-检查到当前已发布 README 原文中包含：
-
-- 顶部徽章
-- 相对链接
-- 中英文跳转链接
-- fenced code blocks
-
-静态内容层面没有发现 README 被 npm 发布流程截断或丢失关键区块。
-
-### 未完成
-
-未能完成 npm 网页端的实时可视验收。
-
-阻塞：
-
-- 直接自动抓取 npmjs 页面受限。
-- 试图补装 Playwright 浏览器 runtime 时，`npx playwright install chrome` 因 npm registry `ECONNRESET` 失败。
-
-因此本次对 npm README 的最终结论是：
-
-- 已发布内容原文正常。
-- 网页端实际渲染仍待后续在网络正常的浏览器环境中补一次可视确认。
-
-## 本次为验收补的修正
-
-- [examples/official-ui-stack-sample/babel.config.js](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/babel.config.js)
-  - 显式通过 Expo 包根目录解析 `babel-preset-expo`
-  - 同时加入 `expo-router/babel`
-  - 解决 pnpm workspace 下 `bundle` 无法解析 Babel preset 的问题
-- [src/core/build.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/core/build.ts)
-  - 在 `build-hap` 前把 tarball 形态的本地 `*.har` 展开成 `ohpm` 可安装目录
-  - 构建后恢复生成的 `oh-package.json5`，避免工作区残留临时 specifier
-- [templates/harmony/entry/src/main/cpp/CMakeLists.txt](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/templates/harmony/entry/src/main/cpp/CMakeLists.txt)
-  - 增加 `.expo-harmony/ohpm-local-deps` 的 RNOH C++ 源码回退查找
-- [tests/build.test.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/tests/build.test.ts)
-  - 补了本地 HAR 规范化与恢复逻辑的测试
-
-## 证据
-
-- `pnpm test`：`10` 个 suite，`40` 个测试全部通过
-- `pnpm build`：通过
-- `hdc list targets`：返回 `127.0.0.1:5555`
-- `doctor --strict`：识别为 `expo55-rnoh082-ui-stack`，`18 supported, 0 manual, 0 unknown`
-- `build-hap --mode debug`：已推进到 ArkTS 编译阶段，但最终失败，说明本机 DevEco / SDK / hvigor / ohpm 已真正参与构建
-
-## 对 v1.5.1 的最终状态判断
-
-- `doctor / init / sync-template / bundle / env`：可用
-- `official-ui-stack-sample` runtime 手动验收：未完成
-- `Build Debug Hap(s)`：未通过
-- npm README 已发布原文：正常
-- npm README live page 可视验收：待补
-
-## 追加进展（2026-03-27 晚间）
-
-这轮继续补验收后，`Build Debug Hap(s)` 已经打通，但设备侧人工验收仍未完成。
-
-### 新增验证结果
-
-执行：
-
-```bash
-pnpm build
-pnpm test -- --runInBand tests/build.test.ts tests/init.test.ts tests/officialUiStackSample.test.ts
-cd examples/official-ui-stack-sample
-pnpm run harmony:build:debug
-```
-
-结果：
-
-- `pnpm build`：通过。
-- 定向测试：`3` 个 suite、`15` 个测试全部通过。
-- `build-hap --mode debug`：通过，已产出：
-
-```text
-examples/official-ui-stack-sample/harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-```
-
-### 为打通 Debug HAP 新补的修正
-
-- [src/core/template.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/core/template.ts)
-  - 将 autolinking 生成物与 `ts.ts` shim 标记为 build-required managed files
-  - `build-hap` 前会强制刷新这些生成文件，但不会顺带覆盖其他用户可漂移模板
-- [src/core/build.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/core/build.ts)
-  - `bundleProject()` 改为在构建前强制同步 build-required managed files
-  - 对规范化后的本地 gesture-handler HAR 增加 `react/renderer/debug/SystraceSection.h -> <cxxreact/SystraceSection.h>` 兼容 shim
-- [templates/harmony/entry/hvigorfile.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/templates/harmony/entry/hvigorfile.ts)
-  - 显式设置 `autolinking: null`
-  - 禁用 hvigor 二次 autolinking，避免其用旧模板回写 `RNOHPackagesFactory.h`
-- [tests/build.test.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/tests/build.test.ts)
-  - 增补 build-required managed files 强制刷新测试
-  - 增补 gesture-handler Systrace shim 测试
-- [tests/init.test.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/tests/init.test.ts)
-  - 断言生成的 `harmony/entry/hvigorfile.ts` 含 `autolinking: null`
-
-### 设备侧仍未完成的原因
-
-这次已经不再是 HAP 构建阻塞，而是当前本机模拟器实例不可用。
-
-- `hdc list targets -v`：当前返回 `[Empty]`
-- DevEco Emulator CLI 可列出实例名：`Enjoy 90 Pro Max`
-- 该实例目录存在：`/Users/blackishgreen03/.Huawei/Emulator/deployed/Enjoy 90 Pro Max`
-- 但当前系统进程中没有活跃的 emulator/qemu guest，无法安装 HAP
-- 实例日志显示最近一次 guest 在 `2026-03-27 18:49` 出现 `Guest no response` / `hdc is abnormal`
-- 随后在 `2026-03-27 19:04` 尝试重新拉起时，又出现 `can not read uuid file` / `can not read sn`
-
-因此当前未完成项变成：
-
-- `hdc install -r entry-default-unsigned.hap`
-- `aa start` 拉起 `com.blackishgreen.expoharmonyuistack/EntryAbility`
-- 首页、SVG、gesture、reanimated、路由跳转的最终人工运行时验收
-
-### 对当前状态的更新判断
-
-- `doctor / init / sync-template / bundle / env`：可用
-- `Build Debug Hap(s)`：已通过
-- `official-ui-stack-sample` runtime 手动验收：仍待补
-- 当前阻塞：模拟器实例健康状态 / `hdc` target 缺失，而非 toolkit 构建链路
-
-## 设备侧补验收（2026-03-30 下午）
-
-这轮在同一台机器上继续补了模拟器侧验收，结论是：`build/install/start` 链路现在都已经真正打通，但 `official-ui-stack-sample` 仍未达到可验首页状态，最新阻塞已经从 native 构建前移到 JS runtime 兼容层。
-
-### 新增验证结果
-
-执行：
-
-```bash
-pnpm build
-pnpm test -- --runInBand tests/build.test.ts
-cd examples/official-ui-stack-sample
-pnpm exec tsc --noEmit
-pnpm run harmony:build:debug
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc list targets -v
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc install -r harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack
-```
-
-结果：
-
-- `pnpm build`：通过。
-- `tests/build.test.ts`：`1` 个 suite、`13` 个测试全部通过。
-- sample `tsc --noEmit`：通过。
-- `build-hap --mode debug`：通过，持续产出 `entry-default-unsigned.hap`。
-- `hdc list targets -v`：返回 `127.0.0.1:5555 TCP Connected localhost`。
-- `hdc install -r entry-default-unsigned.hap`：通过，返回 `install bundle successfully`。
-- `aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack`：通过，返回 `start ability successfully`。
-
-### 新增运行时结论
-
-- 之前 sample 中直接引用 `react-native-reanimated/lib/module/reanimated2` 深路径会在模拟器上红屏，现已改回从 `react-native-reanimated` 包入口导入，旧的模块解析红屏已消失。
-- 覆盖安装完成后单独重新拉起应用，进程可以稳定存活，不再是安装期把 Ability 顶掉。
-- 但当前前台画面仍是白屏，尚未进入可人工点击验收的首页。
-
-本次从 `hilog` 抓到的关键运行时错误包括：
-
-- `Invariant Violation: Looks like you're passing a function component "BaseImage" to createAnimatedComponent`
-- `Error: Incompatible React versions`
-- 日志明确显示：
-  - `react: 19.2.0`
-  - `react-native-renderer: 19.1.1`
-
-### 对阻塞点的最新判断
-
-- 当前已确认不是 `hdc` target、安装、Ability 拉起、ArkTS/C++ 编译、也不是深路径 `reanimated2` 模块解析问题。
-- 当前阻塞已经收敛为 JS runtime 侧的版本窗/adapter 兼容问题：
-  - 公开矩阵当前宣称的是 `Expo 55 + React 19.2.x + React Native 0.83.x + @react-native-oh/react-native-harmony 0.82.18`
-  - 但本机实际安装的 `@react-native-oh/react-native-harmony@0.82.18` `peerDependencies.react-native` 仍明确要求 `0.82.1`
-  - 设备侧运行日志也与这条不匹配相吻合
-
-因此截至 `2026-03-30 15:42 CST` 的最新结论变为：
-
-- `doctor / init / sync-template / bundle / env`：可用
-- `Build Debug Hap(s)`：可用
-- `hdc install`：可用
-- `aa start`：可用
-- `official-ui-stack-sample` runtime 手动验收：仍未通过
-- 当前阻塞：`react` / `react-native` / `@react-native-oh/react-native-harmony` / reanimated 组合在设备侧的 JS runtime 兼容性，而非 toolkit 构建链路本身
-
-## 最终收口（2026-03-30 18:05 CST）
-
-这轮没有继续维持一个“文档里支持 gesture，设备上却跑不通”的公开矩阵，而是把 `expo55-rnoh082-ui-stack` 收口到当前真实可运行的窗口：
-
-- 保留：`expo-router`、`expo-linking`、`expo-constants`、`react-native-reanimated`、`react-native-svg`
-- 移出公开矩阵：`react-native-gesture-handler`
-- `gesture-handler` 继续保留为矩阵外的手动探索项，不再作为 `doctor --strict` 通过条件，也不再作为官方 sample 的运行时承诺
-
-### 本轮补的修正
-
-- [src/data/uiStack.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/data/uiStack.ts)
-  - 从 `UI_STACK_VALIDATED_ADAPTERS` 移除 `react-native-gesture-handler`
-- [src/data/dependencyCatalog.ts](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/src/data/dependencyCatalog.ts)
-  - 将 `gesture-handler` 及其 Harmony adapter 调整为矩阵外 `manual` 状态
-- [examples/official-ui-stack-sample/package.json](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/package.json)
-  - 移除 `react-native-gesture-handler` 与 `@react-native-oh-tpl/react-native-gesture-handler`
-- [examples/official-ui-stack-sample/app/_layout.tsx](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/app/_layout.tsx)
-  - 移除 `GestureHandlerRootView`
-- [examples/official-ui-stack-sample/app/index.tsx](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/app/index.tsx)
-  - 将首页交互改成纯 `react-native` `Pressable` + `react-native-reanimated` 的 spring rail
-- [examples/official-ui-stack-sample/app/details.tsx](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/examples/official-ui-stack-sample/app/details.tsx)
-  - 文案改为当前真实验证项
-- [README.md](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/README.md)、[README.en.md](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/README.en.md)、[docs/support-matrix.md](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/docs/support-matrix.md)
-  - 将公开矩阵、sample 说明和 release gate 同步到真实版本窗
-
-### 重新执行的验证
-
-执行：
-
-```bash
-pnpm install --ignore-scripts
-pnpm exec jest tests/doctor.test.ts tests/officialUiStackSample.test.ts tests/docs.test.ts --runInBand
-pnpm build
-
-cd examples/official-ui-stack-sample
-pnpm run harmony:doctor:strict
-pnpm run harmony:init
-pnpm run harmony:sync-template
-pnpm run harmony:bundle
-pnpm run harmony:env
-pnpm run harmony:build:debug
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc install -r harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack
-/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack -U expoharmonyuistack://details
-```
-
-结果：
-
-- 定向 Jest：`3` 个 suite、`20` 个测试全部通过
-- `pnpm build`：通过
-- `doctor --strict`：通过，sample 当前为 `16 supported, 0 manual, 0 unknown`
-- `init / sync-template / bundle / env / build-hap --mode debug`：全部通过
-- `hdc install -r`：通过，返回 `install bundle successfully`
-- `aa start`：通过，返回 `start ability successfully`
-- `aa dump --all`：确认 `com.blackishgreen.expoharmonyuistack` 处于 `FOREGROUND`
-- `hilog`：已出现 `JS bundle executed successfully`，未再出现此前的 `gesture-handler` / reanimated runtime fatal
-
-### 设备侧证据
-
-- 首页截图：
-  [official-ui-stack-sample-home-reset.jpeg](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/.tmp-acceptance/official-ui-stack-sample-home-reset.jpeg)
-- `/details` 路由截图：
-  [official-ui-stack-sample-deeplink.jpeg](/Users/blackishgreen03/workspace/Expo-Harmony-Plugin/.tmp-acceptance/official-ui-stack-sample-deeplink.jpeg)
-
-当前观察到的设备侧状态：
-
-- 首页能正常显示标题、SVG、`Constants.expoConfig?.name`、`Linking.createURL('/details')`
-- `/details` 页面可通过 scheme deep link 进入并稳定显示
-- 调试环境下仍会出现 Dev Menu websocket / packager 重连日志，这不是当前 sample 运行阻塞
-
-### 对 `v1.5.1` 的最终状态改判
-
-- 公开矩阵：已修正到真实可运行版本窗
-- `doctor / init / sync-template / bundle / env / build-hap / install / start`：可用
-- 官方 UI-stack sample：可在当前模拟器上正常显示首页与 `/details`
-- 设备侧剩余未纳入公开承诺的项：`react-native-gesture-handler`

package/docs/v1.6.0-acceptance.md

@@ -1,193 +0,0 @@
-# v1.6.0 验收记录
-
-日期：2026-03-31
-
-基线：
-
-- 仓库：`Expo-Harmony-Toolkit`
-- 版本：`1.6.0`
-- 发布目标：npm 包 `expo-harmony-toolkit@latest`
-
-## 结论
-
-这次 `v1.6.0` 已完成发版前验收，满足 npm 发布条件。
-
-- `doctor --strict` 既有 verified 矩阵 `expo55-rnoh082-ui-stack` 仍然可用。
-- 新增的 tiered support model、preview capability skeleton、permission generation、official native capabilities sample 已完成本地构建与设备侧验证。
-- `pnpm release:check` 已通过，包含 `build`、`test`、`npm pack --dry-run`、tarball 文件清单检查、tarball 安装 smoke，以及临时 sample 的 `build-hap --mode debug`。
-- 当前未完成项只剩 release HAP signing；这不属于 npm 发版 gate。
-
-## 环境
-
-- macOS `26.3` (`25D125`)
-- Node `v20.19.6`
-- pnpm `10.32.1`
-- npm `10.8.2`
-- DevEco Studio：`/Applications/DevEco-Studio.app`
-- Harmony SDK：`/Applications/DevEco-Studio.app/Contents/sdk`
-- Java：`/usr/bin/java`
-- ohpm：`/Applications/DevEco-Studio.app/Contents/tools/ohpm/bin/ohpm`
-- hvigor：`/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js`
-- hdc：`/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc`
-- 在线目标：`127.0.0.1:5555`
-
-## 验收范围
-
-### 1. 核心构建与测试
-
-执行：
-
-```bash
-pnpm build
-pnpm test
-pnpm release:check
-```
-
-结果：
-
-- `pnpm build`：通过。
-- `pnpm test`：`11` 个 suite、`57` 个测试全部通过。
-- `pnpm release:check`：通过。
-- tarball 文件清单符合预期，没有把 `examples/`、`fixtures/`、`tests/` 打进 npm 包。
-- tarball smoke 在临时 sample 上完成：
-  - `expo-harmony doctor --strict`
-  - `expo-harmony init --force`
-  - `expo-harmony bundle`
-  - `expo-harmony build-hap --mode debug`
-
-### 2. Verified 矩阵回归
-
-对象：
-
-- `examples/official-ui-stack-sample`
-
-执行：
-
-```bash
-node ../../bin/expo-harmony.js doctor --project-root . --strict
-node ../../bin/expo-harmony.js init --project-root .
-node ../../bin/expo-harmony.js bundle --project-root .
-node ../../bin/expo-harmony.js build-hap --project-root . --mode debug
-```
-
-结果：
-
-- `doctor --strict`：通过，矩阵识别为 `expo55-rnoh082-ui-stack`。
-- `init`：通过。
-- `bundle`：通过。
-- `build-hap --mode debug`：通过，产出：
-
-```text
-examples/official-ui-stack-sample/harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-```
-
-设备侧验证：
-
-```bash
-hdc install -r entry-default-unsigned.hap
-hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonyuistack
-```
-
-结果：
-
-- HAP 安装成功。
-- `EntryAbility` 启动成功。
-- 通过 `uitest dumpLayout` 验证首页可见：
-  - `Official UI Stack Sample`
-  - `Expo Harmony UI Stack Sample`
-  - `expoharmonyuistack:///details`
-  - `RNSVGSvgView(...)` 节点存在
-  - `Run reanimated spring`
-  - `Open details route`
-- 点击一次 motion rail 后，再点击 `Open details route`，`/details` 页面可见：
-  - `UI Stack Details`
-  - `doctor -> init -> bundle -> build-hap -> runtime`
-  - `Back to home`
-
-当前判断：
-
-- `expo-router`
-- `expo-linking`
-- `expo-constants`
-- `react-native-svg`
-- `react-native-reanimated`
-
-都仍然落在可启动、可渲染、可跳转的 verified 运行时路径内。
-
-### 3. Preview Native Capabilities 验证
-
-对象：
-
-- `examples/official-native-capabilities-sample`
-
-执行：
-
-```bash
-node ../../bin/expo-harmony.js doctor --project-root . --target-tier preview
-node ../../bin/expo-harmony.js init --project-root .
-node ../../bin/expo-harmony.js bundle --project-root .
-node ../../bin/expo-harmony.js build-hap --project-root . --mode debug
-```
-
-结果：
-
-- `doctor --target-tier preview`：通过，`expo-file-system` / `expo-image-picker` 识别为 `manual/preview`。
-- `init`：通过，并生成 Harmony permission declaration 与 preview shim。
-- `bundle`：通过。
-- `build-hap --mode debug`：通过，产出：
-
-```text
-examples/official-native-capabilities-sample/harmony/entry/build/default/outputs/default/entry-default-unsigned.hap
-```
-
-设备侧验证：
-
-```bash
-hdc install -r entry-default-unsigned.hap
-hdc shell aa start -a EntryAbility -b com.blackishgreen.expoharmonynativepreview
-```
-
-结果：
-
-- HAP 安装成功。
-- `EntryAbility` 启动成功。
-- `bm dump` 可见 request permissions：
-  - `ohos.permission.CAMERA`
-  - `ohos.permission.READ_IMAGEVIDEO`
-  - 对应 `$string:` reason 已写入 bundle metadata。
-- 通过 `uitest dumpLayout` 与点击事件验证：
-  - 首页可见 `Official Native Capabilities Sample`
-  - `/file-system` 页面可见 `expo-file-system preview`
-  - 点击 `Attempt preview write` 后，message 更新为 preview bridge 文案，不 crash
-  - `/image-picker` 页面可见 `expo-image-picker preview`
-  - 点击 `Attempt preview pick` 后，message 更新为 preview bridge 文案，不 crash
-
-当前判断：
-
-- preview tier 的承诺已经达到：
-  - 可被 `doctor` 分级识别
-  - 可 `init`
-  - 可 `bundle`
-  - 可 `build-hap --mode debug`
-  - 可安装与启动
-  - 点击 capability demo 不会 crash，而是稳定落到 preview bridge 提示
-
-## 非阻塞观察
-
-- `env.signing.missing` 仍然存在；当前 sidecar 没有 release signing config，这不阻塞 npm 发版，也不阻塞 debug HAP 验证。
-- 设备日志里仍可看到一些非致命 debug 噪音，例如：
-  - `StatusBar is translucent by default`
-  - `DevMenu` / `ACCELEROMETER` 相关提示
-  - 若干 websocket retry / `epoll wait event` 噪音
-- 本轮没有观察到阻止应用启动、阻止页面渲染、或导致 preview / verified sample route 崩溃的 fatal runtime 问题。
-
-## 对 v1.6.0 的最终判断
-
-- `doctor / init / bundle / build-hap(debug)`：可用
-- verified UI-stack matrix：通过设备侧回归
-- preview native capabilities skeleton：通过设备侧回归
-- tarball smoke：通过
-- npm 发布前 gate：通过
-- release HAP signing：未配置，不纳入本次 npm 发版阻塞项
-
-因此，`v1.6.0` 已具备进入 npm 正式发布流程的条件。

package/docs/v1.7.0-acceptance.md

@@ -1,111 +0,0 @@
-# v1.7.0 验收记录（模拟器收口版）
-
-日期：2026-04-02
-
-基线：
-
-- 仓库：`Expo-Harmony-Toolkit`
-- 版本：`1.7.0`
-- 验收约束：当前无真机，只做模拟器与构建层收口
-
-## 当前结论
-
-`v1.7.0` 这一轮的正确结论不是“所有 preview capability 已 verified”，而是：
-
-- 四个 official sample 都已经收口成可理解、可上手、可重复操作的官方示例
-- `official-minimal-sample` 不再只是空白 smoke 卡片，而是最短链路说明页
-- `official-app-shell-sample` 不再只是回归页，而是 router / linking / constants 的最小 onboarding sample
-- `official-ui-stack-sample` 继续作为 verified UI-stack 主 sample，并把成功信号写得更显式
-- `official-native-capabilities-sample` 现在按“每页一个模块、只讲核心支持子集、unsupported 边界明确”的方式收口
-- `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 仍然全部保持 `preview`
-- 在没有真机前，不把任何 preview capability 提升到 `verified`
-
-这份记录里默认使用以下判读：
-
-- `🟡` 表示实现已到位，主要只差真机 / release 证据
-- `🟠` 表示包已进入 `preview`，但这个具体子 API 还没补齐到可信实现；不是“只差真机”
-
-## 本轮实现范围
-
-- 统一重做四个 official sample 的页面表达和使用文档
-- `expo-file-system` sample 补齐目录创建、写入、读回、列目录、复制、移动、清理
-- `expo-image-picker` sample 保留单图选择 / 单次拍照 / denied / canceled / asset-return 主路径
-- `expo-location` sample 收口到 foreground permission、current、last-known、geocode、reverse-geocode
-- `expo-camera` sample 收口到 camera permission + still capture through Harmony system camera UI
-- `expo-location` shim 明确把 `watchPositionAsync`、background permission、heading API 降为 unsupported
-- `expo-camera` shim 明确把 embedded preview、pause/resume、microphone、video 相关入口降为 unsupported
-- sample 指南、support matrix、README、acceptance 记录同步到真实状态
-
-## 自动化检查结果
-
-执行：
-
-- `pnpm build`
-- `pnpm test`
-
-结果：
-
-- `pnpm build`：通过
-- `pnpm test`：通过，`11` suites / `61` tests
-
-另外，sample 相关针对性回归也已通过：
-
-- `tests/officialSample.test.ts`
-- `tests/officialAppShellSample.test.ts`
-- `tests/officialUiStackSample.test.ts`
-- `tests/officialNativeCapabilitiesSample.test.ts`
-- `tests/init.test.ts`
-- `tests/docs.test.ts`
-
-## 这版 sample 的实际完成度
-
-### Official Minimal Sample
-
-- 页面现在明确说明它验证的是最短 `doctor -> init -> bundle -> build-hap` 链路
-- 页面明确写出成功标准与故意不覆盖的范围
-- 适合作为新开发者的最小入口，而不是仅供维护者理解的 smoke baseline
-
-### Official App Shell Sample
-
-- 首页明确展示 app name、pathname、observed URL、generated details URL
-- 同时提供 router push、`Link` 组件、generated deep link 三条入口
-- `/details` 页面也会回显当前 pathname / URL，便于判断 deep-link 是否真正解析成功
-
-### Official UI Stack Sample
-
-- 保留 router、linking、constants、SVG、reanimated 的 verified 主线
-- 首页新增“Success signals”表达，降低验收歧义
-- `/details` 页面会回显 route / URL，帮助判断动画和路由是否互相影响
-
-### Official Native Capabilities Sample
-
-- `/file-system`
-  - 现在是完整 sandbox 文件流 sample
-  - 覆盖目录创建、读写、inspect、列目录、copy、move、cleanup
-- `/image-picker`
-  - 继续聚焦 permission、单图选择、单次拍照、deny/cancel/success 三类结果
-- `/location`
-  - `🟡` foreground permission、current、last-known、geocode、reverse-geocode 可直接操作
-  - `🟠` `watchPositionAsync`、background permission、heading API 已不再伪装成主路径支持；这些不是“只差真机”
-- `/camera`
-  - `🟡` 相机权限和 through-system-ui 的 still capture 可直接操作
-  - `🟠` embedded preview、pause/resume、microphone、video 已不再伪装成主路径支持；这些不是“只差真机”
-
-## 当前未完成的边界
-
-在没有真机前，以下内容仍未完成：
-
-- 任一 preview capability 的 `verified` 晋升
-- `🟡` 已实现子集的真机与 release 证据补齐
-- `🟠` `expo-location` 的真实 continuous watch、background permission parity、heading API 实现与验收
-- `🟠` `expo-camera` 的 embedded live preview、preview pause/resume、microphone / video API 实现与验收
-- release signing 配置以外的真机 release HAP 运行证据
-
-## 版本结论
-
-因此，`v1.7.0` 现在可以对外保持的准确说法是：
-
-- verified 主线仍然只有 `expo55-rnoh082-ui-stack`
-- 四个 native capability 已经收口成“模拟器下真正可用的高质量 preview sample”
-- 工具链、sample、矩阵、README、acceptance 文档现在口径一致
-- 下一步只有在拿到真机后，才应该讨论 capability promotion