expo-harmony-toolkit 1.7.0 → 1.7.2

package/docs/v1.7.1-acceptance.md

@@ -0,0 +1,111 @@
+# v1.7.1 验收记录（模拟器收口版）
+
+日期：2026-04-02
+
+基线：
+
+- 仓库：`Expo-Harmony-Toolkit`
+- 版本：`1.7.1`
+- 验收约束：当前无真机，只做模拟器与构建层收口
+
+## 当前结论
+
+`v1.7.1` 这一轮的正确结论不是“所有 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.1` 现在可以对外保持的准确说法是：
+
+- verified 主线仍然只有 `expo55-rnoh082-ui-stack`
+- 四个 native capability 已经收口成“模拟器下真正可用的高质量 preview sample”
+- 工具链、sample、矩阵、README、acceptance 文档现在口径一致
+- 下一步只有在拿到真机后，才应该讨论 capability promotion

package/docs/v1.7.2-acceptance.md

@@ -0,0 +1,37 @@
+# v1.7.2 验收记录（Preview 子集收口版）
+
+- 版本：`1.7.2`
+- 日期：`2026-04-02`
+- 目标：把 `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 当前文档中的 `🟠` 子项全部收口到明确 `🟡` 子集
+
+## 结论
+
+`v1.7.2` 的正确结论不是“preview capability 已 verified”，而是：
+
+- 四项能力继续全部保持 `preview`
+- `runtimeMode` 继续保持 `adapter`
+- `evidence.release` 继续保持 `false`
+- 公开文档、official sample、模板生成与测试口径已收口到新的 yellow subset
+
+## 这轮收口内容
+
+- `expo-file-system`
+  - base64、append / partial read、`getInfoAsync({ md5: true })`、`downloadAsync`
+- `expo-image-picker`
+  - multi-select、mixed library selection、camera photo/video capture、`getPendingResultAsync`
+- `expo-location`
+  - background permission、`watchPositionAsync`、`getHeadingAsync`、`watchHeadingAsync`
+- `expo-camera`
+  - embedded `CameraView`、preview pause/resume、video recording、microphone permission
+
+## 文档与 sample 口径
+
+- [support-matrix](./support-matrix.md) 已更新为新的 yellow subset
+- [official-native-capabilities-sample](./official-native-capabilities-sample.md) 已改成四条 route 的收口版 walkthrough
+- README 中英、acceptance link、sample route copy 已同步更新
+
+## 保持不变的边界
+
+- 这轮不做 `preview -> verified` 晋升
+- 这轮不扩张到 `expo-notifications`、scanner parity、resumable task 家族等非目标能力
+- 真机与 release 证据仍需后续验收补齐

package/package.json

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