在 Wear OS 上创建和运行应用

本页面提供使用 Android Studio 模板构建首个 Wear OS 应用的指南。该应用展示了在 Wear OS 设备上快速查看信息的多种方式，并介绍了一些在该平台上开发应用的最佳实践。

本指南基于您已具备 Android 平台和Android Studio IDE 的一些先验知识。如果您完全不了解 Android，请使用此代码实验室创建一个应用。要了解 Android Studio 的更多功能，请访问了解 Android Studio页面。

创建 Wear OS 应用

下载并安装最新版本的 Android Studio 后，完成“新建项目”向导。

  1. 打开 Android Studio，然后转到文件 > 新建 > 新建项目。将出现新建项目窗口。
  2. 在模板面板中，选择Wear OS。然后，在主面板中，选择空 Wear 应用。
  3. 命名您的项目，然后单击完成。Android Studio 将下载必要的依赖项并构建项目的初始版本。

  4. 转到工具 > SDK 管理器，并安装以下两个软件包：

    • Android 14.0 (“UpsideDownCake”)（API 级别 34），其中包括Wear OS 5 - ARM 64 v8a 系统镜像和Wear OS 5 - Intel x86 Atom_64 系统镜像。
    • Android 13.0 (“Tiramisu”)（API 级别 33），其中包括Wear OS 4 ARM 64 v8a 系统镜像和Wear OS 4 Intel x86 Atom_64 系统镜像。

    要关闭 SDK 管理器，请单击确定。

您现在可以准备在 Wear OS 上运行您的第一个应用了。

在模拟器上运行应用

运行第一个 Wear OS 应用最简单的方法是配置模拟器。

配置模拟器

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

  1. 在 SDK 管理器中，打开SDK 工具选项卡。确认您拥有最新版本的Android SDK Platform-Tools。
  2. 转到工具 > 设备管理器。
  3. 选择创建 (+)。将出现虚拟设备配置向导。
  4. 在类别面板中，选择Wear OS并选择一个硬件配置文件，例如Wear OS 小型圆形。单击下一步。

  5. 对于在中国境外使用的系统镜像，请选择UpsideDownCake发行版名称。此发行版面向 Android 14.0 (Wear OS 5)。对于在中国使用的系统镜像，请选择R发行版名称。此发行版面向 Android 11.0 (Wear OS 3)。如果您尚未安装与您的设备定义匹配的 Wear OS 5 系统镜像，请单击发行版名称旁边的下载来获取它。单击下一步。

    注意：Wear OS 模拟器的系统镜像包含第三方文件和源代码的通知。您可以通过打开NOTICE.txt文件查看特定系统镜像的第三方通知，该文件位于以下目录之一：

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI（用于在中国境外使用的模拟器）。
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI（用于在中国使用的模拟器）。

  6. 除非您想自定义模拟器，否则您可以保留此屏幕上所有设置的默认值。单击完成。

有关使用模拟器的更多信息，请参阅有关如何在 Android 模拟器上运行应用的指南。

在模拟器中打开应用

  1. 转到运行 > 选择设备。选择您刚刚创建的模拟器。
  2. 在 Android Studio 工具栏中，单击运行 。模拟器将启动并打开您的应用。
  3. 片刻之后，您应该会在模拟器中看到一条“Hello...”消息。

使用模拟器测试蓝牙音频

在运行 Wear OS 4 或更高版本的系统镜像上，模拟器支持模拟蓝牙，这使您可以测试蓝牙音频的多个用例。

最近的系统镜像仅支持 64 位架构

Wear OS 4 及更高版本的模拟器系统镜像仅支持以下 64 位架构：x86-64和arm64-v8a。如果您知道或怀疑您的应用使用原生代码（不是用 Kotlin 或 Java 编程语言编写的），请检查您的应用是否同时包含 32 位和 64 位原生库。

了解有关如何支持 64 位架构的更多信息。

在物理手表上运行应用（可选）

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

要在物理手表上运行应用，请准备设备进行测试，然后将其连接到您的开发机器。

准备手表进行测试

要准备手表进行测试，请通过完成以下步骤启用 ADB 调试。

  1. 在手表上，打开设置菜单。
  2. 转到菜单底部。如果没有显示开发者选项项目，请完成以下子步骤。否则，继续执行下一步。
    1. 点击系统 > 关于或系统 > 关于 > 版本。
    2. 找到内部版本号项目并点击它七次。如果您的手表受 PIN 或图案保护，则在系统提示时输入它。
  3. 在设置菜单中，点击开发者选项。
  4. 启用ADB 调试选项。

将手表连接到开发机器

有些手表允许您通过 USB 连接。其他手表则需要无线连接。

设置通过 USB 的有线连接

使用以下步骤连接手表：

  1. 使用 USB 数据线将手表连接到您的开发机器。
  2. 在手表上，启用始终允许来自此计算机，然后点击确定。

设置无线连接

如果您的手表没有 USB 端口，请了解如何使用 Wi-Fi 或蓝牙连接手表。

安装特定版本的 Wear OS（可选）

如果您的应用测试用例依赖于特定版本的 Wear OS，您可以将软件镜像刷入支持 USB（有线）数据连接的手表。例如，您可以将工厂镜像或完整 OTA 镜像刷入 Google Pixel Watch 3 或 Google Pixel Watch 2 设备。

在手表上打开应用

  1. 转到运行 > 选择设备。选择连接到您的机器的手表。
  2. 在 Android Studio 工具栏中，单击运行 。模拟器将启动并打开您的应用。
  3. 片刻之后，您应该会在手表上看到一条“Hello...”消息。