對 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. 依序輕觸「開發人員選項」>「透過 Wi-Fi 連線進行偵錯」
  3. 片刻後螢幕會顯示手錶的 IP 位址 (例如 192.168.1.100)。 以便在後續步驟中使用,因此請特別留意。

將偵錯工具連線至手錶

  1. 將手錶和開發機器連上相同的網路。
  2. 使用手錶的 IP 位址將偵錯工具連線至手錶。舉例來說,如果 IP 位址為 192.168.1.100,則 ADB 連線指令及其回應應如下所示 (通訊埠號碼,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 配對手錶。

在開始之前,請先將智慧手錶和手機配對,然後在手錶上啟用開發人員選項。確認手機已啟用開發人員選項。如要確認,請開啟手機的「設定」選單並選取「關於手機」,然後點選版本號碼七次。

在手機上啟用 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. 輸入連線指令後,請查看手錶。系統會要求您確認允許執行 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 網站。