若要在实体手表上调试 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
。下一步需要用到它,请记下它。
将调试器与手表配对
- 在您的 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
将调试器连接到手表
- 将手表和开发机器连接到同一网络。
使用手表的 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 项目 适用于 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
将原始文件转换为 MP4ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4
注意:有关下载和安装说明,请参阅 FFmpeg 网站。
请参阅以下相关资源: