Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Jetpack Compose Glimmer

用于构建增强型 Android XR 体验的设计语言和界面工具包

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2026 年 9 月 23 日	-	-	-	1.0.0-alpha20

声明依赖项

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

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

Groovy

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

Kotlin

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

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

反馈

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

创建新问题

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

版本 1.0

版本 1.0.0-alpha20

2026 年 9 月 23 日

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

API 变更

添加了 Glimmer AlertDialog (I01019)
库现在以 Kotlin 2.2 为目标平台，并需要 kotlinc 2.2（I82396、b/498369605）
添加了 LeadingImageCard 和 TrailingImageCard (Icdf91)
添加了 ImageCard API，并从 Card 和 ActionCard 中移除了 header 参数 (I81f62)
添加了用于锚定到现实世界对象的 IconMarker 组件。(I958d6)

bug 修复

androidx.lifecycle:lifecycle-runtime 依赖项已更新为 2.10.0。如果要在 AGP 9.5.0-alpha04 版或更高版本中运行捆绑的生命周期运行时 lint 检查，则必须使用此版本。（I99bfd、b/556807521）

版本 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 变更

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

bug 修复

compileSdk 针对已更新到 37.1 的 Compose 库。这需要为使用 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)
将 IconToggleButton 和 ToggleButton 中的 SurfaceDefaults.color、SurfaceDefaults.focusedColor 和 checkedBackgroundColor 函数设为 @Composable 函数。（I52eb5、b/481943080）
向 Modifier.surface() 函数添加了 focusedColor 和 focusedContentColor 参数，以自定义聚焦界面的颜色。(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 变更

添加了与 GlimmerHorizontalPager 搭配使用的页面指示器 API。使用 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 参数，用于在界面停用时应用视觉叠加层。(I8b781)
reverseLayout 于 GlimmerPagerLayoutInfo 中引入（I73818、b/481669559）
在 ToggleButtonDefaults 和 IconToggleButtonDefaults 中将 animateShape 重命名为 animatedShape (I15f00)
重命名了与 List 相关的组件，以使用 GlimmerLazyList 前缀。（If0737、b/425919254、b/483126735）
针对 Glimmer 的语音指示器的初始实现（I446c7、b/481998624）
移除了“surface”修饰符的可聚焦和可点击重载。现在，它是一个仅负责视觉效果的单一修饰符。手动添加“focusable”“clickable”或其他修饰符以创建互动界面 - 如需了解详情，请参阅示例。(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 变更

调整了主要、正面、负面和表面广告素材的默认值。添加了一个名为“background”的新颜色轴。（I6bb6c、b/481671956）
在 GlimmerTheme 中添加了 ComponentSpacingValues 子系统，该子系统提供可在组件中使用的边衬区和其他间距元素的值。组件默认对象（例如 ContentPadding、ItemSpacing）中现有的 PascalCase 间距和内边距常量已重命名为 camelCase，并转换为可组合项属性。（I96e30、b/491166461）
将 onClick 移至形参列表的最后位置，以用作尾随 lambda。如果没有提供适用的 lambda，则不消耗 IndirectPointerEvent(s)（I9343e、b/486965466）
将“深度”和相关实体重命名为 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）
添加了新的 TextStyle，名为 caption。对于现有 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 的重载版本，其中包含用于放置标题的 slot。(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，即当修饰符节点被重复使用时，装饰未在项范围内更新。(7ec2c94)

版本 1.0.0-alpha03

2025 年 12 月 17 日

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

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 组件，您可以先从这些组件入手：
- 文本
- 图标
- 标题条状标签
- 卡片
- 列表
- 按钮
- 堆栈（开发中）