Material Design für XR

Mit Material-Komponenten und ‑Layouts entwickeln, die sich für XR anpassen
Letzte Aktualisierung Stabile Release Releasekandidat Beta-Release Alpha-Release
19. Mai 2026 - - - 1.0.0-alpha17

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von XR Compose Material3 Core hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

Cool

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

Kotlin

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

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.

Neues Problem melden

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 1.0

Version 1.0.0-alpha17

19. Mai 2026

androidx.xr.compose.material3:material3:1.0.0-alpha17 ist veröffentlicht. Version 1.0.0-alpha17 enthält diese Commits.

API-Änderungen

  • Für Orbiter wird jetzt entweder OrbiterAnchorPoint + VolumeOffset oder OrbiterPoseProvider anstelle von „position“, „offset“, „offsetType“, „alignment“ und „elevation“ verwendet. Außerdem wurde der Parameter shouldRenderInNonSpatial entfernt. Wenn der Entwickler nicht möchte, dass der Orbiter in nicht räumlichen Umgebungen gerendert wird, sollte er den Orbiter in eine if-Anweisung einfügen und SpatialCapabilities prüfen. (I9fbb3)
  • Es wurden verschiebbare Modifikatoren hinzugefügt. Diese Modifikatoren funktionieren derzeit für SpatialPanels und SpatialExternalSurface. Sie werden in Zukunft für SpatialGltfModel und schließlich für alle SubspaceComposables unterstützt. (I9a3cd)

Version 1.0.0-alpha16

25. März 2026

androidx.xr.compose.material3:material3:1.0.0-alpha16 ist veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

API-Änderungen

  • Der Orbiter verwendet jetzt entweder OrbiterAnchorPoint + VolumeOffset oder OrbiterPoseProvider anstelle von position, offset, offsetType, alignment und der Höhe. Außerdem wurde der Parameter shouldRenderInNonSpatial entfernt. Wenn der Entwickler nicht möchte, dass der Orbiter in nicht räumlichen Umgebungen gerendert wird, sollte er den Orbiter in eine if-Anweisung einfügen und SpatialCapabilities prüfen. (I9fbb3, b/462428503)

Version 1.0.0-alpha15

25. Februar 2026

androidx.xr.compose.material3:material3:1.0.0-alpha15 ist veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.

API-Änderungen

Version 1.0.0-alpha14

28. Januar 2026

androidx.xr.compose.material3:material3:1.0.0-alpha14 ist veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.

Version 1.0.0-alpha13

3. Dezember 2025

androidx.xr.compose.material3:material3:1.0.0-alpha13 ist veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.

Neue Funktionen

  • XR-Implementierung und ComponentOverride für WideNavigationRail und ModalWideNavigationRail erstellen (I1e86d, b/407769444)
  • NavigationSuiteScaffold, ListDetailPaneScaffold und SupportingPaneScaffold verwenden jetzt recommendedContentBoxInFullSpace, um ihre Standardgrößen festzulegen (Ic54f1, b/388111668, b/394913962, b/394913962).

Version 1.0.0-alpha12

22. Oktober 2025

androidx.xr.compose.material3:material3:1.0.0-alpha12 ist veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

Neue Funktionen

  • SpaceModeToggleButton zum Wechseln zwischen HomeSpace und FullSpace hinzugefügt (Ic6865)

Fehlerkorrekturen

  • XR-Symbolleisten verbessern (Ied1f5)

Version 1.0.0-alpha11

27. August 2025

androidx.xr.compose.material3:material3:1.0.0-alpha11 ist veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

Fehlerkorrekturen

  • Verhalten des schwebenden Aktionsschaltfläche in der XR-NavRail korrigieren (Ibe20b)

Version 1.0.0-alpha10

30. Juli 2025

androidx.xr.compose.material3:material3:1.0.0-alpha10 ist veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

  • XR-Implementierung und ComponentOverride für horizontale und vertikale Symbolleiste erstellen (0e9496c, dcfef96)

