Jetpack Compose Glimmer

声明依赖项

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

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

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

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

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

反馈

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

创建新问题

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

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 中的一个错误，即在重复使用修饰符节点时，不会在项范围内更新装饰。(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 组件，您可以先从这些组件入手：
  • 文本
  • 图标
  • 标题条状标签
  • 卡片
  • 列表
  • 按钮
  • 堆栈（开发中）