Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

Wear OS 版本说明

此页面介绍了与 Wear OS by Google 谷歌相关的信息。

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 助理体验

借助针对开发者预览版 2 更新的 Wear OS 映像和模拟器,您可以在 Wear OS 中探索 Android P 预览版功能

请通过 Wear OS by Google 谷歌问题跟踪器提交任何错误或反馈。您提交问题的时间越早,我们在最终版本中进行修复的可能性就越高。

模拟器和可下载的映像

预览版映像和模拟器在 Wear OS 中纳入了 Android P 预览版功能

Android Studio 提供了 Wear 模拟器的开发者预览版;请参阅 Wear OS 预览版设置

注意:此预览版仅面向开发者,不适合日常使用或用户使用。在下载映像前,请先查看已知问题

以下映像适用于测试和开发面向下一个 Wear OS 版本的应用:

已知问题

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

Wear OS 映像的问题

  • 当您处于任何应用中并按手表侧面的电源按钮时,您可能会返回上一个屏幕,而不是表盘主题。

中国版 Wear OS 映像的问题

  • 当您处于任何应用中并按手表侧面的电源按钮时,您可能会返回上一个屏幕,而不是表盘主题。
  • 与音量相关的声音设置无法保留。例如,来电时手表会响铃,即使手表设为静音也是如此。此外,如果您调整闹钟音量,更改不起作用。
  • 多个进行中的通知可能无法正确显示。例如,如果同时设置计时器和秒表,则系统不会显示通知。我们建议您使用一个(而不是多个)进行中的通知测试应用。
  • 中国版 Wear 应用商店尚未开放。开发者无法通过此渠道更新或安装新应用。要解决此问题,我们建议开发者使用 adb 旁加载应用以进行测试。

Wear 模拟器的问题

  • 配套手机上的来电未在配对模拟器中显示(对应)为来电。
  • 在您使用 SDK 管理器安装最新版本的 Android P 或中国版时,或者确认您已安装相应版本后,在您选择(勾选)后,这些选项旁的复选框可能会被取消选中。如果它们变为取消选中状态,请重新选择。
  • 在模拟器执行冷启动时,系统可能会显示以下错误:“您的设备内部出现了问题。请联系您的设备制造商了解详情。”此错误不会影响功能。向下滚动并点击“OK”,即可开始测试应用。
  • 语音回复在模拟器上可能无法运行。例如,如果您在 Wear 模拟器上收到一条 Google 环聊消息通知,并尝试通过语音回复消息,则系统会显示“Google 屡次停止运行”错误消息,并且您无法通过语音进行回复。
  • Instant Run 与 Wear 模拟器可能不兼容。
  • 可能无法程序化地(例如通过 adb)进行屏幕截图或在提交错误报告时进行屏幕截图。要解决此问题,请点击模拟器工具栏中的摄像头按钮来截取屏幕截图。

中国版 Wear 模拟器的问题

  • 配套手机上的来电可能未在配对模拟器中显示(对应)为来电。相应地,未接电话的通知可能不会在模拟器中显示。此外,您可能无法从模拟器接听电话,并且来电铃声会继续响。
  • 在您使用 SDK 管理器安装最新版本的 Android P 或中国版时,或者确认您已安装相应版本后,在您选择(勾选)后,这些选项旁的复选框可能会被取消选中。如果它们变为取消选中状态,请重新选择。
  • 在模拟器执行冷启动时,系统可能会显示以下错误:“您的设备内部出现了问题。请联系您的设备制造商了解详情。”此错误不会影响功能。向下滚动并点击“OK”,即可开始测试应用。
  • Instant Run 与 Wear 模拟器可能不兼容。
  • 可能无法程序化地(例如通过 adb)进行屏幕截图或在提交错误报告时进行屏幕截图。要解决此问题,请点击模拟器工具栏中的摄像头按钮来截取屏幕截图。

Wear 中的 Google 助理

