Glance Wear

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

声明依赖项

如需添加 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-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，该属性必须在 GlanceWearWidgetService 上使用，以提供与哪个 GlanceWearWidget 实现相关联。(Ifcabb, b/514679763)

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

  • 我们在 WearWidgetBrush 中添加了 image 画笔，以支持 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)
  • 我们在 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 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 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 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，其中包含用于 Wear widget 背景的 color 方法。(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 的库。