Wear OS 发行说明

此页面包含有关 Wear OS 版本的信息，例如 Wearable SDK 和 Wearable Support Library。

2023 年 8 月 31 日 Wearable SDK 18.1.0

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

2022 年 9 月 20 日 Wearable SDK 18.0.0

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

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

2022 年 2 月 16 日 Wearable Support Library v2.9.0

Wearable Support Library 的 2.9.0 版本弃用了所有剩余的类。请改用 Wear OS Jetpack 库。

2021 年 10 月 29 日 Wear OS Jetpack 库

Wear OS Jetpack 库 是 Wearable Support Library 的替代品，它们并非设计为一起使用。Wearable Support Library 不适用于 Wear OS 3。

2021 年 4 月 27 日 Wearable SDK 17.1.0

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

2020 年 9 月 28 日 Wearable Support Library v2.8.1

Wearable Support Library 的 2.8.1 版本包含以下更改。

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

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

2020 年 9 月 24 日 Wearable Support Library v2.8.0

Wearable Support Library 的 2.8.0 版本包含以下更改。

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

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

WearableActivity 已弃用

WearableActivity 已弃用。请改用 AmbientModeSupport。

SKIP_CONFIRMATION_UI 已弃用

ActionConfirmationActivity.SKIP_CONFIRMATION_UI 已弃用。自 Wear 2.0 发布以来，此额外内容未使用。

2020 年 5 月 15 日 Wearable Support Library v2.7.0

Wearable Support Library 的 2.7.0 版本包含以下功能。

手表表盘的硬件加速

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

更多信息，请参阅 使用硬件加速提高手表表盘性能。

2020 年 4 月 21 日 Wearable Support Library v2.6.0

Wearable Support Library 的 2.6.0 版本包含以下改进。

迁移到 Android Jetpack

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

此更改还允许您在 Android Studio 4.0 和更高版本中使用 Wearable Support 库，从而解决 问题 #147972079 等问题。

2019 年 8 月 28 日 Wearable Support Library v2.5.0

Wearable Support Library 的 2.5.0 版本包含以下改进。

修复使用 TYPE_NO_PERMISSION 复杂功能类型调用 startActivity() 时的 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 的 无线 (OTA) 更新已重新启用后台应用的闹钟和作业。

虽然此策略更改支持提高应用开发的灵活性，但后台闹钟和作业仍受其他 Android P 限制的约束，包括与 应用待机桶 相关的限制。请遵循 最佳实践，以确保您的应用能够正常运行，无论应用位于哪个桶中。

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

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

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

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

已知问题

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

Wear OS 镜像的问题

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

中国版 Wear OS 镜像的问题

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

Wear 模拟器的问题

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

中国版 Wear 模拟器的问题

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

Wear 上的 Google 助理

对 Wear OS 上的 Google 助理的增强支持使您可以构建可随时用于可穿戴设备的体验，而无需编写 Android 代码。具体来说，您可以为 Google 动作平台构建，帮助您的用户完成您的产品和服务相关的事项。

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

  • 帮助用户快速完成交互
  • 向用户提示您的操作的功能

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

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

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

Wear OS 上的 Google 助理的这些增强功能不依赖于 Android P，并且正在推广到所有 Wear 2.0 用户。有关构建 Google 动作的介绍，请参阅 与 Google 助理集成。

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

如下节所述，提供与电源相关的功能以延长电池寿命。本开发者预览版 2 部分中的信息取代了开发者预览版 1 中与电源相关的部分信息。

新增模式：增强省电模式

当手表处于增强省电模式时，会显示默认的省电表盘。以下所有功能均被关闭：

  • 无线电
  • 触摸屏
  • 抬腕亮屏功能

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

有限的后台活动

为了改善电源管理，后台应用将无法再启动闹钟和作业，除非手表正在充电。例外情况包括表盘和活动的复杂功能。

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

改进的应用兼容性

为了提高应用兼容性，Android P 已开始实施对非SDK接口的使用进行某些限制。请计划迁移到非SDK方法和字段之外。如果您的用例没有可用的公共等效项，请告知我们。

深色UI系统主题

自2018年初以来，Wear OS已切换到默认的UI主题，该主题为通知流和系统启动器提供较暗的背景。此更改旨在提高您应用的可读性；请使用此新的UI主题检查您的应用的可访问性。

提供更新的Codelabs

为了帮助您探索使用Wear OS进行开发的重要方法，现已提供更新的Codelabs。例如，尝试新的基于Kotlin的表盘Codelab，以试验Kotlin领域特定语言或DSL。

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

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

已知问题

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

此开发者预览版中的亮点

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

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

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

  • 对应用使用非SDK接口的限制：为了提高应用兼容性，Android P 已开始实施对非SDK接口的使用进行某些限制。请计划迁移到非SDK方法和字段之外。如果您的用例没有可用的公共等效项，请告知我们。
  • 深色UI系统主题：自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。例外情况包括应用请求高带宽网络的情况，以及手表连接到充电器的情况。此功能将在开发者预览版中逐步推出，因此您可能不会立即在手表上看到它。

可穿戴支持库v2.3.0更新

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

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

2018年3月15日 Wear品牌重塑

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

Android Wear的新名称

Android Wear更名为Google Wear OS。

2018年2月27日 环境模式更新

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

支持环境模式的新类

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

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

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

Android模拟器：Wear更新

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

可穿戴支持库v2.2.0中的增强功能

可穿戴支持库的2.2.0版本包含以下描述的更新。

新的未读通知指示器

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

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

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

对ComplicationDrawable类的增强

当系统指示值为TYPE_NO_PERMISSION（表示表盘缺乏获取复杂功能数据的权限）时，ComplicationDrawable类将启动对表盘的点击权限请求。

此外，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 Support Library，v27.0.0：功能和错误修正

Android Support Library 的 27.0.0 版本 包含 Wear 的新功能。请查看以下部分。

支持环境模式的新首选方法

环境模式允许 Wear 应用在设备空闲时保持对用户的可见性。Android Support Library 提供了一种新的、首选的让您的应用使用环境模式的方法。Wear 团队寻求 开发者反馈 来应对这一重大变化。

具体来说，使用 AmbientMode 类可带来以下好处

Android Support Library 中的清单元数据常量

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

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 Support Library，v2.1.0：增强功能及更多

Wearable Support Library 的 2.1.0 版本 包含以下部分中描述的更新，并需要 Android Support Library 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 卡片有时无法启用安装。作为变通方法，请导航到**设置 > 系统 > 关于 > 系统更新**。