Material Design para XR

Criar com componentes e layouts do Material Design que se adaptam para XR
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
22 de outubro de 2025 - - - 1.0.0-alpha12

Declarar dependências

Para adicionar uma dependência ao núcleo do XR Compose Material3, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

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

Kotlin

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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0-alpha12

22 de outubro de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha12. A versão 1.0.0-alpha12 contém estes commits.

Novos recursos

  • Adição de SpaceModeToggleButton para alternar entre HomeSpace e FullSpace (Ic6865).

Correções de bugs

  • Melhoria das barras de ferramentas de XR (Ied1f5)

Versão 1.0.0-alpha11

27 de agosto de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estes commits.

Correções de bugs

  • Correção do comportamento do FAB na NavRail do XR (Ibe20b)

Versão 1.0.0-alpha10

30 de julho de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estes commits.

Novos recursos

  • Agora é possível criar uma implementação de XR e ComponentOverride para barras de ferramentas horizontal e vertical (0e9496c, dcfef96)

Correções de bugs

  • Correção de um problema em que a caixa de diálogo do XR não mostrava alguns conteúdos (c82e61b)

Versão 1.0.0-alpha08

20 de maio de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estes commits.

Correções de bugs

  • Correção de falha quando ListDetailPaneScaffold ou SupportingPaneScaffold não tem filhos (46df990).
  • Redução do minSdk do Material XR para 24 (6064706)

Versão 1.0.0-alpha07

7 de maio de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estes commits.

Mudanças na API

  • Os projetos lançados com o Kotlin 2.0 exigem o KGP 2.0.0 ou mais recente para serem consumidos (Idb6b5).

Versão 1.0.0-alpha06

26 de março de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estes commits.

Versão 1.0.0-alpha05

12 de março de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estes commits.

Novos recursos

  • O TopAppBar é espacializado em um Orbiter por padrão ao usar EnableXrComponentOverrides.
  • O AlertDialog do Material é espacializado em um SpatialPanel por padrão ao usar EnableXrComponentOverrides.

Mudanças na API

  • Renomeação dos tipos ComponentOverride para Override e dos tipos ComponentOverrideContext para OverrideScope (Id973c).

Correções de bugs

  • Correção de aliasing e scrimming incorreto em NavigationRail e NavigationBar espacializados. (I9db52).

Versão 1.0.0-alpha04

26 de fevereiro de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estes commits.

Novos recursos

  • ListDetailPaneScaffold e SupportingPaneScaffold usam SpatialPanels por padrão ao usar EnableXrComponentOverrides (I166b0).

Mudanças na API

  • Os getters DefaultNavigationRailOrbiterProperties e DefaultNavigationBarOrbiterProperties não são mais@Composable (I61618).
  • LocalNavigationRailOrbiterProperties e LocalNavigationBarOrbiterProperties não são mais anuláveis (I61618).

Versão 1.0.0-alpha03

12 de fevereiro de 2025

androidx.xr.compose.material3:material3:1.0.0-alpha03 é lançado sem mudanças significativas desde a última versão Alfa. A versão 1.0.0-alpha03 contém estes commits.

Versão 1.0.0-alpha02

29 de janeiro de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estes commits.

Novos recursos

  • Ative a personalização das propriedades Orbiter no XR NavigationBar e NavigationRail. (Ic300f).

Mudanças na API

  • Criação da capacidade de substituir ThreePaneScaffold no XR (Ib66f1)
  • Implementação da substituição de painel não animado para XR (I7f620)
  • Adição e uso da nova anotação experimental ExperimentalMaterial3ComponentOverrideApi (Ia1eaf).

Correções de bugs

  • Fixe a dependência do Material3 XR no XR Compose. (Ia02cc).

Versão 1.0.0-alpha01

12 de dezembro de 2024

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha01.

Recursos da versão inicial

Versão inicial para desenvolvedores do Material Design para XR. Usando a biblioteca Material 3 atual, os componentes e layouts adaptáveis são aprimorados com comportamentos espaciais da interface. É possível criar diretamente com componentes M3 XR ou adaptar sua implementação atual adicionando o wrapper EnableXrComponentOverrides. Saiba mais neste guia para desenvolvedores.

Adaptações de XR compatíveis:

Problemas conhecidos

  • No momento, ListDetailPaneScaffold e SupportingPaneScaffold não são compatíveis com vários painéis espaciais.