升级到最新版本的 Wear OS

从 Wear 2.0 升级

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

特定于 Android 的更改

Wear 2.0 包含 API 级别为 25 至 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 OS 2.0 中存在功能块复杂功能、应用、表盘主题和许多其他 surface。升级您的应用时,您必须修改界面,以遵从最新的设计准则。

此外,API 级别 30 包含 Ongoing Activity API持续性活动可让持续性通知显示在 Wear OS 界面内的其他 surface 中,这样,用户就可以与长时间进行的活动保持更高的互动度。

注意: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 库现已稳定