Improve controller behavior and update project requirements

2026-09-30 15:42:36 +08:00
parent 55374356ed
commit 071f06d365
52 changed files with 2205 additions and 335 deletions
@@ -0,0 +1,31 @@
+# 2026-09-29 “显示内容”两档图片与缓存验收
+
+## 变更与选测
+
+核桃派协议增加 `library.summary`、`library.preview` 和能力 `library_progressive`；`library.thumbnail` 仍是 64×64 PNG。板端按条目修订保存可再生 16×16 缓存并清理失效文件。App 按设备、条目修订和画质保存目录与图片，内容页先请求全部小图，再逐项请求完整图；有缓存时以目录修订确认复用。“当前设备画面”的 `frame.get` 路径不变，断线不提供离线列表。App 更新到 0.2.2／versionCode 5，设备 `VERSION` 保持 1.1.3，功能时间为 `2026-09-29T22:15+08:00`。
+
+直接影响目录、图片 BLE 请求、Android 私有文件缓存、内容页与软件设置。因此选择设备协议/缓存本机测试、sharedCore JVM、内容与设置的独立模拟器、登记手机的 `cache-storage` 和 `library-cache` 两个定向场景，以及 debug 构建/覆盖安装。未改动显示驱动、实际输出、WiFi、权限、后台策略或当前帧读取；这些专项按影响跳过。实屏视觉检查不适用，没有切换显示内容、测试图案或启动摄像头。
+
+## 实际结果
+
+| 验证 | 结果 |
+|---|---|
+| 板端本机 | `test_mobile_control.py` 19 项通过；与 `test_mobile_protocol.py` 合计的协议/控制定向测试 27 项通过。覆盖目录修订和顺序、16×16 PNG、旧 64×64 接口、失效小图清理、实际用户动画首帧和空动画。最终动画修复后重跑控制测试 19 项通过。 |
+| App 共享逻辑 | `:sharedCore:jvmTest` 通过；覆盖两轮顺序、重连复用、修订变化删除旧项、清空、旧设备回退及断线取消。 |
+| 独立模拟器 | API 35 的 content、settings、navigation 场景通过；内容页验证小图先于完整图、设置页清空确认。 |
+| 登记手机缓存存储 | `cache-storage` 通过；验证设备隔离、修订清理、损坏文件按未命中处理和清空。 |
+| 登记手机真实 BLE | `library-cache` 通过：现有目录 15 项，首次两档图片共 30 次请求，PNG 负载 77,058 字节；未变化的重连图片请求 0 次、PNG 负载 0 字节；生产 Controller 复用缓存时图片写入 0 次。这里统计的是 PNG 负载，不是包含协议与无线链路开销的总传输字节数。 |
+| 设备部署 | 使用现有可回滚开发部署流程，最终服务 active、移动接口可用；部署的移动控制、小图缓存及功能时间文件摘要与本地一致，恢复副本保留。未修改设备 `VERSION`，未导出 OTA/IMG。 |
+| App 交付 | `:androidApp:assembleDebug`、`:androidApp:assembleDebugAndroidTest` 成功；仅 debug 签名。登记手机覆盖安装后的 APK 摘要与交付包一致：`c3ae5ab3caa252f60c715d6f8ecf177767c1e7bc3ea12652b688efe5a3fc3c07`。 |
+
+## 首次失败、修复及复测
+
+- 首次真实 BLE 测试在一条用户动画的 `library.preview` 返回 `BAD_REQUEST`。该动画首帧使用 `path` 指向持久图片，而旧演示动画使用内嵌 `image`；预览/完整图提取现均识别并验证两种形式。控制测试和真实 BLE 全库两档读取复测通过。不能把首次失败写成网络故障。
+- 既有 AVD 名称曾指向已不存在的磁盘目录。保留旧配置，使用已登记的 SDK 镜像新建专用 AVD 后完成上述独立模拟器场景；未清空或覆盖旧 AVD。
+- 一次本地调用只准备了 instrumentation APK，缺少产品 APK；在同一隔离工程补构建产品 APK 后运行成功。运行真机场景前应同时确认两个 APK 都存在。
+
+可复用方法已更新到 [测试流程](../../如何安卓测试/README.md) 和 [排障指南](../../如何安卓测试/常见问题与排障.md)。本归档不保存凭据、真实设备标识、开发机绝对路径或无线数据内容。
+
+## 边界
+
+真实 BLE 结果证明设备上全部现存 15 项的两档接口可读取，且未变化重连没有再次下载；首次加载的 App 逐帧呈现顺序由 JVM 和模拟器验证，不把测试探针的请求顺序冒充真实界面目视结果。没有执行长时间前后台循环、跨 SSID、第二台手机、旧 Android 系统或完整无线链路计量；本轮变更不要求这些专项。没有发现复测后仍未解决的本轮产品故障。