Glance Wear

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

声明依赖项

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

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

Groovy

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

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

Kotlin

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

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

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

反馈

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

创建新问题

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

Glance Wear 版本 1.0

版本 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)
  • 移除了 fetchActiveWidgetsForProvider 方法，因为已有 fetchActiveWidgets。(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 的库。