创建并运行您的首个 Wear OS 应用

本页将指导您使用 Android Studio 中的模板构建您的首个 Wear OS 应用。该应用会展示在 Wear OS 设备上一目了然地查看信息的不同方法，并会介绍一些在该平台上开发应用的最佳实践。

在使用本指南前，您需要掌握一些有关 Android 平台和 Android Studio IDE 的知识。如果您是 Android 纯新手，请使用此 Codelab 创建应用。如需详细了解 Android Studio 的功能，请访问探索 Android Studio 页面。

创建 Wear OS 应用

下载并安装最新版 Android Studio 后，请完成新项目向导：

  1. 打开 Android Studio，然后依次点击 File > New > New Project。此时将显示 New Project 窗口。
  2. 在 Templates 窗格中，选择 Wear OS。然后，在主窗格中选择 Empty Wear App。
  3. 为项目命名，然后点击 Finish。Android Studio 会下载必要的依赖项并构建您的项目。

现在，您便可以在 Wear OS 上运行您的首个应用。

在模拟器上运行应用

运行 Wear OS 应用的一种简单方法是在模拟器上运行。

配置模拟器

如需在 Android Studio 中配置模拟器，请完成以下步骤：

  1. 在 SDK 管理器中，打开 SDK Tools 标签页。确认您使用的是最新版 Android SDK 平台工具。关闭 SDK 管理器。
  2. 前往 Tools > Device Manager。
  3. 选择 Create (+)。系统随即会显示 Virtual Device Configuration 向导。
  4. 在 Category 窗格中，选择 Wear OS，并选择硬件配置文件，例如 Wear OS Small Round。点击 Next。
  5. 除非您需要进行特定自定义，否则请保留此界面上的默认设置。Android Studio 默认选择最新的 API 和系统映像。 点击 Finish。

如需详细了解如何使用模拟器，请参阅有关如何在 Android 模拟器上运行应用的指南。

在模拟器中打开应用

  1. 在主工具栏中，找到 运行 widget。从设备下拉菜单中选择您创建的模拟器，然后点击 Run “运行按钮” 按钮以启动应用。
  2. 片刻之后，模拟器中会显示“Hello…”消息。

在实体手表上运行应用（可选）

通过在实体手表上运行和调试应用，您可以更好地评估总体用户体验。如果您的应用依赖于特定硬件（例如传感器或 GPU），这一点尤为重要。

如需在实体手表上运行应用，请准备用于测试的设备，然后将其连接到开发机器。

准备手表以进行测试

如需准备手表以进行测试，请执行以下步骤来启用 ADB 调试：

  1. 在手表上，打开设置菜单。
  2. 前往菜单底部。如果未显示开发者选项菜单项，请完成以下子步骤。如果显示了此菜单项，请继续下一步操作。
    1. 依次点按系统 > 关于或系统 > 关于 > 版本。
    2. 找到 Build 号项目并点按七次。如果手表受 PIN 码或图案保护，请在收到提示时输入该 PIN 码或图案。
  3. 从设置菜单中，点按开发者选项。
  4. 启用 ADB 调试选项。

如需了解详情，请参阅配置设备上的开发者选项。

将手表连接到开发机器

有些手表支持通过 USB 进行连接，而有些手表则需要使用无线连接。

通过 USB 设置有线连接

按照以下步骤连接手表：

  1. 使用 USB 线将手表连接到开发机器。
  2. 在手表上，启用一律允许使用这台计算机进行调试，然后点按确定。

设置无线连接

如果无法通过 USB 端口调试手表，请参阅使用 Wi-Fi 连接到设备。

在手表上打开应用

  1. 在运行 widget（主工具栏的一部分）中，使用设备下拉菜单选择您的实体设备。
  2. 点击运行 widget 中的运行 “运行按钮” 按钮。
  3. 片刻之后，您的设备上会显示“Hello…”消息。

规划应用架构

现在，您已运行了一个基本应用，接下来可以开始使用模板以外的功能了。在开始添加新功能之前，最好先考虑一下将决定应用的关键架构决策。以下部分将探讨一些需要考虑的重要问题。

应用模型：独立、非独立或混合

考虑应用对配对手机的依赖程度：

  • 混合（建议用于大多数应用）：这是最常见且最灵活的方法。即使没有手机，应用的核心功能也能正常运行（例如跟踪锻炼情况），但在连接手机后，应用可提供增强的功能，例如同步数据或提供更简便的配置。
  • 独立应用：您的应用完全可以自行运行，无需使用手机即可实现核心功能。这非常适合可以离线运行或使用自有互联网连接的应用。“空 Wear 应用”模板默认会创建独立应用。
  • 非独立应用：您的应用需要手机才能实现其核心功能。

如需详细了解此选择以及相关指导，请参阅独立 Wear OS 应用与非独立 Wear OS 应用。

构建界面

Compose for Wear OS 是一种新式声明性框架，也是为 Wear OS 应用构建界面的推荐方式。您使用的模板是使用 Compose 构建的，为您提供了一个良好的起点。

使用 Compose 进行构建时，请使用专门为 Wear OS 设计的库。 这些库提供针对手表优化的组件，对于打造出色的用户体验至关重要。

例如，使用 TransformingLazyColumn 而不是标准 LazyColumn，前者会自动将缩放和透明度效果应用于圆形屏幕边缘的项目。

同样，对于导航，请使用 Wear OS Navigation 库中的 SwipeDismissableNavHost 与系统的滑动关闭手势集成。

数据存储和同步

如何管理数据是一项核心架构选择。对于设备端持久性，您的选择与移动设备上相同，DataStore 用于键值数据或类型化对象，Room 用于更复杂的结构化数据，是推荐的现代选择。

  • 先在设备上存储数据：将应用设计为离线优先，将必要的数据直接存储在手表上，以便在没有手机连接的情况下也能正常运行。
  • 与手机同步数据：当您需要与配套的手机应用同步或流式传输数据（例如用户设置或锻炼数据）时，请使用数据层 API。它提供了一个可通过蓝牙和 Wi-Fi 运行的通信渠道。

管理长时间运行的工作

许多核心 Wear OS 体验（例如锻炼或媒体播放）都是长时间运行的。正确管理这项工作对于帮助保持可靠性和节省电量至关重要。

  • 对于用户启动的长时间运行的任务：当用户启动的任务即使在用户离开应用后也需要继续运行时（例如跟踪跑步），您必须使用前台服务。在 Wear OS 上，将此服务与 Ongoing Activity API 配对。这会在表盘上创建一个持久性通知和一个可点按的图标，让用户返回您的应用。
  • 对于可延迟的后台任务：对于不需要立即执行的工作（例如定期同步数据），请使用 WorkManager。它会感知电池电量并遵循低电耗模式等系统优化，因此非常适合用于非紧急的后台处理。

考虑应用之外的因素：界面和电源

最后，请注意，Wear OS 体验不仅仅是主应用。

  • 支持其他平台：如需打造富有吸引力的高品质应用，请考虑支持其他经过腕表优化的平台。考虑创建用于快速操作和显示信息的功能块，以及用于直接在用户表盘上显示重要数据的复杂功能。
  • 规划能效：电池续航时间对于穿戴式设备至关重要。从一开始就将应用设计为省电型。这意味着，您需要仔细考虑如何提取数据、使用传感器和运行后台任务。将工作推迟到手表充电时执行通常是一个不错的策略。如需了解详情，请参阅有关节省电量的指南。