Fehlerkorrekturen

  • Problem behoben, bei dem im XR-Dialog einige Inhalte nicht angezeigt wurden (c82e61b)

Version 1.0.0-alpha08

20. Mai 2025

androidx.xr.compose.material3:material3:1.0.0-alpha08 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Fehlerkorrekturen

  • Absturz behoben, wenn ListDetailPaneScaffold oder SupportingPaneScaffold keine untergeordneten Elemente hat (46df990)
  • Material XR-Mindest-SDK auf 24 senken (6064706)

Version 1.0.0-alpha07

7. Mai 2025

androidx.xr.compose.material3:material3:1.0.0-alpha07 ist veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

  • Für Projekte, die mit Kotlin 2.0 veröffentlicht wurden, ist KGP 2.0.0 oder höher erforderlich. (Idb6b5)

Version 1.0.0-alpha06

26. März 2025

androidx.xr.compose.material3:material3:1.0.0-alpha06 ist veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Version 1.0.0-alpha05

12. März 2025

androidx.xr.compose.material3:material3:1.0.0-alpha05 ist veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

  • TopAppBar wird standardmäßig in einen Orbiter räumlich gerendert, wenn EnableXrComponentOverrides verwendet wird.
  • Material AlertDialog wird standardmäßig in einem SpatialPanel räumlich gerendert, wenn EnableXrComponentOverrides verwendet wird.

API-Änderungen

  • ComponentOverride-Typen in Override und ComponentOverrideContext-Typen in OverrideScope umbenennen (Id973c)

Fehlerkorrekturen

  • Aliasing und falsche Scrimming-Effekte bei räumlich gerenderten NavigationRail- und NavigationBar-Elementen korrigieren. (I9db52)

Version 1.0.0-alpha04

26. Februar 2025

androidx.xr.compose.material3:material3:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

  • ListDetailPaneScaffold und SupportingPaneScaffold verwenden standardmäßig SpatialPanels, wenn EnableXrComponentOverrides verwendet wird (I166b0)

API-Änderungen

  • Die Getter DefaultNavigationRailOrbiterProperties und DefaultNavigationBarOrbiterProperties sind nicht mehr@Composable (I61618)
  • LocalNavigationRailOrbiterProperties und LocalNavigationBarOrbiterProperties sind nicht mehr nullable (I61618)

Version 1.0.0-alpha03

12. Februar 2025

androidx.xr.compose.material3:material3:1.0.0-alpha03 wird ohne nennenswerte Änderungen seit der letzten Alphaversion veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Version 1.0.0-alpha02

29. Januar 2025

androidx.xr.compose.material3:material3:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Aktivieren Sie die Anpassung von Orbiter-Eigenschaften für XR NavigationBar und NavigationRail. (Ic300f)

API-Änderungen

  • Möglichkeit schaffen, ThreePaneScaffold auf XR zu überschreiben (Ib66f1)
  • Nicht animierte Pane-Überschreibung für XR implementieren (I7f620)
  • Neue experimentelle Annotation ExperimentalMaterial3ComponentOverrideApi (Ia1eaf) hinzufügen und verwenden

Fehlerkorrekturen

  • Die Abhängigkeit von Material3 XR von XR Compose wird angepinnt. (Ia02cc)

Version 1.0.0-alpha01

12. Dezember 2024

androidx.xr.compose.material3:material3:1.0.0-alpha01 ist veröffentlicht.

Funktionen der Erstversion

Erste Entwicklerversion von Material Design für XR. Mit der vorhandenen Material 3-Bibliothek werden Komponenten und adaptive Layouts mit räumlichen UI-Verhaltensweisen erweitert. Sie können direkt mit M3 XR-Komponenten entwickeln oder Ihre aktuelle Implementierung anpassen, indem Sie den EnableXrComponentOverrides-Wrapper hinzufügen. Weitere Informationen

Unterstützte XR-Anpassungen:

Bekannte Probleme

  • ListDetailPaneScaffold und SupportingPaneScaffold unterstützen derzeit keine mehreren räumlichen Bereiche.