navigation3

  
O Navigation 3 é uma nova biblioteca de navegação projetada para funcionar com o Compose.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
23 de setembro de 2026 1.2.0 - - 1.3.0-alpha01

Declarar dependências

Para adicionar uma dependência ao navigation3, 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 {
    implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha01"
    implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha01")
    implementation("androidx.navigation3:navigation3-ui:1.3.0-alpha01")
}

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.3

Versão 1.3.0-alpha01

23 de setembro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.3.0-alpha01. A versão 1.3.0-alpha01 contém estes commits.

** Correções de bugs **

  • Correção da transferência de animação de volta preditiva em NavDisplay migrando para DeferredAnimatedContent e resolvendo problemas de transferência de transição. I145eaedd b/430807423

Não há notas de versão para este artefato.

Versão 1.2.0

23 de setembro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0. A versão 1.2.0 contém estes commits.

A versão 1.2.0 agora está estável!

Mudanças importantes desde a 1.1.0

API Result

  • Essa nova API permite transmitir resultados entre NavEntries usando o ResultEventBus fornecido por LocalResultEventBus e ResultEventBusNavEntryDecorator.
  • Adição de rememberResultEventBus para oferecer suporte à elevação de um ResultEventBus fora de ResultEventBusNavEntryDecorator e transmissão para rememberResultEventBusNavEntryDecorator.
  • Os resultados transmitidos podem ser acessados como estado com ResultEventBus#conflateAsState ou coletados como um fluxo de resultados com ResultEffect.

API Deep Link

O Navigation3 agora oferece suporte a links diretos do Kotlin Multiplatform (KMP) em androidx.navigation3.runtime.deeplink via DeepLinkRequest, DeepLinkUri e DeepLinkMatcher.

  • DeepLinkRequest e RequestExtras: representam uma solicitação de link direto criada de um DeepLinkUri, uma string de URI ou um Intent do Android. Outros metadados de solicitação podem ser anexados usando o contêiner RequestExtras com segurança de tipos criado com a DSL requestExtras e RequestExtrasKey<T>.
  • DeepLinkMatcher: representa um link direto que pode ser correspondido a um DeepLinkRequest. Cada instância de correspondência está associada à chave de navegação que oferece suporte a esse link direto. Uma chave de navegação pode ser associada a vários comparadores. Chamar DeepLinkMatcher.match vai retornar um MatchResult que contém a chave de navegação associada se a correspondência for bem-sucedida. Há duas implementações padrão de DeepLinkMatcher: UriDeepLinkMatcher para correspondência de links diretos com base em Uri e StaticKeyDeepLinkMatcher para correspondência de links diretos com apenas DeepLinkMatcher.Filter que correspondem por um booleano.
  • BackStackMatcher: um DeepLinkMatcher para construir um backstack sintético após uma correspondência de link direto bem-sucedida. É possível criar BackStackMatcher usando a função de extensão DeepLinkMatcher.withBackStack.

Processamento de volta preditiva

  • Adicionamos NavigationBackHandler e rememberNavigationEventState para simplificar a conexão de SceneState com o processamento de volta preditiva (onBackCompleted e onBackCancelled). Isso permite que componentes de interface personalizados ofereçam suporte à navegação de retorno padrão e a gestos de volta preditiva sem calcular manualmente os deltas da backstack.
  • Melhorias nas transições de volta preditiva, incluindo suporte a gestos de volta preditiva acionados no meio da animação de encaminhamento.

Outras mudanças

  • Agora, NavEntry.contentKey usa por padrão um composto de key.toString() e key::class.toString(), evitando colisões de chaves entre chaves data object que compartilham o mesmo nome simples em interfaces diferentes.
  • Agora, o EntryProvider prioriza a correspondência com base em instâncias de chave em vez de tipos de chave.
  • Adição de uma verificação de lint para garantir que as implementações de Scene sejam data classes ou implementem equals e hashCode.

Versão 1.2.0-rc01

9 de setembro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-rc01. A versão 1.2.0-rc01 contém estes commits.

Correções de bugs

  • Não permitir nomes de substituição duplicados em padrões de URI de link direto. (I8985c, b/522343165)

Versão 1.2.0-beta01

26 de agosto de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-beta01. A versão 1.2.0-beta01 contém estes commits.

Mudanças na API

  • Refatoração de DeepLinkRequest.extras de Map<String, Any> para uma nova classe RequestExtras semelhante a um mapa com segurança de tipo, que armazena pares de RequestExtrasKey<T> para T. RequestExtras pode ser instanciado com a DSL requestExtras. (Ic929d, b/543883369).

Correções de bugs

  • Correção de um problema em que os gestos de retorno preditivo acionados durante uma transição para frente não eram animados em resposta ao progresso do deslizar. O gesto "Voltar" preditivo agora será animado e concluído corretamente. (Icdcb0, b/456218398)
  • Adicionada uma verificação de lint para garantir que as implementações de Scene sejam classes de dados ou implementem equals e hashcode para garantir que o mesmo Scene seja usado quando apropriado. (Ibdf0d, b/542316099)
  • O NavEntry.contentKey agora usa por padrão uma combinação de key.toString() e key::class.toString(). Isso garante que objetos de dados que compartilham o mesmo nome, mas implementam interfaces diferentes, não tenham mais o mesmo contentKey. No entanto, o key::class da plataforma JS retorna apenas o nome da classe simples em vez do nome totalmente qualificado. Por isso, a plataforma JS ainda precisa implementar um contentKey personalizado para objetos de dados com nomes duplicados. (I1fbbb, b/512534342)
  • Foi corrigida a IllegalArgumentException gerada por SaveableStateProvider para chaves duplicadas usadas durante a navegação de retorno rápida quando várias transições de remoção estão em andamento. (I4d728, b/516312097)

