调试 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 2 上。

在手表上启用开发者选项

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

  1. 打开手表的设置
  2. 依次点按系统 > 关于 > 版本
  3. 点按 Build 号七次。
  4. 系统会显示一条消息,确认您现在处于开发者模式。

通过 Wi-Fi 调试

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

将手表连接到 Wi-Fi 网络

  1. 打开手表的设置
  2. 依次点按连接 > Wi-Fi
  3. 选择一个网络并根据需要输入密码。

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

启用 Wi-Fi 调试

  1. 打开手表的设置
  2. 依次点按开发者选项 > 通过 WLAN 调试
  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 项目 Android tool for Mac 在 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 网站。