Material Design per XR

Crea con componenti e layout Material che si adattano a XR
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
25 marzo 2026 - - - 1.0.0-alpha16

Dichiara le dipendenze

Per aggiungere una dipendenza dal core di XR Compose Material3, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

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

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Versione 1.0

Versione 1.0.0-alpha16

25 marzo 2026

androidx.xr.compose.material3:material3:1.0.0-alpha16 è stato rilasciato. La versione 1.0.0-alpha16 contiene questi commit.

Modifiche alle API

  • Orbiter è stato modificato in modo da utilizzare un OrbiterAnchorPoint + VolumeOffset o un OrbiterPoseProvider anziché position, offset, offsetType, alignment ed elevation. È stato rimosso anche il parametro shouldRenderInNonSpatial. Se lo sviluppatore non vuole che l'orbiter venga visualizzato in uno spazio non spaziale, deve racchiuderlo in un'istruzione if e controllare SpatialCapabilities. (I9fbb3, b/462428503)

Versione 1.0.0-alpha15

25 febbraio 2026

androidx.xr.compose.material3:material3:1.0.0-alpha15 è stato rilasciato. La versione 1.0.0-alpha15 contiene questi commit.

Modifiche alle API

Versione 1.0.0-alpha14

28 gennaio 2026

androidx.xr.compose.material3:material3:1.0.0-alpha14 è stato rilasciato. La versione 1.0.0-alpha14 contiene questi commit.

Versione 1.0.0-alpha13

3 dicembre 2025

androidx.xr.compose.material3:material3:1.0.0-alpha13 è stato rilasciato. La versione 1.0.0-alpha13 contiene questi commit.

Nuove funzionalità

  • Crea l'implementazione XR e ComponentOverride per WideNavigationRail e ModalWideNavigationRail (I1e86d, b/407769444)
  • NavigationSuiteScaffold, ListDetailPaneScaffold e SupportingPaneScaffold ora utilizzano recommendedContentBoxInFullSpace per impostare le dimensioni predefinite (Ic54f1, b/388111668, b/394913962, b/394913962)

Versione 1.0.0-alpha12

22 ottobre 2025

androidx.xr.compose.material3:material3:1.0.0-alpha12 è stato rilasciato. La versione 1.0.0-alpha12 contiene questi commit.

Nuove funzionalità

  • Aggiunto SpaceModeToggleButton per passare da HomeSpace a FullSpace (Ic6865)

Correzioni di bug

  • Migliora le barre degli strumenti XR (Ied1f5)

Versione 1.0.0-alpha11

27 agosto 2025

androidx.xr.compose.material3:material3:1.0.0-alpha11 è stato rilasciato. La versione 1.0.0-alpha11 contiene questi commit.

Correzioni di bug

  • Correzione del comportamento del pulsante di azione mobile in XR NavRail (Ibe20b)

Versione 1.0.0-alpha10

30 luglio 2025

androidx.xr.compose.material3:material3:1.0.0-alpha10 è stato rilasciato. La versione 1.0.0-alpha10 contiene questi commit.

Nuove funzionalità

  • Crea l'implementazione XR e ComponentOverride per la barra degli strumenti orizzontale e verticale (0e9496c, dcfef96)

Correzioni di bug

  • Correzione del problema per cui la finestra di dialogo XR non mostrava alcuni contenuti (c82e61b)

Versione 1.0.0-alpha08

20 maggio 2025

androidx.xr.compose.material3:material3:1.0.0-alpha08 è stato rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Correzioni di bug

  • Correzione dell'arresto anomalo quando ListDetailPaneScaffold o SupportingPaneScaffold non hanno figli (46df990)
  • Abbassa il minSdk di Material XR a 24 (6064706)

Versione 1.0.0-alpha07

7 maggio 2025

androidx.xr.compose.material3:material3:1.0.0-alpha07 è stato rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche alle API

  • I progetti rilasciati con Kotlin 2.0 richiedono l'utilizzo di KGP 2.0.0 o versioni successive. (Idb6b5)

Versione 1.0.0-alpha06

26 marzo 2025

androidx.xr.compose.material3:material3:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Versione 1.0.0-alpha05

12 marzo 2025

androidx.xr.compose.material3:material3:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

  • TopAppBar viene spazializzato in un orbiter per impostazione predefinita quando si utilizza EnableXrComponentOverrides.
  • Material AlertDialog viene spazializzato in un SpatialPanel per impostazione predefinita quando si utilizza EnableXrComponentOverrides.

Modifiche alle API

  • Rinomina i tipi ComponentOverride in Override e i tipi ComponentOverrideContext in OverrideScope (Id973c)

Correzioni di bug

  • Correzione dell'aliasing e dello scrimming errato su NavigationRail e NavigationBar spazializzati. (I9db52)

Versione 1.0.0-alpha04

26 febbraio 2025

androidx.xr.compose.material3:material3:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

  • ListDetailPaneScaffold e SupportingPaneScaffold utilizzano SpatialPanels per impostazione predefinita quando si utilizza EnableXrComponentOverrides (I166b0)

Modifiche alle API

  • I getter DefaultNavigationRailOrbiterProperties e DefaultNavigationBarOrbiterProperties non sono più@Composable (I61618)
  • LocalNavigationRailOrbiterProperties e LocalNavigationBarOrbiterProperties non sono più nullable (I61618)

Versione 1.0.0-alpha03

12 febbraio 2025

androidx.xr.compose.material3:material3:1.0.0-alpha03 è stato rilasciato senza modifiche significative rispetto all'ultima versione alpha. La versione 1.0.0-alpha03 contiene questi commit.

Versione 1.0.0-alpha02

29 gennaio 2025

androidx.xr.compose.material3:material3:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Consenti la personalizzazione delle proprietà Orbiter su NavigationBar e NavigationRail XR. (Ic300f)

Modifiche alle API

  • Crea la possibilità di eseguire l'override di ThreePaneScaffold su XR (Ib66f1)
  • Implementa l'override del riquadro non animato per XR (I7f620)
  • Aggiungi e utilizza la nuova annotazione sperimentale ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Correzioni di bug

  • Blocca la dipendenza di Material3 XR da XR Compose. (Ia02cc)

Versione 1.0.0-alpha01

12 dicembre 2024

androidx.xr.compose.material3:material3:1.0.0-alpha01 è stato rilasciato.

Funzionalità della release iniziale

Release iniziale per gli sviluppatori di Material Design per XR. Utilizzando la libreria Material 3 esistente, i componenti e i layout adattivi vengono migliorati con comportamenti dell'interfaccia utente spaziale. Puoi creare direttamente con i componenti M3 XR o adattare l'implementazione attuale aggiungendo il wrapper EnableXrComponentOverrides. Scopri di più in questa guida per gli sviluppatori.

Adattamenti XR supportati:

Problemi noti

  • Al momento, ListDetailPaneScaffold e SupportingPaneScaffold non supportano più pannelli spaziali