在 Wear OS 上建立並執行應用程式

本頁面提供指南，協助您使用 Android Studio 範本建構第一個 Wear OS 應用程式。此應用程式會展示多種在 Wear OS 裝置上快速查看資訊的方法，並介紹在平台上開發應用程式的最佳做法。

閱讀本指南所需的基礎知識包括瞭解 Android 平台和 Android Studio IDE。如果您是 Android 新手，請先使用這個程式碼研究室建立應用程式。如要進一步瞭解 Android Studio 的功能，請參閱「認識 Android Studio」頁面。

注意：如要使用模擬器適用的最新系統映像檔，請安裝 Android Studio Hedgehog 以上版本。

建立 Wear OS 應用程式

下載並安裝最新版本的 Android Studio 後，請按照「New project」精靈的指示完成操作：

1. 開啟 Android Studio，然後依序點選「File」>「New」>「New Project」。系統會顯示「New Project」視窗。
2. 在「Templates」窗格中，選取「Wear OS」。接著在主要窗格中，選取「Empty Wear App」。
3. 為專案命名，然後按一下「Finish」。Android Studio 會下載必要的依附元件，並建構專案的初始版本。

4. 依序前往「Tools」>「SDK Manager」，然後安裝下列兩個套件：

   • Android 14.0 ("UpsideDownCake) (API 級別 34)，其中包含 Wear OS 5 - ARM 64 v8a 系統映像檔和 Wear OS 5 - Intel x86 Atom_64 系統映像檔。
   • Android 13.0 (「Tiramisu」) (API 級別 33)，其中包含 Wear OS 4 ARM 64 v8a 系統映像檔和 Wear OS 4 Intel x86 Atom_64 系統映像檔。
   注意： Wear OS 的最新穩定版是 Wear OS 5，以 Android 14 為基礎。

   如要關閉 SDK Manager，請按一下「OK」。

您接著可以執行在 Wear OS 上的第一個應用程式。

注意：根據預設，「New Project」精靈會建立獨立的 Wear OS 應用程式，不需要連線至其他裝置即可執行。

Wear OS 應用程式應與手機應用程式分開運作，讓使用者在選擇手機時享有最大的彈性。如果應用程式需要與手機連線才能提供完整體驗或較複雜的功能，請參閱「將手錶連線到手機」指南。

在模擬器上執行應用程式

如要執行您的第一個 Wear OS 應用程式，最簡單的方法就是設定模擬器。

注意：如果您打算在中國推出 Wear OS 應用程式，請另外參閱「建立中國版 Wear OS 應用程式」頁面。

設定模擬器

如要在 Android Studio 中設定模擬器，請完成下列步驟：

1. 在 SDK Manager 中開啟「SDK Tools」分頁。確認已安裝最新版的 Android SDK Platform-Tools。
2. 依序前往「Tools」>「Device Manager」。
3. 選取「Create (+)」後，將出現「Virtual Device Configuration」精靈。
4. 在「Category」窗格中選取「Wear OS」，然後選擇硬體設定檔，例如「Wear OS Small Round」。按一下「Next」。

5. 用於中國境外的系統映像檔，請選取「UpsideDownCake」版本，此版本指定 Android 14.0 (Wear OS 5) 為目標。用於中國境內的系統映像檔，請選取「R」版本，此版本指定 Android 11.0 (Wear OS 3) 為目標。如果您尚未安裝符合裝置定義的 Wear OS 5 系統映像檔，請按一下「Release Name」旁邊的「Download」來取得這個映像檔。按一下「下一步」。

   注意：Wear OS 模擬器的系統映像檔包含第三方檔案的公告和原始碼。您可以開啟下列其中一個目錄中的 NOTICE.txt 檔案，查看特定系統映像檔的第三方公告：

   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI 適用於在中國境外使用的模擬器。
   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI 適用於在中國使用的模擬器。

6. 如果不想自訂模擬器，您可以保留這個畫面上所有設定的預設值。按一下「Finish」。

如要進一步瞭解如何使用模擬器，請參閱「在 Android Emulator 上執行應用程式」指南。

在模擬器中開啟應用程式

1. 依序前往「Run」>「Select Device」。選擇剛剛建立的模擬器。
2. 在 Android Studio 工具列中，按一下「Run」圖示 。模擬器會啟動，並開啟您的應用程式。
3. 不久後，您應該會在模擬器中看到「Hello...」訊息。

使用模擬器測試藍牙音訊

在搭載 Wear OS 4 以上版本的系統映像檔上，模擬器可支援模擬藍牙，因此您能夠針對各種用途測試藍牙音訊。

較新的系統映像檔僅支援 64 位元架構

Wear OS 4 以上版本的模擬器系統映像檔僅支援以下 64 位元架構：x86-64 和 arm64-v8a。如果您發現或懷疑應用程式使用原生程式碼 (非以 Kotlin 或 Java 程式設計語言編寫的程式碼)，請確認應用程式同時含有 32 位元和 64 位元的原生程式庫。

您也可以參考這篇文章，進一步瞭解如何支援 64 位元架構。

在實體手錶上執行應用程式 (選用)

在實體手錶上執行應用程式並進行偵錯，可讓您更有效評估整體使用者體驗。如果應用程式依賴特定硬體，例如感應器或 GPU，這麼做尤其重要。

如要在實體手錶上執行應用程式，請為裝置做好測試準備，並將裝置連線至開發機器。

為手錶做好測試準備

如要用手錶測試，請完成下列準備步驟，啟用 ADB 偵錯功能。

1. 開啟手錶上的「設定」選單。
2. 前往選單底部。如未顯示「開發人員選項」項目，請完成下列子步驟，如已顯示則請移至下一個步驟。
   1. 依序輕觸「系統」>「關於」，或是「系統」>「關於」>「版本」。
   2. 找到「版本號碼」項目，然後輕觸七次。如果需要輸入 PIN 碼或圖案才能解鎖手錶，請在出現提示時輸入。
3. 在「設定」選單中，輕觸「開發人員選項」。
4. 啟用「ADB 偵錯」選項。

將手錶連線至開發機器

部分手錶可透過 USB 建立連線，其他則需使用無線連線。

設定 USB 連線

請按照下列步驟連接手錶：

1. 使用 USB 傳輸線，將手錶連接至開發機器。
2. 在手錶上啟用「一律允許透過這台電腦進行」，然後輕觸「確定」。

設定無線連線

如果手錶沒有 USB 連接埠，請參閱這篇文章，瞭解如何透過 Wi-Fi 或藍牙連線至手錶。

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

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

在手錶上開啟應用程式

1. 依序前往「Run」>「Select Device」。選擇與機器連結的手錶。
2. 在 Android Studio 工具列中，按一下「Run」圖示 。模擬器會啟動，並開啟您的應用程式。
3. 不久後，手錶應會顯示「Hello...」訊息。