android: phase Z wrap-up (docs, release build, camera feature optional, APK)

This commit is contained in:
ZXCLI
2026-09-11 00:57:46 +08:00
parent 512508e629
commit 8e1312a137
5 changed files with 115 additions and 28 deletions
+43 -8
View File
@@ -376,14 +376,16 @@
`Controller::PushFrame` 输入=整帧缓冲(28B头+像素+28B尾),与本管线一致。
- 预期:66b/66c/66f 全部有响应 → cali 下载(首次)→ 流出帧。
## 待办
## 待办2026-09-10 更新:执行计划 A→F 已全部完成)
- 真机USB实测(温度绝对值标定、FFC/录像/MDT保存端到端)——进行中:
自检清单位于 docs/android_app/real_device_checklist.mdPhase A3 产出)
- 网络互连远程预览(用户需求:UDP自动发现+手动IP)
- 离线MDT温度解码(ConvertResponse2Temperature+标定参数,待真机文件对照)
- 厂商12调色板精确提取(需运行时抓取)
- 可见光PIP融合、云模块(预留结构)
- **真机实测**(唯一未完成的主线):照 `docs/android_app/real_device_checklist.md`
24 步走一遍——1-12 单机(USB 出流/FFC/拍照/录像/媒体库/分析页温度条/PDF)、
13-15 可见光 PIP、16-24 双机远程预览。每步都有预期 DebugLog 原文可对照。
- 红热调色板(索引 11)精确表:官方 APK 预览图为占位副本,需真机抓帧反推。
- 云端点对接:当前为占位接口,需账号与接口文档。
- 任务巡检 UI(TaskParser 已就绪,尚无界面)——沿自早期计划,未列入本轮范围。
- 旧的"网络互连/离线MDT解码/调色板提取/PIP/云模块"五项**已在本轮全部实现**
(见下方阶段表),此处不再重复。
## 执行计划进度(2026-09-10docs/android_app/execution_plan.md
@@ -439,8 +441,41 @@
单测 44 个全绿,含 **loopback 端到端测试**(真实 TCPhello→welcome→
start→stream-start→5 帧逐字节往返→ffc→stop→stream-stop)与粘包/截断/
坏长度/重同步用例。debug+release 双构建通过。真机双机步骤写入清单第 16-24 步。
- [ ] Phase Z:收尾(文档/全量构建/APK
- [x] Phase Z2026-09-10):收尾完成。docs 更新(本文件 + HANDOFF_DEVELOPMENT
§3 结构表加入 net/ cloud/ ui/remote/ 与 VendorPalettes/PipCameraView
§7 状态与待办重写 + 禁改清单);全量 `assembleDebug test`44 单测全绿)
+ `assembleRelease`R8)通过;APK 已覆盖提交
build-artifacts/mag160c-app-debug.apk12.66MBmd5 76ff4e12…);
dex 抽查 10 个新增中文串 UTF-8 正确、无 GBK 乱码;APK 校验:
screenOrientation=portrait 保持、camera/camera.any 均为 required=false
(CAMERA 权限原本会让相机变必需,已显式声明为可选)。
**未 push**(按用户指令)。
## 本轮(2026-09-10 执行计划 A→F)总结
七个阶段全部落地,每阶段一次 commit:
| 阶段 | commit | 内容 |
|---|---|---|
| A | 06c1f30 | lifetime 查询 + cali MD5 对照 + 真机自检清单 |
| B | 656d419 | MDT 温度解码 + 分析页温度条/测温探针 |
| C | b7a928e | 厂商调色板提取(11/12 精确表) |
| D | c34940e | 云模块脚手架(opt-in 默认关) |
| E | f8b3200 | 可见光 PIP 叠加(Camera2,三档可拖) |
| F | 512508e | 局域网远程预览(UDP 发现 + 原始帧 TCP,客户端渲染) |
测试:29(D 结束)→ 44(F 结束),含真实 TCP loopback 端到端用例。
**留给用户的实测**`docs/android_app/real_device_checklist.md` 共 24 步
1-12 单机 USB/拍照/录像/分析;13-15 PIP16-24 双机远程预览),
每步标注预期 DebugLog 原文。
**已知未完成项(诚实记录)**
1. 红热调色板(索引 11)仍是近似——官方 APK 预览图是白热的占位副本,
生成的 case12/13 对任何预览覆盖率 ≤6%,不猜测;需真机抓帧反推。
2. 全部真机验证(温度绝对值、PIP 相机、双机远程、MDT 温度条)需用户配合;
本机无模拟器(SDK 无 emulator 组件)、无连接设备,只能保证编译与单测。
3. 云端点为占位,需账号与接口文档才能对接。
## 里程碑日志