Glance Wear

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

声明依赖项

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

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

Groovy

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

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

Kotlin

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

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

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

反馈

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

创建新问题

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

Glance Wear 版本 1.0

版本 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 检查，以强制执行以下操作：widget 元数据的 <wearwidget-provider> XML 中的每个 <container> 都会明确指定受支持的类型属性，并且不会定义重复的类型。(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 远程 Compose 操作。这样一来，RemoteText 就可以在受支持的 Host 渲染器上使用可变字体功能（例如字体轴、行高等等），并且在不支持时自动回退。

修复

  • 根据开发者的反馈，更新了 AssociateWithGlanceWearWidget 注解的 KDocs

版本 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 传播受支持的操作，并向这些操作添加过滤允许的操作的配置文件，从而改进了在旧版 Host 上运行的 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 修复

  • 我们根据用户体验反馈调整了 Squircle 形 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，该 widget 必须在 GlanceWearWidgetService 上使用，以提供与其关联的 GlanceWearWidget 的实现。(Ifcabb, b/514679763)

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

  • 我们向 WearWidgetBrush 添加了 image 画笔，以支持 Wear Widgets 中的位图背景。(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)
  • 我们向 GlanceWearWidgetService 生命周期方法添加了 @CallSuper

版本 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 Widgets。(I36504, b/485147770)
  • 公开了 is*Available（isDailyStepsAvailable 等）变量，以验证相关健康数据类型是否可用且有效。(Ib98a7, b/498179656)
  • 向 GlanceWearWidget 添加了 triggerUpdateAll API，以触发给定应用的所有 widget 的更新。(I6ab20, b/510896410)

bug 修复

  • 在 WearWidgetParams 中以内部字段的形式添加了 Renderer 版本信息，以防止在 alpha10 版本中生成文档时出现中断。(Idcf8e, b/511263591, b/512830184)
  • 在调试模式或模拟器中为 Wear Widgets 触发强制拉取更新流程。

版本 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 Widget 中公开了 glance.wear.health.DataType API。开发者可以使用这些 API 访问系统健康数据。

bug 修复

  • 修复了在 Wear 7 模拟器或运行 1.6 渲染器的设备上发生的 alpha09 版本中的崩溃循环，方法是不允许将空字体轴发送到 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，该 API 将用于实验性 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 Widgets 配置文件的操作。

API 变更

  • 我们将 CONTAINER_TYPE_FULLSCREEN 重命名为 CONTAINER_TYPE_TILE_COMPAT，以便更好地区分全屏兼容性 widget。这包括将之前 FULLSCREEN 类型到 Widget 参数中的 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 变更

版本 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 的库。