创建和运行穿戴式应用

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 中创建项目,请执行以下操作:

  1. 依次点击 File > New > New Project
  2. Project Template 窗口中,点击 Wear OS 标签页,选择 Blank Activity,然后点击 Next
  3. New Project 窗口中,为项目命名,填写标准项目信息,然后点击 Finish

    Android Studio 会使用应用模块为您的数据提供程序创建项目。

  4. 在应用模块的 build.gradle 文件中:
    • android 部分,确认 compileSdkVersion 设为 28。
    • android 部分,确认 targetSdkVersion 设为 28。
    • dependencies 部分替换为 Wear OS 专用依赖项。
  5. 在 Android 清单文件中,确保已定义 <uses-feature> 标记。定义 android:name="android.hardware.type.watch",如以下示例所示:
    <manifest>
    ...
      <uses-feature android:name="android.hardware.type.watch" />
    ...
    </manifest>
    
  6. 同步您的 Android Studio 项目。 如需运行新模块中的代码,请参阅启动模拟器并运行您的 Wear OS 应用

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

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

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

  1. 在 Android Studio 中,依次选择 Tools > AVD Manager,打开 Android Virtual Device Manager。
  2. 点击 Create Virtual Device
  3. Category 窗格中,选择 Wear OS,并选择硬件配置文件。点击 Next
  4. 选择要下载的系统映像。例如,选择 Release Name 为“Pie”、API Level 为“28” 且 Target 为“Android 9.0 (Wear OS)”的映像。点击 Next,然后点击 Finish
  5. 关闭 Android Virtual Device Manager。
  6. 在 Android Studio 工具栏中,从目标设备下拉菜单中选择您刚刚创建的 AVD,然后点击 Run

    该 AVD 将启动,并会在过一会儿后运行您的应用。您将会看到 “Hello…”消息。

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

将手机与手表 AVD 配对

如果您希望在手表 AVD 上有一个 Google 帐号,以便进行应用开发,可以将手机与手表 AVD 配对并同步 Google 帐号:

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

注意:您也可以使用 Wear OS 模拟器配对助理将实体手机或虚拟手机与手表 AVD 配对。手机必须搭载 Android 11 或更高版本,并且已安装 Google Play 商店。此外,此工具仅在 Android Studio Arctic Fox (2021.3.1) Beta 版及更高版本中提供。请参阅使用 Wear OS 模拟器配对助理

更新 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 调试:

  1. 打开手表上的设置菜单。
  2. 滚动到菜单底部。如果菜单中未提供开发者选项,请依次点按系统关于
  3. 点按版本号 7 次。
  4. 设置菜单中,点按开发者选项
  5. 启用 ADB 调试

连接手表:

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

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

设置手机

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

注意:Wear OS 应用应该是独立应用,独立于手机运行。 不过,如果您的应用依赖于某个手机应用,请参阅下文,了解如何更新手机,使其拥有最新的 Wear OS 配套应用。

使用配套应用的 Android 版本

在 Android 手机上,转到 Wear OS 应用详情。点按更新下载并安装应用。安装后,确认已为应用选择自动更新(请参阅更新下载的应用的“为特定应用设置自动更新”部分)。点按打开启动应用。

将 Android 手机与手表配对

在手机上安装配套应用后,如有必要,可取消任何过时的手表配对。然后,将手机与安装了新映像的手表进行配对:

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

适用于 iPhone 的配套应用

如果有 iOS 版配套应用,但安装该应用的手机必须运行 iOS 8.2 或更高版本,请按照以下步骤操作:

  1. 在 iPhone 上访问 App Store,然后将 Wear OS 配套应用下载并安装到 iPhone 上。
  2. 按照手表和手机上的说明开始配对过程。如需了解详情,请参阅相关的帮助页面

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

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

在您的现有项目中提供 Wear OS 模块

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

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

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

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

包含库

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

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

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

通知

如需了解通知的依赖关系,请参阅在 Wear 上创建通知

Wear OS 界面库

Wear OS 界面库中的组件体现了适合手表应用的最佳做法,建议您使用这些组件。因此,建议您添加 Wear OS 界面库的依赖项。 如需了解详情,请参阅以下页面:

其他 Jetpack 库

Wear OS 已从支持库迁移到 Jetpack。如需查看所有新类的完整列表,请参阅我们的版本说明。 以下是功能特性的部分示例:

Play 服务和穿戴式设备数据层 API

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

手机应用和手表应用之间的差异

下面是手机应用和手表应用之间的一些差异:

  • 在适用情况下,手表应用使用手表专用的 API(例如,针对圆形布局、穿戴式设备抽屉式导航栏、氛围模式等的 API)。
  • 手表应用具有不同的用户体验模型。
  • 手表应用包含适合手表的功能。
  • 手表应用可以使用许多标准的 Android API,但不支持以下 API:

    在使用某个 API 之前,您可以通过调用 hasSystemFeature() 来检查手表是否支持某项功能。

节省手表的电量

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

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

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

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

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

如需了解详情和最佳实践,请查看让您的应用始终显示在 Wear OS 上页面。

使用 Wear OS 模拟器配对助理

注意:您的手机必须搭载 Android 11 或更高版本,并且已安装 Google Play 商店才能使用 Wear OS 模拟器配对助理。

  1. 在 Android Studio 的设备下拉菜单中,点击 Wear OS 模拟器配对助理
  2. 选择一部手机和一个 Wear AVD 来相互配对。如果都不可用,请点击 View AVD Manager 以设置手机或手表 AVD。然后,点击 Next

    Android Studio 会尝试启动并在两个设备之间建立连接。如果手机上未安装 Wear OS 应用,系统会提示您从 Play 商店下载配套应用

  3. 请在下载配套应用根据系统提示打开配套应用
  4. 在手机上的 Wear OS 应用中,开始执行标准配对过程。例如,在欢迎屏幕上,点按设置按钮。或者,如果已配对某个现有手表,请在左上方的下拉菜单中点按添加新手表
  5. 在手机上的 Wear OS 应用中,点按“溢出”按钮,然后点按与模拟器配对