如要對 Wear OS 應用程式進行偵錯,請使用 Wi-Fi 或藍牙將開發機器連線至手錶。或者,如果您的手錶有 USB 連接埠,請透過 USB 連線。
在手錶上啟用開發人員選項
您必須先啟用開發人員選項,才能在手錶上偵錯。這個步驟只須執行一次。開發人員選項會保持啟用狀態,直到您停用為止。若要啟用開發人員選項,請執行下列步驟:
- 開啟手錶的「設定」。
- 依序輕觸「系統」>「關於」。
- 捲動至「版本號碼」,然後輕觸版本號碼七次。
- 系統會顯示對話方塊,確認您是開發人員。
透過 Wi-Fi 連線進行偵錯
開始之前,請先按照之前所述,在手錶上啟用開發人員選項。
將手錶連上 Wi-Fi 網路
- 開啟手錶的「設定」。
- 依序輕觸「連線」>「Wi-Fi」。
- 選擇網路,並視需要輸入密碼。
注意:手錶和開發機器必須連上相同的網路。並非所有存取點都適合。您可能需要使用能正確設定防火牆的存取點,以支援
adb
。
啟用 Wi-Fi 偵錯功能
- 開啟手錶的「設定」。
- 依序輕觸「開發人員選項」>「透過 Wi-Fi 連線進行偵錯」。
- 稍後片刻,螢幕會顯示手錶的 IP 位址,例如
192.168.1.100
。請記下這些資訊,您將在下一個步驟中使用。
將偵錯工具連線至手錶
- 將手錶和開發機器連上相同的網路。
使用手錶的 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 偵錯功能
- 開啟手機的「設定」選單。
- 選取「開發人員選項」,並啟用「USB 偵錯」。
在手錶上啟用 ADB 或藍牙偵錯功能
- 開啟手錶的「設定」選單。
- 捲動至「開發人員選項」。
- 確認 ADB 偵錯已啟用。
- 啟用「透過藍牙偵錯」。
在手機上啟用藍牙偵錯功能
- 在手機上開啟 Wear OS 隨附應用程式。
- 捲動至「進階設定」,輕觸即可查看「進階設定」選項。
- 啟用「透過藍牙偵錯」。選項下方會顯示下列狀態訊息:
Host: disconnected Target: connected
此時開發機器 (主機) 無法與手錶 (目標) 通訊。您必須完成連結。
注意:一次只能透過一部裝置偵錯。如果您配對了多支手錶,則只有在主畫面上選取的裝置,才能啟用藍牙偵錯功能。
將偵錯工具連線至手錶
在最後一個步驟,您會用到所有工具:偵錯工具、手機和手錶。
- 使用 USB 傳輸線將手機連接至開發機器。
- 在偵錯工具中執行這兩個指令:
adb forward tcp:4444 localabstract:/adb-hub adb connect 127.0.0.1:4444
注意:您必須使用 IP 位址 127.0.0.1。在開發機器上使用任何可用的通訊埠,並在兩個指令中使用相同的通訊埠。在這個範例中,通訊埠是 4444。
- 輸入連線指令後,手錶會要求您確認是否允許 ADB 偵錯。
- 在手機上檢查 Wear OS 隨附應用程式顯示的狀態,如下所示:
Host: connected Target: connected
智慧手錶現已連線至偵錯工具,您隨時可以開始進行偵錯。
使用藍牙對手錶進行偵錯時,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 裝置上錄製影片:
- 在手錶上錄製原始影格:
adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
- 將原始檔案複製到開發機器:
adb pull /sdcard/video.raw video.raw
- 使用
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 網站。
請參閱下列相關資源: