创建和运行穿戴式应用

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 标签页,选择 Empty Compose Activity,然后点击 Next
  3. New Project 窗口中,为项目命名,填写标准项目信息,然后点击 Finish

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

  4. 在应用模块的 build.gradle 文件中:
    • android 部分,确认 compileSdkVersion 设置为 33。
    • android 部分,确认 targetSdkVersion 设置为 30。
    • 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. 选择要下载的系统映像。例如,选择 API Level 为“30”且 Target 为“Android 11.0 (Wear OS)”的映像。点击 Next,然后点击 Finish
  5. 关闭 Android Virtual Device Manager。
  6. 在 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 调试:

  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 虚拟设备 (AVD) 或模拟器配对。

使用 Wear OS 模拟器配对助理

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

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

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

  1. 创建 Wear 模拟器(如果尚未创建)。
  2. 设备管理器中,按要配对的某台设备的“溢出”下拉菜单图标,然后选择 Pair Wearable

    图 1. 可与 Wear 模拟器配对的设备的下拉菜单。

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

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

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

将手机与手表 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 设备

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

将 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 的界面

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 上页面。