此页面由 Cloud Translation API 翻译。

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，您必须先下载并安装在模拟器上运行的系统映像。然后，您必须创建一个运行此系统映像的虚拟设备。

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

下载并安装最新版本的 Android Studio Meerkat（如果您尚未这样做）。
在 Android Studio 中，依次点击 Tools > SDK Manager。
在 SDK Platforms 标签页中，展开 Android 15.0（“VanillaIceCream”）部分，然后选择 Wear OS 5.1 - Preview ARM 64 v8a System Image 或 Wear OS 5.1 - Preview Intel x86_64 Atom System Image：
点击 OK。当确认更改窗口出现时，再次点击确定。
等待 Android Studio 下载并安装系统映像，然后点击 Finish。

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

在 Android Studio 中，依次选择 Tools > Device Manager 来打开设备管理器。系统随即会显示 Device Manager 窗格。
在 Device Manager 窗格中的工具栏中，依次点击 Add a new device > Create Virtual Device。
在 Form Factor 窗格中，选择 Wear OS，并选择硬件配置文件。点击 Next。
选择要使用的 Wear OS 5.1 系统映像。系统映像的 API 级别应为 35。
点击下一步，然后点击完成。

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

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

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

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

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

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "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。如需解决此问题，请将每个库升级到最新版本。