對 Wear OS 應用程式進行偵錯

如要對實體手錶上的 Wear OS 應用程式偵錯，請使用 Wi-Fi 或藍牙將開發機器連線至手錶。如果手錶有 USB 連接埠，也可以透過 USB 連線。

如果應用程式需要支援跨多部裝置運作的工作流程，例如在手錶和手機上運作，您也可以測試這類支援功能。如要進一步瞭解如何設定連線及進行測試，請參閱「將手錶連線至手機」。

注意：如果沒有實體手錶，也可以在 Android Studio 的模擬器上測試及執行應用程式。

升級至最新版 Wear OS

為確認應用程式可在最新版軟體上正常運作，請檢查測試裝置是否搭載裝置支援的最新版 Wear OS。

如要在測試裝置上檢查是否有系統更新，請完成下列步驟：

  1. 將裝置連上 Wi-Fi 網路。
  2. 開始為裝置充電。
  3. 等待裝置充電至 50% 以上。

  4. 在測試裝置上，依序前往「設定」>「系統」>「系統更新」。

    如果有可用的系統更新，會下載並安裝到測試裝置上。

安裝 Wear OS 特定版本 (選用)

如果應用程式的測試案例需要使用 Wear OS 特定版本，您可以將軟體映像檔刷新至支援 USB 數據連線的手錶上。舉例來說，您可以將原廠映像檔或完整 OTA 映像檔刷新至 Google Pixel Watch 2 上。

在手錶上啟用開發人員選項

在手錶上偵錯前，請先啟用開發人員選項。這個步驟只需要執行一次。開發人員選項會保持啟用狀態，直到您停用為止。如要啟用開發人員選項，請按照下列步驟操作：

  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. 在 Wear OS 裝置上，找到系統中的無線偵錯選項 可以管理叢集設定，像是節點 資源調度、安全性和其他預先設定項目選取「配對新裝置」。
  2. 記下 Wi-Fi 配對碼、IP 位址和通訊埠。
  3. 在開發機器的終端機視窗中輸入以下內容 指令： 
    adb pair IP_ADDRESS:PORT
  4. 當系統提示時，輸入步驟 2 的 Wi-Fi 配對碼。終端機會輸出配對是否成功。例如： 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
，瞭解如何調查及移除這項存取權。 配對完成後，主機電腦會顯示在「配對裝置」清單中。 Wear OS 裝置的「Wireless Debugging」畫面。

將偵錯工具連線至手錶

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