Wear OS 5.1

Wear OS 5.1 在部分设备上以及 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) 软件更新。您还可以通过执行以下任一操作来手动更新设备：

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

准备模拟器以进行测试

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

下载并安装系统映像

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

1. 下载并安装最新版本的 Android Studio Ladybug Feature Drop 或更高版本（如果您尚未这样做 ）。
2. 在 Android Studio 中，依次前往 Tools > SDK 管理器 。

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：

   

4. 点击 OK 。当 Confirm Change 窗口出现时，再次点击 OK 。

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

创建虚拟设备

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

1. 在 Android Studio 中，依次选择 Tools > Device Manager 来打开设备管理器。系统随即会显示 设备管理器 窗格。
2. 在 设备管理器 窗格内的工具栏中，依次点按 Add a new device > 创建虚拟设备 。
3. 在 Form Factor 窗格中，选择 Wear OS ，然后选择硬件配置文件。点击 Next 。
4. 选择要使用的 Wear OS 5.1 系统映像。系统映像的 API Level 应为 35 。
5. 点击 Next ，然后点击 Finish 。

在模拟器上测试应用

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

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

影响所有应用的变更

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

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 所对应的值更新它们。

如何设置 build 文件中的值的格式取决于您所使用的 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 使用的 API 级别与 Wear OS 5.1相同。

探索新功能

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

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

• 凭据管理器支持：Credential Manager 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 或更高版本。