Wear OS 5.1

探索最新版 Wear OS，這項系統適用於特定裝置，以及 Android Studio 的官方模擬器。更新目標 SDK 版本後，請檢查應用程式是否正常運作。

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

準備好支援的裝置進行測試

Wear OS 5.1 可在下列裝置上執行：

• Google Pixel Watch 3
• Google Pixel Watch 2
• Google Pixel Watch

裝置應會收到無線 (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 System Image」或「Wear OS 5.1 Intel x86_64 Atom System Image」：

   

4. 按一下「OK」。「確認變更」視窗隨即顯示，請再次點選「確定」。

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

建立虛擬裝置

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

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

在模擬器上測試應用程式

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

1. 前往 Android Studio 工具列，選取虛擬裝置。
2. 輕觸「跑步」 。
3. 在虛擬裝置上安裝應用程式，並瀏覽應用程式使用的各種面向使用者的工作流程。

影響所有應用程式的變更

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

下列行為變更不會在 Wear OS 5.1 中生效：

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

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

如要提升應用程式與 Wear OS 5.1 的相容性，請將應用程式的目標 SDK 版本更新至 API 級別 35。(這與 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 的值：

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

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

AGP 4.2.0 以下版本

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

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

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 的最新系統映像檔已在支援的裝置和模擬器上推出，具有下列特點：

已知問題

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

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