59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# 66 修复旧 Wi-Fi 设备恢复失败时无法搜索 USB 设备
|
||
|
||
- 类型：缺陷
|
||
- 父级大工单：#1
|
||
- 所属 MVP / 版本：#2 Client 可运行任务闭环（MVP）
|
||
- 状态：已完成，待用户验收
|
||
- 日期：2026-08-09
|
||
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/66
|
||
|
||
## 背景与目标
|
||
|
||
Client 保存了不可连接的旧 Wi-Fi ADB 地址时，点击“搜索”会在恢复旧设备失败后
|
||
直接结束，导致 `adb devices -l` 已经识别的 USB 设备也无法显示。本任务让局部
|
||
恢复失败不再中断普通设备搜索。
|
||
|
||
## 最终方案
|
||
|
||
- 后台 Worker 仍先尝试恢复已保存设备。
|
||
- 恢复失败时保存警告文字，并继续调用普通设备搜索。
|
||
- 搜索成功结果同时携带实际设备列表和可选恢复警告。
|
||
- 主线程先刷新实际设备表格，再提示旧设备恢复失败、配置已保留。
|
||
- 只有普通设备搜索也失败时才显示“搜索失败”并保留旧表格。
|
||
- 不自动删除或改写已保存设备，不改变保存、删除和 USB 转 Wi-Fi 流程。
|
||
|
||
## 改了哪些
|
||
|
||
- `client/src/android_device_service.py`：增加包含设备列表和恢复警告的简单结果对象。
|
||
- `client/src/settings_ui_event.py`：恢复失败后继续搜索，并区分警告与整体失败。
|
||
- `client/test/test_settings_ui_event.py`：补充恢复失败后的 USB、空结果和整体失败测试。
|
||
- `docs/client/05-ui-specification.md`：记录设备搜索的容错与反馈规则。
|
||
|
||
## 验收结果
|
||
|
||
| 验收标准 | 结果 |
|
||
|---|---|
|
||
| 已保存 Wi-Fi 在线时正常恢复并自动勾选 | 通过 |
|
||
| 旧 Wi-Fi 离线但 USB 在线时仍显示 USB | 通过 |
|
||
| 旧 Wi-Fi 离线且无其他设备时显示空表和恢复警告 | 通过 |
|
||
| 普通设备枚举失败时保留旧表格并显示搜索失败 | 通过 |
|
||
| ADB 操作继续在工作线程执行 | 通过 |
|
||
| 已保存配置不被自动修改或删除 | 通过 |
|
||
|
||
## 测试
|
||
|
||
- 执行的命令：
|
||
- `C:/Python310/python.exe -m unittest discover -s test -p test_settings_ui_event.py -v`
|
||
- `C:/Python310/python.exe -m unittest discover -s test -v`
|
||
- `C:/Python310/python.exe -m py_compile src/android_device_service.py src/settings_ui_event.py`
|
||
- 设置 `QT_QPA_PLATFORM=offscreen` 后创建并关闭 `MainWindow`
|
||
- 使用当前保存的旧 Wi-Fi 地址运行 `AndroidDeviceSearchWorker`，观察恢复警告和设备结果
|
||
- 结果：设置页 37 项测试通过；Client 全量 183 项测试通过；语法检查通过；
|
||
离屏冒烟输出 `OK`；旧 Wi-Fi 恢复超时后仍返回 USB 设备 `30167b23`。
|
||
- **没验证到的部分**：尚未由用户在可见 Client 界面点击“搜索”完成最终交互验收；
|
||
没有测试可正常连接的真实 Wi-Fi 手机，仅由自动化测试覆盖该分支。
|
||
|
||
## 相关提交
|
||
|
||
- `ff8cdd7` 修复 Wi-Fi 恢复失败后继续搜索设备
|