创建和运行穿戴式应用

Wear OS 应用直接在手表上运行，可让您使用传感器和 GPU 等硬件。穿戴式设备应用与使用 Android 软件开发套件 (SDK) 的其他应用类似，但在设计和功能方面有所不同。

Wear OS 应用应独立于手机应用运行，以便用户在选择手机时拥有最大的灵活性。如需了解详情，请参阅独立 Wear OS 应用与非独立 Wear OS 应用。

注意：如调试 Wear OS 应用中所述，您可以通过 USB、Wi-Fi 或蓝牙在实体手表上测试应用。通过在实体手表上调试应用，您可以更好地评估总体用户体验。您还可以使用 Android Studio 中的手表模拟器，测试自己的应用在不同屏幕形状和尺寸下的效果。

设置您的环境

安装最新版本的 Android Studio。如需了解如何在 Android Studio 中创建应用，请参阅项目概览。

使用 SDK 管理器确认已安装支持 Wear OS Android 11（API 级别 30）的最新版 Android 平台。

如果您计划在中国境内推出自己的 Wear OS 应用，请参阅打造中国版 Wear OS 应用。

创建 Wear OS 应用

您可以使用 Android Studio 的 New Project 向导来创建 Wear OS 应用项目。

开始 Wear OS 项目

如需在 Android Studio 中创建项目，请完成以下步骤：

依次点击 File > New > New Project。
在 Project Template 窗口中，点击 Wear OS 标签页，选择 Empty Compose Activity，然后点击 Next。
在 New Project 窗口中，为项目命名，填写标准项目信息，然后点击 Finish。

Android Studio 会使用应用模块为您的数据提供程序创建项目。
在应用模块的 build.gradle 文件中，执行以下操作：
- 在 android 部分，确认 compileSdkVersion 设置为 33。
- 在 android 部分，确认 targetSdkVersion 设置为 30。
- 将 dependencies 部分替换为 Wear OS 专用依赖项。
在 Android 清单文件中，确保已定义 <uses-feature> 标记。定义 android:name="android.hardware.type.watch"，如以下示例所示：
```
<manifest>
...
  <uses-feature android:name="android.hardware.type.watch" />
...
</manifest>
```
同步您的 Android Studio 项目。如需在新模块中运行代码，请参阅下一部分中的步骤。

启动模拟器并运行您的 Wear OS 应用

如需使用模拟器，请配置 Android 虚拟设备 (AVD)。通过 SDK 管理器确认您已安装最新版 Android SDK 平台工具。

您可以按照以下步骤配置 AVD 并运行您的应用：

在 Android Studio 中，依次选择 Tools > AVD Manager，打开 Android Virtual Device Manager。
点击 Create Virtual Device。
在 Category 窗格中，选择 Wear OS，并选择硬件配置文件。点击 Next。
选择要下载的系统映像。例如，选择 API Level 为“30”且 Target 为“Android 11.0 (Wear OS)”的映像。点击 Next，然后点击 Finish。
关闭 Android Virtual Device Manager。
在 Android Studio 工具栏中，从目标设备菜单中选择您刚刚创建的 AVD，然后点击 Run 。
该 AVD 将启动，并会在过一会儿后运行您的应用。您将会看到“Hello...”消息。

如需详细了解如何使用 AVD，请参阅在 Android 模拟器上运行应用。

更新 Wear OS 项目

如果您已有项目，可能需要更新 settings.gradle 文件。请务必使用 google() 来指示 Google Maven 制品库。如需了解相关信息，请参阅 Google 的 Maven 制品库。

在 Android Studio 项目的 settings.gradle 文件中添加以下代码：

  dependencyResolutionManagement {
      ...
      repositories {
          google()
          jcenter()
      }
  }

警告：JCenter 仓库已于 2021 年 3 月 31 日变为只读仓库。如需了解详情，请参阅 JCenter 服务更新。

设置手表

将应用部署到手表的过程与将应用部署到手机类似。

本部分假定您的手表有 USB 端口。如果您的手表没有 USB 端口，请参阅使用 Wi-Fi 或蓝牙连接手表的说明。

在手表上启用 adb 调试，如下所示：

打开手表上的设置菜单。
滚动到菜单底部。如果菜单中未提供开发者选项，请依次点按系统和关于。
点按 build 号七次。
从设置菜单中，点按开发者选项。
启用 ADB 调试。

按照以下步骤连接手表：

通过 USB 将手表连接到您的计算机，以便将应用直接安装到手表上。
在手表上，点按始终允许使用这台计算机进行调试，然后点按确定。

