WLAN 调试

大约 3 分钟

名词解释

在 Android 上有两种通过网络进行调试的方法，分别叫「通过 WLAN 调试」和「无线调试」。

通过 WLAN 调试 (Debug Over WLAN, 网络调试) 指的是在部分设备中引入，或者可以手动使用命令开启的一种调试方式。用于快速调试难以通过数据线连接的设备，比如说手表和电视。
默认端口号为 5555。您只需要打开设备的开发者选项，启用 WLAN 调试，并使用 IP 地址 (或加上冒号和端口号) 即可连接并调试。
如果是默认端口号，则直接输入 IP 地址就可以连接。在下文中，统一称为「WLAN 调试」。
但是，由于安全性问题和新增的无线调试，谷歌已经不再推荐使用原版 WLAN 调试，新系统已经删除了 WLAN 调试。
无线调试 (Wireless Debugging) 则是在 Android 11 中新增的一种调试方式，是 WLAN 调试的增强版，用来替代 WLAN 调试。
与 WLAN 调试相同，无线调试也是通过 Wi-Fi 进行调试，但是您需要先配对才能连接。
无线调试的优势在于它使用了安全的加密连接来配对设备，并且很多 Android 11+ 设备都自带。
如果您可以找到无线调试的选项，那么您可以使用无线调试快速连接设备。否则您暂时只能通过数据线手动打开 WLAN 调试。

已弃用

在 2023 年 5 月发布的 Wear OS 4 中，删除了 WLAN 调试。
如果您的设备支持无线调试，建议您学习如何使用无线调试。

前置条件

您需要确保您的手表和手机在同一个 Wi-Fi 网络中，随后在设备的开发者选项中启用无线调试。

进入手表的系统设置，进入关于手表界面，找到软件信息或软件版本，在版本号信息上点击 7 次，打开开发者模式。
- 不同设备的开发者模式打开方式可能不同，您可以在网上搜索「开发者模式」+「您的设备型号」，找到对应的开发者模式打开方式。
针对三星手表、小米手表和华为手表，请直接参见三星手表、Wear OS 2 、Wear OS 3 原生和华为手表查看具体的开发者模式打开方式。
返回并进入开发者模式，点击「ADB 调试」并启用，然后找到「通过 WLAN 调试」，点击按钮打开。

提示

如果您的设备没有「通过 WLAN 调试」选项，也没有「无线调试」的选项，那么您可以尝试使用 USB 线缆连接设备。

如果设备是 Android 11+，我们非常建议您使用无线调试，会更加方便快捷。

在手机上打开 WearOS 工具箱。请不要打开「使用配对码连接」功能。
在「通过 WLAN 调试」下方将会看到一个或多个 IP 地址，请选择其中一个最短的 IP 地址。如果末尾是 5555，则只需要输入 IP 地址就可以不需要输入端口号。
如果您不理解，您也可以进入系统设置，进入 WLAN，点击已连接上的 Wi-Fi 网络，在里面即可找到设备的 IP 地址；您也可以进入路由器后台查看设备的 IP 地址。
在手表上授权连接。请勾选「总是允许」后连接，以方便接下来的使用。
完成授权后，请再次点击工具箱的「连接」按钮，手表将会建立连接。
检查是否已经连接上手表，随后根据设备型号和系统决定是否打开工具箱的连接兼容性功能。