用途
该技能用于在没有 USB 线缆的情况下将 Android 设备连接到 ADB。核心场景是使用 Android 11 引入的无线调试配对流程（adb pair），以及作为兼容方案保留的旧式 adb tcpip 路径。适用于希望无线部署、调试应用的开发者，也可用于排查配对后无法连接的问题。
主要能力
- 现代
adb pair流程：Android 11（API 30）及以上的手机/平板、Android 13（API 33）及以上的 TV 与 Wear OS 支持无线调试。流程为：在设备端开启 设置 → 开发者选项 → 无线调试，选择「使用配对码配对设备」，记下显示的 IP:PORT 与六位配对码，然后在工作站执行adb pair <host:port>并输入配对码。二维码配对使用同一协议。 - 连接调试端口：配对端口是一次性的。配对成功后设备会暴露另一个用于实际调试的 IP:PORT，需用
adb connect连接该端口，再用adb devices确认状态为device。adb disconnect [<host:port>]可断开单个或全部 TCP 设备。 - mDNS 自动发现：ADB 服务器可发现已配对设备并自动连接。
adb mdns check显示 mDNS 守护进程版本，adb mdns services列出发现的服务。服务类型包括_adb._tcp（旧式 tcpip）、_adb-tls-pairing._tcp（临时配对端口）、_adb-tls-connect._tcp（配对后的调试端口，默认自动连接，由ADB_MDNS_AUTO_CONNECT=adb-tls-connect控制）。 - mDNS 后端选择：文档默认 Bonjour，但 ADB v34+ 在 Linux/Windows 上默认切换为 Openscreen。可用
ADB_MDNS_OPENSCREEN=1 adb start-server强制 Openscreen，或=0强制 Bonjour。 - 旧式
adb tcpip路径：仅在无法配对时使用。需先用 USB 连接并确认设备，执行adb tcpip 5555，拔掉 USB 后adb connect 192.168.1.42:5555。
使用方式与排查
连接失败时按顺序排查：确认两端在同一 SSID 与 VLAN/子网；公司 Wi-Fi 可能阻止 p2p 连接；若 mDNS 被禁用，改用 adb connect <ip:port> 手动连接；出现 connection refused 通常是无线调试端口已关闭或误用了配对端口，需重新开启并重新配对；Wi-Fi 切换或断网会导致自动断开，需重连网络。
适用场景
- 无线部署可调试应用到多台远程设备。
- 通过无线传输运行插桩测试（参见
../../tests/running-instrumented-tests-via-adb/SKILL.md）。 - 排查
adb mdns check中 Bonjour 与 Openscreen 的困惑。
限制与安全
无线 ADB 属于「信任局域网」的功能。任何能访问网络并拿到配对码的人都可以配对；配对后由密钥控制访问；建议不使用时在设置中关闭无线调试以立即关闭监听套接字；避免在公共/咖啡馆/酒店 Wi-Fi 上使用；旧式 adb tcpip 是未认证的开放 TCP 监听，应优先使用 adb pair。
前提条件
工作站与设备处于同一 Wi-Fi 网络；手机/平板需 Android 11+，TV/Wear OS 需 Android 13+；需有可用的 ADB 服务器；设备端需开启无线调试。资料未提供其他平台或收费信息。