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 系统映像或 Wear OS 5.1 Intel x86_64 Atom 系统映像：

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

  4. 点击 OK。当确认更改窗口出现时，再次点击确定。

  5. 等待 Android Studio 下载并安装系统映像，然后点击 Finish。

创建虚拟设备

如需在官方模拟器中创建运行此系统映像的虚拟设备，请完成以下步骤：

  1. 在 Android Studio 中，依次选择 Tools > Device Manager 来打开设备管理器。系统随即会显示设备管理器窗格。
  2. 在设备管理器窗格内的工具栏中，依次点按添加新设备图标 > 创建虚拟设备。
  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 使用的 API 级别与 Wear OS 5.1 相同。

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

更新应用的目标 SDK 版本

您可以将应用的目标 SDK 版本更新为 API 级别 35，从而提高应用与 Wear OS 5.1 的兼容性。（此 API 级别与 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 的最新系统映像（可在受支持的设备和模拟器上使用）具有以下特征：

发布日期

2025 年 3 月 18 日（适用于 Google Pixel Watch 3 LTE、Google Pixel Watch 2 LTE 和 Google Pixel Watch [蓝牙/Wi-Fi 版和 LTE 版]）

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 的系统映像存在以下已知问题：