用户指南

最新更新
稳定版 发布候选版本 Beta 版 Alpha 版 2025 年 5 月 20 日
1.0.0-alpha08 - - - 声明依赖项

要添加对 XR Compose Material3 核心的依赖项，您必须将 Google Maven 代码库添加到您的项目中。阅读Google 的 Maven 代码库以了解更多信息。

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

Groovy

Kotlin

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

有关依赖项的更多信息，请参阅添加构建依赖项。

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

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的建议，请告诉我们。在创建新问题之前，请查看此库中的现有问题。您可以通过点击星形按钮为您已发现的问题进行投票。

创建新问题

有关详细信息，请参阅问题跟踪器文档。

版本 1.0

版本 1.0.0-alpha08

androidx.xr.compose.material3:material3:1.0.0-alpha08 已发布。版本 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 包含这些提交。

注意：您需要 Android Emulator 版本 35.6.7 或更高版本才能使用此库版本。

使用 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。
  • 将 ComponentOverride 类型重命名为 Override，将 ComponentOverrideContext 类型重命名为 OverrideScope (Id973c)

使用 Kotlin 2.0 发布的项目需要 KGP 2.0.0 或更高版本才能使用。(Idb6b5)

  • 修复空间化 NavigationRail 和 NavigationBar 上的别名和不正确的蒙层。(I9db52)

修复 ListDetailPaneScaffold 或 SupportingPaneScaffold 没有子项时崩溃的问题 (46df990)

  • 版本 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)

使用 EnableXrComponentOverrides 时，TopAppBar 默认会空间化为 Orbiter。

  • DefaultNavigationRailOrbiterProperties 和 DefaultNavigationBarOrbiterProperties getter 不再是 @Composable (I61618)

使用 Kotlin 2.0 发布的项目需要 KGP 2.0.0 或更高版本才能使用。(Idb6b5)

  • 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)

使用 EnableXrComponentOverrides 时，TopAppBar 默认会空间化为 Orbiter。

  • 创建在 XR 上覆盖 ThreePaneScaffold 的能力 (Ib66f1)

使用 Kotlin 2.0 发布的项目需要 KGP 2.0.0 或更高版本才能使用。(Idb6b5)

  • 为 XR 实现非动画 Pane 覆盖 (I7f620)
  • 添加并使用新的实验性注解 ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
  • 固定 Material3 XR 对 XR Compose 的依赖。(Ia02cc)

修复 ListDetailPaneScaffold 或 SupportingPaneScaffold 没有子项时崩溃的问题 (46df990)

  • 版本 1.0.0-alpha01

2024 年 12 月 12 日

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

初始版本的功能

Material Design for XR 的初始开发者版本。使用现有的 Material 3 库，组件和自适应布局通过空间 UI 行为得到增强。您可以直接使用 M3 XR 组件进行构建，或者通过添加 EnableXrComponentOverrides 封装容器来调整您当前的实现。在此开发者指南中了解更多信息。

支持的 XR 适配

任何 Compose 布局中的导航栏，包括 NavigationSuiteScaffold，都将自动适应 XR Orbiter。有关详细信息，请阅读Material Design 指南。

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

  • 本页上的内容和代码示例受内容许可中描述的许可条款约束。Java 和 OpenJDK 是 Oracle 和/或其关联公司的商标或注册商标。