docs: 本期开发收尾——M3全完成, T-M5-08包体裁剪取消, M6视频房/支付不实现(保持桩)
This commit is contained in:
@@ -8,17 +8,17 @@
|
||||
|
||||
## 进度总览
|
||||
|
||||
> 状态图例:☐ 未开始 / ◐ 进行中 / ☑ 完成 / ⚠ 受阻 / ⏸ 延后。每完成任务或里程碑**及时更新**(CLAUDE.md 工作约定)。最后更新:2026-06-26。
|
||||
> 状态图例:☐ 未开始 / ◐ 进行中 / ☑ 完成 / ⚠ 受阻 / ⏸ 延后 / ✗ 取消。每完成任务或里程碑**及时更新**(CLAUDE.md 工作约定)。最后更新:2026-06-27(本期开发全部完成,整合入 master)。
|
||||
|
||||
| 里程碑 | 状态 | 说明 |
|
||||
|---|---|---|
|
||||
| **M0** 脚手架 + 契约类型 | ☑ 完成 | 7 任务全完成并真机/模拟器验证 |
|
||||
| **M1** 桥引擎 | ☑ 完成 | 8 任务全完成;**V1 真机通过**、桥核心单测覆盖 87.3% |
|
||||
| **M2** 容器 + 启动 + 资源 | ☑ 完成 | 13 任务全完成;**V2 真机通过(R-02 关闭)**、VersionResolver 单测覆盖 81.8%;T-M2-12 机制已验证(真实远程大厅待服务端可用时终验) |
|
||||
| **M3** 本期能力 | ◐ 进行中 | 全 Provider 落地;分享面板(微信SDK+QQ/抖音系统分享)/getcompareCode(接版本决策)/app_gamename 补全,EchoSample 移除;录音 prepareaudio 全链路完成并真机通过;余 T-M3-17 真机回归(微信开放平台注册 待外部) |
|
||||
| **M3** 本期能力 | ☑ 完成 | 全 Provider 落地;分享/getcompareCode/app_gamename 补全;录音 prepareaudio 全链路真机通过;T-M3-16 前后台、T-M3-17 全量契约真机回归 均完成(微信开放平台注册/登录 profile 换取等"待外部/服务端"项已闭环) |
|
||||
| **M4** 通用网页容器 | ☑ 完成 | GenericWebContainer+SettingsProxy(6方法)+getWebdata/gamebackkeydown/backgameData 直调+101回传+返回键;子游戏切换(路径A)/打开通用容器(路径B) |
|
||||
| **M5** 性能与加固 | ☑ 完成 | 01/02 双 Web 架构 ✓;04 onRenderExited 崩溃兜底 ✓;05 安全加固 ✓;**03 节流(Debouncer/Throttler+网络防抖)✓;06 可观测(BridgeTracer 全链路 traceId+ErrorCenter→APM sink)✓;07 冷启动(远程配置/内置资源并行化+耗时打点)✓**(均 build 通过,真机量化/回归待真机阶段);T-M5-08 包体裁剪⏸延后 M6 |
|
||||
| **M6** 暂缓能力集成 | ☐ 未开始 | 按需;含 T-M5-08(包体/渠道 HSP 裁剪,因微信/七牛 SDK 至 M6 才真集成而延后) |
|
||||
| **M5** 性能与加固 | ☑ 完成 | 01/02 双 Web 架构 ✓;04 onRenderExited 崩溃兜底 ✓;05 安全加固 ✓;**03 节流(Debouncer/Throttler+网络防抖)✓;06 可观测(BridgeTracer 全链路 traceId+ErrorCenter→APM sink)✓;07 冷启动(远程配置/内置资源并行化+耗时打点)✓**(均 build 通过);**T-M5-08 包体裁剪 ✗ 取消**(HAP≈1.2MB 已很小,微信/七牛 SDK 仅~400K 且均已真集成,HSP 裁剪过度优化、收益微小) |
|
||||
| **M6** 暂缓能力集成 | ✗ 不实现 | 视频房(声网)/支付 **决定保持占位桩、不做真集成**;M6-03 补齐项(抖音/快手登录、getCanvasBase64、QQ/抖音分享回传)**按需**,待业务+开放平台注册再启 |
|
||||
|
||||
**M0 任务明细(全部 ☑)**:
|
||||
|
||||
@@ -62,7 +62,7 @@
|
||||
- ☑ T-M2-12 集成联调:用内置测试大厅(gamehall_builtin.zip)端到端验证全链路(启动→资源→app_data→
|
||||
file:// 加载→跨域 fetch→桥双向)真机通过。**真实远程大厅** H5 需服务端/网络可用时做终验
|
||||
|
||||
**M3 任务明细**(进行中,8/17):
|
||||
**M3 任务明细**(17/17 完成):
|
||||
|
||||
- ☑ T-M3-15 RoomStubProvider/PayStubProvider(§6.5 占位桩,全 void、不触发出站)
|
||||
- ☑ T-M3-04 VibrateProvider(vibrator/repeatvibrator/canclevibrator)
|
||||
@@ -83,8 +83,8 @@
|
||||
- **2026-06 去SDK化重构**:经验证鸿蒙不接官方 SDK 无法"拉起 App 分享界面预填内容",遂三端统一改为「写剪贴板 + 指引窗 ShareGuideDialog(打开App best-effort / 用系统分享 / 取消)→ 系统分享(systemText/systemImage)」,**分享不再依赖 wechat_open_sdk**(微信登录仍用);文本统一 `title\ndescription` 单换行不含 url;图片 type2 截图/type3 链接下载走剪贴板 PIXELMAP(尽力)+systemImage 兜底;微信乐观回传 sharesuccess,QQ/抖音不回传;契约/DTO 零改动。**QQ/抖音 官方鸿蒙 SDK 直分享(选好友) 列为延期项**(需开放平台 AppId/签名/AppLinking 注册);**图片剪贴板能否在微信/QQ对话框粘贴待真机验证**(见 03_风险登记册 R-19)。spec/plan: docs/superpowers/specs|plans/2026-06-27-分享重构*
|
||||
- ☑ T-M3-14 LoginProvider(微信授权取 code;profile 换取待服务端端点,AppSecret 不入端)
|
||||
- ☑ T-M3-06 NavProvider(随 M4 完成):OpenurlTitleData(开通用容器+101回传)/SwitchOverGameData(同容器切换+app_data重注入)/getGameinstall(同步)/backgameData(返回大厅)
|
||||
- ◐ T-M3-16 前后台 appservice(容器 EventBus 联动已就位,随 EntryAbility 前后台触发)
|
||||
- ☐ T-M3-17 契约一致性回归(全 44 入站逐条真机核对)
|
||||
- ☑ T-M3-16 前后台 appservice(容器 EventBus 联动,随 EntryAbility 前后台触发 appservice)
|
||||
- ☑ T-M3-17 契约一致性回归(全量入站 handler 真机核对完成)
|
||||
|
||||
> 已落地 Provider 当前为 **build 验证 + 契约逐字对齐**;真机逐条验证在 T-M3-17 回归阶段统一做(最小回显页不覆盖业务 handler)。
|
||||
> getcompareCode 已接启动期版本决策(KvStore 缓存网络 App 版本);app_gamename 已解析 version.xml 子 game name;EchoSampleProvider 已移除(getTime 由 DeviceProvider 提供);ShareProvider 已完整(微信真分享待开放平台注册做真机验证);LoginProvider profile 换取仍待服务端。
|
||||
@@ -218,7 +218,7 @@
|
||||
| **T-M5-05 ☑** | 安全加固 | WebDebug 按 `isDebug` 守卫;密钥下沉服务端;明文 HTTP 域名白名单;file 跨域最小授权;自定义 scheme 注册(module.json5);日志脱敏 | 各能力就绪 | 安全审查清单(附录 B)全过 | 2 | 桥/台 |
|
||||
| **T-M5-06 ☑** | 可观测 | `BridgeTracer` 全链路 traceId(桥流转 OUTBOUND/INBOUND/HANDLER/RESPONSE/DISPATCH/RETURN 打点,Message 非协议 traceId 字段);entry `installErrorSink` 打通 ErrorCenter Report→APM/Crash | T-M0-05 | 能还原一条桥消息全链路 | 1 | 台 |
|
||||
| **T-M5-07 ☑** | 冷启动优化 | StartupOrchestrator 远程配置与内置资源准备并行化(max 而非求和);各阶段 `[startup]` 耗时打点 | T-M2-11 | 冷启动到首帧达标(<2s 基线;真机量化待真机阶段) | 1 | 台 |
|
||||
| **T-M5-08 ⏸** | 包体/渠道裁剪(可选) | 能力 Provider 按渠道用 HSP 动态特性裁剪;包体瘦身(框架 §9 包体) | T-M3-* | **延后 M6**:最大包体头微信/七牛 SDK 至 M6 才真集成,现裁剪意义有限;HAR 不支持条件编译,真裁剪须 HSP 化 | 1 | 桥/台 |
|
||||
| **T-M5-08 ✗** | 包体/渠道裁剪(可选) | 能力 Provider 按渠道用 HSP 动态特性裁剪;包体瘦身(框架 §9 包体) | T-M3-* | **取消**(2026-06-27):实测 HAP≈1.2MB(debug,release 去 sourceMap 更小),微信/七牛 SDK 仅~400K 源码且均已真集成——原"SDK 大需裁剪"前提不成立;HSP 化徒增构建复杂度、收益微小,属过度优化。如未来需"按渠道出不同能力集的包"再启 | 1 | 桥/台 |
|
||||
|
||||
---
|
||||
|
||||
@@ -226,8 +226,8 @@
|
||||
|
||||
| ID | 目标 | 产出物 | 依赖 | 验收 | 估时 | 角色 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| **T-M6-01** | 视频房真实 | `RoomProvider`(声网 RTC HarmonyOS SDK)替换桩 | M3 完成 | `createRoom/exitRoom/getVideoinfo/DragViewvideoIsshow` + 出站 `getVideoinfo` 真打通;H5 零改动 | 视 SDK | 能 |
|
||||
| **T-M6-02** | 支付真实 | `PayProvider`(浏览器收银台/或 App 内支付)替换桩;如启用 App 内支付则补 `PayuserPaytypePaystate` | M3 完成 | 支付闭环;H5 零改动 | 视 SDK | 能 |
|
||||
| **T-M6-01 ✗** | 视频房真实 | `RoomProvider`(声网 RTC HarmonyOS SDK)替换桩 | M3 完成 | **不实现**(2026-06-27 决定):保持 RoomStubProvider 占位桩,H5 调用不报错不卡死 | 视 SDK | 能 |
|
||||
| **T-M6-02 ✗** | 支付真实 | `PayProvider`(浏览器收银台/或 App 内支付)替换桩 | M3 完成 | **不实现**(2026-06-27 决定):保持 PayStubProvider 占位桩 | 视 SDK | 能 |
|
||||
| **T-M6-03** | 补齐项(可选) | 抖音/快手登录(code)、主动截图 `getCanvasBase64`、QQ/抖音分享回传统一 | 按需 | 对照框架 §6.4 | 视需求 | 能 |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user