建立並執行第一個 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 會下載必要的依附元件，並建構專案。

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

在模擬器上執行應用程式

在模擬器上執行 Wear OS 應用程式是簡單直接的方法。

設定模擬器

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

  1. 在 SDK Manager 中開啟「SDK Tools」分頁。確認已安裝最新版的 Android SDK Platform-Tools。關閉 SDK 管理工具。
  2. 依序前往「Tools」>「Device Manager」。
  3. 選取「Create (+)」後，將出現「Virtual Device Configuration」精靈。
  4. 在「Category」窗格中選取「Wear OS」，然後選擇硬體設定檔，例如「Wear OS Small Round」。按一下「Next」。
  5. 除非需要進行特定自訂作業，否則請保留這個畫面上的預設設定。Android Studio 預設會選取最新的 API 和系統映像檔。 按一下「Finish」。

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

在模擬器中開啟應用程式

  1. 在主要工具列中，找到「執行小工具」。從裝置下拉式選單中選取您建立的模擬器，然後按一下「Run」(執行) 「執行按鈕」 按鈕啟動應用程式。
  2. 不久後，模擬器中會顯示「Hello...」訊息。

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

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

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

為手錶做好測試準備

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

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

詳情請參閱「設定裝置端開發人員選項」。

將手錶連線至開發機器

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

設定 USB 連線

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

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

設定無線連線

如果無法透過 USB 連接埠偵錯手錶，請參閱「透過 Wi-Fi 連線至裝置」。

在手錶上開啟應用程式

  1. 在「Run Widget」 (主工具列的一部分) 中，使用裝置下拉式選單選取實體裝置。
  2. 按一下「執行」「執行按鈕」 按鈕，位於「執行小工具」中。
  3. 不久後，裝置上會顯示「Hello...」訊息。

規劃應用程式架構

現在您已執行基本應用程式，可以開始進階操作了。開始新增功能前，建議先思考會影響應用程式的重大架構決策。以下各節將探討一些重要問題，供您參考。

應用程式模型：獨立、非獨立或混合

請考量應用程式對已配對手機的依賴程度：

  • 混合式 (適用於大多數應用程式)：這是最常見且最具彈性的做法。即使沒有手機，應用程式的核心功能也能運作 (例如追蹤運動)，但連線手機後，應用程式會提供更多功能，例如同步處理資料或簡化設定程序。
  • 獨立應用程式：應用程式完全獨立運作，不需要手機提供核心功能。如果應用程式可以離線運作或使用自己的網際網路連線，這就是絕佳選擇。「Empty Wear App」範本預設會建立獨立應用程式。
  • 非獨立應用程式：應用程式需要手機才能運作核心功能。

如需更多資訊和相關指引，請參閱「獨立與非獨立 Wear OS 應用程式」。

建立使用者介面

Compose for Wear OS 是新型宣告式架構，建議您使用這個架構建構 Wear OS 應用程式的 UI。您使用的範本是以 Compose 建構而成，是絕佳的起點。

使用 Compose 建構應用程式時，請使用專為 Wear OS 設計的程式庫。這些元件經過最佳化，可提供優質的手錶使用者體驗。

舉例來說，請使用 TransformingLazyColumn，而非標準的 LazyColumn，因為前者會自動對圓形螢幕邊緣的項目套用縮放和透明度效果。

同樣地，如要進行導覽，請使用 Wear OS Navigation 程式庫中的 SwipeDismissableNavHost，與系統的「滑動即可關閉」手勢整合。

資料儲存與同步處理

資料管理方式是核心架構選擇。如要在裝置上保存資料，可使用與行動裝置相同的選項，包括使用 DataStore 儲存鍵/值資料或型別物件，以及使用 Room 儲存更複雜的結構化資料，這些都是建議使用的現代選項。

  • 先將資料儲存在裝置上：設計離線優先應用程式，直接將必要資料儲存在手錶上，這樣即使沒有手機連線，應用程式仍可正常運作。
  • 與手機同步處理資料：如要與隨附的手機應用程式同步處理或串流資料 (例如使用者設定或運動資料)，請使用 Data Layer API。這項功能提供透過藍牙和 Wi-Fi 運作的通訊管道。

管理長時間執行的工作

許多核心 Wear OS 體驗 (例如運動或媒體播放) 都會長時間執行。請務必正確管理這項工作，以維持可靠性並節省電力。

  • 使用者啟動的長時間工作：如果使用者啟動的工作必須在離開應用程式後繼續執行 (例如追蹤跑步)，您必須使用前景服務。在 Wear OS 上，請將這項服務與 Ongoing Activity API 配對。這會在錶面上建立持續性通知和可輕觸的圖示，讓使用者返回您的應用程式。
  • 可延後的背景工作：如果工作不需要立即執行 (例如定期同步資料)，請使用 WorkManager。這項工具會考量電池用量，並尊重系統最佳化設定 (例如 Doze 模式)，因此適合用於非緊急的背景處理作業。

跳脫應用程式框架：介面和功能

最後請注意，Wear OS 體驗不只是主要應用程式。

  • 支援其他介面：如要建立高品質且令人愛不釋手的應用程式，請規劃支援其他手錶專用介面。建議建立動態磚，提供快速動作和資訊，並建立小工具，直接在使用者錶面上顯示重要資料。
  • 規劃省電措施：穿戴式裝置的電池續航力至關重要。從一開始就設計省電的應用程式。也就是說，您必須謹慎思考如何擷取資料、使用感應器，以及執行背景工作。將工作延後到手錶充電時執行，通常是不錯的策略。詳情請參閱省電指南。