建立並執行穿戴式應用程式

Wear OS 應用程式直接在手錶上執行,可讓您存取感應器和 GPU 等硬體。穿戴式應用程式與使用 Android SDK 的其他應用程式相似,但在設計和功能方面有所不同。

Wear OS 應用程式應獨立於手機應用程式上運作,讓使用者在選擇手機時享有最佳彈性。詳情請參閱「獨立與非獨立 Wear OS 應用程式」。

注意:您可以使用 USB、Wi-Fi 或藍牙,在實際的手錶上測試應用程式,如在對 Wear OS 應用程式進行偵錯中所述,這樣做可以讓您更有效地評估整體使用者體驗。您也可以使用 Android Studio 中的手錶模擬器,測試各種螢幕形狀和大小的應用程式。

設定環境

安裝最新版本的 Android Studio。如要瞭解如何在 Android Studio 中建立應用程式,請參閱「專案總覽」。

使用 SDK Manager 以確認您使用的是支援 Wear OS (Android 11,API 級別 30) 的最新版 Android 平台。

如果您打算在中國推出 Wear OS 應用程式,請參閱「建立中國版 Wear OS 應用程式」。

建立 Wear OS 應用程式

您可以使用 Android Studio 的「New Project」精靈建立 Wear OS 應用程式。

啟動 Wear OS 專案

如要在 Android Studio 中建立專案:

  1. 依序按一下「File」>「New」>「New Project」
  2. 在「Project Template」視窗中按一下「Wear OS」分頁標籤,選取「Empty Compose Activity」,然後按一下「Next」
  3. 在「New Project」視窗中為專案命名並填寫標準專案資訊,然後按一下「Finish」

    Android Studio 會建立含有資料供應商應用程式模組的專案。

  4. 在應用程式模組的 build.gradle 檔案中:
    • android 部分中,確認 compileSdkVersion 已設為 33。
    • android 部分中,確認 targetSdkVersion 已設為 30。
    • dependencies 部分替換為 Wear OS 特定依附元件。
  5. 在 Android 資訊清單檔案中,確認已定義 <uses-feature> 標記。定義 android:name="android.hardware.type.watch",如以下範例所示:
    <manifest>
    ...
      <uses-feature android:name="android.hardware.type.watch" />
    ...
    </manifest>
    
  6. 同步處理 Android Studio 專案。如要在新模組中執行程式碼,請參閱「啟動模擬器並執行 Wear OS 應用程式」。

啟動模擬器並執行 Wear OS 應用程式

如要使用模擬器,請設定 Android 虛擬裝置 (AVD)。確認您已透過 SDK Manager 取得最新版的 Android SDK Platform-tools

設定 AVD 並執行應用程式,如下所示:

  1. 在 Android Studio 中,依序選取「Tools」>「AVD Manager」以開啟 Android 虛擬裝置管理工具。
  2. 按一下「Create Virtual Device」
  3. 在「Category」窗格中選取「Wear OS」,然後選擇硬體設定檔。按一下「Next」
  4. 選取要下載的系統映像檔。舉例來說,您可以選取「API Level」為 30 的映像檔,「Target」選取「Android 11.0 (Wear OS)」。依序按一下「Next」和「Finish」
  5. 關閉 Android 虛擬裝置管理工具。
  6. 在 Android Studio 工具列中,從目標裝置下拉式選單中選取您剛才建立的 AVD,然後按一下「Run」

    AVD 會啟動,並在幾分鐘後執行應用程式。系統會顯示「Hello...」訊息。

如要進一步瞭解如何使用 AVD,請參閱「在 Android Emulator 上執行應用程式」一文。

更新 Wear OS 專案

如果您有現有專案,可能需要更新 settings.gradle 檔案。請務必使用 google() 來表示 Google Maven 存放區。如需相關資訊,請參閱「Google 的 Maven 存放區」。

Android Studio 專案的 settings.gradle 檔案應包含:

  dependencyResolutionManagement {
      ...
      repositories {
          google()
          jcenter()
      }
  }

警告:JCenter 存放區在 2021 年 3 月 31 日已變成唯讀狀態。詳情請參閱「JCenter 服務更新」。

設定智慧手錶

將應用程式部署至手錶的做法與將應用程式部署至手機類似。

本節假設您的手錶有 USB 連接埠。如果手錶沒有 USB 連接埠,請參閱「使用 Wi-Fi 或藍牙」連線手錶的操作說明。

在手錶上啟用 ADB 偵錯:

  1. 開啟手錶上的「設定」選單。
  2. 捲動至選單底部。如未提供「開發人員選項」項目,請依序輕觸「系統」和「關於」
  3. 輕觸版本號碼 7 次。
  4. 在「設定」選單中,輕觸「開發人員選項」
  5. 啟用「ADB 偵錯」

與手錶連接:

  1. 透過 USB 將手錶連接至電腦,以便將應用程式直接安裝到手錶。
  2. 在手錶上依序輕觸「一律允許透過這台電腦進行」和「確定」

