升级到最新版本的 Wear OS

从 Wear 2.0 升级

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

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 版本，因此当您将 compileSdkVersion 和 targetSdkVersion 字段从 28 更改为 30 时，需要一次性处理这些更改。

注意：即使您没有更改应用中的 compileSdkVersion 或 targetSdkVersion，也要确保您的应用与 API 级别 29 兼容。

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 库是一组库，包含与 Wearable Support 库类似的功能，并更好地支持 Wear OS 3。

适用于 Wear OS 的 Jetpack 库是 Wearable Support 库的替代品，不建议同时使用。Wearable Support 库在 Wear OS 3 上无法运行。