升级到最新版 Wear OS

从 Wear 2.0 升级

本指南介绍了 Wear OS 的升级过程。

Android 特定变更

Wear 2.0 涵盖了多个 Android 版本,从 API 级别 25 到 API 级别 28。

注意:没有适用于 Android 10 (API 级别 29) 的 Wear OS 版本。

如果您的 Wear OS 应用以 Wear OS 2.0 (API 级别 28) 为目标,那么大部分升级工作是处理从 Android 9 (API 级别 28) 到 Android 11 (API 级别 30) 的平台变更。

没有适用于 Android 10 (API 级别 29) 的 Wear OS 版本,您需要在将 compileSdkVersiontargetSdkVersion 字段从 28 更改为 30 时,一次性处理这些变更。

注意:即使您未更改应用中的 compileSdkVersiontargetSdkVersion,也请确保您的应用与 API 级别 29 兼容

Wear OS 特定变更

卡片复杂功能、应用、表盘以及许多其他界面均存在于 Wear OS 2.0 中。升级应用时,您必须修改用户界面以整合最新的设计指南。

此外,API 级别 30 包含了 正在进行的活动 API。一项 正在进行的活动 可让正在进行的通知在 Wear OS 用户界面中的其他界面上显示,从而让用户能够更好地参与长期运行的活动。

注意:Alpha 版表盘 API 的某些功能仅适用于运行 API 级别 30 或更高版本的设备。

选择要开始的版本

大多数开发者都会构建一个以 API 级别 30 为目标的稳定应用,并使 minSdkVersion 版本保持足够低,以支持最常见的 Android 版本。例如,要启用对 Wear 2.0 设备的支持,请将您的 minSdkVersion 设置为 25。

如果您有 Android 开发经验,那么这些知识大部分都适用于 Wear OS。要了解两者之间的差异,请阅读Wear OS 与移动开发

注意:API 级别 30 的 Wear OS 模拟器系统映像处于开发者预览版。请参阅版本说明以了解最新更新。

Wear OS 版 Jetpack 库

Wear OS 版 Jetpack 库 是一组库,它们提供与可穿戴设备支持库类似的功能,并更好地支持 Wear OS 3。

Wear OS 版 Jetpack 库是可穿戴设备支持库的替代品,并非设计为与后者一起使用。可穿戴设备支持库不适用于 Wear OS 3。

如需了解详情,请参阅博文Wear OS Jetpack 库现已稳定发布