调试 Wear OS 应用

如需调试 Wear OS 应用,请使用 Wi-Fi 或蓝牙将开发机器连接到手表。如果您的手表有 USB 端口,也可以通过 USB 进行连接

在手表上启用开发者选项

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

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