升级到最新版本的 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 上不起作用。