调试 Wear OS 应用

如需调试您的 Wear OS 应用,您可以按照本页中所述,通过 WLAN 或蓝牙将开发机器连接到手表。如果您的手表有 USB 端口,您可以通过 USB 连接

在手表上启用开发者选项

您必须先启用开发者选项,才能在手表上进行调试。您只需执行此操作一次。开发者选项将保持启用状态,直到您将其停用。

  1. 打开手表的设置
  2. 依次点按系统 > 关于
  3. 滚动到版本号并点按版本号七次。
  4. 将出现一个对话框,确认您现在已处于开发者模式。

通过 WLAN 调试

在开始调试前,确保您已在手表上启用开发者选项

将手表连接到 WLAN 网络

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

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

启用 WLAN 调试

  1. 打开手表的设置
  2. 依次点按开发者选项 > 通过 WLAN 调试
  3. 片刻后,屏幕将显示手表的 IP 地址(例如 192.168.1.100)。下一步中会用到它,因此请记录下来。

将调试程序连接到手表

  1. 确保您的手表和开发计算机连接到同一网络。
  2. 使用手表的 IP 地址,将调试程序连接到手表。例如,如果 IP 地址是 192.168.1.100,adb connect 命令及其响应将如下所示(向地址中添加了端口号 5555):

        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>
    

通过蓝牙调试

蓝牙调试仅适用于 Android 配对手表。在开始调试前,确保手表和手机已配对,并且您已在手表上启用开发者选项。您还应确保在手机上也启用了开发者选项。要进行检查,请打开手机的设置菜单,选择关于手机并点击版本号七次。

在手机上启用 USB 调试

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

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

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

在手机上启用蓝牙调试

  1. 在手机上,打开 Wear 配套应用。
  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 配套应用中的状态显示。它应如下所示:
        Host: connected
        Target: connected
        
  5. 手表现已连接到调试程序,您可以随时开始调试。

使用蓝牙调试手表时,adb 始终使用 IP 地址 127.0.0.1 外加您指定的端口。因此,所有 adb 命令都采用以下格式(仍按上例,端口为 4444):

adb -s 127.0.0.1:4444 <command> 

如果您不是使用模拟器,并且只连接了一个设备进行调试,则根本不需要指定地址:

    adb <command>
    

对 Wear 使用 screenrecord

如果在 macOS® 上开发,您可以使用 GitHub 项目(即适用于 Mac 的 Android 工具)从 Wear 设备上录制视频。

或者,您也可以按照以下步骤从 Wear 设备上录制视频:

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