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
19 mai 2026 - - - 1.0.0-alpha17

Déclarer des dépendances

Pour ajouter une dépendance sur le 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-alpha17"
}

Kotlin

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

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-alpha17

19 mai 2026

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

Modifications apportées à l'API

  • Modification de Orbiter pour utiliser un OrbiterAnchorPoint + VolumeOffset ou un OrbiterPoseProvider au lieu de position, offset, offsetType, alignment et elevation. Le paramètre shouldRenderInNonSpatial a également été supprimé. 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 SpatialCapabilities. (I9fbb3)
  • Ajout de modificateurs déplaçables. Ces modificateurs fonctionnent actuellement pour SpatialPanels et SpatialExternalSurface. Elles seront prises en charge à l'avenir pour SpatialGltfModel, puis pour tous les SubspaceComposables. (I9a3cd)

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

Modifications apportées à l'API

  • Orbiter utilise désormais un OrbiterAnchorPoint + VolumeOffset ou un OrbiterPoseProvider au lieu de position, offset, offsetType, alignment et de l'altitude. Le paramètre shouldRenderInNonSpatial a également été supprimé. 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 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

Modifications apportées à l'API

  • Modifications de la marge intérieure du modificateur d'espace secondaire pour la prise en compte du sens de 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

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

Nouvelles fonctionnalités

  • Créer 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éliorer les 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 bouton d'action flottant 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éer une implémentation XR et ComponentOverride pour la barre d'outils horizontale et verticale (0e9496c, dcfef96)

Correction de bugs

  • Correction du problème lié à l'affichage partiel du contenu de 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 du plantage lorsque ListDetailPaneScaffold ou SupportingPaneScaffold n'ont pas d'enfants (46df990)
  • Réduction de la version minimale (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 KGP 2.0.0 ou version ultérieure pour être utilisés. (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

Nouvelles fonctionnalités

  • TopAppBar est spatialisé dans un Orbiter par défaut lorsque vous utilisez EnableXrComponentOverrides.
  • Le AlertDialog Material 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 lors de l'utilisation de EnableXrComponentOverrides (I166b0).

Modifications apportées à l'API

  • Les getters DefaultNavigationRailOrbiterProperties et DefaultNavigationBarOrbiterProperties ne sont plus @Composable (I61618).
  • LocalNavigationRailOrbiterProperties et LocalNavigationBarOrbiterProperties ne peuvent plus avoir une valeur nulle. (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

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

Nouvelles fonctionnalités

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

Modifications apportées à l'API

  • Créer la possibilité de remplacer ThreePaneScaffold sur XR (Ib66f1)
  • Implémenter le remplacement de la fenêtre non animée pour XR (I7f620)
  • Ajouter et utiliser la nouvelle annotation expérimentale ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Correction de bugs

  • Épinglez 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

Première version développeur de Material Design pour XR. Les composants et les mises en page adaptatives sont améliorés avec les comportements d'UI spatiaux à l'aide de la bibliothèque Material 3 existante. Vous pouvez créer directement avec les 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 acceptées :

Problèmes connus

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