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) 软件更新。您还可以通过执行以下任一操作手动更新设备：

准备好模拟器以进行测试

如需在官方模拟器中运行 Wear OS 5.1，您必须先下载并安装在模拟器上运行的系统映像。然后，您必须创建一个运行此系统映像的虚拟设备。

下载并安装系统映像

如需下载并安装正确的系统映像，请完成以下步骤：

  1. 下载并安装最新版本的 Android Studio Ladybug Feature Drop（如果您尚未这样做）。
  2. 在 Android Studio 中，依次点击 Tools > SDK Manager。

  3. 在 SDK Platforms 标签页中，点击 Show Package Details，然后展开包含 API 级别 35-ext15 工件的 Android 15.0（“VanillaIceCream”）部分。然后，选择 Wear OS 5.1 ARM 64 v8a System Image 或 Wear OS 5.1 Intel x86_64 Atom System Image：

    “模拟器 build 映像显示在 Android API 35 的 build 映像组中”

  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. 在 Form Factor 窗格中，选择 Wear OS，并选择硬件配置文件。点击 Next。
  4. 选择要使用的 Wear OS 5.1 系统映像。系统映像的 API 级别应为 35。
  5. 点击下一步，然后点击完成。

在模拟器上测试应用

如需在您创建的此虚拟设备上测试您的应用，请完成以下步骤：

  1. 前往 Android Studio 工具栏，然后选择虚拟设备。
  2. 点击 Run 图标 。
  3. 在虚拟设备上安装您的应用，然后浏览应用使用的面向用户的不同工作流。

影响所有应用的变更

在 Wear OS 5.1 上测试应用时，请检查您的应用如何处理对 Android 15 中的所有应用都有影响的系统行为变更（Android 15 使用与 Wear OS 5.1 相同的 API 级别）。

以下几项行为变更不会在 Wear OS 5.1 中生效：

更新应用的目标 SDK 版本

您可以将应用的目标 SDK 版本更新为 API 级别 35，从而提高应用与 Wear OS 5.1 的兼容性。（这与 Android 15 使用的 API 级别相同。）

为此，请打开模块级 build.gradle 或 build.gradle.kts 文件，并使用 Wear OS 5.1 所对应的值更新它们。

如何设置 build 文件中的值的格式取决于您所使用的 Android Gradle 插件 (AGP) 版本。

AGP 7.0.0 或更高版本

如果您使用的是 AGP 7.0.0 或更高版本，请使用以下 Wear OS 5.1 所对应的值更新应用的 build.gradle 或 build.gradle.kts 文件：

Groovy

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

Kotlin

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

AGP 4.2.0 或更低版本

如果您使用的是 AGP 4.2.0 或更低版本，请使用以下 Wear OS 5.1 所对应的值更新应用的 build.gradle 或 build.gradle.kts 文件：

Groovy

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

Kotlin

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

只会影响以 API 级别 35 为目标平台的应用的变更

将目标 SDK 版本更新到 API 级别 35 后，请处理以 Android 15 为目标平台的应用的更改，该平台使用的 API 级别与 Wear OS 5.1 相同。

探索新功能

Wear OS 5.1 引入了若干功能，有助于提升 Wear OS 应用体验。

值得探索的显著功能包括：

  • Credential Manager 支持：Credential Manager API 提供统一的身份验证解决方案，支持使用密码、通行密钥和联合身份（例如使用 Google 账号登录）的登录流程。用户的凭据存储在凭据提供程序中，该提供程序会在设备之间同步账号信息。
  • 手表扬声器播放：在支持通过手表扬声器播放媒体内容的设备上，如果您的应用集成了 Wear 输出切换器，用户可以选择此扬声器作为首选媒体输出选项。

版本说明

Wear OS 5.1 的最新系统映像适用于受支持的设备和模拟器，具有以下特点：

发布日期

Google Pixel Watch 3（LTE 版）、Google Pixel Watch 2（LTE 版）和 Google Pixel Watch（蓝牙/Wi-Fi 版和 LTE 版）：2025 年 3 月 18 日

2025 年 3 月 4 日（Google Pixel Watch 3 蓝牙版/Wi-Fi 版和 Google Pixel Watch 2 蓝牙版/Wi-Fi 版）
build

Google Pixel Watch 3 和 Google Pixel Watch 2 上的 BP1A.250305.019.W3

Google Pixel Watch 上的 BP1A.250305.019.W2

模拟器上的 AP4A.241205.004.F4
模拟器支持 x86（64 位）、ARM (v8-A)

已知问题

包含 Wear OS 5.1 的系统映像存在以下已知问题：