Add opt-in physical USB device enrollment and remembered choices in 0.2.7
This commit is contained in:
1 parent
dc29a20a41
commit
208d37b7d8
20 files changed
+515
-18
No files matched your search
@@ -129,7 +129,31 @@ Agent 对已配置且启用的 `adb_serial` 持续检查 ADB 列表,同一个
|
||||
|
||||
- 设备消失、`offline`、`unauthorized` 或 ADB server 不可达:撤销该手机的控制中心注册,关闭旧数据流及租约;Agent 管理连接继续保留,显示未就绪原因。
|
||||
- 手机重新在线并授权后:使用原设备 ID 自动注册,本地连接客户端可重新获取租约;不重启 Agent、不改写配置,不中断其他在线手机。
|
||||
- 手动停用的设备保持停用。发现新插入的未配置设备仍需通过“发现 ADB 设备”或 CLI 添加,不会自动公开新手机。
|
||||
- 手动停用的设备保持停用。默认仍需通过“发现 ADB 设备”或 CLI 添加新手机;0.2.7 可按 Agent 开启下述真实 USB 自动注册。
|
||||
- 使用 `target` 直连手机的配置不依赖本机 ADB 列表,注册前及每 5 秒检测 TCP 连接,单次检测超时 3 秒。TCP 可达仅表示端口可连接,不代表所有 ADB 命令必定成功。
|
||||
|
||||
工作台可能保留已建立的本地连接行,便于手机恢复后重连;该行会明确显示远端离线,不再沿用旧的 ADB 就绪提示。若 Agent 状态仍显示旧版本,请更新实际运行的守护程序,仅更新桌面 UI 不会替换已启动的 Agent。
|
||||
|
||||
## 可选真实 USB 自动注册(0.2.7)
|
||||
|
||||
默认关闭,每台 Agent 单独设置。两套桌面客户端的 Agent 管理提供“开启 USB 自动注册”“关闭 USB 自动注册”和“取消所选 USB 设备的忽略”。先选择目标 Agent,再操作;读取配置可查看当前开关、忽略列表及 ID 映射。关闭只停止自动添加,已配置的手机继续按原有方式工作。
|
||||
|
||||
无界面主机可使用 CLI(远程管理加 `--agent ID` 及管理员凭据):
|
||||
|
||||
```sh
|
||||
adsctl devices auto-usb on
|
||||
adsctl devices auto-usb off
|
||||
adsctl devices unignore USB_SERIAL
|
||||
adsctl config get
|
||||
```
|
||||
|
||||
对应 agent.json 字段:`auto_register_usb`(缺省 false)、`ignored_usb_serials`(删除后不再自动加入的序列号)与 `usb_device_ids`(序列号到稳定设备 ID 的映射)。保存和自动添加均经过校验及原子持久化;退出/重启保留这些记录。开启后约每 5 秒扫描一次物理 USB,并与 ADB 在线列表交叉确认;Windows 本机设备查询有 15 秒超时,查询失败只跳过本轮,不影响管理连接和已配置设备。
|
||||
|
||||
- 只处理 Agent 主机回环地址 ADB server 中状态为 `device` 的已授权手机。默认 127.0.0.1:5037,外部 ADB server 不自动注册。
|
||||
- Windows 通过 PnP 父设备链确认 USB 设备位于 PCI 物理控制器下;Linux 检查 sysfs 的 PCI USB 设备并排除 vhci。模拟器、网络 ADB、ADS 虚拟 USB 与无法确认物理来源的设备均不自动添加。Windows/Linux 的特殊非 PCI 控制器也会跳过,可手动添加;macOS 此开关尚未支持物理设备检测。
|
||||
- 新 ID 使用 Agent ID 与 USB 序列号的稳定散列并保存映射;拔插/重启不会换 ID。已手动添加的同序列号设备不会再添加一条,也不会覆盖其 ID 或停用状态。
|
||||
- 删除手机会保存忽略记录;停用保留设备条目和 enabled=false,两者均不会被扫描自动恢复。恢复忽略可用上述 CLI,或在“发现 ADB 设备”中选择手机再取消忽略;手动重新添加也会取消对应忽略。
|
||||
- 手机必须有可识别的 USB 序列号。序列号变化视为新设备;设备条目最多 128 个,历史映射与忽略列表各最多 512 条,并受配置文件 64 KiB 上限约束。
|
||||
- 自动注册不会执行 `adb tcpip`,也不改变现有 ADB 数据通道实现。若手机已在线但转发提示无法访问 adbd,请按原有部署要求准备手机调试端口;注册不代表所有后续命令一定成功。
|
||||
|
||||
操作复用现有 config_get/config_set,控制中心无需新增管理协议;Agent 本身必须更新到 0.2.7。建议先更新实际守护程序,再从桌面端开启。
|
||||
@@ -110,3 +110,13 @@ Port cleanup follow-up:
|
||||
- 本机 local-pc 已从 0.2.4 更新到 0.2.6,原程序备份在忽略的 work 目录,配置哈希保持一致。实测 ADB 列表为空时,Agent connected=false 并显示“ADB 未发现该设备”,管理 IPC 持续可用;本轮未要求插拔真实手机,恢复路径由真实三端集成测试覆盖。
|
||||
- 0.2.6 Windows Avalonia/Flutter Setup 与 Linux Agent/Avalonia/Flutter deb 已生成。Windows Avalonia 正式包启动检查通过;Linux Flutter 原生静态分析及 37 项测试通过,Linux Agent/Avalonia 正式 deb 的 6 项临时根安装/卸载测试通过。
|
||||
- Ubuntu 24.04 对正式 Flutter/Agent deb 的 6 项隔离安装测试通过;正式 Flutter deb 解包后在真实桌面会话执行 --package-check,输出 ADS_FLUTTER_PACKAGE_OK 并退出 0。
|
||||
|
||||
### 0.2.7:可选真实 USB 自动注册
|
||||
|
||||
- Agent 配置新增默认关闭的 auto_register_usb、ignored_usb_serials 与 usb_device_ids。后台扫描仅允许回环 ADB server 的 device 状态与原生物理 USB 清单的交集,排除模拟器、网络设备和 ADS 虚拟 USB;已有同序列号配置优先,不覆盖手动 ID/停用状态。
|
||||
- Windows PnP 查询实际运行通过;纯逻辑测试覆盖默认关闭、非物理来源排除、忽略、持久化 ID、停用、ADB 地址别名去重与非本机 ADB 排除。当前没有接入可用于插拔的新真实 USB 手机,因此尚未做真实新手机自动添加的插拔验收。
|
||||
- 真实控制中心、Agent 和 CLI 集成测试验证开启/关闭、删除写入忽略、取消忽略与过期配置拒绝;原设备离线注销、恢复、管理 IPC、受监督重启、多设备流隔离测试仍通过。
|
||||
- Flutter 38 项测试、静态分析,以及 Avalonia 30 项测试通过;Windows/Linux 管理界面均接入开启/关闭与取消忽略。策略操作使用配置比对,配置有并发修改时拒绝覆盖并提示刷新。
|
||||
- 本机 local-pc 已更新到最终 0.2.7,确认 auto_register_usb=false,配置哈希未变;运行程序与两套 Windows 发行目录 Agent 的 SHA256 一致。正式发布二进制的策略/上下线集成测试通过,Avalonia 正式包启动检查通过。
|
||||
- Windows 两套 Setup 与 Linux Agent/Avalonia/Flutter deb 已生成;Linux Agent/Avalonia 0.2.7 正式 deb 的 6 项临时根安装、版本和 CLI 链接回退测试通过。
|
||||
- Ubuntu 24.04 的正式 Flutter/Agent deb 也通过 6 项隔离安装测试;解包后的 Flutter GUI 在真实桌面会话输出 ADS_FLUTTER_PACKAGE_OK,退出 0。
|
||||
Reference in new issue
Block a user