适用于 XR 的 Material Design

使用可适应 XR 的 Material 组件和布局进行构建

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2026 年 3 月 25 日	-	-	-	1.0.0-alpha16

声明依赖项

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

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

Groovy

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

Kotlin

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

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

反馈

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

创建新问题

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

1.0 版

1.0.0-alpha16

2026 年 3 月 25 日

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

API 变更

将 Orbiter 更改为使用 OrbiterAnchorPoint + VolumeOffset 或 OrbiterPoseProvider，而不是 position、offset、offsetType、alignment 和 elevation。还移除了 shouldRenderInNonSpatial 参数。如果开发者不希望 Orbiter 在非空间中呈现，则应将 Orbiter 封装在 if 语句中，并检查 SpatialCapabilities。(I9fbb3、b/462428503)

1.0.0-alpha15

2026 年 2 月 25 日

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

API 变更

子空间修饰符内边距更改，以实现布局方向感知（I53e25、b/475290780、b/474410590）

1.0.0-alpha14

2026 年 1 月 28 日

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

1.0.0-alpha13

2025 年 12 月 3 日

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

新功能

为 WideNavigationRail 和 ModalWideNavigationRail 创建 XR 实现和 ComponentOverride (I1e86d, b/407769444)
NavigationSuiteScaffold、ListDetailPaneScaffold 和 SupportingPaneScaffold 现在使用 recommendedContentBoxInFullSpace 来设置其默认大小 (Ic54f1, b/388111668, b/394913962, b/394913962)

1.0.0-alpha12

2025 年 10 月 22 日

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

新功能

添加了 SpaceModeToggleButton，用于在 HomeSpace 和 FullSpace 之间切换 (Ic6865)

bug 修复

改进了 XR 工具栏 (Ied1f5)

1.0.0-alpha11

2025 年 8 月 27 日

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

bug 修复

修复了 XR NavRail 中 FAB 的行为 (Ibe20b)

1.0.0-alpha10

2025 年 7 月 30 日

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

新功能

为水平和垂直工具栏创建 XR 实现和 ComponentOverride (0e9496c, dcfef96)

bug 修复

修复了 XR 对话框不显示某些内容的问题 (c82e61b)

1.0.0-alpha08

2025 年 5 月 20 日

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

bug 修复

修复了 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)

bug 修复

修复了空间化 NavigationRail 和 NavigationBar 上的别名和不正确的遮罩。(I9db52)

1.0.0-alpha04

2025 年 2 月 26 日

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

新功能

ListDetailPaneScaffold 和 SupportingPaneScaffold 默认使用 SpatialPanels，前提是使用 EnableXrComponentOverrides (I166b0)

API 变更

DefaultNavigationRailOrbiterProperties 和 DefaultNavigationBarOrbiterProperties getter 不再是 @Composable (I61618)
LocalNavigationRailOrbiterProperties 和 LocalNavigationBarOrbiterProperties 不再可为 null (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)

bug 修复

固定了 Material3 XR 对 XR Compose 的依赖项。(Ia02cc)

1.0.0-alpha01

2024 年 12 月 12 日

发布了 androidx.xr.compose.material3:material3:1.0.0-alpha01。

初始版本的功能

Material Design for XR 的初始开发者版本。使用现有的 Material 3 库，组件和自适应布局通过空间界面行为得到增强。您可以直接使用 M3 XR 组件进行构建，也可以通过添加 EnableXrComponentOverrides 封装容器来调整当前实现。如需了解详情，请参阅此开发者指南。

支持的 XR 适配：

任何 Compose 布局（包括 NavigationSuiteScaffold）中的导航栏都会自动适应 XR Orbiter。如需了解详情，请参阅 Material Design 指南。
任何 Compose 布局（包括 NavigationSuiteScaffold）中的导航栏都会自动适应 XR Orbiter。如需了解详情，请参阅 Material Design 指南。

已知问题

ListDetailPaneScaffold 和 SupportingPaneScaffold 目前不支持多个空间面板