Android NDK开发详解Wear之Wear OS 应用开发与移动应用开发

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

注意：即使您不更改应用的 compileSdkVersion 或 targetSdkVersion，也请确保应用兼容 API 级别 29。

特定于 Wear OS 的更改

Wear OS 2.0 中存在功能块、复杂功能、应用、表盘主题和许多其他 surface。升级您的应用时，您必须修改界面，以遵从最新的设计准则。

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

注意：Alpha 版表盘主题 API 的某些功能仅在 API 级别为 30 或更高的设备上可用。

选择起始版本

由于 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 库现已稳定。

Wear OS 应用开发与移动应用开发的差异

Wear OS 以 Android 为基础，并且专门针对腕部佩戴进行了优化。如果您有 Android 应用开发经验，那么您可能使用过同时适用于这两类开发的许多功能和 API。不过，设计移动应用的方式与设计 Wear OS 应用的方式有一些区别。

建议您仔细阅读 Wear OS 应用开发原则指南，了解如何设计您的应用。

注意：API 级别为 30 的 Wear OS 模拟器系统映像目前为开发者预览版。如需了解最新更新，请参阅版本说明。

如需了解与 Android 移动应用开发相比，Wear OS 应用开发中的特定功能、API 或最佳实践有何不同，请参阅下表，或使用过滤字段查找特定主题。

在此处输入相应信息以查找特定的功能、API 或最佳实践

功能、API 或最佳实践	Wear OS 应用与移动应用	Wear OS 详细信息
设计应用的界面或用户体验	不同	专注于几秒钟内就能完成的少数关键任务。
界面 surface	不同	不止包含各种活动和通知，还提供许多独特的 surface，包括应用、功能块、复杂功能、表盘主题等。
界面组件	移动应用等	包括移动设备组件和 Wear OS 专用组件，包括：BoxInsetLayout、SwipeDismissFrameLayout、WearableRecyclerView 等。
持续性活动	不同	将持续性通知添加到新的 Wear OS 应用 surface 中。
深色主题或模式	不同	仅提供深色模式以节省电量。
返回堆栈	不同	允许用户通过滑动关闭返回堆栈或在堆栈中上移。
实体按钮	不同	穿戴式设备通常包含一个或多个实体按钮。所有 Wear OS 设备都至少有一个按钮，即电源按钮。除此之外，手表上可能没有可在您的应用中使用的多功能按钮，也可能有多个此类按钮。
旋转输入	不同	某些 Wear OS 设备包含实体侧面旋钮或旋转输入钮。用户可以旋转此类按钮来向上或向下滚动您的应用的当前视图。
恢复应用运行	不同	允许用户点按两次辅助硬件按钮来使最近使用的应用恢复运行。当用户重新进入您的应用时，您的应用必须记住用户的滚动位置。
架构组件	相同	请参阅 Android 文档中的 Android 架构组件。
导航	不同	应用应采用浅层设计（避免超过两层）和线性设计（内联显示大部分内容和导航组件）。
与其他应用交互	相同	请参阅与其他应用交互。
与已配对设备交互	新增	可以通过 Wear 应用与已配对设备进行交互。如需了解详情，请参阅发送和同步数据。
intent 和 intent 过滤器	相同	请参阅 Android 文档中的 intent 和 intent 过滤器。
动画和过渡	相同	请参阅 Android 文档中的动画和过渡。
图片和图形	相同	请参阅 Android 文档中的图片和图形。
服务和后台任务	相同	请参阅 Android 文档中的服务概览。
后台任务	相同	请参阅 Android 文档中的后台工作概览。
权限	相同	请参阅 Android 文档中的 Android 中的权限。
应用数据和文件	相同	请参阅 Android 文档中的应用数据和文件。
用户数据和身份	类似	除了相关移动 API 之外，还有其他身份验证选项。详细了解在穿戴式设备上进行身份验证。
用户位置	相同	FusedLocationProvider 还利用手机的 GPS 芯片节省电池电量，并在 Wear OS 上检测位置。
轻触和输入	移动应用等	除标准触控输入外，还提供更多输入方式。如需了解详情，请参阅轻触和输入概览。
传感器	移动应用等	Wear OS 应用的开发与移动应用开发类似。如需简化 Wear OS 中的应用，请考虑使用能够为您处理这方面工作的 Health Services API。了解传感器。
健康服务	新增	提供由传感器、内容感知算法和全天健康状况监测功能生成的健身和健康数据。如需了解详情，请参阅 Wear OS 上的健康服务。
连接性	类似	大多数移动 API 均完全受支持，但也存在一些限制。例如，android.webkit API 不受支持。如需了解详情，请参阅 Wear OS 上的网络访问和同步。
Android App Bundle	相同	请参阅 Android 文档中的 Android App Bundle 简介。
依赖项注入	相同	请参阅 Android 文档中的 Android 中的依赖项注入。
测试	类似	请参阅 Android 文档中的在 Android 平台上测试应用。
性能	类似	请参阅 Android 文档中的应用性能指南。
无障碍功能	相同	请参阅 Android 文档中的打造无障碍应用。
隐私	相同	请参阅 Android 文档中的隐私设置最佳实践。
安全性	相同	请参阅 Android 文档中的应用安全性最佳实践。

本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2023-11-10。