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 可在下列裝置上執行：

• Google Pixel Watch 3 (藍牙/Wi-Fi)
• Google Pixel Watch 2 (藍牙/Wi-Fi)

裝置應會收到無線 (OTA) 軟體更新。您也可以透過下列任一方式手動更新裝置：

• 在「設定」應用程式中，依序前往「系統」>「系統更新」。
• 啟用開發人員選項後，請將特定軟體映像檔刷新至支援 USB (有線) 數據連線的裝置。舉例來說，您可以刷新原廠映像檔或完整 OTA 映像檔。

準備模擬器以進行測試

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

下載並安裝系統映像檔

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

1. 如果尚未下載及安裝最新版本的 Android Studio Ladybug Feature Drop，請下載並安裝該版本或更高版本。
2. 在 Android Studio 中，按一下「Tools」(工具) >「SDK Manager」。

3. 在「SDK Platforms」分頁中，按一下「Show Package Details」，然後展開「Android 15.0 (\"VanillaIceCream\")」部分，其中包含 API 級別 35-ext15 的構件。接著，請選取 Wear OS 5.1 ARM 64 v8a 系統映像檔或 Wear OS 5.1 Intel x86_64 Atom 系統映像檔：

   

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 生效：

• Wear OS 5.1 不支援私人空間。
• 預測返回動畫可能不會顯示。

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

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

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

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

AGP 7.0.0 以上版本

如果您使用 AGP 7.0.0 以上版本，請將應用程式的 build.gradle 或 build.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.gradle 或 build.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 應用程式的使用體驗。

注意： 在應用程式中加入這些功能前，請先讓應用程式做好準備，以便處理 Wear OS 5.1 引進的行為變更。

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

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

版本資訊

Wear OS 5.1 的最新系統映像檔可在支援的裝置和模擬器上使用，具有下列特性：

發布日期	2025 年 3 月 4 日
版本	裝置上的 BP1A.250305.019.W3 模擬器上的 AP4A.241205.004.F4
模擬器支援	x86 (64 位元)、ARM (v8-A)

已知問題

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

• 在裝置重設後，模擬器不一定會在設定流程中允許使用者新增帳戶。
• 輕觸通知後，使用者必須捲動畫面，應用程式才會開啟。
• Wear 健康服務有時無法開始運動。
• 如果您在指定目標 API 級別為 35 的應用程式中存取 androidx.wear.tiles 或 androidx.wear:wear-phone-interactions 程式庫，可能會發生 SecurityException。如要解決這個問題，請將各個程式庫升級至最新版本。