调试 Wear OS 应用

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

在手表上启用开发者选项

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

  1. 打开手表的设置
  2. 依次点按系统 > 关于
  3. 滚动到版本号并点按版本号七次。
  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,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>

通过蓝牙调试

注意:蓝牙调试仅适用于搭载 Wear OS 2 的 Android 配对手表。

在开始之前,请将手表和手机配对,并在手表上启用开发者选项。检查手机上是否已启用开发者选项。要进行检查,请打开手机的设置菜单,选择关于手机并点击 build 号七次。

在手机上启用 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 网站。