Jetpack Compose Glimmer

  
設計語言和 UI 工具包，用於建構擴增 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")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

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)

修正錯誤

  • 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 變更

  • 將 SurfaceDefaults.color 和 SurfaceDefaults.focusedColor 的 color 參數名稱變更為 baseColor (Id1a08)
  • 在 GlimmerPagerState 的 animateScrollToPage 和 scrollToPage 函式中新增 pageOffsetFraction 參數。(I5ed0d)

修正錯誤

  • 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)
  • 建立 SurfaceDefaults.color、SurfaceDefaults.focusedColor、checkedBackgroundColor 函式，以及 IconToggleButton 和 ToggleButton、@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 變更

  • 新增頁面指標 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 參數，可在介面停用時套用視覺疊加層。(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 變更

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 建立 Typography 例項，並採用建議的 Google Sans Flex 設定。這個 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 變更

修正錯誤

  • 將 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 子系統，提供用於邊框間距和其他間距元素的元件值。元件 Defaults 物件 (例如 ContentPadding、ItemSpacing) 中現有的 PascalCase 間距和邊框間距常數已重新命名為 camelCase，並轉換為 Composable 屬性。(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 變更

  • 以 ContentPadding 常數取代 TitleChipDefaults.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)

修正錯誤

  • 在 VerticalStack 中新增初始焦點處理功能，確保焦點進入堆疊時，焦點會移至頂端項目。修正了初始焦點會指派給下一個項目，導致立即捲動至該項目的問題。(bd69841)
  • 修正 VerticalStack 的 ItemDecorationNode 錯誤，在重複使用修飾符節點時，裝飾項目不會在項目範圍內更新。(7ec2c94)

1.0.0-alpha03 版本

2025 年 12 月 17 日

發布 androidx.xr.glimmer:glimmer:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

修正錯誤

  • 更新 Stacks 的行為並修正錯誤

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 的初始開發人員版本，設計語言和 UI 元件可用於建構擴增 Android XR 體驗。簡化樣式、區分焦點並最佳化高度，讓使用者能清楚閱讀內容，盡量減少干擾。
  • 開始使用我們最初的 Jetpack Compose Glimmer 元件：
    • 文字
    • 圖示
    • 標題方塊
    • 資訊卡
    • 清單
    • 按鈕
    • 堆疊 (開發中)