调试 Wear OS 应用

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

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

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

更新到最新版本的 Wear OS

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

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

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

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

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

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

在手表上启用开发者选项

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

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

通过 Wi-Fi 进行调试

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

将手表连接到 Wi-Fi 网络

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

启用 Wi-Fi 调试

打开手表的设置。
点击开发者选项 > 通过 Wi-Fi 调试。
稍等片刻，屏幕上将显示手表的 IP 地址，例如192.168.1.100。您需要此 IP 地址才能执行下一步操作，因此请记下它。

将调试器与手表配对

在您的 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 项目适用于 Mac 的 Android 工具录制 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网站。

请参阅以下相关资源