调试 Wear OS 应用

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

如果您的应用需要支持多设备工作流(例如手表和手机),您还可以测试这些工作流。要详细了解如何设置连接进行测试,请访问将手表连接到手机

注意:如果您没有实体手表,也可以在 Android Studio 中通过模拟器测试并运行您的应用

更新到最新版 Wear OS

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

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

  1. 将设备连接到 Wi-Fi 网络。
  2. 开始为设备充电。
  3. 等待设备电池电量达到 50% 或更高。
  4. 在测试设备上,依次转到设置 > 系统 > 系统更新

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

安装特定版本的 Wear OS(可选)

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

在手表上启用开发者选项

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

  1. 打开手表的设置
  2. 依次轻触系统 > 关于 > 版本
  3. 轻触版本号项七次。
  4. 此时会出现一条消息,确认您现在是开发者。

通过 Wi-Fi 调试

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

将手表连接到 Wi-Fi 网络

  1. 打开手表的设置
  2. 轻触连接 > Wi-Fi
  3. 选择网络并输入密码(如果需要)。

    注意:手表和您的开发机器必须连接到同一网络。并非所有接入点都适用。您可能需要使用防火墙配置正确以支持 adb 的接入点。

启用 Wi-Fi 调试

  1. 打开手表的设置
  2. 轻触开发者选项 > 通过 Wi-Fi 调试
  3. 片刻之后,屏幕会显示手表的 IP 地址,例如 192.168.1.100。下一步需要用到它,请记下它。

将调试器与手表配对

  1. 在您的 Wear OS 设备上,在系统设置中找到无线调试选项。选择配对新设备
  2. 记下Wi-Fi 配对码IP 地址和端口
  3. 在开发机器的终端窗口中,输入以下命令:
    adb pair IP_ADDRESS:PORT
  4. 出现提示时,输入第 2 步中的 Wi-Fi 配对码。终端将输出配对是否成功。例如:
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
配对后,主机电脑会显示在您的 Wear OS 设备“无线调试”屏幕上的“已配对设备”列表中。

将调试器连接到手表

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

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

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

  1. 打开手表的设置菜单。
  2. 滚动到开发者选项
  3. 确认ADB 调试已启用。
  4. 启用通过蓝牙调试

在手机上启用蓝牙调试

  1. 在手机上,打开 Wear OS 配套应用。
  2. 滚动到高级设置并轻触以查看高级设置选项。
  3. 启用通过蓝牙调试。该选项下方会出现以下状态消息:
    Host: disconnected
    Target: connected
    

此时,开发机器(主机)未与手表(目标)通信。您需要完成链接。

注意:您一次只能调试一台设备。如果您配对了多只手表,蓝牙调试仅在主屏幕上选择的设备上启用。

将调试器连接到手表

在最后一步中,您将使用所有组件:调试器、手机和手表。

  1. 使用 USB 线将手机连接到您的开发机器。
  2. 在调试器中运行以下两个命令:
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect 127.0.0.1:4444
    

    注意:您必须使用 IP 地址 127.0.0.1。在开发机器上使用任何可用的端口,并在两个命令中使用相同的端口。在本例中,端口为 4444。

  3. 输入 connect 命令后,手表会要求您确认是否允许ADB 调试
  4. 在手机上,检查 Wear OS 配套应用中的状态显示是否符合以下情况:
    Host: connected
    Target: connected
    
  5. 手表现已连接到调试器,您可以开始调试了。

当您使用蓝牙调试手表时,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 设备录制视频:

  1. 在手表上录制原始帧
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. 将原始文件复制到您的开发机器
    adb pull /sdcard/video.raw video.raw
  3. 使用 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 网站。