Wear OS 发布说明

本页面包含有关 Wear OS 版本的信息，例如 Wearable SDK 和 Wearable 支持库。

2024 年 11 月 21 日 Wearable SDK 19.0.0

Wearable SDK 19.0.0 版包含次要 SDK 更新。更新包括：

  • 库依赖项已更新到最新版本。
  • 移除了不受支持的包含 MessageOptions 参数的 sendMessage() API 变体。

2023 年 8 月 31 日 Wearable SDK 18.1.0

Wearable SDK 18.1.0 版包含次要 API 更新，以支持下一个 Wearable 支持库版本。更新包括：

2022 年 9 月 20 日 Wearable SDK 18.0.0

Wearable SDK 18.0.0 版包含次要 API 更新，以支持下一个 Wearable 支持库版本。更新包括：

  • WearableListenerService 支持面向 Android 13 的应用 — 问题 235538840。
  • 新的 MessageClient.sendRequest() 方法。

2022 年 2 月 16 日 Wearable 支持库 v2.9.0

Wearable 支持库 2.9.0 版已弃用所有剩余的类。请改用Wear OS Jetpack 库。

2021 年 10 月 29 日 Wear OS Jetpack 库

Wear OS Jetpack 库是 Wearable 支持库的替代品，它们并非设计用于一起使用。Wearable 支持库在 Wear OS 3 上无法运行。

2021 年 4 月 27 日 Wearable SDK 17.1.0

Wearable SDK 17.1.0 版包含次要 API 更新，以支持下一个 Wearable 支持库版本。

2020 年 9 月 28 日 Wearable 支持库 v2.8.1

Wearable 支持库 2.8.1 版包含以下更改。

允许在使用表盘模板时禁用 Jetifier

Android Studio 表盘模板现在使用 AndroidX 依赖项，以允许禁用 Jetifier。这些修复适用于在 Android Studio 4.2 或更高版本中使用表盘模板时。

2020 年 9 月 24 日 Wearable 支持库 v2.8.0

Wearable 支持库 2.8.0 版包含以下更改。

指定默认非系统复杂功能提供程序的备用功能

表盘现在可以使用 setDefaultComplicationProviderWithFallbacks 来指定一个或多个默认使用的非系统复杂功能提供程序。如果没有安装指定的非系统提供程序，系统将回退到使用默认系统提供程序。

WearableActivity 已弃用

WearableActivity 已弃用。请改用 AmbientModeSupport。

SKIP_CONFIRMATION_UI 已弃用

ActionConfirmationActivity.SKIP_CONFIRMATION_UI 已弃用。自 Wear 2.0 发布以来，此 extra 未被使用。

2020 年 5 月 15 日 Wearable 支持库 v2.7.0

Wearable 支持库 2.7.0 版包含以下功能。

表盘的硬件加速

现在，当使用 CanvasWatchFaceService 类时，您可以请求硬件加速的画布。利用硬件加速来提高表盘的性能并访问更多 UI 性能数据。

有关详细信息，请参阅使用硬件加速提升表盘性能。

2020 年 4 月 21 日 Wearable 支持库 v2.6.0

Wearable 支持库 2.6.0 版包含以下改进。

迁移到 Android Jetpack

Wearable 支持库已迁移到 Android Jetpack。现有库现在已映射并通过 androidx 命名空间在 AndroidX 中访问，并且已删除对已弃用的支持库的所有依赖项。

此更改还允许您在 Android Studio 4.0 及更高版本中使用 Wearable 支持库，从而解决了诸如问题 #147972079 等问题。

2019 年 8 月 28 日 Wearable 支持库 v2.5.0

Wearable 支持库 2.5.0 版包含以下改进。

修复了在调用 startActivity() 时出现 TYPE_NO_PERMISSION 复杂功能类型的 ComplicationDrawable 问题

ComplicationDrawable 现在包含一个 NEW_TASK 标志，可确保源自 WatchFaceService 的 startActivity() 调用包含 FLAG_ACTIVITY_NEW_TASK，以避免 android.util.AndroidRuntimeException。

此更改允许 TYPE_NO_PERMISSION 复杂功能类型正确启动权限请求活动，而不是导致表盘崩溃。

2018 年 9 月 25 日 Wearable SDK 16.0.0

Wearable SDK 16.0.0 版将 Google Play 服务的最低要求版本从 12.4 降低到 8.6。此更改允许现有应用更新到最新版本的 Wearable SDK，而无需更新 Google Play 服务 APK。

2018 年 6 月 11 日 更新至 Wear OS 开发者预览版 2

