Glance Wear

  
Glance Wear 是一个用于为 Wear OS 构建 widget 的库
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 9 月 23 日 - - - 1.0.0-alpha19

声明依赖项

如需添加 glance-wear 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha19"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha19"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha19")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha19")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

Glance Wear 版本 1.0

版本 1.0.0-alpha19

2026 年 9 月 23 日

发布了 androidx.glance.wear:wear:1.0.0-alpha19、androidx.glance.wear:wear-core:1.0.0-alpha19 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19。版本 1.0.0-alpha19 中包含这些提交内容。

仅限内部测试更改。

版本 1.0.0-alpha18

2026 年 9 月 9 日

发布了 androidx.glance.wear:wear:1.0.0-alpha18、androidx.glance.wear:wear-core:1.0.0-alpha18 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18。版本 1.0.0-alpha18 中包含这些提交内容。

API 变更

  • 向 WearWidgetPreview 添加了 useSafeFallbackRendererVersion 参数，以允许预览具有安全回退的 widget，该回退包含适用于旧版主机的受支持操作。(I9c324)

bug 修复

  • compileSdk 针对已更新到 37.1 的 Compose 库。 这需要为使用 Compose 的所有应用和库传递性地更新 compileSdk。(I05b0f)
  • 添加了 lint 检查，用于警告 Wear widget 中冗余的 fontFamily 参数用法。(I7730c)

版本 1.0.0-alpha17

2026 年 8 月 26 日

发布了 androidx.glance.wear:wear:1.0.0-alpha17、androidx.glance.wear:wear-core:1.0.0-alpha17 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17。版本 1.0.0-alpha17 中包含这些提交内容。

新功能

  • 在 Glance Wear 中添加了 lint 检查，以强制执行以下操作：确保 <wearwidget-provider> XML 中用于 widget 元数据的每个 <container> 明确指定受支持的 type 属性，并且不定义重复的类型。（I52c9a、b/464458215）

版本 1.0.0-alpha16

2026 年 8 月 12 日

发布了 androidx.glance.wear:wear:1.0.0-alpha16、androidx.glance.wear:wear-core:1.0.0-alpha16 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16。版本 1.0.0-alpha16 中包含这些提交内容。

新功能

  • 为 <wearwidget-provider> XML 元数据添加了 Lint 验证，以确保存在所需的配置元素（例如 container 和 previewImage）。（Ia9983、b/464458215）
  • 为将黑色或透明背景设置为 Wear Widget 添加了 Lint 错误警告（Idedb0、b/529269573）
  • 为 Wear Widgets 配置文件启用了 CORE_TEXT 远程撰写操作。这使得 RemoteText 能够在受支持的主机渲染器上使用可变字体功能（例如字体轴、行高等），并在不支持时自动回退。

可修复漏洞数

  • 根据开发者的反馈，更新了 AssociateWithGlanceWearWidget 注释的 KDoc

版本 1.0.0-alpha15

2026 年 7 月 29 日

发布了 androidx.glance.wear:wear:1.0.0-alpha15、androidx.glance.wear:wear-core:1.0.0-alpha15 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15。版本 1.0.0-alpha15 中包含这些提交内容。

新功能

  • 在为 Wear widget 文档设置空白背景时添加了 Lint 警告。（Ic6475、b/529269573）

版本 1.0.0-alpha14

2026 年 7 月 15 日

发布了 androidx.glance.wear:wear:1.0.0-alpha14、androidx.glance.wear:wear-core:1.0.0-alpha14 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14。版本 1.0.0-alpha14 中包含这些提交内容。

API 变更

  • 我们为完全圆角的 Glance Wear widget 添加了 RoundAllWidgetPreviewParams、RoundSmallWidgetPreviewParams 和 RoundLargeWidgetPreviewParams 预览参数提供程序。（If5336、b/512405233）

新功能

  • 我们已为 Glance Wear widget 设置并添加 Linter 库。(If4218、b/527402079)
    • 添加了 lint 检查，以确保 GlanceWearWidgetService 的子类使用 @AssociateWithGlanceWearWidget 注释明确声明其关联的 widget 类。（Idc575、b/477024153）
  • 我们通过 WearWidgetParams 传播支持的操作，并添加了对允许的操作的配置文件进行过滤的功能，从而改进了在旧版宿主上运行的 widget 的向后兼容性。（Ib0a1b、I83cb1、[b/526716195]）

