Jetpack Compose Glimmer

声明依赖项

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

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

dependencies {
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha15"
}

dependencies {
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha15")
}

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

反馈

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

创建新问题

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

版本 1.0

版本 1.0.0-alpha19

2026 年 9 月 9 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha19 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha19。版本 1.0.0-alpha19 中包含 这些提交内容。

API 变更

• 将 SurfaceDefaults.color 和 SurfaceDefaults.focusedColor 的 color 参数名称更改为 baseColor (Id1a08)
• 向 GlimmerPagerState 中的 animateScrollToPage 和 scrollToPage 函数添加了 pageOffsetFraction 参数。(I5ed0d)

bug 修复

• Compose 库的 compileSdk 已更新为 37.1。这将需要以传递方式更新使用 Compose 的所有应用和库的 compileSdk。(I05b0f)

版本 1.0.0-alpha18

2026 年 8 月 26 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha18 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18。版本 1.0.0-alpha18 中包含 这些提交内容。

API 变更

• 将 ButtonGroupState.Saver 序列化类型从 Int 更改为 *。(I78af5)
• 将 SurfaceDefaults.color 和 SurfaceDefaults.focusedColor，以及 IconToggleButton 和 ToggleButton 中的 checkedBackgroundColor 函数设为 @Composable 函数。(I52eb5, b/481943080)
• 向 Modifier.surface() 函数添加了 focusedColor 和 focusedContentColor 参数，以自定义焦点 Surface 的颜色。(Ied24a)
• 从所有组件中移除了边框自定义功能，并从 GlimmerTheme.colors 中移除了轮廓颜色。(I0d814)

版本 1.0.0-alpha17

2026 年 8 月 12 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha17 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha17。版本 1.0.0-alpha17 中包含 这些提交内容。

版本 1.0.0-alpha16

2026 年 7 月 29 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha16 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha16。版本 1.0.0-alpha16 中包含 这些提交内容。

API 变更

• 添加了页面指示器 API，以与 GlimmerHorizontalPager 搭配使用。使用 Pager 时，此组件默认捆绑，但只要提供 GlimmerPagerState，也可以单独使用（I54990、b/481669397）
• 添加了 ButtonGroup 组件（I26324、b/481662773）

版本 1.0.0-alpha15

2026 年 7 月 1 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha15 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha15。版本 1.0.0-alpha15 中包含 这些提交内容。

版本 1.0.0-alpha14

2026 年 6 月 3 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha14 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha14。版本 1.0.0-alpha14 中包含 这些提交内容。

glimmer 和 glimmer-google-fonts 版本 1.0

版本 1.0.0-alpha13

2026 年 5 月 19 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha13 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13。版本 1.0.0-alpha13 中包含 这些提交内容。

API 变更

• 向 Modifier.surface 添加了可选的 enabled 参数，该参数会在 Surface 处于停用状态时应用视觉叠加层。(I8b781)
• 在 GlimmerPagerLayoutInfo 中引入了 reverseLayout（I73818、b/481669559）
• 将 ToggleButtonDefaults 和 IconToggleButtonDefaults 中的 animateShape 重命名为 animatedShape (I15f00)
• 重命名了与 List 相关的组件，以使用 GlimmerLazyList 前缀。(If0737, b/425919254, b/483126735)
• 针对 Glimmer 实现了语音指示器的初始版本（I446c7、b/481998624）
• 移除了“surface”修饰符的可聚焦和可点击重载。现在，它是一个仅负责视觉效果的修饰符。手动添加“focusable”/“clickable”/其他修饰符以创建互动式 Surface - 如需了解详情，请参阅示例。(I12dbe)

版本 1.0.0-alpha12

2026 年 5 月 6 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha12 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha12。版本 1.0.0-alpha12 中包含 这些提交内容。

API 变更

• 引入了 Glimmer Pager API (I2d830、b/481670271)
• 添加了 ToggleButton 和 IconToggleButton API（I2656b、Ib1667、b/481299196、b/481663547）

版本 1.0.0-alpha11

2026 年 4 月 22 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha11 和 androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11。版本 1.0.0-alpha11 中包含 这些提交内容。

API 变更

• glimmer-google-fonts 已发布 - 添加此依赖项并使用 createGoogleSansFlexTypography 创建具有推荐的 Google Sans Flex 配置的 Typography 实例。此 Typography 实例可以通过 GlimmerTheme 正常提供。(Iec9e4, b/458447191)

版本 1.0.0-alpha10

2026 年 4 月 8 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha10。版本 1.0.0-alpha10 中包含 这些提交内容。

API 变更

