延展實境專用 Material Design

使用可自動調整的 Material 元件和版面配置，打造 XR 應用程式
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2025 年 7 月 30 日 - - - 1.0.0-alpha10

宣告依附元件

如要新增 XR Compose Material3 核心的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

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

Groovy

dependencies {
    // Use to implement XR Compose Material3
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
}

Kotlin

dependencies {
    // Use to implement XR Compose Material3
   implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
}

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

意見回饋

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

建立新問題

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

1.0 版本

1.0.0-alpha10 版本

2025 年 7 月 30 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂項目。

新功能

  • 建立 XR 實作項目，並為水平和垂直工具列建立 ComponentOverride (0e9496c、dcfef96)

修正錯誤

  • 修正 XR 對話方塊未顯示部分內容的問題 (c82e61b)

1.0.0-alpha08 版本

2025 年 5 月 20 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha08。1.0.0-alpha08 版包含這些修訂項目。

修正錯誤

  • 修正 ListDetailPaneScaffold 或 SupportingPaneScaffold 沒有子項時發生的當機問題 (46df990)
  • 將 Material XR minSdk 降至 24 (6064706)

1.0.0-alpha07 版本

2025 年 5 月 7 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha07。1.0.0-alpha07 版包含這些修訂項目。

API 變更

  • 以 Kotlin 2.0 發布的專案必須使用 KGP 2.0.0 以上版本。(Idb6b5)

1.0.0-alpha06 版本

2025 年 3 月 26 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目。

1.0.0-alpha05 版本

2025 年 3 月 12 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha05。1.0.0-alpha05 版包含這些修訂項目。

新功能

  • 使用 EnableXrComponentOverrides 時，TopAppBar 預設會空間化為 Orbiter。
  • 使用 EnableXrComponentOverrides 時，Material AlertDialog 預設會空間化為 SpatialPanel。

API 變更

  • 將 ComponentOverride 型別重新命名為 Override，並將 ComponentOverrideContext 型別重新命名為 OverrideScope (Id973c)

修正錯誤

  • 修正空間化 NavigationRail 和 NavigationBar 的鋸齒狀問題和錯誤的半透明效果。(I9db52)

1.0.0-alpha04 版本

2025 年 2 月 26 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

新功能

  • 使用 EnableXrComponentOverrides 時，ListDetailPaneScaffold 和 SupportingPaneScaffold 預設會使用 SpatialPanels (I166b0)

API 變更

  • DefaultNavigationRailOrbiterProperties 和 DefaultNavigationBarOrbiterProperties getter 不再是 @Composable (I61618)
  • LocalNavigationRailOrbiterProperties 和 LocalNavigationBarOrbiterProperties 不再可為空值 (I61618)

1.0.0-alpha03 版本

2025 年 2 月 12 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha03，該版本與上一個 Alpha 版沒有差別。1.0.0-alpha03 版包含這些修訂項目。

1.0.0-alpha02 版

2025 年 1 月 29 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

新功能

  • 在 XR NavigationBar 和 NavigationRail 上啟用 Orbiter 屬性自訂功能。(Ic300f)

API 變更

  • 建立在 XR 上覆寫 ThreePaneScaffold 的功能 (Ib66f1)
  • 為 XR 實作非動畫窗格覆寫 (I7f620)
  • 新增及使用新的實驗性註解 ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

修正錯誤

  • 將 Material3 XR 的依附元件固定在 XR Compose。(Ia02cc)

1.0.0-alpha01 版

2024 年 12 月 12 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha01。

初始版本的功能

XR 專用 Material Design 的初始開發人員版本。使用現有的 Material 3 程式庫，透過空間 UI 行為強化元件和自動調整式版面配置。您可以直接使用 M3 XR 元件建構，也可以新增 EnableXrComponentOverrides 包裝函式，調整目前的實作項目。詳情請參閱這份開發人員指南。

支援的延展實境改編內容：

已知問題

  • ListDetailPaneScaffold 和 SupportingPaneScaffold 目前不支援多個空間面板