Versão 1.2.0-alpha07

29 de julho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha07. A versão 1.2.0-alpha07 contém estes commits.

Mudanças na API

  • Adicionada uma classe abstrata WrappedMatchResult para encapsular outro DeepLinkMatcher.MatchResult. Isso permite resultados de correspondência personalizados sobrepostos a outro. (I7d4dc, b/470282247)

  • Adicionada uma nova classe BackStackMatcher que usa dois parâmetros: uma instância de correspondência e uma lambda de builder que fornece o resultado da correspondência do matcher de entrada e retorna uma backstack. Se houver uma correspondência, BackStackMatcher vai retornar um BackStackMatchResult que estende WrappedMatchResult e contém o resultado da correspondência original e a backstack criada com a lambda. O BackStackMatcher só pode ser criado com a nova função de extensão DeepLinkMatcher.withBackStack. (Ibf987, b/470282247)

  • Adicionada uma classe abstrata DeepLinkSerializer que estende KSerializer para codificar e decodificar value : T como um String. DeepLinkSerializer pode ser usado para serializar argumentos de link direto não primitivos. Compatível com rememberSaveable e rememberNavBackStack. (Id3c9f, b/470282247)

  • DeepLinkMatcher adicionou um segundo parâmetro de tipo out R : DeepLinkMatcher.MatchResult<T> para que os desenvolvedores possam acessar as propriedades do MatchResult com subclasse retornado por DeepLinkMatcher.match() sem conversão de tipo. (I693d3, b/470282247)

  • O limite superior de DeepLinkMatcher.MatchResult's T mudou de Any? para Any. (I6bf1a).

  • O campo uri do construtor DeepLinkRequest agora tem o valor padrão "null". O uriString do construtor secundário foi renomeado para uri. (Ia0f14, b/522194187)

Correções de bugs

  • O ResultEffect agora usa rememberUpdatedState para capturar a lambda onResult mais recente. (I7d2a3, b/531709234)
  • Correção da correspondência de links diretos para segmentos de caminho vazios. Se o tipo de argumento for String, o caminho vazio será tratado como um valor de string vazia. Caso contrário, o caminho vazio será tratado como nenhum valor fornecido e vai voltar ao valor padrão. Se não houver um valor padrão, a correspondência vai falhar. (I56575, b/535298128)
  • Adicionado suporte para valores de consulta vazios em DeepLinkRequest.uri. Se o argumento for do tipo String, o valor vazio será tratado como uma string vazia literal. Caso contrário, o valor vazio será tratado como nenhum valor fornecido, e a correspondência tentará usar o valor substituto. Se não houver um valor padrão, a correspondência vai falhar. (I30343, b/535127459).
  • Agora, o EntryProvider prioriza a correspondência com base em instâncias de chave em vez de tipos de chave. (Ib5ec9, b/533331924)
  • Agora, o SceneState calcula corretamente as cenas anteriores, começando pela cena não sobreposta mais acima. (I91915, b/513630541).

Versão 1.2.0-alpha06

15 de julho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha06. A versão 1.2.0-alpha06 contém estes commits.

Correções de bugs

  • Correção da documentação UriDeepLinkMatcher sobre fragmentos de URI para esclarecer que fragmentos com caracteres curinga correspondem a qualquer entrada, mas a entrada não é extraída como argumentos. (I5ad9b, b/524677091)
  • Correção do problema em que UriDeepLinkMatcher não correspondia a uma solicitação se o padrão de URI não continha um esquema ou não começava com uma barra dupla. Por exemplo, www.example.com/home agora vai corresponder a http://www.example.com/home. (Ia6b65, b/522791926)

Versão 1.2.0-alpha05

1º de julho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha05. A versão 1.2.0-alpha05 contém estes commits.

Nova API

  • Adição de uma API rememberResultEventBus que retorna um ResultEventBus que pode ser transmitido para rememberResultEventBusNavEntryDecorator. Isso permite elevar um ResultEventBus fora do ResultEventBusNavEntryDecorator. (Ia655b, b/516995400)

