feat: add optional Windows virtual USB ADB device
This commit is contained in:
1 parent
2abfb63da9
commit
08d60de364
23 files changed
+802
-26
No files matched your search
@@ -14,6 +14,7 @@
|
||||
| 目录 | 作用 | 主要语言/格式 |
|
||||
| --- | --- | --- |
|
||||
| `agent/` | 远程设备守护程序 ads-agent,注册设备、连接手机 ADB、建立转发并重连;源码在 `src/` | Rust、TOML |
|
||||
| `usb/` | 可选 ads-usb 本机虚拟 ADB USB 设备,提供回环 USB/IP、描述符和 ADB 帧适配;Windows 使用已签名 USBip 虚拟控制器 | Rust、TOML |
|
||||
| `client/` | 本地守护程序 ads-client,维护设备租约、监听本地端口并自动调用 adb connect;源码在 `src/` | Rust、TOML |
|
||||
| `server/` | ads-server 控制中心、旧协议兼容转发及独立 ads-relay 中继节点 | Go |
|
||||
| `server/cmd/ads-relay/` | 独立中继入口,提供短期票据认证、WSS 数据配对及可选 STUN | Go |
|
||||
@@ -41,9 +42,9 @@
|
||||
|
||||
桌面项目下的 `bin/`、`obj/` 同样是 .NET 生成的构建产物与中间文件,已被 Git 忽略。根目录的 `adb_bridge.py` 与 `start-bridge.ps1` 是旧局域网桥接入口,分别使用 Python 和 PowerShell,不属于上述目录。
|
||||
|
||||
## 可选 USB 模拟功能(方案记录,尚未实现)
|
||||
## 可选 USB 模拟功能(Windows 已开始实现)
|
||||
|
||||
用户要求:将跨平台 USB 模拟的可行性与产品设计记录在此,当前不进行实现。以下内容是后续开发的设计依据,不代表现有产品已经支持。未经用户后续要求,不因本文件而启动驱动、桥接或 UI 开发。
|
||||
用户于 2026-11-12 授权新增可选 USB 模拟,先实现 Windows。当前采用独立 Rust USB/IP 虚拟 ADB 设备 + 已签名的 USBip UDE 控制器,复用现有网络隧道,包含桌面开关、驱动检测和安装脚本;详见 docs/windows-usb.md。Linux/macOS 仍仅记录方案,未经后续要求不实现其后端。以下跨平台内容保留为设计依据。
|
||||
|
||||
### 目标与范围
|
||||
|
||||
@@ -84,7 +85,7 @@
|
||||
|
||||
| 平台 | 候选路线 | 成本与限制 |
|
||||
| --- | --- | --- |
|
||||
| Windows | 使用 UDE 模拟 USB 控制器/ADB USB 设备,并连接本机桥接服务 | 需要内核驱动开发、驱动签名、管理员安装、ADB 接口绑定和兼容性验证 |
|
||||
| Windows | 使用已签名 USBip UDE 控制器 + 本项目虚拟 ADB USB/IP 设备 | 已实现并验证 USB 枚举与远程 shell;安装控制器需管理员权限,不自行编写内核驱动 |
|
||||
| Linux | 使用 USB/IP 的 `vhci_hcd`,配合模拟 ADB USB 设备的服务 | 需要内核模块支持、权限配置、USB/IP 请求适配及发行版兼容性验证 |
|
||||
| macOS | 使用 `IOUSBHostControllerInterface` 实现虚拟 USB 控制器 | 需要向 Apple 申请 `com.apple.developer.usb.host-controller-interface` 受管理 entitlement;获批与实际验证前不承诺正式支持 |
|
||||
|
||||
@@ -96,14 +97,14 @@ macOS 是正式交付的最大不确定性。不能把存在 API 或实验原型
|
||||
- MTP 文件传输、fastboot 以及其他 USB 功能不自动获得支持,需要独立设计与实现。
|
||||
- 不将该方案描述为整台手机所有 USB 功能的透明透传。
|
||||
|
||||
### 后续分阶段验证(尚未启动)
|
||||
### 原跨平台分阶段方案(Windows 验证进度见 docs/windows-usb.md)
|
||||
|
||||
1. 检查现有转发协议层、设备端接入方式,以及可复用的隧道和设备生命周期管理能力。
|
||||
2. 优先完成 Windows、Linux 的最小原型验证,确认原版 ADB 能发现模拟设备并建立 USB transport。
|
||||
3. 同期为 macOS 申请必要 entitlement 并验证原型;权限和兼容性验证通过后,再列为正式支持。
|
||||
4. 验证 ADB 命令、USB 筛选、目标第三方软件、多设备、断线重连及组件安装/卸载行为,再决定正式产品范围。
|
||||
|
||||
当前仅记录设计,不修改运行逻辑,不添加驱动或安装组件,不启动上述验证工作。
|
||||
当前 Windows 实现以 docs/windows-usb.md 的范围及验证记录为准;其余平台仍仅记录设计。
|
||||
|
||||
### 参考资料
|
||||
|
||||
|
||||
Reference in new issue
Block a user