探索最新版 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) 软件更新。您还可以通过执行以下操作之一来手动更新设备:
- 在设置应用中,依次前往系统 > 系统更新。
- 启用开发者选项后,将特定软件映像刷写到支持 USB(有线)数据连接的设备上。例如,您可以刷写出厂映像或完整的 OTA 映像。
准备模拟器以进行测试
如需在官方模拟器中运行 Wear OS 5.1,您必须先下载并安装可在模拟器上运行的系统映像。然后,您必须创建运行此系统映像的虚拟设备。
下载并安装系统映像
如需下载并安装正确的系统映像,请完成以下步骤:
- 下载并安装最新版本的 Android Studio Ladybug Feature Drop 或更高版本(如果您尚未这样做)。
- 在 Android Studio 中,依次转到 Tools > SDK Manager。
在 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 系统映像:
点击 OK。当确认更改窗口出现时,再次点击确定。
等待 Android Studio 下载并安装系统映像,然后点击 Finish。
创建虚拟设备
如需在官方模拟器中创建运行此系统映像的虚拟设备,请完成以下步骤:
- 在 Android Studio 中,依次选择 Tools > Device Manager 来打开设备管理器。系统随即会显示设备管理器窗格。
- 在设备管理器窗格内的工具栏中,依次点按添加新设备图标
> 创建虚拟设备。
- 在 Form Factor 窗格中,选择 Wear OS,并选择硬件配置文件。点击 Next。
- 选择要使用的 Wear OS 5.1 系统映像。系统映像的 API 级别应为 35。
- 点击下一步,然后点击完成。
在模拟器上测试应用
如需在此虚拟设备上测试您创建的应用,请完成以下步骤:
- 前往 Android Studio 工具栏,然后选择虚拟设备。
- 点按跑步图标
。
- 在虚拟设备上安装应用,并浏览应用使用的面向用户的不同工作流。
影响所有应用的变更
在 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 的系统映像存在以下已知问题:
- 模拟器并不总是允许用户在设备重置后的设置流程中添加账号。
- 点按通知后,发送通知的应用不会立即打开,直到用户滚动屏幕后才会打开。
- 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 或更高版本。