Navegação 3

O Navigation 3 é uma nova biblioteca de navegação projetada para funcionar com o Compose. Com o Navigation 3, você tem controle total sobre a backstack e navega para e de destinos adicionando e removendo itens de uma lista. Ele cria um sistema de navegação de apps flexível, fornecendo:

  • Convenções para modelar uma backstack, em que cada entrada representa o conteúdo para o qual o usuário navegou
  • Uma interface que é atualizada automaticamente com as mudanças na backstack (incluindo animações)
  • Um escopo para itens na backstack, permitindo que o estado seja mantido enquanto um item está na backstack
  • Um sistema de layout adaptável que permite que vários destinos sejam exibidos ao mesmo tempo e permite a troca perfeita entre esses layouts
  • Um mecanismo para que o conteúdo se comunique com o layout pai (metadados)

Em um nível alto, você implementa o Navigation 3 das seguintes maneiras:

  1. Defina o conteúdo para o qual os usuários podem navegar no app, cada um com uma chave exclusiva, e adicione uma função para resolver essa chave no conteúdo. Consulte Resolver chaves para conteúdo.
  2. Crie uma backstack em que as chaves sejam enviadas e removidas à medida que os usuários navegam pelo app. Consulte Criar uma backstack.
  3. Use um NavDisplay para mostrar a backstack do app. Sempre que a backstack muda, ela atualiza a interface para mostrar o conteúdo relevante. Consulte Mostrar a backstack.
  4. Modifique as estratégias de cena NavDisplay do conforme necessário para oferecer suporte a layouts adaptáveis e plataformas diferentes.
  5. Ofereça suporte a links diretos para navegar diretamente até os destinos.

Você pode conferir o código-fonte completo do Navigation 3 no AOSP.

Melhorias no Jetpack Navigation

O Navigation 3 melhora a API original do Jetpack Navigation das seguintes maneiras:

  • Oferece uma integração mais simples com o Compose
  • Oferece controle total da backstack
  • Permite criar layouts que podem ler mais de um destino da backstack ao mesmo tempo, permitindo que eles se adaptem a mudanças no tamanho da janela e outras entradas.

Leia mais sobre os princípios do Navigation 3 e as opções de design da API na postagem do blog de anúncio.

Amostras de código

O repositório de receitas contém exemplos de como usar os blocos de construção do Navigation 3 para resolver desafios comuns de navegação.