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
• Google Pixel Watch 2
• Google Pixel Watch

您的设备应收到 OTA（无线）软件更新。您也可以通过以下任一方式手动更新设备：

• 在设置应用中，依次导航到系统 > 系统更新。
• 在启用开发者选项后，将特定的软件映像刷入支持 USB（有线）数据连接的设备。例如，您可以刷入出厂映像或完整的 OTA 映像。

准备模拟器进行测试

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

下载并安装系统映像

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

1. 如果您尚未下载并安装最新版 Android Studio Ladybug Feature Drop 或更高版本，请立即进行。
2. 在 Android Studio 中，点击工具 > SDK 管理器。

3. 在SDK 平台标签页中，点击显示软件包详情，然后展开包含 API 级别 35-ext15 构件的 Android 15.0（"VanillaIceCream"）部分。然后，选择 Wear OS 5.1 ARM 64 v8a 系统映像或 Wear OS 5.1 Intel x86_64 Atom 系统映像

   

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

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

创建虚拟设备

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

1. 在 Android Studio 中，通过选择工具 > 设备管理器打开设备管理器。设备管理器窗格随即显示。
2. 在设备管理器窗格的工具栏中，点击添加新设备 > 创建虚拟设备。
3. 在外形规格窗格中，选择 Wear OS 并选择一个硬件配置文件。点击下一步。
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 版本

您可以通过将应用的目标 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 或更高版本，请使用 Wear OS 5.1 的以下值更新您的应用 build.gradle 或 build.gradle.kts 文件

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

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

AGP 4.2.0 或更低版本

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

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

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

仅影响面向 API 级别 35 的应用的变化

将目标 SDK 版本更新到 API 级别 35 后，请处理针对 Android 15 的应用变更，Android 15 使用与 Wear OS 5.1 相同的 API 级别。

探索新功能

Wear OS 5.1 引入了多项功能，以帮助增强您的 Wear OS 应用体验。

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

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

版本说明

适用于 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 或更高版本。