Material Design para XR

Crie com componentes e layouts do Material Design que se adaptam à XR
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
25 de março de 2026 - - - 1.0.0-alpha16

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

Kotlin

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

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

25 de março de 2026

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha16. A versão 1.0.0-alpha16 contém estas confirmações.

Mudanças na API

  • O Orbiter foi alterado para usar um OrbiterAnchorPoint + VolumeOffset ou um OrbiterPoseProvider em vez de position, offset, offsetType, alignment e elevação. Também removemos o parâmetro shouldRenderInNonSpatial. Se o desenvolvedor não quiser que o Orbiter seja renderizado em um espaço não espacial, ele precisará envolvê-lo em uma instrução "if" e verificar as SpatialCapabilities. (I9fbb3, b/462428503)

Versão 1.0.0-alpha15

25 de fevereiro de 2026

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha15. A versão 1.0.0-alpha15 contém estas confirmações.

Mudanças na API

Versão 1.0.0-alpha14

28 de janeiro de 2026

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha14. A versão 1.0.0-alpha14 contém estas confirmações.

Versão 1.0.0-alpha13

3 de dezembro de 2025

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha13. A versão 1.0.0-alpha13 contém estas confirmações.

Novos recursos

  • Agora é possível criar uma implementação de XR e ComponentOverride para WideNavigationRail e ModalWideNavigationRail (I1e86d, b/407769444)
  • NavigationSuiteScaffold, ListDetailPaneScaffold e SupportingPaneScaffold agora usam recommendedContentBoxInFullSpace para definir os tamanhos padrão (Ic54f1, b/388111668, b/394913962, b/394913962)

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 estas confirmações.

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 estas confirmações.

Correções de bugs

  • Correção do comportamento do FAB no XR NavRail (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 estas confirmações.

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 de 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 estas confirmações.

Correções de bugs

  • Correção de uma falha que ocorria quando ListDetailPaneScaffold ou SupportingPaneScaffold não tinham 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 estas confirmações.

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 estas confirmações.

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 estas confirmações.

Novos recursos

  • TopAppBar é espacializado em um Orbiter por padrão ao usar EnableXrComponentOverrides.
  • O AlertDialog do Material Design é 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 alias 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 estas confirmações (link em inglês).

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

Lançamento de androidx.xr.compose.material3:material3:1.0.0-alpha03 sem mudanças notáveis desde a última versão Alfa. A versão 1.0.0-alpha03 contém estas confirmações.

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 estas confirmações.

Novos recursos

  • Ativação da personalização das propriedades Orbiter em NavigationBar e NavigationRail de XR. (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

  • Fixação da 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 oferecem suporte a vários painéis espaciais