連結手錶之後,請按照建構並執行應用程式的說明選取部署目標,藉此執行應用程式。

設定手機

本節說明如何透過 Wear OS 隨附應用程式設定配對手機。

注意:Wear OS 應用程式應為獨立應用程式,且與手機分開運作。如果應用程式需要手機應用程式,請參閱下列資訊,瞭解如何使用最新的 Wear OS 隨附應用程式更新手機。

使用隨附應用程式的 Android 版本

在 Android 手機上前往 Wear OS 應用程式清單。輕觸「更新」下載並安裝應用程式。安裝完成後,請確認已經為應用程式選取「自動更新」(請參閱更新已下載的應用程式中的「為特定應用程式設定自動更新」部分)。輕觸「開啟」啟動應用程式。

將 Android 手機與手錶配對

在手機上安裝隨附應用程式後,視需要取消所有逾時的手錶配對。將手機與建立新映像檔的手錶配對:

  1. 在手機上從裝置清單中選取裝置名稱。配對碼會顯示在手機和手錶上。確認兩者的配對碼相符。
  2. 輕觸「配對」即可繼續進行配對程序。手錶連線到手機時,畫面上會顯示確認訊息。在手機上,畫面會顯示列出手機上的帳戶清單。
  3. 選擇要新增至手錶的 Google 帳戶並同步到手錶。
  4. 確認螢幕鎖定,並輸入密碼,以便開始將帳戶從手機複製到手錶。
  5. 按照精靈中的操作說明完成配對程序。

iPhone 隨附的應用程式

您可以使用 iOS 隨附應用程式,但已安裝該應用程式的手機必須搭載 iOS 8.2 或以上版本:

  1. 在 iPhone 上前往 App Store,下載並安裝 Wear OS 隨附應用程式。
  2. 按照手錶和手機上的操作說明開始配對程序。詳情請參閱相關的「說明頁面」。

將裝置與手錶模擬器配對

如要將裝置與手錶的 Android 虛擬裝置 (AVD) 或模擬器配對,您可以手動操作,也可以使用 Wear OS 模擬器配對助理。

使用 Wear OS 模擬器配對助理

注意:手機必須搭載 Android 11 (API 級別 30) 以上版本並安裝 Google Play 商店,才能使用 Wear OS 模擬器配對助理。此外,請確認 Wear 模擬器執行的是 API 級別 28 以上版本,以便使用最新的助理功能。如要升級模擬裝置的系統映像檔,請使用 SDK Manager

Wear OS 模擬器配對助理可讓您輕鬆管理及連結 Wear 模擬器。您可以將多部 Wear 裝置與單一虛擬或實體手機配對;Android Studio 也會記住配對的裝置,並在先前配對過的裝置啟動時重新配對。

如要配對兩部裝置,請按照下列步驟操作:

  1. 如果您尚未建立 Wear 模擬器,請先完成這項作業。
  2. 在「Device Manager」中,找到其中一個要配對的裝置,然後按下「溢位」下拉式選單圖示,然後選取「Pair Wearable」

    圖 1. 透過裝置的下拉式選單可與 Wear 模擬器配對。

  3. 這項操作會啟動 Wear OS 模擬器配對助理。如果您在手機上點選「與穿戴式裝置配對」,系統就會顯示可用的 Wear 裝置清單。如果您是使用 Wear 裝置開始進行,則系統會顯示可用的手機清單。選取要配對的裝置,然後點選「下一步」
  4. Android Studio 可能需要幾分鐘的時間,才能將裝置啟動並準備就緒。如果手機尚未安裝 Wear OS 隨附應用程式,請按照提示登入 Play 商店,然後進行安裝及設定。
  5. 如要在手機上的 Wear OS 應用程式中配對裝置,請按一下三點圖示選單,然後選取「與模擬器配對」。

成功配對裝置後,「Device Manager」會在配對的裝置旁邊顯示小型圖示。您也可以按一下溢位下拉式選單,然後選取「View Details」查看配對裝置清單。

圖 2. 「Paired Devices」工具視窗會顯示與所選裝置配對的裝置。

將手機與手錶 AVD 配對

如要您需要在手錶 AVD 上使用 Google 帳戶進行開發作業,可以將手機與手錶 AVD 配對並同步處理 Google 帳戶:

  1. 按照步驟設定手機
  2. 在手機上啟用「開發人員選項」和「USB 偵錯」
  3. 透過 USB 將手機連接至電腦。
  4. 將 AVD 的通訊埠轉送到已連接的手機 (每次連接手機時):
    adb -d forward tcp:5601 tcp:5601
  5. 在手機上的 Wear OS 應用程式中啟動標準配對程序。舉例來說,在歡迎畫面中輕觸「設定」按鈕。或者,如果現有的手錶已配對,請在左上方的下拉式選單中選取「新增手錶」
  6. 在手機上的 Wear OS 應用程式中輕觸「溢位」按鈕,然後輕觸「與模擬器配對」
  7. 輕觸「設定」圖示
  8. 在「裝置設定」下方,輕觸「模擬器」
  9. 輕觸「帳戶」並選取 Google 帳戶,然後按照精靈中的步驟將帳戶與模擬器同步處理。如有需要,請輸入螢幕鎖定裝置密碼和 Google 帳戶密碼,藉此啟動帳戶同步處理作業。

