Wear OS 5.1

探索最新版 Wear OS,可在 Android Studio 的官方模擬器中使用。更新目標 SDK 版本後,請檢查應用程式是否能正常運作。

Wear OS 5.1 以 Android 15 (API 級別 35) 為基礎,因此您必須測試已將目標指定為 Wear OS 5 的 API 級別 34 應用程式。

準備模擬器以進行測試

如要在官方模擬器中執行 Wear OS 5.1,您必須先下載並安裝在模擬器上執行的系統映像檔。接著,您必須建立執行此系統映像檔的虛擬裝置。

下載並安裝系統映像檔

如要下載並安裝正確的系統映像檔,請完成下列步驟:

  1. 如果尚未下載並安裝最新版本的 Android Studio Meerkat,請先下載並安裝。
  2. 在 Android Studio 中,按一下「Tools」(工具) >「SDK Manager」。
  3. 在「SDK Platforms」分頁中,展開「Android 15.0 (『VanillaIceCream』)」部分,然後選取「Wear OS 5.1 - Preview ARM 64 v8a System Image」或「Wear OS 5.1 - Preview Intel x86_64 Atom System Image」

    「模擬器建構映像檔會顯示在 Android API 35 的建構映像檔群組中」

  4. 按一下「OK」。當「確認變更」視窗顯示時,請再次按一下「確定」

  5. 等待 Android Studio 下載並安裝系統映像檔,然後按一下「Finish」

建立虛擬裝置

如要建立在官方模擬器中執行此系統映像檔的虛擬裝置,請完成下列步驟:

  1. 在 Android Studio 中,依序選取「Tools」>「Device Manager」,開啟裝置管理工具。系統會顯示「Device Manager」窗格。
  2. 在「Device Manager」窗格中的工具列中,依序按一下「Add a new device」「Create Virtual Device」。
  3. 在「板型規格」窗格中選取「Wear OS」,然後選擇硬體設定檔。按一下「Next」
  4. 選取要使用的 Wear OS 5.1 系統映像檔。系統映像檔的 API 級別應為 35
  5. 依序按一下「下一步」和「完成」

在模擬器上測試應用程式

如要在您建立的這個虛擬裝置上測試應用程式,請完成下列步驟:

  1. 前往 Android Studio 工具列,選取虛擬裝置。
  2. 按一下「執行」圖示
  3. 在虛擬裝置上安裝應用程式,並瀏覽應用程式使用的不同面向使用者的流程。

影響所有應用程式的變更

在 Wear OS 5.1 上測試應用程式時,請檢查應用程式如何處理系統行為變更,這些變更會影響 Android 15 中的所有應用程式,因為 Wear OS 5.1 使用與該版本相同的 API 級別。

以下行為變更不會在 Wear OS 5.1 生效:

更新應用程式的目標 SDK 版本

只要將應用程式的目標 SDK 版本更新至 API 級別 35,即可提升應用程式與 Wear OS 5.1 的相容性。(這是 Android 15 使用的 API 級別)。

如要這麼做,請開啟模組層級的 build.gradlebuild.gradle.kts 檔案,然後更新為 Wear OS 5.1 的值。

建構檔案中值的格式,取決於您使用的 Android Gradle 外掛程式 (AGP) 版本。

AGP 7.0.0 以上版本

如果您使用 AGP 7.0.0 以上版本,請將應用程式的 build.gradlebuild.gradle.kts 檔案更新為下列 Wear OS 5.1 的值:

Groovy

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Kotlin

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 以下版本

如果您使用 AGP 4.2.0 以下版本,請將應用程式的 build.gradlebuild.gradle.kts 檔案更新為下列 Wear OS 5.1 的值:

Groovy

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

Kotlin

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

只會影響以 API 級別 35 為目標的應用程式

將目標 SDK 版本更新至 API 級別 35 後,請處理以 Android 15 為目標的應用程式變更,因為這些應用程式與 Wear OS 5.1 使用相同的 API 級別。

探索新功能

Wear OS 5.1 推出了幾項功能,有助於提升 Wear OS 應用程式的使用體驗。

值得一探究竟的功能包括:

  • 憑證管理工具支援:憑證管理工具 API 提供統一的驗證解決方案,支援使用密碼、密碼金鑰和聯合身分 (例如「使用 Google 帳戶登入」) 的登入流程。使用者的憑證會儲存在憑證提供者中,後者會在裝置間同步帳戶資訊。
  • 手錶喇叭播放:如果應用程式整合了 Wear Output Switcher,在支援透過手錶喇叭播放媒體的裝置上,使用者可以將這個喇叭選為偏好的媒體輸出選項。

版本資訊

在 Wear OS 5.1 模擬器上提供的系統映像檔具有下列特性:

  • 發布日期:2024 年 11 月 19 日
  • 版本 ID:AP4A.241205.004.F1

已知問題

包含 Wear OS 5.1 的系統映像檔有下列已知問題:

  • 在裝置重設後,模擬器不一定會在設定流程中允許使用者新增帳戶。
  • 輕觸通知後,使用者必須捲動畫面,應用程式才會開啟。
  • Wear 健康服務有時無法開始運動。