• 添加了 IconButton API。(I0f3dd, b/481298420)
• 将 StackState 保存器的类型泛化为 Saver<StackState, *>。(Ic164f, b/491893461)

bug 修复

• 将 Compose compileSdk 更新为 API 37。这意味着，使用 Compose 时，需要最低 AGP 版本 9.2.0。(Id45cd, b/413674743)

版本 1.0.0-alpha09

2026 年 3 月 25 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha09。版本 1.0.0-alpha09 中包含 这些提交内容。

API 变更

• 调整了主色、正色、负色和 Surface 的默认值。添加了一个名为“background”的新颜色轴。(I6bb6c, b/481671956)
• 在 GlimmerTheme 中添加了 ComponentSpacingValues 子系统，该子系统提供的值可用于组件中的内边距和其他间距元素。组件 Defaults 对象（例如 ContentPadding、ItemSpacing）中现有的 PascalCase 间距和内边距常量已重命名为 camelCase 并转换为可组合属性。(I96e30, b/491166461)
• 将 onClick 移至形参列表中的最后一个位置，以用作尾随 lambda。如果没有提供适用的 lambda，则不使用 IndirectPointerEvent(s) (I9343e, b/486965466)
• 将 Depth 和相关实体重命名为 DepthEffect。公开了 DepthEffect 的层属性。(Ie26d2, b/485632564)

版本 1.0.0-alpha08

2026 年 3 月 11 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha08。版本 1.0.0-alpha08 中包含 这些提交内容。

API 变更

• 将 TitleChipDefaults.contentPadding 替换为 ContentPadding 常量。(If992f, b/489451530)
• Glimmer ListState 现在提供 ScrollIndicatorState (I0a2f8、b/481662773)
• 添加了一个名为 caption 的新 TextStyle。对于现有的 TextStyles，更新了 fontWeight、fontSize 和 lineHeight。(I2319f, b/473560419)

版本 1.0.0-alpha07

2026 年 2 月 25 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha07。版本 1.0.0-alpha07 中包含 这些提交内容。

版本 1.0.0-alpha06

2026 年 2 月 11 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha06。版本 1.0.0-alpha06 中包含 这些提交内容。

API 变更

• 添加了 VerticalList API 的重载版本，其中包含标题的槽。(Ic3d44)
• 更新了 Glimmer Text autoSize 参数的排序，以与 material3 保持一致。(Ic24bd, b/477669012)

版本 1.0.0-alpha05

2026 年 1 月 28 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha05。版本 1.0.0-alpha05 中包含 这些提交内容。

版本 1.0.0-alpha04

2026 年 1 月 14 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha04。版本 1.0.0-alpha04 中包含 这些提交内容。

新功能

• 为 VerticalStack 添加了对每个项使用多个项装饰的支持 (22daab3)，并添加了对通用装饰形状的支持 (033e015)。

API 变更

• 添加了 VerticalListDefaults，以提供 VerticalList 可组合项的推荐值。(I07b1a, b/448364605)

bug 修复

• 向 VerticalStack 添加了初始焦点处理，以确保焦点进入堆栈时，顶部项获得焦点。这修复了初始焦点分配给下一项导致立即滚动到该项的问题。(bd69841)
• 修复了 VerticalStack 的 ItemDecorationNode 中的 bug，该 bug 会导致在重复使用修饰符节点时，项范围内的装饰不会更新。(7ec2c94)

版本 1.0.0-alpha03

2025 年 12 月 17 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha03。版本 1.0.0-alpha03 中包含 这些提交内容。

bug 修复

• 针对堆栈的行为更新和 bug 修复

版本 1.0.0-alpha02

2025 年 12 月 3 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha02。版本 1.0.0-alpha02 中包含 这些提交内容。

API 变更

• ListScope 上新的 items(items: List<T>) 和 itemsIndexed(items: List<T>) 扩展方法。(Ic2afe)
• 为 VerticaList 提供了 FlingBehavior API。(I16de7)
• 为 VerticalList 焦点感知吸附行为提供了一个工厂。(I4a528)

版本 1.0.0-alpha01

2025 年 11 月 5 日

发布了 androidx.xr.glimmer:glimmer:1.0.0-alpha01。版本 1.0.0-alpha01 中包含 这些提交内容。

新功能

• Jetpack Compose Glimmer 的初始开发者版本，用于打造增强型 Android XR 体验的设计语言和界面组件。旨在通过简化的样式、差异化的焦点和优化的海拔高度，实现清晰、易读且干扰最小的效果。
• 开始使用我们的初始 Jetpack Compose Glimmer 组件集：
  • 文本
  • 图标
  • 标题条状标签
  • 卡片
  • 列表
  • 按钮
  • 堆栈（开发中）