Android NDK开发详解Wear之调试 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 2 上。

在手表上启用开发者选项

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

打开手表的设置。
依次点按系统 > 关于 > 版本。
点按 Build 号七次。
系统会显示一条消息，确认您现在处于开发者模式。
通过 Wi-Fi 调试
在开始之前，在手表上按照上文所述步骤启用开发者选项。

将手表连接到 Wi-Fi 网络

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

启用 Wi-Fi 调试

打开手表的设置。
依次点按开发者选项 > 通过 WLAN 调试。
片刻后，屏幕会显示手表的 IP 地址，例如 192.168.1.100。执行下一步时会用到它，因此请记录下来。

将调试程序连接到手表

将您的手表和开发机器连接到同一网络。
使用手表的 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。

输入 connect 命令后，手表会提示您确认是否允许 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 tool for Mac 在 Wear OS 设备上录制视频。

或者，您也可以按照以下步骤在 Wear OS 设备上录制视频：

在手表上录制原始帧：

Kadb 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 网站。

请参阅以下相关资源：

Android 调试桥 (adb)
调试应用
设计原则
截取 Wear 界面屏幕
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2023-11-02。