最近对 Wear OS 开发者预览版 2 的空中下载更新已重新启用后台应用的闹钟和作业。

尽管此政策更改支持增加应用开发的灵活性，但后台闹钟和作业仍受其他 Android P 限制的约束，包括与应用待机功耗分区相关的限制。请遵循最佳实践，以确保您的应用在任何功耗分区中都能良好运行。

此更新还通过限制后台应用对用户输入和传感器数据的访问来加强用户输入和数据隐私。根据应用的要求，您可能需要使用前台服务来启用对传感器数据的持续访问。

2018 年 5 月 8 日 Wear OS 开发者预览版 2

Wear OS 开发者预览版 2 具有改进的 Google 助理体验等功能。

使用 Wear OS by Google 问题跟踪器提交任何错误或反馈。您提交得越早，修复程序被包含在最终版本中的可能性就越高。

已知问题

本节包含预览版 2 的已知问题。

Wear OS 镜像问题

  • 当您在任何应用中时，按下手表侧面的电源按钮，您可能会返回到上一个屏幕而不是表盘。

Wear OS 中国版镜像问题

  • 当您在任何应用中时，按下手表侧面的电源按钮，您可能会返回到上一个屏幕而不是表盘。
  • 音量相关声音设置未持久化。例如，即使手表上的声音设置为关闭，来电也会导致手表发出可听见的铃声。如果您调整闹钟音量，更改将无效。
  • 多个正在进行的通知可能无法正确显示。例如，如果同时设置了计时器和秒表，则不显示通知。我们建议您使用一个正在进行的通知而不是多个通知来测试您的应用。
  • 中国版 Wear 应用商店无法使用。开发者无法通过该渠道更新或安装新应用。我们建议使用 `adb` 作为一种解决方法，通过侧载方式安装您的应用程序进行测试。

Wear 模拟器问题

  • 配套手机的来电未显示或_镜像_为配对模拟器中的来电。
  • 当您使用 SDK 管理器安装或确认您拥有 Android P 或中国版的最新安装时，选择这些选项旁边的复选框在您选择它们后可能会取消选择。如果它们取消选择，请再次选择它们。
  • 当模拟器执行冷启动时，可能会显示以下错误：“您的设备出现内部问题。请联系制造商了解详细信息。”这不影响功能。向下滚动并点击确定以开始测试您的应用。
  • 语音回复可能在模拟器上不起作用。例如，如果您在 Wear 模拟器上收到 Google Hangouts 消息的通知，并且您尝试通过语音回复消息，则会出现“Google 不断停止”错误消息，并且您无法通过语音回复。
  • 即时运行可能与 Wear 模拟器不兼容。
  • 以编程方式截取屏幕截图，例如使用 `adb` 或通过提交错误报告，可能不起作用。作为一种解决方法，点击模拟器工具栏上的相机按钮截取屏幕截图。

Wear 模拟器中国版问题

  • 配套手机的来电可能不会显示，或_镜像_为配对模拟器中的来电。因此，未接来电的通知可能不会在模拟器中显示。此外，您可能无法从模拟器接听电话，在这种情况下，电话会继续响铃。
  • 当您使用 SDK 管理器安装或确认您拥有 Android P 或中国版的最新安装时，选择这些选项旁边的复选框在您选择它们后可能会取消选择。如果它们取消选择，请再次选择它们。
  • 当模拟器执行冷启动时，可能会显示以下错误：“您的设备出现内部问题。请联系制造商了解详细信息。”这不影响功能。向下滚动并点击确定以开始测试您的应用。
  • 即时运行可能与 Wear 模拟器不兼容。
  • 以编程方式截取屏幕截图，例如使用 `adb` 或通过提交错误报告，可能不起作用。作为一种解决方法，点击模拟器工具栏上的相机按钮截取屏幕截图。

Wear 上的 Google 助理

Wear OS 上对助理的增强支持让您无需编写 Android 代码即可构建适合可穿戴设备的体验。具体来说，您可以为 Actions on Google 平台构建，帮助您的用户通过您的产品和服务完成任务。

此外，Wear OS 现在支持通过语音和触摸进行更快的交互。还支持建议芯片。它们执行以下操作：

  • 帮助用户快速完成互动
  • 向用户提示您的 Action 的功能

此外，Wear OS 现在支持更多可视化卡片，以及列表和轮播。

因此，您可以使用 DialogFlow、模板或 Actions SDK 为 Wear OS 创建 Actions on Google。您还可以利用专为手表设计的新响应模板。Actions on Google 的最佳实践包括：

  • 简短、简洁的对话
  • 启用视觉和听觉反馈