DeepLinkRequest

  • Adição de dois construtores compatíveis com KMP: um que usa um DeepLinkUri e outro que usa uma string bruta de URI. (I3c088, b/513200887, b/522194187).
  • (Somente Android) Adição de um construtor que usa um Intent. (Ia0498, b/513200887, b/522194187).
  • Todos os construtores têm um campo extras adicional para um Map<String, Any> anexar mais informações de solicitação. (If81d5, b/513200887)
  • Uma nova dsl requestExtras foi adicionada como uma maneira type-safe de criar um mapa de extras. A DSL fornece uma função put para armazenar pares de RequestExtrasKey para Any. A função de extensão Map<String, Any>.get(key) pode ser usada para ler do mapa com um RequestExtrasKey(I5091c, b/513200887).
  • (Somente Android) Adicionamos uma função ActionExtrasKey e actionExtra para criar um mapa de extras com ActionExtrasKey. (Id0c90, [b/513200887]
  • Adicionamos uma função MimeTypeExtrasKey e mimeTypeExtra para criar um mapa de extras com MimeTypeExtrasKey. (I85131, b/513200887)

DeepLinkMatcher

  • Adicionamos as funções DeepLinkMatcher.mimeTypeFilter e DeepLinkMatcher.actionFilter para criar DeepLinkMatcher.Filters que filtram DeepLinkRequest por mimeType ou action (somente Android). Os dois filtros correspondem por igualdade de string e não diferenciam maiúsculas de minúsculas. (Ie7e67, b/513191950).

Mudanças na API

DeepLinkRequest

  • Remova a função de fábrica fromAction. Para criar uma solicitação associada a uma ação, use o novo campo DeepLinkRequest.extras.(Id0c90, b/513200887)
  • A função de fábrica fromMimeType foi removida. Para criar uma solicitação associada a um mimeType, use o novo campo DeepLinkRequest.extras. (I85131, b/513200887)
  • (Somente Android) Remoção da função de fábrica fromIntent. Substituído por um novo construtor que usa um mapa de intent e extras. (Ia0498, b/513200887, b/522194187).
  • As funções de fábrica fromUri e fromUriString foram removidas. Substituído por novos construtores que usam um DeepLinkUri ou um URI de string bruta. (Id5b6f, b/522194187).
  • DeepLinkMatcher, DeepLinkMatcher.MatchResult e as subclasses deles agora usam um T covariante (out T) para que as chaves hierárquicas não precisem de conversão de tipo com Matchers. (I1e453, b/525094876)
  • O parâmetro do construtor UriMatchResult para o mapa de argumentos agora tem como padrão um mapa vazio. (I3acdd).
  • A classe abstrata DeepLinkMatcher.Filter agora é uma interface funcional. O campo do construtor filter foi removido e precisa ser transmitido diretamente na subclasse. (I9eb7d, b/522194187).

Correções de bugs

  • Correção do desaparecimento imediato da entrada aberta ao abrir uma entrada com metadados aninhados que contêm valores lambda. (Idb872, b/520494430).
  • Correção de UriDeepLinkMatcher para que retorne um UriMatchResult nulo em vez de gerar MissingFieldException quando argumentos obrigatórios estiverem faltando durante a correspondência. (I5322f, b/524663005)
  • Um UriDeeplinkMatcher que contém o URI com o esquema HTTPS só pode ser correspondido a solicitações que também têm o esquema HTTPS. (Ibfe22, b/522304329).
  • Corrija UriDeepLinkMatcher para identificar corretamente o esquema http como uma correspondência positiva com https ao corresponder um DeepLinkRequest a um UriDeepLinkMatcher. (I3a62b, b/518804264)
  • O comparador DeepLinkMatcher.MatchResult agora retorna 0 por padrão quando dois resultados são iguais. (I48ddb, b/518841353)
  • Agora, UriDeepLinkMatcher vai retornar um UriMatchResult nulo em vez de gerar uma exceção quando a solicitação de correspondência falhar devido à falta de argumentos obrigatórios. (I669a7, b/470282247, b/512923412).

Versão 1.2.0-alpha04

3 de junho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha04. A versão 1.2.0-alpha04 contém estes commits.

Correções de bugs

  • Correção de um problema de animação de sobreposição em que sobreposições aninhadas, como ModalBottomSheet, eram reanimadas inesperadamente quando as sobreposições acima eram removidas. (Ia2b9e, b/502624496)

Versão 1.2.0-alpha03

19 de maio de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha03. A versão 1.2.0-alpha03 contém estes commits.

Novos recursos

O Navigation 3 agora oferece suporte a links diretos com DeepLinkRequest e DeepLinkMatcher:

  • DeepLinkRequest um link direto solicitado que contém um DeepLinkUri e um mimeType ou ação opcional(somente Android). Junto com a nova classe, há funções complementares para criar uma instância com um uri, um mimeType ou um action. A plataforma Android também tem um auxiliar para criar uma solicitação de uma intent. (Iaaac9, b/470282247)

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
val uriAndMimeRequest = DeepLinkRequest.fromUriString(
  "https://sampledeeplink.com/user/profile?id=123",
  "image/png"
)

  • DeepLinkMatcher representa um link direto que pode ser correspondido a um DeepLinkRequest. Cada instância de correspondência está associada à chave de navegação que oferece suporte a esse link direto. Uma chave de navegação pode ser associada a vários comparadores. Chamar DeepLinkMatcher.match vai retornar um MatchResult que contém a chave de navegação associada se a correspondência for bem-sucedida. Há duas implementações padrão de DeepLinkMatcher: UriDeepLinkMatcher para correspondência de links diretos com base em Uri e StaticKeyDeepLinkMatcher para correspondência de links diretos com apenas DeepLinkMatcher.Filter que correspondem a um Boolean. (I3798e, b/470282247).

  • UriDeepLinkMatcher uma implementação opinativa de DeepLinkMatcher que processa links diretos combinando DeepLinkUri a uma chave de navegação serializável. Ele aceita argumentos de link direto de tipos primitivos ou coleção de primitivos, como listas, matrizes e conjuntos. (I1520b, b/470282247).

    @Serializable
data class UserKey(val id: Int): NavKey

// declare a deep link supported by UserKey
val userMatcher = UriDeepLinkMatcher(
  uriPattern = "www.sampledeeplink.com/user?userId={id}",
  serializer = serializer<UserKey>()
)

// handle a requested deep link with fallback key
val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey

  • Adição de DeepLinkUri, que é uma versão multiplataforma do Kotlin de android.net.Uri (Id4725, b/470282247).

Mudanças na API

  • Aumentado para compileSdk 37 para corresponder ao compileSdk do Compose

Correções de bugs

  • Corrigimos o IllegalArgumentException do AnimatedBottomSheetSample ao mostrar várias sobreposições. O exemplo SceneStrategy agora vai calcular corretamente o último OverlayScene e mostrar em todas as cenas de sobreposição. (If2281, b/506733412)
  • Aumentamos a dependência NavigationEvent para 1.1.1, o que remove o NavigationEventHandler sem operação no modo de inspeção para ativar a volta preditiva nas prévias do Android Studio. (I487fd).

Versão 1.2.0-alpha02

22 abril de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha02. A versão 1.2.0-alpha02 contém estes commits.

Mudanças na API

  • Renomeie onBack para onBackCompleted e adicione onBackCancelled ao NavigationBackHandler para oferecer suporte ao processamento de gestos de retorno cancelados. (I92741).
  • Adicione NavigationBackHandler para simplificar o processamento de gestos de volta e volta preditiva ao usar SceneState. Isso permite que os desenvolvedores criem com mais facilidade componentes de interface personalizados que oferecem suporte à navegação de retorno padrão e a gestos preditivos sem calcular manualmente os deltas da backstack. (I6a055).
  • Adicionamos rememberNavigationEventState para simplificar a conexão de SceneState com o processamento de volta preditiva. (Iae49c).

Novos recursos

  • Adição de uma API ResultEventBus para permitir a transmissão de resultados entre NavEntries com o LocalResultEventBus fornecido pelo novo ResultEventBusNavEntryDecorator. Os resultados transmitidos podem ser avaliados como um estado com ResultEventBus#conflateAsState ou como um fluxo de resultados com ResultEffect.

Versão 1.2.0-alpha01

8 de abril de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.0-alpha01. A versão 1.2.0-alpha01 contém estes commits.

Correções de bugs

  • O acesso a LocalNavAnimatedContentScope de um OverlayScene não vai mais causar um IllegalStateException, já que os OverlayScenes agora são fornecidos com um LocalAnimatedContentScope sem operação. (I2f00c, b/486067688)

Versão 1.1.7

26 de agosto de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.7. A versão 1.1.7 contém estes commits.

Correções de bugs

  • Correção de um problema em que os gestos de retorno preditivo acionados durante uma transição para frente não eram animados em resposta ao progresso do deslizar. O gesto "Voltar" preditivo agora será animado e concluído corretamente. (Icdcb0, b/456218398)

Versão 1.1.6

12 de agosto de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.6. A versão 1.1.6 contém estes commits.

Correções de bugs

  • O NavEntry.contentKey agora usa por padrão um composto de key.toString() e key::class.toString(). Isso garante que objetos de dados que compartilham o mesmo nome, mas implementam interfaces diferentes, não tenham mais o mesmo contentKey. No entanto, o key::class da plataforma JS retorna apenas o nome da classe simples em vez do nome totalmente qualificado. Por isso, a plataforma JS ainda precisa implementar um contentKey personalizado para objetos de dados com nomes duplicados. (I1fbbb, b/512534342)
  • Correção de IllegalArgumentException gerado por SaveableStateHolder para reutilização de chaves quando várias transições de remoção estão em andamento simultaneamente devido à remoção rápida da backstack. (I4d728, b/516312097)

Versão 1.1.5

29 de julho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.5. A versão 1.1.5 contém estes commits.

Correções de bugs

  • A DSL entryProvider agora prioriza NavEntry criados com uma instância de chave, por exemplo, entry(key = userKey) { ... } em vez de NavEntry criados com uma classe de chave, como entry<UserKey>{ ... }.(Ib5ec9, b/533331924)

Versão 1.1.4

1º de julho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.4. A versão 1.1.4 contém estes commits.

Correções de bugs

  • Correção de uma entrada aberta que desaparecia imediatamente ao abrir uma entrada com metadados aninhados que continham valores lambda. (Idb872, b/520494430).

Versão 1.1.3

17 de junho de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.3. A versão 1.1.3 contém estes commits.

Correções de bugs

  • Correção de um problema de animação de sobreposição em que sobreposições aninhadas, como ModalBottomSheet, eram reanimadas inesperadamente quando as sobreposições acima eram removidas. (Ia2b9e, b/502624496)

  • Aumentamos a dependência NavigationEvent para 1.1.2, o que removeu o NavigationEventHandler sem operação no modo de inspeção para ativar a volta preditiva nas prévias do Android Studio.

Versão 1.1.2

19 de maio de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.2. A versão 1.1.2 contém estes commits.

Correções de bugs

  • Aumentamos a dependência NavigationEvent para 1.1.1, que removeu o NavigationEventHandler sem operação no modo de inspeção para ativar a volta preditiva nas prévias do Android Studio.

Versão 1.1.1

22 abril de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.1. A versão 1.1.1 contém estes commits.

Correções de bugs

  • O acesso a LocalNavAnimatedContentScope de um OverlayScene não vai mais causar um IllegalStateException, já que os OverlayScenes agora são fornecidos com um LocalAnimatedContentScope sem operação. (I2f00c, b/486067688)

Versão 1.1.0

8 de abril de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0. A versão 1.1.0 contém estes commits.

A versão 1.1.0 agora está estável!

Mudanças importantes desde a versão 1.0.0

Elementos compartilhados entre cenas - O Navigation3 agora oferece suporte ao tratamento de cenas como objeto de elemento compartilhado. Isso significa que, quando as cenas mudam, é possível garantir uma transição suave. Para ativar, transmita um SharedTransitionScope para NavDisplay ou rememberSceneState.

SceneDecoratorStrategy - Introdução de SceneDecoratorStrategy para oferecer suporte a casos de uso, como decorar cenas com componentes comuns da interface ou compartilhar estado entre cenas.

DSL NavMetadata - O Navigation3 agora oferece uma nova DSL de metadados com segurança de tipos. A DSL usa uma nova interface MetadataKey que permite definir os tipos de chave e valor que serão fornecidos ao mapa de metadados. Isso também adicionou novas NavMetadataKeys para transições NavDisplay, que podem ser usadas com a nova DSL de metadados para adicionar transições a NavDisplay.

Animações de OverlayScene - A interface OverlayScene tem um novo callback de suspensão onRemoved. Esse callback é invocado depois que uma chave associada à cena é removida da pilha de retorno, mas antes de sair da composição. Isso permite que as animações de saída chamadas em onRemoved sejam concluídas antes que a cena de sobreposição seja removida da composição.

Outras mudanças - NavDisplay e rememberSceneState agora usam um List<SceneStrategy> em vez do único parâmetro SceneStrategy anterior, que era encadeado pelo infixo then. - Agora você pode adicionar metadados de forma dinâmica considerando a chave de entrada usando a DSL EntryProvider.

Versão 1.1.0-rc01

25 de março de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0-rc01. A versão 1.1.0-rc01 contém estes commits.

Correções de bugs

  • Agora, o NavDisplay garante que as entradas exibidas abaixo das sobreposições tenham o Lifecycle limitado a STARTED. Isso garante que APIs como dropUnlessResumed continuem funcionando ao usar caixas de diálogo. (If209f, b/483966071)
  • Correção de um problema no NavDisplay em que navegar para frente e para trás entre as mesmas telas e interromper as animações entre elas podia fazer com que a ordem z das telas ficasse incorreta. (I4d491, b/459419800)

Versão 1.1.0-beta01

11 de março de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0-beta01. A versão 1.1.0-beta01 contém estes commits.

Versão 1.1.0-alpha05

25 de fevereiro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0-alpha05. A versão 1.1.0-alpha05 contém estes commits.

Mudanças na API

  • NavDisplay e rememberSceneState agora usam um List<SceneStrategy> em vez do único parâmetro SceneStrategy anterior, que era encadeado pelo infixo then. Isso se alinha mais de perto com o List<SceneDecoratorStrategy<T>> que ambas as APIs já usam. As APIs anteriores foram descontinuadas. (I78b2c, b/482108465)
  • Adicionamos um operador #contains de metadados para verificar se o mapa de metadados contém o NavMetadataKey especificado. (Ic30db, b/485311895)
  • Adicionamos NavMetadataKey DialogKey para DialogSceneStrategy usar com a DSL de metadados. (Ic7a26, b/483388817)

Versão 1.1.0-alpha04

11 de fevereiro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0-alpha04. A versão 1.1.0-alpha04 contém estes commits.

Novos recursos

  • O Navigation3 agora oferece uma nova DSL de metadados com segurança de tipos. A DSL usa uma nova interface MetadataKey que permite definir os tipos de chave e valor que serão fornecidos ao mapa de metadados. Isso também adicionou novos NavMetadataKeys para transições NavDisplay, para que possam ser usados com a nova DSL metadata e adicionar transições a NavDisplay. (Ic10ef, Ic049c,b/476213928)

Mudanças na API

  • A interface OverlayScene tem um novo callback de suspensão onRemoved. Esse callback é invocado depois que uma chave associada à cena é removida da pilha de retorno, mas antes de sair da composição. Isso permite que as animações de saída chamadas em onRemoved sejam concluídas antes que a cena de sobreposição seja removida da composição. (I29a72, b/440558061)
  • SceneStrategy separou a função de decoração em um novo SceneDecoratorStrategy. Essa nova interface é o que deve ser usado para decorar cenas. Há novas APIs para NavDisplay e rememberSceneState que permitem a adição de SceneDecoratorStrategies. (If9385, b/477669607, b/477670333)

Correções de bugs

  • Foi corrigido um erro em que a transmissão de um SharedTransitionLayout para NavDisplay ou rememberSceneState e o uso de qualquer OverlayScene causavam uma falha. Isso acontecia porque o uso de SharedTransitionLayout só funciona com NavEntries renderizados como parte do AnimatedContent, e os OverlayScene são renderizados em janelas separadas. (I1bb76, b/478664101)

Atualização de dependências

  • Do Navigation3 1.0.1: o Navigation3 agora depende do NavigationEvent 1.0.2. Isso corrige uma IllegalStateException causada pelo uso de NavDisplay durante as prévias AndroidStudio. (Id7212, b/477149762)

Versão 1.1.0-alpha03

28 de janeiro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0-alpha03. A versão 1.1.0-alpha03 contém estes commits.

Novos recursos

  • Agora você pode adicionar metadados de forma dinâmica considerando a chave de entrada usando a DSL EntryProvider. (I942fb, b/474416976).

Versão 1.1.0-alpha02

14 de janeiro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.1.0-alpha02. A versão 1.1.0-alpha02 contém estes commits.

Novos recursos

  • O SceneStrategy agora oferece suporte ao aninhamento de cenas usando uma nova função calculatedScene(Scene). Isso significa que os SceneStrategy podem ser personalizados para oferecer mais funcionalidades a outras cenas. (I5df7c,b/440333896)

Versão 1.1.0-alpha01

03 de dezembro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estes commits.

Mudanças na API

  • Agora, o Navigation3 oferece suporte ao tratamento de cenas como objeto de elemento compartilhado. Isso significa que, quando as cenas mudam, é possível garantir uma transição suave. Para ativar, transmita um SharedTransitionScope para NavDisplay ou rememberSceneState. (I15868).

Versão 1.0

Versão 1.0.1

11 de fevereiro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.0.1. A versão 1.0.1 contém estes commits.

Atualização de dependências

  • Navigation3 agora depende do NavigationEvent 1.0.2. Isso corrige uma IllegalStateException causada pelo uso de NavDisplay durante as prévias do AndroidStudio. (Id7212, b/477149762)

Versão 1.0.0

19 de novembro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0. A versão 1.0.0 contém estes commits.

Conheça o Navigation3!

  • A biblioteca Navigation3 agora está estável. O Navigation3 é a primeira abordagem do AndroidX Compose para navegação.
  • Para mais informações, consulte nossa postagem do blog de anúncio, acesse os recursos e confira as receitas.

Versão 1.0.0-rc01

5 de novembro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-rc01. A versão 1.0.0-rc01 contém estes commits.

Correções de bugs

  • O NavDisplay agora define um LocalLifecycleOwner no nível Scene que permite aos autores de cenas determinar se todas as transições foram concluídas verificando se o Lifecycle.State é RESUMED. O comportamento do LocalLifecycleOwner no nível NavEntry não mudou: ele também permanece limitado a STARTED se uma transição estiver em andamento e a CREATED se esse NavEntry tiver sido removido do backstack e estiver em processo de animação. (I03113, b/454045829)

Versão 1.0.0-beta01

22 de outubro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-beta01. A versão 1.0.0-beta01 contém estes commits.

Mudanças na API

  • Agora, SceneStrategyScope tem apenas um construtor público sem argumentos, adequado para testar seu SceneStrategy e o Scene retornado isoladamente. Para casos de uso mais complexos, use rememberSceneState(). (I8440c, b/451679047)

Correções de bugs

  • Correção de um loop infinito ao encadear SceneStrategy com then. (Iba3f0, b/450323470)
  • Corrigimos o tremeluzir da tela ao trocar o backStack transmitido para NavDisplay e usar animações. (Ief7b5, b/450967248)

Versão 1.0.0-alpha11

8 de outubro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estes commits.

Mudanças na API

  • O método calculateScene em SceneStrategy não é mais @Composable. Em vez disso, considere mover esse trabalho para a construção do seu método SceneStrategy (ou seja, em um método rememberMySceneStrategy()) que permite definir totalmente o ciclo de vida de qualquer valor rememberSaveable ou instruções remember principais com base nos valores corretos. (If1733, b/448709506).
  • O parâmetro onBack para SceneStrategy.calculateScene foi movido para o novo escopo de receptor de SceneStrategyScope para deixar mais claro que esse é um parâmetro opcional e fornecer um ponto de extensão para futuros recursos do Navigation3. (I3aea3, b/448460407)
  • A lambda onBack transmitida para NavDisplay e para seu SceneStrategy não fornece mais um parâmetro count: Int para indicar quando várias entradas devem ser removidas. Em vez disso, a lambda () -> Unit será chamada várias vezes seguidas no raro caso em que suas solicitações de cena mostram várias entradas. (Idedb5, b/446989346)
  • Remova a classe NavEntryWrapper e substitua a funcionalidade dela por uma classe NavEntry final com um novo construtor secundário que usa um NavEntry com novo conteúdo. Isso vai permitir o suporte contínuo para encapsular uma entrada com conteúdo novo. (I7da2a, b/444447130)
  • A função navEntryDecorator, que cria e retorna um NavEntryDecorator, foi removida e substituída pela classe NavEntryDecorator, que agora é pública e aberta para criação de subclasses. (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator foi renomeado como SaveableStateHolderNavEntryDecorator porque decora entradas com um SaveableStateHolder. O decorador também foi refatorado de uma função para uma classe, já que é funcionalmente uma fábrica para NavEntryDecorator. (Ie6013, b/447381176).
  • As exibições personalizadas que usam SceneState como alternativa ao NavDisplay não precisam mais usar o local de composição LocalEntriesToRenderInCurrentScene, que agora é interno. (Ic40ef, b/414668196)
  • Remoção de SceneSetupNavEntryDecorator e rememberSceneSetupNavEntryDecorator() da plataforma da API pública. Essa funcionalidade agora é incluída por padrão sem que você precise fazer isso manualmente. (Ieae42, b/444479133)
  • NavEntry, DialogScene, SinglePaneScene e SceneState agora implementam equals. (I96121)
  • A interface de cena tem um novo campo de metadados para anexar metadados específicos da cena ao NavDisplay. Isso permite que uma cena substitua os metadados no NavDisplay, por exemplo, com transições. (I1fd96, b/443955625)
  • Simplifique a assinatura rememberNavBackStack removendo o parâmetro de tipo genérico redundante. A função agora aceita vararg elements: NavKey. (I03e45)
  • As animações padrão para NavDisplay agora fazem parte da API comum, o que permite que elas sejam chamadas de todas as plataformas. (I71af9, b/447147159).
  • Renomeie EntryProviderBuilder para EntryProviderScope para refletir com precisão que a classe é uma DSL do Kotlin que fornece um escopo para criar NavEntries. (Ia7465).

Correções de bugs

  • rememberNavBackStack() agora aplica a serialização polimórfica para NavKey e exige um SavedStateConfiguration personalizado configurado para garantir a restauração correta do estado. O KDoc foi atualizado para refletir a exigência de que todos os subtipos NavKey sejam registrados no SerializersModule fornecido. (I6de37,I782f2, b/446664383)

Versão 1.0.0-alpha10

24 de setembro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estes commits.

Mudanças na API

  • Adicione uma nova sobrecarga de NavDisplay que usa uma lista de NavEntry<T> decorada por rememberDecoratedNavEntries. (I4025b, b/441940314)
  • Movemos DialogScene para um novo pacote. (Ia5840).
  • Remoção da API pública DecorateNavEntry. Em vez disso, use rememberDecoratedNavEntries para incluir um NavEntry com uma lista de decoradores. (Id8c09).
  • A interface do Navigation3 agora oferece novas propriedades transitionSpec padrão. (Ibcabd).
  • Adicionamos um novo objeto SceneState para ajudar a gerenciar cenas. Isso também fornece uma nova sobrecarga de NavDisplay que usa SceneState e NavigationEventState. (Idfb46, b/444479133)
  • O NavDisplay agora permite personalizar as transições com base no que Scene você está indo e vindo, analisando o currentState e o targetState do Transition. (I906cc, b/443872322)
  • NavigationEventInfo agora é um abstract class em vez de um interface. Atualize todas as implementações personalizadas para herdar da classe (por exemplo, data class MyInfo : NavigationEventInfo()). (I1e59c, b/444734264)
  • As APIs de gerenciador navigationevent-compose foram atualizadas. NavigationEventHandler e NavigationBackHandler (e variantes) agora são compatíveis com uma nova sobrecarga que aceita NavigationEventStates içados. As sobrecargas simples (que usam currentInfo) são preservadas e agora usam esse novo modelo de estado internamente. (Ic3251, b/444734264)
  • Todas as APIs de cena foram movidas de navigation3-ui para navigation3-runtime. Isso significa que agora eles estão disponíveis em todas as plataformas compatíveis com navigation3-runtime. (I431d0, b/444449993)
  • Adicionada uma nova sobrecarga de rememberDecoratedNavEntries que usa uma lista de NavEntry para decorar. As entradas de entrada já podem ser decoradas com outros decoradores de entrada. (I5a034, b/444230270)
  • Remover parâmetros de tipo curinga navigation3 (I02540)
  • Melhoria no processamento de genéricos para a DSL entryProvider. Se você importava androidx.navigation3.runtime.entry antes, isso não é mais necessário. (I299fc).
  • Restrinja a sobrecarga NavBackStackSerializer baseada em reflexão ao Android. Isso evita falhas implícitas de serialização de tempo de execução em plataformas que não são Android, exigindo o uso da sobrecarga SavedStateConfiguration explícita em código multiplataforma. (I73313, b/420443609).
  • Faça do swipeEdge do NavigationEvent um @IntDef (Icee54, b/443950342)
  • Restringir a serialização de NavBackStack ao Android. Isso evita falhas de tempo de execução em plataformas que não são Android. Para salvar o estado em várias plataformas, use a sobrecarga rememberNavBackStack com um SavedStateConfiguration explícito. (I1e418, b/420443609)

Correções de bugs

  • Correção de falha durante a volta preditiva quando o NavDisplay aninhado tem uma única entrada secundária. (I2cdc0, b/441933162).

Versão 1.0.0-alpha09

10 de setembro de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estes commits.

Mudanças na API

  • O DecoratedNavEntryProvider foi substituído por rememberDecoratedNavEntries, que cria e retorna NavEntries decoradas com a lista de decoradores fornecidos (I0fe1c, b/441328236).
  • NavBackStack agora é genérico no tipo NavKey. Isso permite que apps e bibliotecas definam tipos de chaves personalizados para as pilhas de retorno, em vez de ficarem restritos a NavKey. (I4d190,Iad2f4, b/420443609)
  • O NavBackStack agora é @kotlinx.serialization.Serializable, o que permite salvar e restaurar o estado de navegação em caso de encerramento do processo e mudanças de configuração sem código extra. (I2c3cf, b/420443609).
  • RememberNavBackStack foi movido para commonMain para garantir que seja fornecido em todos os destinos de plataforma. (Id69e7, b/420443609)

Correções de bugs

  • NavDisplay agora move corretamente cada NavEntry individual para o Lifecycle.State correto. (I30aac, b/440145700)
  • Correção de um problema em que o NavDisplay ignorava qualquer NavigationEventDispatcherOwner aninhado definido pela LocalNavigationEventDispatcherOwner da biblioteca NavigationEvent. (I6224a).

Mudanças na dependência

Versão 1.0.0-alpha08

27 de agosto de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estes commits.

Novos recursos

  • Adição de novas metas do Kotlin Multiplatform (KMP) aos artefatos Navigation3 Runtime. O Navigation3 Runtime agora é compatível com as seguintes plataformas: JVM (Android e computador), nativa (Linux, iOS, watchOS, macOS, MinGW) e Web (JavaScript, WasmJS). (I55078, b/424410398, b/419294028, b/419046226). Observação: isso não fornece destinos do KMP para o artefato Navigation3 UI. Em outras plataformas, você precisa implementar seu próprio NavDisplay personalizado. Se você quiser que ele seja compatível, vote no problema do Jetbrains aqui e acompanhe o progresso para receber mais suporte.
  • O objeto NavDisplayInfo agora é público e pode ser usado para extrair a lista de entradas visíveis do NavDisplay. (Ibc91f).

Mudanças na API

  • Adicionamos um novo NavBackStackSerializer para ser usado em conjunto com rememberNavBackStack e realizar a restauração de estado. Agora, rememberNavBackStack() também usa um SavedStateConfiguration que pode ser usado para fornecer sua própria configuração. (I2f4d2, I4cd58, b/420443609)

Correções de bugs

  • Correção de um problema em que a navegação causava o disparo de eventos de ciclo de vida incorretos. (I8bf6d, b/425901162, b/434109022)

Problemas conhecidos

  • Houve um bug introduzido por I8bf6d que fez com que os ciclos de vida fossem baseados em cenas em vez de entradas individuais, o que quebrou o ciclo de vida em todos os casos em que o key fornecido ao NavEntry não é um String ou o NavEntry não substituiu o contentKey e o definiu como igual ao key. Isso foi corrigido para a próxima versão.Bundle (b/440145700)

Versão 1.0.0-alpha07

13 de agosto de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estes commits.

Atualização do MinSdk

Mudanças na API

  • SavedStateNavEntryDecorator agora usa o SaveableStateRegistry integrado ao SaveableStateProvider para salvar e restaurar estados. (If8d9a).
  • O predictivePopTransitionSpec agora recebe a borda de deslize como um parâmetro, permitindo personalizar a transição com base na borda em que o usuário iniciou o gesto de volta preditivo. (I753a8).

Correções de bugs

  • Corrigimos um problema que fazia com que as cenas personalizadas fossem recalculadas infinitamente porque a cena mais recente não era lembrada. (I7ba84, b/418153031)

Atualização de dependências

Versão 1.0.0-alpha06

30 de julho de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estes commits.

Atualização de dependências

Versão 1.0.0-alpha05

2 de julho de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estes commits.

Mudanças de comportamento

  • O estado do NavEntry agora é estritamente baseado na lista atual de decoradores transmitidos ao NavDisplay. Isso significa que os decoradores precisam ser trocados ao longo das backstacks no caso de várias backstacks para preservar o estado das NavEntries na backstack. Caso contrário, os estados serão limpos como se as entradas tivessem sido removidas (em vez de uma troca). (I7a759, b/428033667).

Versão 1.0.0-alpha04

18 de junho de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estes commits.

Mudanças na API

  • NavEntry.content agora é particular. Para invocar o conteúdo NavEntry, chame a nova API NavEntry.Content(), que não exige mais um parâmetro key para ser invocada. (Icd0fd, b/420991203).
  • NavEntry.key agora é um campo particular. O NavEntry e os estados relevantes dele precisam ser identificados pelo novo campo contentKey, que é gerado pela nova lambda contentKeyFactory e usa por padrão um hash salvável gerado pelo NavEntry.key (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812).

Mudanças na dependência

  • O Navigation3 agora depende do novo artefato androidx.navigationevent.compose.

Versão 1.0.0-alpha03

4 de junho de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estes commits.

Correções de bugs

  • Navigation3 não vai mais limpar os estados do decorador para backStacks que foram trocados e substituídos por outra instância de backStack. (I28a42, b/415076044).

Versão 1.0.0-alpha02

23 de maio de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estes commits.

Correções de bugs

  • Foi corrigido um problema com o SavedStateNavEntryDecorator que causava colisões para diferentes classes de dados com os mesmos valores de propriedade. (b/418070648, Iff4775).
  • Correção de um problema de classe ausente que causava falhas ao executar sem declarar dependências explícitas. (b/419049149, I4b4ed)

Versão 1.0.0-alpha01

20 de maio de 2025

Lançamento de androidx.navigation3:navigation3-*:1.0.0-alpha01. A versão 1.0.0-alpha01 inclui estes commits.

Novos recursos

O Navigation3 é uma nova biblioteca de navegação criada especificamente para processar a navegação no app do Jetpack Compose. O artefato androidx.navigation3.runtime fornece os blocos de construção, enquanto o artefato androidx.navigation3.ui fornece a camada de interface usando a API NavDisplay. Os desenvolvedores podem fornecer o próprio estado diretamente à função combinável NavDisplay, que muda o conteúdo com base nas mudanças no estado do desenvolvedor.

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

Para mais informações, consulte o guia do Navigation3.