Glance Wear

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

声明依赖项

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

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

Groovy

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

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

Kotlin

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

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

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

反馈

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

创建新问题

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

Glance Wear 版本 1.0

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