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。建议先更新实际守护程序,再从桌面端开启。
|
||||
Reference in new issue
Block a user