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（蓝牙/Wi-Fi）
• Google Pixel Watch 2（蓝牙/Wi-Fi）

您的设备应该会收到无线下载 (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，然后展开包含 API 级别 35-ext15 工件的 Android 15.0（“VanillaIceCream”）部分。然后，选择 Wear OS 5.1 ARM 64 v8a 系统映像或 Wear OS 5.1 Intel x86_64 Atom 系统映像：

   

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 中生效：

• 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 为目标平台的应用的更改，该平台使用的 API 级别与 Wear OS 5.1 相同。

探索新功能

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

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

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

版本说明

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

已知问题

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

• 模拟器并不总是允许用户在设备重置后的设置流程中添加账号。
• 点按通知后，发送通知的应用不会打开，直到用户滚动屏幕。
• Wear 健康服务有时无法启动锻炼。
• 如果您在以 API 级别 35 为目标平台的应用中访问 androidx.wear.tiles 或 androidx.wear:wear-phone-interactions 库，可能会发生 SecurityException。如需解决此问题，请将每个库升级到最新版本。