# 安卓四栏界面与连接体验优化

App：0.2.0，versionCode 3，debug 签名。设备协议主版本保持 1，设备发布版本仍为 1.1.1；功能时间为 2026-09-26T14:30+08:00。未导出 OTA 或 IMG。

## 实现范围

四栏导航、设备与 WiFi 顶部摘要、保存设备及长按管理、已连接时独立扫描、GATT RSSI、精简共享预览、设备持久内容排序、中文设置、折叠 WiFi 表单、DHCP/静态字段、立即生效确认、密码保留/替换、关于与手机昵称设置已实现。设备端增加保守的脱敏 WiFi 失败分类，密码不回读。需求、详细设计、兼容记录及 root 测试规则已同步。

## 已完成验证

- 仓库外独立复制构建：JVM 13 项通过；主 APK、测试 APK、Android lint 通过（无错误，16 项工具链、资源与代码建议警告）。源码摘要匹配，debug 签名校验通过。
- 设备相关业务与协议回归：46 项通过；隔离复制后同组 46 项通过。手机登记门禁单测 8 项通过。仓库卫生检查通过。
- 登记手机 android-test-a：ADB 与 root 门禁通过，所有自动点击、滑动及输入经 root；语义节点仅用于读取目标实时位置。
- 约 340dp 宽度，字体 1.0/1.3 的竖屏及字体 1.3 横屏：四栏、三点菜单和关于操作通过，分别 8.656/8.983/9.191 秒。字体、旋转、密度均恢复。该检查验证可见控件及操作，不代表所有设备布局均已验证。
- 实际 Activity：91.814 秒通过。四栏、精简页面、菜单、后台 30 秒释放及返回重连、永久昵称写入后重新连接、恢复原昵称、取消记忆后断开及手动重新连接通过。
- 最新完整 BLE 真机回归：301.514 秒通过。60 轮状态和画面读取，设备持久混合内容顺序摘要一致，两次加密会话、配置冲突后会话保持、当前 WiFi 立即重应用并保留密码、原动画暂停/位置/速度恢复、亮度当前值写入、默认内容读回、Controller 内容/设置读取、后台释放及前台重连均通过。
- 最新 root 真机 WiFi 专项通过：validate、validate_invalid、scan、wrong、inspect_failure。扫描填入、确认取消不提交、密码替换输入、明确 AUTH_FAILED 与“密码错误”中文反馈通过。错误后核对原网络配置摘要及连接，日志不含测试密码，恢复备份/定时器和私有测试材料已清理。
- WiFi 表单先前实测通过：空名称不能保存、DHCP 关闭展开静态字段、确认弹窗、取消不提交、非法 IP 拒绝；此过程未改变原网络。
- 真实 systemd stop/start：运行目录保留、配置/网络/持久身份摘要不变、移动接口恢复及无遗留手机会话均通过。

## 失败与修复记录

布局测试初版的直接命令引号不被 UiAutomation 解释，随后显示配置变更终止 instrumentation；改由电脑端调整并在 finally 恢复，启动测试后仅读取语义位置和 root 输入。重复文字选择改为可见节点定位后，三种布局通过。没有使用无障碍动作注入。

WiFi 专项首次 wrong 阶段在提交前建立 BLE 失败；未把此失败算作密码测试。正常阶段增加显式断开并在无手机会话下恢复服务后重跑，各阶段通过。

最新 Activity 首次未找到扫描目标，51.460 秒失败；真实服务生命周期恢复后重测通过。保留失败，不声称已定位此偶发问题的根因。

## 边界

真实多设备切换需要两台可用设备，本轮仅模拟验证；旧 Android 版本未实测。跨 SSID、实际 DHCP/静态地址互换缺少可用第二网络，未验证。驱动与底层显示输出未修改，实屏视觉检查不适用；未启动摄像头、未主动切换测试图案。

## 交付

见 `../构建与发布/交付包/0.2.0-3/`。SHA-256、北京时间构建日期、工具链和源码摘要见 manifest.json 与 SHA256SUMS。最终 verify 阶段通过：App 显示原网络及实际 IP，板端原网络连接、服务运行、恢复材料清理均核验通过。测试手机最终覆盖安装 0.2.0 / code 3，读取已安装 base.apk 的 SHA-256 与交付 APK 完全一致。最后仓库卫生检查通过（579 个候选文件），未输出秘密值。

## 可复用经验同步

本轮已验证处理方法已整理到 [常见问题与排障](../如何安卓测试/常见问题与排障.md)，并同步测试流程、构建说明及根/移动端协作规则。包括命令解析与 LF、布局变更导致测试终止、可见语义节点选择、Compose 开关定位、root 文本编辑和键盘判断、权限安装后复核、阶段主动断开及 WiFi 定时恢复。偶发扫描失败的根因仍未确认；本记录不将服务恢复后通过当作根因证明。后续每轮测试完成反馈都要说明经验文档更新。