在 Wear OS 上创建和运行应用

此页面提供了构建第一个 Wear OS 应用的指南，使用 Android Studio 中的模板。该应用展示了在 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 平台工具。
  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 或蓝牙连接手表。

在手表上打开应用程序

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

参与设备测试版计划

在特定区域，您可以注册三星的 Galaxy One UI Watch Beta 计划。此计划允许您在合格的三星 Galaxy Watch 设备上下载 Wear OS 5 并测试应用程序的行为。

要注册，请完成以下步骤

  1. 下载 Samsung Members 应用程序，该应用程序可在 Google Play 商店 上获得。
  2. 使用您的三星帐户登录。
  3. 在主页横幅或通知页面上，滚动到 One UI Watch Beta 计划注册卡片并选择它。
  4. 在出现的页面上，阅读说明，然后选择出现的“加入”按钮。例如，在三星 Galaxy Watch6 设备上，选择 Watch 6 加入。