版本 1.0.0-alpha13

2026 年 7 月 1 日

发布了 androidx.glance.wear:wear:1.0.0-alpha13、androidx.glance.wear:wear-core:1.0.0-alpha13 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13。版本 1.0.0-alpha13 中包含这些提交内容。

API 变更

bug 修复

  • 我们已根据用户体验反馈，调整了预览版中方形圆角 Wear widget 的参数

版本 1.0.0-alpha12

2026 年 6 月 17 日

发布了 androidx.glance.wear:wear:1.0.0-alpha12、androidx.glance.wear:wear-core:1.0.0-alpha12 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12。版本 1.0.0-alpha12 中包含这些提交内容。

新功能

  • 添加了 AssociateWithGlanceWearWidget，该属性必须在 GlanceWearWidgetService 上使用，以提供与 GlanceWearWidget 关联的实现。（Ifcabb、b/514679763）

    • 例如：
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • 我们已将 image 画笔添加到 WearWidgetBrush，以支持 Wear Widget 中的位图背景。（I9a228、b/513481558）

  • 我们引入了 @Composable 辅助函数 WearWidgetPreview，通过移除 IDE 预览版所需的样板代码，简化 Glance Wear widget 的开发。

API 变更

  • 已将 androidx.glance.wear.health.DataType 重命名为 androidx.glance.wear.health.HealthData（I4cb0b、b/516746689）
  • 公开了 isHeartRateBpmAvailable，以确定主机上是否提供 heartRateBpm。（I5999d、b/514641567）
  • 公开了 RemoteInt 比较运算符。（I5fe3d、b/513228889）
  • 公开了 captureRemoteDocument Flow API 和新的 captureSingleRemoteDocument 重载（采用 RemoteCreationDisplayInfo）作为公共 API。（I87b0e、b/513228889）
  • 我们已将 @CallSuper 添加到 GlanceWearWidgetService 生命周期方法中

版本 1.0.0-alpha11

2026 年 6 月 3 日

发布了 androidx.glance.wear:wear:1.0.0-alpha11、androidx.glance.wear:wear-core:1.0.0-alpha11 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11。版本 1.0.0-alpha11 中包含这些提交内容。

API 变更

  • 我们添加了 WearWidgetPreview，以便在 Android Studio 中预览 Wear Widget。（I36504、b/485147770）
  • 公开 is*Available（isDailyStepsAvailable 等）变量，以验证相关健康数据类型是否可用且有效。（Ib98a7、b/498179656）
  • 向 GlanceWearWidget 添加了 triggerUpdateAll API，以触发对指定应用的所有 widget 进行更新。（I6ab20、b/510896410）

bug 修复

  • 在 WearWidgetParams 中添加了渲染器版本信息作为内部字段，以防止在 alpha10 版本中生成的文档出现中断。（Idcf8e、b/511263591、b/512830184）
  • 在调试模式或模拟器中触发 Wear Widget 的强制拉取更新流程。

版本 1.0.0-alpha10

2026 年 5 月 19 日

发布了 androidx.glance.wear:wear:1.0.0-alpha10、androidx.glance.wear:wear-core:1.0.0-alpha10 和 androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10。版本 1.0.0-alpha10 中包含这些提交内容。

API 变更

  • 在 Wear 微件中公开了 glance.wear.health.DataType API。开发者可以使用这些 API 访问系统健康数据。

bug 修复

  • 修复了 alpha09 版本在 Wear 7 模拟器或运行 1.6 渲染器的设备上发生的崩溃循环，方法是不允许将空字体轴发送到 Glance Wear Widget 的播放器。

版本 1.0.0-alpha09

2026 年 5 月 6 日

发布了 androidx.glance.wear:wear:1.0.0-alpha09 和 androidx.glance.wear:wear-core:1.0.0-alpha09。版本 1.0.0-alpha09 中包含这些提交内容。

API 变更

  • 我们添加了 ExperimentalGlanceWearApi，该参数将用于实验性 Glance Wear 功能。（Id2f76、b/498179813）

bug 修复

  • 更新了 Wear Widget XML 元数据的解析器，以便在启动时识别 widget。

版本 1.0.0-alpha08