这些针对 Wear OS 上的助理的增强功能不依赖于 Android P，并且正在向所有 Wear 2.0 用户推出。有关构建 Actions on Google 的简介，请参阅与 Google 助理集成。

开发者预览版 2 中的省电功能

如以下部分所述，提供了与功耗相关的功能以延长电池续航时间。此开发者预览版 2 部分中的信息取代了开发者预览版 1 的与功耗相关的信息。

新模式：增强型省电模式

当手表处于增强型省电模式时，会显示默认的功耗优化表盘。所有以下功能都已关闭：

  • 无线电
  • 触摸屏
  • 抬腕唤醒功能

用户可以通过短按侧面按钮查看时间。长按允许用户切换回完全运行模式并执行任务，例如使用 NFC 支付或回复消息。假设在增强型省电模式下，应用、表盘和复杂功能数据提供程序不可用。

受限的后台活动

为了改进电源管理，后台应用除非手表正在充电，否则不能再启动闹钟和作业。表盘和活动复杂功能是例外。

注意：如果您的应用必须始终运行，例如用于后台监控，我们建议您通过使用 startForegroundService() 方法来使用前台服务。有关详细信息，请参阅后台服务限制。使用前台服务适用于健康监控等特殊用例。

改进的应用兼容性

为了改进应用兼容性，Android P 已开始实施对非 SDK 接口使用的一些限制。请计划停止使用非 SDK 方法和字段。如果您的用例没有公共等效项，请告知我们。

深色界面系统主题

自 2018 年初以来，Wear OS 已切换到默认 UI 主题，该主题的通知流和系统启动器具有较深的背景。此更改旨在提高应用的浏览性；请使用此新 UI 主题检查应用的无障碍功能。

更新了 Codelabs

为了帮助您探索使用 Wear OS 进行开发的重要方式，我们提供了更新的 Codelabs。例如，尝试新的基于 Kotlin 的表盘 Codelab，以试验 Kotlin 领域专用语言 (DSL)。

2018 年 3 月 27 日 Wear OS 开发者预览版 1

本节包含有关 Wear OS by Google 开发者预览版 1 的信息。在最终生产版本发布之前，此预览版预计会有多次更新。使用 Wear OS by Google 问题跟踪器提交您发现的任何错误。您提交得越早，我们将其修复包含在最终版本中的可能性就越高。

已知问题

  • 在 Wear OS 配套应用中，点击报告可穿戴设备错误似乎有效，但实际上没有生成错误报告。请使用 adb bugreport 作为一种解决方法。
  • 使用手表接听电话并不总是成功。如果失败，用户需要直接从手机接听电话。
  • 配对或启动预加载应用后，有时会出现“检测到 API 兼容性问题”错误。该错误消息会在短时间后消失，不影响可用性。
  • 在手表和模拟器的“设置”菜单中，“获取错误报告”选项显示两次。要获取错误报告，请尝试使用这两个选项中的每一个，因为只有一个是功能正常的。当您点击功能正常的选项时，会显示一个吐司消息，表明正在生成错误报告。
  • 在中国版本中，语音输入会导致应用崩溃。例如，这在使用语音搜索或使用语音添加提醒时发生，因为此功能使用语音输入 API。对于测试，请使用键盘或手写输入代替语音输入。
  • 中国版 Wear 应用商店无法使用。开发者无法通过该渠道更新或安装新应用。我们建议使用 `adb` 作为一种解决方法，通过侧载方式安装您的应用程序进行测试。

此开发者预览版中的亮点

开发者预览版 1 包含以下用于应用测试的功能：

  • 受限的后台活动：为了改进电源管理，后台应用不能再使用闹钟和作业。用户选择的表盘和复杂功能是例外。此功能将在开发者预览版中逐步推出，因此您可能不会立即在手表上看到它。

    注意：如果您的应用必须始终运行，请将其修改为通过使用 startForegroundService() 方法将其设为前台服务。有关详细信息，请参阅后台服务限制。

  • 对应用使用非 SDK 接口的限制：为了改进应用兼容性，Android P 已开始对非 SDK 接口的使用实施某些限制。请计划停止使用非 SDK 方法和字段。如果您的用例没有公共等效项，请告知我们。
  • 深色界面系统主题：自 2018 年初以来，Wear OS 已切换到默认 UI 主题，该主题的通知流和系统启动器具有较深的背景。此更改旨在提高应用的浏览性；请使用此新 UI 主题检查应用的无障碍功能。
  • 当手表离身时，无线电关闭：为了改进电源管理，当手表长时间检测到离身时，蓝牙无线电、Wi-Fi 无线电和蜂窝无线电都将关闭。此功能将在开发者预览版中逐步推出，因此您可能最初不会在手表上看到它。如果此功能在您的开发过程中造成困难，您可以使用 `adb` 通过以下命令禁用此功能：
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • 蓝牙断开连接时 Wi-Fi 关闭：为了改进电源管理，当手表从蓝牙断开连接时，手表不再自动连接到 Wi-Fi。例外情况包括应用请求高带宽网络，以及手表连接到充电器的情况。此功能将在开发者预览版中逐步推出，因此您可能最初不会在手表上看到它。

