Material Design pour la XR

Créer des composants et des mises en page Material qui s'adaptent à la XR
Dernière mise à jour Version stable Version finale Version bêta Version alpha
25 mars 2026 - - - 1.0.0-alpha16

Déclarer des dépendances

Pour ajouter une dépendance au cœur de XR Compose Material3, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

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")
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.0

Version 1.0.0-alpha16

25 mars 2026

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha16. Liste des commits de la version 1.0.0-alpha16 these commits.

Modifications apportées à l'API

  • Modification d'Orbiter pour utiliser un OrbiterAnchorPoint + VolumeOffset ou un OrbiterPoseProvider au lieu de position, offset, offsetType, alignment, et elevation. Suppression également du paramètre shouldRenderInNonSpatial. Si le développeur ne souhaite pas que l'orbiteur s'affiche dans un espace non spatial, il doit l'encapsuler dans une instruction if et vérifier les SpatialCapabilities. (I9fbb3, b/462428503)

Version 1.0.0-alpha15

25 février 2026

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha15. Liste des commits de la version 1.0.0-alpha15 these commits.

Modifications apportées à l'API

  • Modifications apportées à la marge intérieure du modificateur de sous-espace pour la prise en compte du sens de la mise en page (I53e25, b/475290780, b/474410590)

Version 1.0.0-alpha14

28 janvier 2026

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha14. Liste des commits de la version 1.0.0-alpha14 these commits.

Version 1.0.0-alpha13

3 décembre 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha13. Liste des commits de la version 1.0.0-alpha13 these commits.

Nouvelles fonctionnalités

  • Création d'une implémentation XR et ComponentOverride pour WideNavigationRail et ModalWideNavigationRail (I1e86d, b/407769444)
  • NavigationSuiteScaffold, ListDetailPaneScaffold et SupportingPaneScaffold utilisent désormais recommendedContentBoxInFullSpace pour définir leurs tailles par défaut (Ic54f1, b/388111668, b/394913962, b/394913962)

Version 1.0.0-alpha12

22 octobre 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha12. Liste des commits de la version 1.0.0-alpha12 .

Nouvelles fonctionnalités

  • Ajout de SpaceModeToggleButton pour basculer entre HomeSpace et FullSpace (Ic6865)

Correction de bugs

  • Amélioration des barres d'outils XR (Ied1f5)

Version 1.0.0-alpha11

27 août 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11 .

Correction de bugs

  • Correction du comportement du FAB dans XR NavRail (Ibe20b)

Version 1.0.0-alpha10

30 juillet 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10

Nouvelles fonctionnalités

  • Création d'une implémentation XR et ComponentOverride pour la barre d'outils horizontale et verticale (0e9496c, dcfef96)

Correction de bugs

  • Correction d'un problème qui empêchait l'affichage de certains contenus dans la boîte de dialogue XR (c82e61b)

Version 1.0.0-alpha08

20 mai 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Correction de bugs

  • Correction d'un plantage lorsque ListDetailPaneScaffold ou SupportingPaneScaffold n'a pas d'enfant (46df990)
  • Réduction du minSdk de Material XR à 24 (6064706)

Version 1.0.0-alpha07

7 mai 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Modifications apportées à l'API

  • Les projets publiés avec Kotlin 2.0 nécessitent l'utilisation de KGP 2.0.0 ou version ultérieure. (Idb6b5)

Version 1.0.0-alpha06

26 mars 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Version 1.0.0-alpha05

12 mars 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05 these commits.

Nouvelles fonctionnalités

  • TopAppBar est spatialisé dans un orbiteur par défaut lorsque vous utilisez EnableXrComponentOverrides.
  • Material AlertDialog est spatialisé dans un SpatialPanel par défaut lorsque vous utilisez EnableXrComponentOverrides.

Modifications apportées à l'API

  • Renommage des types ComponentOverride en Override et des types ComponentOverrideContext en OverrideScope (Id973c)

Correction de bugs

  • Correction de l'aliasing et de l'ombrage incorrect sur les NavigationRail et NavigationBar spatialisés. (I9db52)

Version 1.0.0-alpha04

26 février 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04 .

Nouvelles fonctionnalités

  • ListDetailPaneScaffold et SupportingPaneScaffold utilisent SpatialPanels par défaut lorsque vous utilisez EnableXrComponentOverrides (I166b0)

Modifications apportées à l'API

  • Les getters DefaultNavigationRailOrbiterProperties et DefaultNavigationBarOrbiterProperties ne sont plus@Composable (I61618)
  • LocalNavigationRailOrbiterProperties et LocalNavigationBarOrbiterProperties ne peuvent plus être nuls (I61618)

Version 1.0.0-alpha03

12 février 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha03 sans modification notable par rapport à la dernière version alpha. Liste des commits de la version 1.0.0-alpha03 these commits

Version 1.0.0-alpha02

29 janvier 2025

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02 these commits.

Nouvelles fonctionnalités

  • Activation de la personnalisation des propriétés Orbiter sur XR NavigationBar et NavigationRail. (Ic300f)

Modifications apportées à l'API

  • Création de la possibilité de remplacer ThreePaneScaffold sur XR (Ib66f1)
  • Implémentation du remplacement de volet non animé pour XR (I7f620)
  • Ajout et utilisation de la nouvelle annotation expérimentale ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Correction de bugs

  • Épinglage de la dépendance de Material3 XR sur XR Compose. (Ia02cc)

Version 1.0.0-alpha01

12 décembre 2024

Publication d'androidx.xr.compose.material3:material3:1.0.0-alpha01.

Fonctionnalités de la version initiale

Version initiale pour les développeurs de Material Design pour la XR. À l'aide de la bibliothèque Material 3 existante, les composants et les mises en page adaptatives sont améliorés avec des comportements d'UI spatiaux. Vous pouvez créer directement des composants M3 XR ou adapter votre implémentation actuelle en ajoutant le wrapper EnableXrComponentOverrides. Pour en savoir plus, consultez ce guide du développeur.

Adaptations XR compatibles :

Problèmes connus

  • ListDetailPaneScaffold et SupportingPaneScaffold ne sont actuellement pas compatibles avec plusieurs panneaux spatiaux.