4.2 KiB
4.2 KiB
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 都存在。
可复用方法已更新到 测试流程 和 排障指南。本归档不保存凭据、真实设备标识、开发机绝对路径或无线数据内容。
边界
真实 BLE 结果证明设备上全部现存 15 项的两档接口可读取，且未变化重连没有再次下载；首次加载的 App 逐帧呈现顺序由 JVM 和模拟器验证，不把测试探针的请求顺序冒充真实界面目视结果。没有执行长时间前后台循环、跨 SSID、第二台手机、旧 Android 系统或完整无线链路计量；本轮变更不要求这些专项。没有发现复测后仍未解决的本轮产品故障。