Jetpack Compose Glimmer

宣告依附元件

如要新增 Jetpack Compose Glimmer 的依附元件，必須將 Google Maven
存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。

在應用程式或模組的 build.gradle 檔案中，新增您需要的構件依附元件：

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

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

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

意見回饋

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

建立新問題

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

1.0 版本

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

• 以 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 參數順序，以符合 Material 3。(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 元件集：
  • 文字
  • 圖示
  • Title Chips
  • 資訊卡
  • 清單
  • 按鈕
  • 堆疊 (開發中)