Wearable 支持库 v2.3.0 更新

Wearable 支持库的 v2.3.0 文档更新包含品牌重塑更新。

此外，库的 v2.3.0 版还包含与 ComplicationDrawable 和 TextRenderer 相关的更新，用于处理带有标记对象的文本范围。这些类对 span 文本的处理有所改进。只有特定子集的 span 可以渲染——请参阅 setText 方法以了解可绘制的 span 类型——这样在表盘中渲染时，span 不会显得格格不入。

2018 年 3 月 15 日 Wear 品牌重塑

本节包含有关 Wear OS 功能的信息。

Android Wear 新名称

Android Wear 更名为 Wear OS by Google。

2018 年 2 月 27 日 微光模式更新

本节包含有关新的 Android Wear 功能的信息。

支持微光模式的新类

Android 支持库的 27.1.0 版包含一个新类 AmbientModeSupport，它取代了已弃用的 AmbientMode 类。样本的更新计划在未来几周内进行。

2018 年 1 月 25 日 最终模拟器及更多

本节包含有关新的 Android Wear 功能的信息。

Android 模拟器：Wear 更新

适用于 Wear 的 Android 模拟器最终更新已可用于测试基于 API 版本 26 的应用。

Wearable 支持库 v2.2.0 中的增强功能

Wearable 支持库的 2.2.0 版包含以下所述的更新。

新的未读通知指示器

因为用户希望了解未读通知，所以提供了一个新的指示器：表盘底部的一个带圆圈的点。如果您更喜欢自行管理通知，可以使用 setHideNotificationIndicator 隐藏默认指示器并显示您自己的指示器，或者使用 setShowUnreadCountIndicator 在状态栏中显示通知计数。

使用 setAccentColor 方法自定义未读通知指示器外圈的颜色。

注意：未读通知指示器在 Wear 2.8.0 的生产版本中未启用。请改用最新的 Wear 模拟器测试您的实现。从 Wear 的下一个消费者版本（2.9.0 版）开始，未读通知指示器将默认显示。

ComplicationDrawable 类的增强功能

ComplicationDrawable 类会为在系统指示值为 TYPE_NO_PERMISSION 时被点击的表盘启动权限请求，表示表盘缺少获取复杂功能数据的权限。

此外，ComplicationDrawable 类在加载图像完成后或点击高亮显示过期时会使其自身失效。为了响应此失效（例如重新绘制表盘），请添加 Drawable.Callback。

已知问题

  • 如果您在模拟器中激活影院模式，如更改屏幕和亮度设置中所述，模拟器可能会一直卡在影院模式。修复此问题需要清除模拟器数据；请参阅运行和停止模拟器并清除数据。
  • 在 API 级别 25 或 26 的模拟器窗口中，电源按钮不起作用。请改用除电源按钮之外的按钮。具体来说，要切换到微光模式（例如，用户用手掌覆盖屏幕），请使用显示屏右侧模拟器工具栏上的电源按钮。要在交互模式下启动应用启动器，请使用模拟器工具栏上的主页按钮。
  • 在模拟器的中国版本中，如果使用手写输入法，屏幕可能会开始闪烁。然后，当您点击屏幕键盘按钮时，键盘会遮挡屏幕的一半。

2017 年 12 月 18 日 Google Play 服务新访问权限

本节包含有关新的 Android Wear 功能的信息。

从 GoogleApiClient 类迁移

从 Google Play 服务 11.8.0 版开始，将您的 Wear 应用从 GoogleApiClient 类迁移，并改用基于 GoogleApi 类和 Tasks API 的 API 客户端对象。

注意：此更新不适用于针对中国的 Android Wear 应用，这些应用通常使用 Google Play 服务 10.2.0 版。

有关详细信息，请参阅以下内容：

连接 Google Play 服务的新组件

当您使用扩展 GoogleApi 类的类时，例如 DataClient 和 MessageClient，Google Play 服务 SDK 会为您管理与 Google Play 服务的连接。使用这些类的应用不再需要创建和管理 GoogleApiClient 对象。有关详细信息，请参阅博客文章 告别 GoogleApiClient。

