對 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,通訊埠編號為 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. 輸入連線指令後,手錶會要求您確認是否允許 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 網站。