调试 Wear OS 应用

要在实际手表上调试您的 Wear OS 应用，请使用 Wi-Fi 或蓝牙将您的开发机器连接到手表。或者，如果您的手表有 USB 端口，使用 USB 连接。

如果您的应用需要跨多个设备（例如手表和手机）支持，您还可以测试跨多个设备的工作流程。要详细了解如何设置用于测试的连接，请访问将手表连接到手机。

注意： 如果您没有实际手表，您也可以在 Android Studio 中测试和运行您的应用。

更新到最新版本的 Wear OS

为了帮助验证您的应用在最新软件上是否按预期运行，请检查您的测试设备是否运行设备支持的最新版本的 Wear OS。

要在测试设备上检查系统更新，请完成以下步骤

将设备连接到 Wi-Fi 网络。
开始为设备充电。
等待设备的电池电量充至 50% 或更高。
在您的测试设备上，导航至 设置 > 系统 > 系统更新。

如果有系统更新可用，它将被下载并安装到您的测试设备上。

安装特定版本的 Wear OS（可选）

如果您的应用测试用例依赖于特定版本的 Wear OS，您可以在支持 USB 数据连接的手表上刷入软件镜像。例如，您可以在 Google Pixel Watch 2 上刷入工厂镜像或完整 OTA 镜像。

在手表上启用开发者选项

在您可以在手表上进行调试之前，请启用开发者选项。您只需执行一次此操作。开发者选项将一直处于启用状态，直到您将其禁用。要启用开发者选项，请执行以下操作：

打开手表的 **设置**。
点击 **系统 > 关于 > 版本**。
点击 **版本号** 项目七次。
将显示一条消息，确认您现在已成为开发者。

通过 Wi-Fi 进行调试

在开始之前，请如前所述在手表上启用开发者选项。

将手表连接到 Wi-Fi 网络

打开手表的 **设置**。
点击 **连接 > Wi-Fi**。
选择一个网络，并在必要时输入其密码。
注意：手表和您的开发机器必须连接到同一个网络。并非所有接入点都适合。您可能需要使用防火墙配置正确的接入点来支持 adb。

启用 Wi-Fi 调试

打开手表的 **设置**。
点击 **开发者选项 > 通过 Wi-Fi 进行调试**。
片刻之后，屏幕将显示手表的 IP 地址，例如 192.168.1.100。您需要此地址以进行下一步操作，请将其记录下来。

将调试器与手表配对

在您的 Wear OS 设备上，在系统设置中找到无线调试选项。选择 **配对新设备**。
记下 **Wi-Fi 配对码** 和 **IP 地址和端口**。
在您的开发机器上的终端窗口中，键入以下命令
```
adb pair IP_ADDRESS:PORT
```
出现提示时，输入步骤 2 中的 Wi-Fi 配对码。终端将输出配对是否成功。例如：
```
Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
```

配对后，主机电脑将出现在您的 Wear OS 设备的 **无线调试** 屏幕上的 **配对设备** 列表中。

将调试器连接到手表

将手表和开发机器连接到同一个网络。
使用手表的 IP 地址和端口号将调试器连接到手表。例如，如果 IP 地址是 192.168.1.100，端口号是 5555，则 adb connect 命令及其响应如下所示
```
adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555
```

手表现在已连接到调试器，您可以开始调试了。使用 -s 标志向手表发送 adb 命令，指定手表的 IP 地址和端口号

adb -s 192.168.1.100:5555 <command>

如果您没有使用模拟器，并且只有一个设备连接到调试器，则无需指定地址

adb <command>

通过蓝牙进行调试

注意：蓝牙调试仅适用于运行 Wear OS 2 的 Android 配对手表。

在开始之前，请将手表和手机配对，并在手表上启用开发者选项，如前所述。通过打开手机的 **设置** 菜单并查找 **开发者选项** 来检查手机上是否启用了开发者选项。如果需要，请在手机上启用开发者选项。

在手机上启用 USB 调试

打开手机的 **设置** 菜单。
选择 **开发者选项** 并启用 **USB 调试**。

在手表上启用 ADB 或蓝牙调试

打开手表的 **设置** 菜单。
滚动到 **开发者选项**。
确认 **ADB 调试** 已启用。
启用 **通过蓝牙进行调试**。

在手机上启用蓝牙调试

在手机上打开 Wear OS 伴侣应用。
滚动到 **高级设置** 并点击以查看 **高级设置** 选项。
启用 **通过蓝牙进行调试**。以下状态消息将出现在该选项下方
```
Host: disconnected
Target: connected
```

此时，开发机器（主机）尚未与手表（目标）通信。您需要完成链接。

注意：您一次只能使用一个设备进行调试。如果您配对了多块手表，则蓝牙调试仅在主屏幕上选择的设备上启用。

将调试器连接到手表

在最后一步中，您将使用所有内容：调试器、手机和手表。

使用 USB 线将手机连接到开发机器。
在调试器中运行以下两个命令
```
adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444
```
注意：您必须使用 IP 地址 127.0.0.1。在您的开发机器上使用任何可用的端口，并在两个命令中使用相同的端口。在本例中，端口为 4444。
输入连接命令后，手表会要求您确认您是否允许 **ADB 调试**。
在手机上，检查 Wear OS 伴侣应用中的状态显示，查看以下内容
```
Host: connected
Target: connected
```

手表现在已连接到调试器，您可以开始调试了。

当您使用蓝牙调试手表时，adb 始终使用 IP 地址 127.0.0.1 加上您分配的端口。在本例中，端口为 4444。所有 adb 命令都使用以下格式

adb -s 127.0.0.1:4444 <command>

如果您没有使用模拟器，并且只有一个设备连接到调试器，则无需指定地址

adb <command>

使用 Wear OS 屏幕录制

如果您在 macOS 上开发，您可以使用 GitHub 项目 Android 工具 for Mac 从您的 Wear OS 设备录制视频。

或者，您可以使用以下步骤从您的 Wear OS 设备录制视频

在手表上录制原始帧

adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

将原始文件复制到您的开发机器
```
adb pull /sdcard/video.raw video.raw
```

使用 ffmpeg 将原始文件转换为 MP4

ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

注意：请参阅 FFmpeg 网站了解下载和安装说明。

请参阅以下相关资源