有关连接到 Google Play 服务的相关 Wear 组件的替代品，请参阅已弃用组件的替代品。有关 Google Play 服务的版本和已知问题，请参阅Google Play 服务发布说明。

注意：如果您使用最新版本的 Google Play 服务编译您的应用，系统会提示用户将其设备更新到最新版本。但是，针对 API 版本 26 的应用的一个已知问题可能会阻止用户收到更新设备的提示。此问题在Google Play 服务发布说明中有所描述。

2017 年 10 月 25 日 微光模式及更多

本节包含有关新的 Android Wear 功能的信息。

Android 支持库 v27.0.0：功能和错误修复

Android 支持库的 27.0.0 版包含 Wear 的新功能。请查阅以下部分。

支持微光模式的新首选方式

微光模式允许 Wear 应用在设备闲置时对用户保持可见。Android 支持库提供了一种新的、首选的方式供您的应用使用微光模式。Wear 团队正在寻求开发者反馈，以了解这一重大变化。

具体来说，使用 AmbientMode 类提供以下优势：

Android 支持库中的清单元数据常量

用于 Android Wear 应用的常量（在 Android Manifest 文件中的 meta-data 标签中使用）现在在 Android 支持库中可用。要使用这些常量（适用于独立应用、通知桥接模式和表盘预览图像），请在应用模块的 build.gradle 文件的依赖项部分添加对以下内容的引用，这需要最新版本的 Google 仓库：

Groovy

implementation 'com.android.support:wear:27.0.0'

Kotlin

implementation("com.android.support:wear:27.0.0")

操作抽屉式导航栏更新

用于创建可穿戴设备操作抽屉式导航栏的 WearableActionDrawerView 类已更新。在最新版本中：

  • 修改菜单项后，操作抽屉式导航栏会正确更新。
  • 如果为操作抽屉式导航栏设置了标题，则标题会正确显示。

RoundedDrawable 类的膨胀

假设 API 级别至少为 24， RoundedDrawable 类现在可以从可绘制 XML 文件中膨胀；请参阅自定义可绘制对象。

Wearable 支持库 v2.1.0：增强功能及更多

Wearable 支持库的 2.1.0 版包含以下部分所述的更新，并且需要 Android 支持库 26.0.2 版或更高版本。

为微光模式提供防烧屏图像

ComplicationDrawable 类允许您为微光模式提供防烧屏图像。具体来说，当启用防烧屏保护时， ComplicationData 对象的防烧屏小图像字段允许表盘在微光模式下显示 SMALL_IMAGE 复杂功能类型中的小图像。

复杂功能的点击事件更新

ComplicationDrawable 类有一个新的 onTap 方法，允许您的表盘将点击事件传递给复杂功能。新方法基于现有功能，其中表盘上的点击会触发 WatchFaceService.Engine.onTapCommand 方法。

您可以通过 onTap 调用将坐标传递给 ComplicationDrawable，以启动包含点击坐标的 ComplicationDrawable 关联的操作。调用新的 onTap 方法时，您可以使用 true 的返回值查看 ComplicationDrawable 是否启动了与其关联的操作。

此外，setHighlightDuration 方法设置复杂功能在调用 onTap 方法后保持高亮显示的时长。

范围值复杂功能的进度条

如果您希望在表盘中为范围值复杂功能绘制自己的进度条，请使用 ComplicationDrawable 类的 setRangedValueProgressHidden 方法隐藏由 ComplicationDrawable 绘制的范围值进度。

2017 年 10 月 2 日 Android Wear 测试版

日期：2017 年 10 月 2 日
版本：OWP4.170828.008
支持设备：LG Watch Sport

本节包含 Android Wear 测试版的已知问题。有关测试版计划或注册信息，请参阅 Android 测试版页面。

已知问题

  • Google Pay 及其卡片在此 Android Wear 测试版中无法使用。
  • 即使蜂窝网络连接已开启，在安装测试版后也会关闭。作为一种解决方法，请在安装测试版后通过导航到设置 > 连接 > 蜂窝网络来开启蜂窝网络连接。
  • 如果在测试版更新后通知不稳定或丢失，或者联系人未同步，请恢复出厂设置手表。
  • 在手表设置完成后开始的 Wear 教程中，一些卡片行为异常，但可以通过滑动正常关闭。
  • 在 Android 6.0 手机上，手表上不会收到电话通知。
  • 更新后心率监测有时会失败。作为一种解决方法，请重启手表。
  • 流中的 OTA 卡有时无法启用安装。作为一种解决方法，请导航到设置 > 系统 > 关于 > 系统更新。