Wear OS 增强了对 Google 助理的支持,让您可以构建能够在穿戴式设备上运行的体验,而无需编写 Android 代码。具体而言,您可针对 Actions on Google 平台进行构建,帮助用户使用您的产品和服务完成各种操作。

此外,Wear OS 现在还可以通过语音和轻触进行更快速的互动。Wear OS 还支持建议内容信息卡,它具备以下功能:

  • 帮助用户快速完成互动
  • 为用户提供您的 Action 功能的相关提示

此外,Wear OS 现在还支持其他具有视觉效果的卡片,以及列表和轮播。

因此,您可以使用 DialogFlow模板Actions SDK 为 Wear OS 创建 Actions on Google。此外,您还可以充分利用特定于手表的新的响应模板。有关 Actions on Google 的最佳做法包括:

  • 简短、简洁的对话框
  • 支持视觉和语音反馈

这些针对 Wear OS 上的 Google 助理的增强不依赖于 Android P,并且正在逐步向所有 Wear 2.0 用户推出。有关如何构建 Actions on Google 的说明,请参阅扩展 Google 助理

开发者预览版 2 中的电量节省情况

如下所述,我们提供了与电源相关的功能以增加电池续航时间。开发者预览版 2 中的本部分信息将取代开发者预览版 1 中与电源相关的信息。

新模式:增强省电模式

当手表处于增强省电模式时,系统会显示一个默认的电量优化表盘主题。此时,系统会关闭以下所有功能:

  • 无线装置
  • 触摸屏
  • 倾斜唤醒功能

用户可以通过短按侧面按钮查看时间。长按可以让用户切换回全功能模式并执行各种任务,例如通过 NFC 付款或回复消息。开发者应假设其应用、表盘主题和复杂功能数据提供器在增强省电模式下不可用。

限制了后台 Activity

为了延长电池续航时间,除非将手表放到充电器上,否则系统不允许应用在后台启动闹钟和作业。例外情况包括表盘主题和活跃的复杂功能。请将您的应用与预览版模拟器可下载的映像结合使用,并在 Wear OS by Google 谷歌问题跟踪器中提供反馈。

注意:如果您的应用必须始终运行(例如,进行后台监控),我们建议您借助 startForegroundService() 方法使用前台服务。有关详情,请参阅后台服务限制。目前,一些例外用例可以使用前台服务,例如运行状况监控。

提升了应用兼容性

为了提升应用兼容性,Android P 已开始对使用非 SDK 接口施加了特定限制。您应制定计划,逐步停止使用非 SDK 方法和字段。如果没有适用于您的用例的等效公开资源,请告知我们

深色系界面系统主题

从 2018 年初开始,Wear OS 的默认界面主题已变成针对通知流和系统启动器采用颜色更深的背景。此更改旨在让您的应用更一目了然,您应该针对这一新的界面主题检查应用的无障碍性。

推出更新的 Codelab

为了帮助您探索通过 Wear OS 进行开发的重要方式,我们推出了经过更新的 Codelab。例如,请观摩基于 Kotlin 的全新表盘主题 Codelab,我们将在其中尝试 Kotlin DSL(Kotlin 领域特定语言)。如果您有任何反馈,请告诉我们。

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

日期:2018 年 3 月 27 日

本部分包含 Wear OS by Google 谷歌开发者预览版 1 的相关信息。我们预计会在最终正式版发布前对此预览版进行几次更新。请通过 Wear OS by Google 谷歌问题跟踪器提交您发现的任何错误。您提交问题的时间越早,我们在最终版本中进行修复的可能性就越高。

模拟器和可下载的映像

预览版映像和模拟器在 Wear OS 中纳入了 Android P 预览版功能

Android Studio 提供了 Wear 模拟器的开发者预览版;请参阅 Wear OS 预览版设置

注意:在下载映像前,请先查看已知问题

以下映像适用于测试和开发面向下一个 Wear OS 版本的应用:

已知问题

  • 在 Wear OS 配套应用中,点按“报告穿戴式设备错误”看似可行,但实际上并未生成错误报告。要解决此问题,我们建议您使用 adb bugreport
  • 有时无法使用手表接听电话。如果接听失败,用户需要直接通过手机接听电话。
  • 在配对或启动预先加载的应用后,有时会出现“检测到 API 兼容性问题”错误。该错误消息很快就会消失,并不影响使用。
  • 在手表和模拟器上的“设置”菜单中,“生成错误报告”选项会显示两次。要生成错误报告,请尝试使用这两个选项中的每个选项,因为只有一个可以正常使用。当您点按可正常使用的选项后,系统会显示提示信息,表示正在生成错误报告。
  • 在中国版中,语音输入会导致应用崩溃。例如,使用语音搜索或使用语音添加提醒时会出现此问题,因为此功能使用语音输入 API。测试时,请使用键盘或手写输入,而不要使用语音输入。
  • 中国版 Wear 应用商店尚未开放。开发者无法通过此渠道更新应用或安装新应用。要解决此问题,我们建议开发者使用 adb 旁加载应用以进行测试。

此开发者预览版中的精彩功能

开发者预览版 1 提供以下应用测试功能:

  • 限制了后台 Activity:为了延长电池续航时间,系统不再允许应用在后台使用提醒和作业。例外情况包括用户选择的表盘主题和复杂功能。我们会在开发者预览版中逐步推出这一功能,因此您现在可能还无法在手表上看到它。

    注意:如果您的应用必须一直保持运行状态,我们建议您借助 startForegroundService() 方法将其修改为前台服务。有关详情,请参阅后台服务限制

  • 应用使用非 SDK 接口的限制。 为了提升应用兼容性,Android P 已开始对使用非 SDK 接口施加了特定限制。您应制定计划,逐步停止使用非 SDK 方法和字段。如果没有适用于您的用例的等效公开资源,请告知我们
  • 深色系界面系统主题。 从 2018 年初开始,Wear OS 的默认界面主题已变成针对通知流和系统启动器采用颜色更深的背景。此更改旨在让您的应用更一目了然,您应该针对这一新的界面主题检查您应用的无障碍性。
  • 摘下手表后,无线装置会关闭:为了延长电池续航时间,当检测到手表长时间离开身体后,蓝牙无线装置、WLAN 无线装置和手机无线装置都会关闭。我们会在开发者预览版中逐步推出这一功能,因此您最初可能还无法在手表上看到它。如果此功能导致开发过程出现问题,则可以使用以下命令通过 adb 停用此功能:
    adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • 断开蓝牙连接后,WLAN 将关闭:为了延长电池续航时间,当手表断开蓝牙连接后,手表将不再自动连接到 WLAN。例外情况包括应用请求高带宽网络,以及手表连接到充电器。我们会在开发者预览版中逐步推出这一功能,因此您最初可能还无法在手表上看到它。

Wearable 支持库 v2.3.0 更新

Wearable 支持库的 v2.3.0 文档更新包含品牌更名方面的更新。

此外,该库的 2.3.0 版还更新了 ComplicationDrawable TextRenderer:适用于具有附加了文本范围的标记对象的文本。这些类可以改进 span 文本的处理效果。只有特定 span 子集可以渲染(请参阅 setText 方法,了解可以绘制哪些类型的 span),因此在表盘主题进行渲染时,span 不会显得格格不入。

2018 年 3 月 15 日 - Wear 品牌更名

日期:2018 年 3 月 15 日

本部分包含与 Wear OS 功能相关的信息。

Android Wear 的新名称

Android Wear 已更名为 Wear OS by Google 谷歌。

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

日期:2018 年 2 月 27 日

本部分包含与 Android Wear 新功能相关的信息。

用于支持微光模式的新类

27.1.0 版本的 Android 支持库包含一个新的类,即 AmbientModeSupport,该类取代了现已弃用的 AmbientMode 类。我们计划在接下来几周内推出示例更新。

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

日期:2018 年 1 月 25 日