连接手表后，通过选择部署目标来您的运行应用，如构建和运行应用中所述。

设置手机

本部分介绍了如何为移动手机设置 Wear OS 配套应用。

注意：我们建议 Wear OS 应用应为独立应用，并且独立于手机运行。不过，如果您的 Wear OS 应用依赖于移动应用，请参阅以下有关使用最新 Wear OS 配套应用更新手机的信息。

使用配套应用的 Android 版本

在 Android 手机上，前往 Wear OS by Google 谷歌智能手表应用详情。点按更新下载并安装应用。安装后，确认已为应用选择自动更新。请参阅更新下载的应用的“如何自动更新个别 Android 应用”部分）。点按打开启动应用。

将 Android 手机与手表配对

在手机上安装配套应用后，如有必要，可取消任何过时的手表配对。然后，将手机与安装了新映像的手表进行配对。为此，请完成以下步骤：

在手机上，从设备列表中选择您的手表设备名称。手机和手表上都会显示配对码。请检查配对码是否一致。
点按配对继续配对过程。手表连接到手机后，系统会显示一条确认消息。手机上会显示一个屏幕，其中会列出手机上的帐号。
选择要添加并同步到手表的 Google 帐号。
确认屏幕锁定，然后输入密码，开始将帐号从手机同步到手表。
按照向导中的说明完成配对过程。

适用于 iPhone 的配套应用

iOS 配套应用适用于搭载 iOS 8.2 或更高版本的手机。如需安装该配套应用，请执行以下操作：

在 iPhone 上访问 App Store，下载并安装 Wear OS by Google 谷歌配套应用。
按照手表和手机上的说明开始配对过程。如需了解详情，请参阅有关解决手表设置问题的页面。

将设备与手表模拟器配对

您可以手动或通过 Wear OS 模拟器配对助理将设备与手表 Android 虚拟设备 (AVD) 或模拟器配对。

使用 Wear OS 模拟器配对助理

注意：您的手机必须搭载 Android 11（API 级别 30）或更高版本，并且已安装 Google Play 商店，才能使用 Wear OS 模拟器配对助理。此外，请确保 Wear 模拟器搭载 API 级别 28 或更高级别，以便使用最新的助理功能。如需为模拟设备升级系统映像，请使用 SDK 管理器。

借助 Wear OS 模拟器配对助理，您可以更轻松地管理和连接 Wear 模拟器。您可以将多台 Wear 设备与一台虚拟或实体手机配对。Android Studio 还会记住之前配对过的设备，并在此类设备启动后重新配对。

如需与两台设备配对，请按以下步骤操作：

创建 Wear 模拟器（如果尚未创建）。
在设备管理器中，点击要配对的设备旁边的溢出菜单图标，然后选择 Pair Wearable。

图 1. 可与 Wear 模拟器配对的设备的溢出菜单。
这将启动 Wear OS 模拟器配对助理。如果您在手机的条目上选择了 Pair Wearable，则会看到一个可用 Wear 设备的列表。如果您是从 Wear 设备入手，则会看到可用手机的列表。选择要配对的设备，然后点击 Next。
Android Studio 可能需要几分钟时间才能启动并准备好相应设备。如果您的手机尚未安装 Wear OS 配套应用，请按照提示登录 Play 商店，然后安装并设置该应用。
如需在手机上的 Wear OS 应用中配对设备，请点击溢出菜单，然后选择与模拟器配对。

设备成功配对后，设备管理器会在已配对的设备旁边显示小图标。您也可以点击溢出下拉菜单，然后选择 View Details 查看已配对设备的列表。

**图 2.** **Paired Devices** 工具窗口会显示与所选设备配对的设备。

将手机与手表 AVD 配对

如果您希望在手表 AVD 上有一个 Google 帐号，以便进行应用开发，可以将手机与手表 AVD 配对，然后执行以下操作来同步 Google 帐号：

按照相关步骤设置手机。
在手机上，启用开发者选项和 USB 调试。
通过 USB 将手机连接到计算机。
在每次连接手机时，使用以下命令将 AVD 的通信端口转接到连接的手机：
adb -d forward tcp:5601 tcp:5601
在手机上的 Wear OS 配套应用中，开始执行标准配对过程。例如，在“欢迎”屏幕上，点按设置按钮。或者，如果已配对某个现有手表，请在左上方的菜单中点按添加新手表。
在手机上的 Wear OS 配套应用中，点按溢出菜单，然后点按与模拟器配对。
点按设置图标。
在设备设置下方，点按模拟器。
点按帐号，然后选择一个 Google 帐号。按照向导中的步骤将帐号与模拟器同步。必要时，输入屏幕锁定设备密码和 Google 帐号密码，开始帐号同步。

