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

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

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

建立 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. 前往 [工具]>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 系統映像檔。
    ，瞭解如何調查及移除這項存取權。

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

您接著可以執行在 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 符合裝置定義的系統映像檔，按一下 找到「版本名稱」旁邊的「下載」，即可取得該版本。點選「下一步」。

    注意：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 或藍牙連線至手錶。

在手錶上開啟應用程式

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

參加裝置 Beta 版計畫

在特定地區，你可以註冊 Samsung 的 Galaxy One UI Watch Beta 版 計畫。這項計畫可讓你在適用的 Samsung Galaxy 上下載 Wear OS 5 版 手錶裝置並測試應用程式行為。

如要註冊，請完成下列步驟：

  1. 下載 Samsung Members 應用程式 Google Play 商店。
  2. 使用 Samsung 帳戶登入。
  3. 在首頁橫幅或通知頁面中，捲動至並選取 註冊 One UI 手錶測試版計畫資訊卡。
  4. 在接著顯示的頁面中詳閱指示，然後選取 [加入] 按鈕。例如，在 Samsung Galaxy Watch6 裝置上，請選取 Watch 6 Join。