本部分包含与 Android Wear 新功能相关的信息。

Android 模拟器:针对 Wear 的更新

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

穿戴式设备支持库 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 类

11.8.0 版的 Google Play 服务开始,Wear 应用应停止使用 GoogleApiClient 类,并改用基于 GoogleApi 类的 API 客户端对象,以及 Tasks API

注意:这项更新不适用于针对中国的 Android Wear 应用,这类应用通常使用 10.2.0 版 Google Play 服务。

有关详情,请参阅:

连接 Google Play 服务的新组件

当您使用可扩展 GoogleApi 类的类(例如 DataClient MessageClient)时,Google Play 服务 SDK 会为您管理与 Google Play 服务之间的连接;请参阅相关博文。使用这些类的应用无需再创建和管理 GoogleApiClient 对象。

要了解 Wear 相关组件(用于连接到 Google Play 服务)的替代组件,请参阅已弃用组件的替代组件。要了解 Google Play 服务的版本和已知相关问题,请参阅 Google Play 服务版本说明

注意:如果您使用最新版的 Google Play 服务编译您的应用,系统会提示用户将其设备更新到相应的最新版本。不过,以 API 版本 26 为目标的应用的某个已知问题可能会阻止用户接收有关更新设备的提示。具体的问题描述请见 Google Play 服务版本说明

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

本部分包含与 Android Wear 新功能相关的信息。

Android 支持库 v27.0.0:功能和错误修正

27.0.0 版的 Android 支持库包含 Wear 的新功能(如下所述)。

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

借助微光模式,用户在设备进入闲置状态后仍可看到 Wear 应用。Android 支持库推出了供应用使用微光模式的全新首选模式。Wear 团队希望就这一重大变化征询开发者的反馈

具体来说,使用 AmbientMode 类后,您可以从以下方面受益:

请参阅使用 AmbientMode 类实现微光模式

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

现在,Android 支持库提供针对 Android Wear 应用(用于 Android 清单文件中的 meta-data 标记)的常量。要使用这些常量(针对独立应用、通知桥接模式以及表盘主题预览图片),请在应用模块的 build.gradle 文件的依赖项部分添加对以下内容的引用(需要使用最新版本的 Google 代码库):

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

操作抽屉式导航栏更新

WearableActionDrawerView 类(用于创建穿戴式设备的操作抽屉式导航栏)有更新。在最新版本中:

  • 修改菜单项后,系统会对操作抽屉式导航栏进行适当的更新
  • 如果针对某个操作抽屉式导航栏设置了标题,则系统会正确显示此标题

扩充 RoundedDrawable 类

假设 API 级别至少为 24,则现在可以通过可绘制的 XML 文件扩充 RoundedDrawable 类;请参阅自定义可绘制资源

穿戴式设备支持库 v2.1.0:增强功能及更多信息

2.1.0 版的穿戴式设备支持库包含下述更新,并要求使用 26.0.2 或更高版的 Android 支持库。

为微光模式提供防烙印图片

借助 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 测试版页面

已知问题

  • 使用此 Android Wear 测试版时,Android Pay 及其卡片无法正常运行。
  • 即使移动网络连接已开启,也会在测试版安装完成后关闭。要解决此问题,请在测试版安装完成后开启移动网络连接,方法是依次转到设置 > 网络连接 > 移动网络
  • 如果在测试版更新完成后,通知功能不稳定或漏发通知,或者联系人未同步,请将手表恢复出厂设置。
  • 在 Wear 教程(手表设置完成后便会启动)中,有些卡片的运行不稳定,但可以(通过滑动)正常关闭。
  • 如果您使用的是搭载 Android 6.0 (Marshmallow) 的手机,则无法在手表上收到电话通知。
  • 更新后,心率监测有时会失败。要解决此问题,请重启手表。
  • 卡片信息流中的 OTA 卡片有时无法启动安装程序。要解决此问题,请依次转到设置 > 系统 > 关于 > 系统更新