将手机连接到多台 Wear 设备

如需将第二台 Wear 设备连接到虚拟或实体手机，请按照与初始配对相同的步骤操作：在设备管理器中找到要配对的手机或 Wear 设备，点击溢出菜单，然后点击 Pair Wearable。

将 Wear OS 模块添加到您的项目

在 Android Studio 中，您可以向现有项目添加一个用于 Wear OS 设备的模块，以便重复使用移动应用的代码。

在您的现有项目中创建 Wear OS 模块

如需创建 Wear OS 模块，请打开您的现有 Android Studio 项目并执行以下操作：

依次点击 File > New > New Module。
在 New Module 窗口中，选择 Wear OS Module，然后点击 Next。
在 Configure the new module 下方，输入以下信息：
- Application/Library Name：新模块的应用启动器图标的标题
- Module Name：源代码和资源文件所在文件夹的名称
- Package Name：模块中代码的 Java 命名空间。作为模块的 Android 清单文件中的 package 属性添加。
- Minimum SDK：应用模块支持的最低平台版本。例如，选择 API 26: Android 8.0。此值会设置 build.gradle 文件中的 minSdkVersion 属性（稍后可进行修改）。
点击 Next。您会看到多个代码模板选项。选择 Blank Wear OS Activity，然后点击 Next。
在 Configure Activity 窗口中，输入 Activity Name、Layout Name 和 Source Language 的值或接受默认值。点击 Finish。

Android Studio 随即会为新模块创建并同步文件。 Android Studio 还会将 Wear OS 所需的所有依赖项添加到新模块的 build 文件中。新模块随即会显示在屏幕左侧的 Project 窗口中。如果您没有看到新模块的文件夹，请确保窗口中显示的是 Android 视图。

在新的 Wear OS 模块的 build.gradle 文件中添加以下内容：

在 android 部分，将 compileSdkVersion 的值设置为 33，将 targetSdkVersion 的值设置为 30。
添加所需的依赖项。如需了解详情，请参阅声明依赖项。
同步您的 Android Studio 项目。如需运行新模块中的代码，请参阅启动模拟器并运行您的 Wear OS 应用。

包含库

注意：Android Studio 提供了项目设置、库集成和打包功能，因此请使用 Android Studio 进行 Wear OS 开发。

当您使用 Android Studio 的项目向导时，该向导会将依赖项导入到相应模块的 build.gradle 文件中。不过，并非所有应用都需要这些依赖项。请查看下面与依赖项相关的信息。

如需将现有 Wear OS 项目更新为最新的 SDK 版本，请使用启动 Wear OS 项目部分中列出的设置。

通知

如需了解通知的依赖项，请参阅在 Wear 上创建通知。

构建适用于 Wear OS 的界面

Compose 是为 Wear OS 应用构建界面时建议采用的方法。Compose for Wear OS 提供了超过 20 个针对 Wear OS 设备类型设计的组件，远远超过基于视图的布局可用的组件数量。这些组件旨在帮助您打造符合 Wear OS 最新 Material Design 准则的用户体验。

不过，如果您希望使用视图进行构建，请添加 Wear OS 界面库的依赖项。如需了解详情，请参阅在 Wear OS 上构建基于视图的界面。

Play 服务和 Wearable Data Layer API

如果您的应用为了同步和发送数据（使用数据层 API）或出于其他原因而依赖于 Google Play 服务，那么您需要最新版本的 Google Play 服务。如果您不使用这些 API，请移除依赖项。

节省手表的电量

当手表处于闲置状态时，或当用户用手掌遮挡屏幕时，手表将从互动模式转换为氛围模式。

如需节省手表的电量，请避免使用氛围模式。如果手表在应用处于活动状态时进入系统氛围模式，并且用户在指定时间内再次与其手表互动，则系统会优先显示应用。

您可能希望针对特定用例替换应用中的氛围模式。例如，如果用户正在跟踪跑步并且需要持续查看时间，请替换氛围模式。

可转换为氛围模式的手表应用称为始终开启的应用。下面介绍了始终开启的应用的两种操作模式：

互动: 在此模式下使用全彩色处理流体动画。应用可对输入做出响应。
氛围模式: 在此模式下，使用黑白色图形渲染屏幕，且不显示任何输入提示。只有运行 Android 5.1 或更高版本的设备支持此显示模式。

如需了解详情和最佳实践，请参阅让您的应用始终显示在 Wear OS 上。