在 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（空白 Wear 应用）。
  3. 为项目命名，然后点击 Finish（完成）。Android Studio 会下载必要的依赖项并构建项目的初始版本。

  4. 转到 Tools > SDK Manager（工具 > SDK 管理器），点击 Show Package Details（显示软件包详情），然后安装以下软件包

    • Android 15.0 ("VanillaIceCream") (API 级别 35-ext15)，其中包括 Wear OS 5.1 ARM 64 v8a 系统映像和 Wear OS 5.1 Intel x86 Atom_64 系统映像。
    • 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 管理器，请点击 OK（确定）。

您现在已准备好在 Wear OS 上运行您的第一个应用。

在模拟器上运行应用

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

配置模拟器

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

  1. 在 SDK 管理器中，打开 SDK Tools（SDK 工具）标签页。确认您已安装最新版 Android SDK Platform-Tools（Android SDK 平台工具）。
  2. 转到 Tools > Device Manager（工具 > 设备管理器）。
  3. 选择 Create (+)（创建 (+)。此时将显示 Virtual Device Configuration（虚拟设备配置）向导。
  4. 在 Category（类别）窗格中，选择 Wear OS，然后选择一个硬件配置文件，例如 Wear OS Small Round（Wear OS 小型圆形）。点击 Next（下一步）。

  5. 对于在中国境外使用的系统映像，请选择 UpsideDownCake 版本名称。此版本面向 Android 14.0 (Wear OS 5)。对于在中国使用的系统映像，请选择 R 版本名称。此版本面向 Android 11.0 (Wear OS 3)。如果您尚未安装与您的设备定义匹配的 Wear OS 5 系统映像，请点击 Release Name（版本名称）旁边的 Download（下载）进行下载。点击 Next（下一步）。

    注意： 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. 您可以保留此屏幕上所有设置的默认值，除非您想自定义模拟器。点击 Finish（完成）。

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

在模拟器中打开应用

  1. 依次点击 Run > Select Device（运行 > 选择设备）。选择您刚刚创建的模拟器。
  2. 在 Android Studio 工具栏中，点击 Run（运行）。模拟器会启动并打开您的应用。
  3. 稍等片刻，您应该会在模拟器中看到“Hello...”消息。

使用模拟器测试蓝牙音频

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

近期系统映像仅支持 64 位架构

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

详细了解如何支持 64 位架构。

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

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

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

准备用于测试的手表

要准备用于测试的手表，请完成以下步骤以启用 ADB 调试。

  1. 在手表上，打开Settings（设置）菜单。
  2. 滚动到菜单底部。如果没有显示 Developer options（开发者选项）项，请完成以下子步骤。否则，继续执行下一步。
    1. 依次点击 System > About（系统 > 关于）或 System > About > Versions（系统 > 关于 > 版本）。
    2. 找到 Build number（版本号）项并轻触七次。如果您的手表受 PIN 码或图案保护，请在提示时输入。
  3. 在 Settings（设置）菜单中，轻触 Developer options（开发者选项）。
  4. 启用 ADB debugging（ADB 调试）选项。

将手表连接到开发机器

有些手表支持通过 USB 连接。另一些则需要无线连接。

设置有线 USB 连接

按照以下步骤连接手表

  1. 使用 USB 线将手表连接到您的开发机器。
  2. 在手表上，启用 Always allow from this computer（始终允许此计算机），然后轻触 OK（确定）。

设置无线连接

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

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

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

在手表上打开应用

  1. 依次点击 Run > Select Device（运行 > 选择设备）。选择连接到您机器的手表。
  2. 在 Android Studio 工具栏中，点击 Run（运行）。模拟器会启动并打开您的应用。
  3. 稍等片刻，您应该会在手表上看到“Hello...”消息。