升级到最新版本的 Wear OS

从 Wear 2.0 升级

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

特定于 Android 的更改

Wear 2.0 包含 API 级别 25 至 API 级别 28 的多个 Android 版本。

注意:没有适用于 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 2.0 中存在卡片复杂功能、应用、表盘和许多其他 surface。不过,您必须修改界面,以纳入我们最新的设计准则。

API 级别 30 包含 Ongoing Activity API

持续性活动可在 Wear OS 界面内的其他 surface 中显示持续性通知,让用户可以持续参与长期活动。

注意:新的 Alpha 版表盘 API 的某些功能仅在搭载 API 级别 30 或更高级别的设备上可用。

选择起始版本

特定于 Android 的更改部分中所述,Wear OS 版本与 Android 版本相关联。在选择起始版本时,请考虑最常见的 Wear OS 设备。

大多数开发者都会构建以 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 库现已稳定