2026 年 4 月 22 日

发布了 androidx.glance.wear:wear:1.0.0-alpha08 和 androidx.glance.wear:wear-core:1.0.0-alpha08。版本 1.0.0-alpha08 中包含这些提交内容。

bug 修复

  • 向 glance:wear:wear 库的清单添加了 <queries> 标记，以确保 PackageManager 查询正确的服务以进行推送更新。(I192787)

其他

  • 还原了“将 Compose compileSdk 更新为 37”(I6007)，该更改也适用于 glance-wear，因此在此版本中，compileSdk 要求不再是 37。

版本 1.0.0-alpha07

2026 年 4 月 8 日

发布了 androidx.glance.wear:wear:1.0.0-alpha07 和 androidx.glance.wear:wear-core:1.0.0-alpha07。版本 1.0.0-alpha07 中包含这些提交内容。

新功能

  • 当 WearWidgetBrush 为空或未指定时，添加默认 Wear widget 背景。(I8300b)
  • 更新了 getActiveWidgets API 以返回 widget 的容器类型。(2772eb1)

API 变更

  • 更改了 widget 更新 API 以接受 WidgetInstanceId，并添加了用于获取指定 widget 的 ID 的辅助程序。如果提供的 ID 无效或不归调用者所有，新 API 会抛出 IllegalArgumentException。（I6f3c5、b/446828899）
  • 在 WearWidgetBrush 中添加竖向和横向渐变。（If70ae、b/470080675）

版本 1.0.0-alpha06

2026 年 3 月 25 日

发布了 androidx.glance.wear:wear:1.0.0-alpha06 和 androidx.glance.wear:wear-core:1.0.0-alpha06。版本 1.0.0-alpha06 中包含这些提交内容。

新功能

  • 内嵌定义 Wear Widget 配置文件的操作。

API 变更

  • 我们将 CONTAINER_TYPE_FULLSCREEN 重命名为 CONTAINER_TYPE_TILE_COMPAT，以便更好地区分全屏兼容性 widget。这包括将之前在 widget 参数中从 FULLSCREEN 类型到 LARGE 的映射恢复原样。

版本 1.0.0-alpha05

2026 年 3 月 11 日

发布了 androidx.glance.wear:wear:1.0.0-alpha05 和 androidx.glance.wear:wear-core:1.0.0-alpha05。版本 1.0.0-alpha05 中包含这些提交内容。

API 变更

  • 我们添加了 WearWidgetBrushAPI，其中包含 color 方法，用于 Wear Widget 背景。（I66f54、b/464273091）
  • 由于已有 fetchActiveWidgets，因此移除了 fetchActiveWidgetsForProvider 方法。（I85e4e、b/486197890）

版本 1.0.0-alpha04

2026 年 2 月 25 日

发布了 androidx.glance.wear:wear:1.0.0-alpha04 和 androidx.glance.wear:wear-core:1.0.0-alpha04。版本 1.0.0-alpha04 中包含这些提交内容。

API 变更

  • 添加了 GlanceWearWidgetManager API，以允许应用查询其活跃 widget 和功能块。(I5be95)
  • 我们已将 API 从 glance:wear:wear-core 库移至 androidx.glance.wear.core 软件包。(I429cf)

bug 修复

  • 公开了常见的远程可组合项和修饰符类型 (Id1d40)

版本 1.0.0-alpha03

2026 年 2 月 11 日

发布了 androidx.glance.wear:wear:1.0.0-alpha03 和 androidx.glance.wear:wear-core:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

API 变更

  • 为 GlanceWearWidget 添加了对互动事件的支持。（Ia4e28、b/469808447）

版本 1.0.0-alpha02

2026 年 1 月 28 日

发布了 androidx.glance.wear:wear:1.0.0-alpha02 和 androidx.glance.wear:wear-core:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

  • 在 widget 参数中将 FULLSCREEN 重新映射到 LARGE (ad78d95)

bug 修复

  • 修复了阻止显示多个 widget 实例的 DataStore 用法 (474f3e4)

版本 1.0.0-alpha01

2026 年 1 月 14 日

发布了 androidx.glance.wear:wear:1.0.0-alpha01 和 androidx.glance.wear:wear-core:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

  • Glance Wear 是一个库，用于使用 RemoteCompose 为 Wear OS 构建 widget。