创建并运行 Wear OS 应用

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

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

注意：如需使用适用于模拟器的最新系统映像，请安装 Android Studio Hedgehog 或更高版本。

创建 Wear OS 应用

下载并安装最新版 Android Studio 后，请完成“new project”向导：

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

4. 依次前往 Tools > SDK Manager，点击 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 系统映像。
   注意： Wear OS 的最新稳定版 Wear OS 5.1 以 Android 15 为基础。

   如需关闭 SDK 管理器，请点击 OK。

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

注意：默认情况下，New Project 向导会创建一个独立的 Wear OS 应用，该应用无需连接到其他设备即可运行。

Wear OS 应用应独立于手机应用运行，以便用户在选择手机时拥有最大的灵活性。如果应用的体验或复杂性要求您连接到手机，请参阅有关如何将手表连接到手机的指南。

在模拟器上运行应用

若要运行您的首个 Wear OS 应用，最简单的方法就是配置模拟器。

注意：如果您计划在中国境内推出自己的 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. 对于在中国境外使用的系统映像，请选择 UpsideDownCake 版本名称。此版本以 Android 14.0 (Wear OS 5) 为目标平台。对于在中国境内使用的系统映像，请选择 R 版本名称。此版本以 Android 11.0 (Wear OS 3) 为目标平台。如果您尚未安装与您的设备定义匹配的 Wear OS 5 系统映像，请点击 Release Name 旁边的 Download 获取相应映像。点击下一步。

   注意：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 及更高版本的模拟器系统映像仅支持 x86-64 和 arm64-v8a 这两种 64 位架构。如果您知道或怀疑您的应用使用的是原生代码（不是用 Kotlin 或 Java 编程语言编写的），请检查您的应用是否同时包含 32 位和 64 位原生库。

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

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

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

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

准备手表以进行测试

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

1. 在手表上，打开设置菜单。
2. 前往菜单底部。如果未显示开发者选项菜单项，请完成以下子步骤。如果显示了此菜单项，请继续下一步操作。
   1. 依次点按系统 > 关于或系统 > 关于 > 版本。
   2. 找到 Build 号项目并点按七次。如果手表受 PIN 码或图案保护，请在收到提示时输入该 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. 依次点击 Run > Select Device。选择已连接到您的机器的手表。
2. 在 Android Studio 工具栏中，点击 Run 图标 。模拟器随即会启动并打开您的应用。
3. 片刻之后，您应该会看到手表上出现“Hello…”消息。