將手機連線至多部 Wear 裝置

如要將第二部 Wear 裝置連線至虛擬或實體手機,請按照與初始配對相同的步驟操作:在「Device Manager」中尋找要配對的手機或 Wear 裝置,然後依序點選溢位下拉式選單和「Pair Wearable」

在專案中新增 Wear OS 模組

您可以為 Android Studio 中的現有專案新增 Wear OS 裝置模組,以便重複使用行動 (手機) 應用程式的程式碼。

在現有專案中提供 Wear OS 模組

如要建立 Wear OS 模組,請開啟現有的 Android Studio 專案,然後執行下列操作:

  1. 依序按一下「File」>「New」>「New Module」
  2. 在「New Module」視窗中選取「Wear OS Module」,然後按一下「Next」
  3. 在「Configure the new module」下方,輸入:
    • 應用程式/程式庫名稱:此字串是新模組的應用程式啟動器圖示標題。
    • 模組名稱:此字串是原始碼和資源檔案的資料夾名稱。
    • 套件名稱:此字串是模組中程式碼的 Java 命名空間。字串會以 package 屬性的形式加入至模組的 Android 資訊清單檔案中。
    • SDK 最低版本:選取應用程式模組支援的平台最低版本。例如:選取「API 26: Android 8.0」。這個值會設定 build.gradle 檔案中的 minSdkVersion 屬性,您稍後可以編輯。
  4. 按一下「Next」。您會看到多個程式碼範本選項。依序按一下「Blank Wear OS Activity」和「Next」
  5. 在「Configure Activity」視窗中輸入或接受「Activity Name」、「Layout Name」和「Source Language」的預設值。按一下「Finish」

Android Studio 會建立並同步處理新模組的檔案。Android Studio 也會將 Wear OS 的所有必要依附元件新增至新模組的建構檔案中。新模組會顯示在畫面左側的「Project」視窗中。如果您沒有看到新模組的資料夾,請確認視窗內有顯示「Android view」

在新 Wear OS 模組的 build.gradle 檔案中納入以下內容:

包含程式庫

注意:我們建議使用 Android Studio 開發 Wear OS,因為這項工具可以用來設定專案,而且內附程式庫和套件。

使用 Android Studio 的專案精靈時,精靈會匯入適當模組 build.gradle 檔案中的依附元件。不過,並非所有應用程式都需要依附元件。請查看以下相關資訊,瞭解依附元件。

如要將現有的 Wear OS 專案更新為最新 SDK 版本,請使用啟動 Wear OS 專案一節中列出的設定。

通知

如要進一步瞭解通知的依附元件,請參閱「在 Wear 上建立通知」。

為 Wear OS 建構使用者介面

建議您使用 Compose 為 Wear OS 應用程式建構使用者介面。Compose for Wear OS 提供超過 20 個專為 Wear OS 板型規格設計的元件,遠超過以檢視畫面為基礎的版面配置可用的元件數量。這些元件旨在協助打造符合最新的 Wear OS 質感設計指南規定的使用者體驗。不過,如果您想使用檢視畫面進行建構,請在 Wear OS UI 程式庫中新增依附元件。詳情請參閱「在 Wear OS 上建構以檢視畫面為基礎的使用者介面」。

Play 服務和穿戴式資料層 API

如果您的應用程式依附於 Google Play 服務,無論是同步處理或傳送資料 (透過使用資料層 API) 或其他原因,都必須使用最新版的 Google Play 服務。如果您目前並未使用這些 API,請移除依附元件。

在手錶上節省電力

手錶處於閒置狀態或使用者用手掌覆蓋螢幕時,就會從互動模式轉換至微光模式。

為了節省手錶的電量,請避免使用微光模式。如果手錶在應用程式處於活動狀態時進入系統微光模式,且使用者在指定時間內再次與手錶互動,應用程式就會提亮。

您可能會針對特定用途,覆寫應用程式中的微光模式。舉例來說,如果使用者要追蹤跑步狀況,且需要隨時查看時間,請覆寫微光模式。

可以轉換為微光模式的手錶應用程式稱為「一律開啟」應用程式。以下說明一律開啟應用程式的兩種操作模式:

互動式內容
在這個模式下,請使用流暢動畫的全彩動畫。應用程式也會回應輸入內容。
微光
使用黑色和白色圖形算繪螢幕,在這個模式中不會顯示任何輸入提示。這個顯示模式僅適用於搭載 Android 5.1 以上版本的裝置。

如需詳細資訊和最佳做法,請參閱「在 Wear OS 上讓應用程式持續顯示」頁面。