navigation3

  
A 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
4 de novembro de 2026 1.2.1 - - 1.3.0-alpha04

Declarar dependências

Para adicionar uma dependência à 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-alpha04"
    implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04"
}

Kotlin

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

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

4 de novembro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.3.0-alpha04. A versão 1.3.0-alpha04 contém estas confirmações.

Correções de bugs

  • Correção de um problema em que o NavEntry compartilhado não era renderizado na tela quando era removido e depois enviado novamente antes da conclusão da remoção. (I6a482).

Versão 1.3.0-alpha03

21 de outubro de 2026

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

Nenhuma mudança desde a versão 1.3.0-alpha02

Versão 1.3.0-alpha02

7 de outubro de 2026

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

Mudanças na API

  • A classe SceneInfo adicionou as propriedades title e url, que são preenchidas automaticamente com os últimos metadados NavEntry's da cena. Use TitleMetadataKey e UrlMetadataKey para definir títulos e URLs de destino nos metadados da entrada. (I78a20, b/542693522).

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 ao migrar para DeferredAnimatedContent e resolver problemas de transferência de transição. I145eaedd b/430807423
    • O DeferredAnimatedContent usa DeferredTransition para separar as transições em uma fase adiada (com defer), que aplica transformações manuais durante um gesto de deslizar, e uma fase automática (com animateTo), que executa a transição quando o gesto é confirmado.

Problemas conhecidos

  • Os elementos compartilhados são renderizados na cena de saída durante as transições, em vez da cena de entrada. (b/582354988).
  • Os elementos compartilhados não buscam durante a fase adiada (gesto).

Versão 1.2.1

4 de novembro de 2026

Lançamento de androidx.navigation3:navigation3-*:1.2.1. A versão 1.2.1 contém estas confirmações.

Alterações

  • O compileSdk foi rebaixado de 37 para 36. A versão 1.2 depende do Compose 1.10, que não exige o compileSdk 37.

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

A versão 1.2.0 agora é 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.
  • Adicionamos rememberResultEventBus para oferecer suporte à elevação de um ResultEventBus fora de ResultEventBusNavEntryDecorator e transmiti-lo para rememberResultEventBusNavEntryDecorator.
  • Os resultados transmitidos podem ser acessados como estado com ResultEventBus#conflateAsState ou coletados como um fluxo de resultados com ResultEffect.

API de link direto

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

  • DeepLinkRequest e RequestExtras: representam um pedido de vinculação de link direto criado com base em um DeepLinkUri, uma string de URI ou um Intent do Android. É possível anexar outros metadados de solicitação 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 associado a um DeepLinkRequest. Cada instância de correspondência é associada à chave de navegação que oferece suporte a esse link direto. Uma chave de navegação pode ser associada a vários correspondentes. 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 corresponder links diretos com base em Uri e StaticKeyDeepLinkMatcher para corresponder links diretos com apenas DeepLinkMatcher.Filter que correspondem por um booleano.
  • BackStackMatcher: um DeepLinkMatcher para criar uma backstack sintética após uma correspondência de link direto bem-sucedida. BackStackMatcher pode ser criado usando a função de extensão DeepLinkMatcher.withBackStack.

Tratamento de volta preditiva

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

Outras mudanças

  • NavEntry.contentKey agora usa como padrão uma composição de key.toString() e key::class.toString(), evitando colisões entre chaves data object que compartilham o mesmo nome simples em diferentes interfaces.
  • O EntryProvider agora prioriza a correspondência com base em instâncias de chave em vez de tipos de chave.
  • Adicionamos 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 estas confirmações.

Correções de bugs

  • Não permitir nomes de marcadores de posiçã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 semelhante a um mapa com segurança de tipos RequestExtras 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 volta preditivos acionados durante uma transição para frente não eram animados em resposta ao progresso do deslize. Agora, o gesto de voltar preditivo será animado e concluído corretamente. (Icdcb0, b/456218398).
  • Adicionamos 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).
  • NavEntry.contentKey agora usa como padrão uma combinação de key.toString() e key::class.toString(). Isso garante que os 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 de classe simples, em vez do nome totalmente qualificado. Portanto, a plataforma JS ainda precisa implementar um contentKey personalizado para objetos de dados com nomes duplicados. (I1fbbb, b/512534342).
  • Correção de IllegalArgumentException gerada por SaveableStateProvider para chaves duplicadas usadas durante a navegação de retorno rápida quando várias transições pop 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

  • Adicionamos uma classe abstrata WrappedMatchResult para unir outra DeepLinkMatcher.MatchResult. Isso permite que os resultados de correspondência personalizados sejam sobrepostos. (I7d4dc, b/470282247)
  • Adicionamos a nova classe BackStackMatcher, que usa dois parâmetros: uma instância de correspondência e uma lambda do builder que fornece o resultado da correspondência de entrada e retorna uma backstack. Após uma correspondência bem-sucedida, BackStackMatcher retorna um BackStackMatchResult que estende WrappedMatchResult, contendo o resultado original da correspondência com a backstack criada com o lambda. O BackStackMatcher só pode ser criado com a nova função de extensão DeepLinkMatcher.withBackStack. (Ibf987, b/470282247).

  • Adicionamos 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 da subclasse MatchResult retornada por DeepLinkMatcher.match() sem conversão de tipo. (I693d3, b/470282247).

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

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

Correções de bugs

  • O ResultEffect agora usa rememberUpdatedState para capturar o 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 vazio. Caso contrário, o caminho vazio será tratado como nenhum valor fornecido e voltará ao valor padrão. Se não houver um valor padrão, a correspondência vai falhar. (I56575, b/535298128).
  • Adicionamos 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 se nenhum valor tivesse sido fornecido, e a correspondência tentará usar o valor padrão. Se não houver um valor padrão, a correspondência vai falhar. (I30343, b/535127459).
  • O EntryProvider agora prioriza a correspondência com base em instâncias de chave em vez de tipos de chave. (Ib5ec9, b/533331924).
  • O SceneState agora calcula corretamente as cenas anteriores, começando pela cena que não é de sobreposição mais alta. (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 de 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 de falha de correspondência de UriDeepLinkMatcher com uma solicitação se o padrão de URI não contiver um esquema ou não começar com 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 para fora do ResultEventBusNavEntryDecorator. (Ia655b, b/516995400).

DeepLinkRequest

  • Adicionamos dois construtores compatíveis com KMP: um que usa um DeepLinkUri e outro que usa um URI de string bruta. (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 extra para que um Map<String, Any> anexe mais informações de solicitação. (If81d5, b/513200887).
  • Uma nova DSL requestExtras foi adicionada como uma forma de segurança de tipos para 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 para Android) A função de fábrica fromIntent foi removida. 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 quando usadas com Matchers. (I1e453, b/525094876)
  • O parâmetro do construtor UriMatchResult para o mapa de argumentos agora usa um mapa vazio como padrão. (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 de um problema em que a entrada removida desaparecia imediatamente ao ser removida para uma entrada com metadados aninhados que contêm valores lambda. (Idb872, b/520494430).
  • Correção de UriDeepLinkMatcher para que ele retorne um UriMatchResult nulo em vez de gerar MissingFieldException quando argumentos obrigatórios estiverem ausentes durante a correspondência. (I5322f, b/524663005).
  • Um UriDeeplinkMatcher que contém um URI com o esquema https só pode ser correspondido com solicitações que também tenham o esquema https. (Ibfe22, b/522304329).
  • Correção de UriDeepLinkMatcher para identificar corretamente o esquema http como uma correspondência positiva com https ao associar 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).
  • UriDeepLinkMatcher agora vai retornar um UriMatchResult nulo em vez de gerar uma exceção quando a solicitação atendida 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 delas 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 uma ação opcional (somente Android). Além da 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 assistente 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 associado a um DeepLinkRequest. Cada instância de correspondência é associada à chave de navegação que oferece suporte a esse link direto. Uma chave de navegação pode ser associada a vários correspondentes. 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 corresponder links diretos com base em Uri e StaticKeyDeepLinkMatcher para corresponder 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 ao associar DeepLinkUri a uma chave de navegação serializável. Ele é compatível com argumentos de link direto de tipos primitivos ou coleções 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

  • Atualizado para compileSdk 37 para corresponder ao compileSdk do Compose.

Correções de bugs

  • Correção do IllegalArgumentException do AnimatedBottomSheetSample ao exibir várias sobreposições. A amostra SceneStrategy agora vai calcular corretamente o último valor não OverlayScene e mostrá-lo em todas as cenas de sobreposição. (If2281, b/506733412).
  • A dependência NavigationEvent foi atualizada para a versão 1.1.1, 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

  • Renomeamos onBack como onBackCompleted e adicionamos onBackCancelled ao NavigationBackHandler para oferecer suporte ao processamento de gestos de voltar cancelados. (I92741).
  • Adição de NavigationBackHandler para simplificar o processamento de gestos de voltar e de volta preditivo 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 aos gestos preditivos sem calcular manualmente os deltas da backstack. (I6a055).
  • Adicione 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 estas confirmações.

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 volta preditivos acionados durante uma transição para frente não eram animados em resposta ao progresso do deslize. Agora, o gesto de voltar preditivo 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

  • NavEntry.contentKey agora usa como padrão uma combinação de key.toString() e key::class.toString(). Isso garante que os 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 de classe simples, em vez do nome totalmente qualificado. Portanto, a plataforma JS ainda precisa implementar um contentKey personalizado para objetos de dados com nomes duplicados. (I1fbbb, b/512534342).
  • Correção de IllegalArgumentException gerada por SaveableStateHolder para reutilização de chaves quando várias transições de pop 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 estas confirmações.

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 um problema em que a entrada removida desaparecia imediatamente ao ser removida para uma entrada com metadados aninhados que contêm 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 delas eram removidas. (Ia2b9e, b/502624496).

  • A dependência NavigationEvent foi atualizada para a versão 1.1.2, que removeu a operação no-op NavigationEventHandler no modo de inspeção para ativar o recurso de 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 estas confirmações.

Correções de bugs

  • A dependência NavigationEvent foi atualizada para a versão 1.1.1, que removeu a operação no-op NavigationEventHandler no modo de inspeção para ativar o gesto de voltar preditivo 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 estas confirmações.

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ável.

Mudanças importantes desde a versão 1.0.0

Elementos compartilhados entre cenas: o Navigation3 agora permite tratar cenas como objetos de elementos compartilhados. Isso significa que, quando as cenas mudam, é possível garantir uma transição suave. Para ativar esse recurso, 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 de interface ou compartilhar o estado entre cenas.

DSL NavMetadata: a 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 um novo NavMetadataKeys para transições de NavDisplay, para que possam 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 backstack, 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 parâmetro SceneStrategy único anterior que era encadeado pelo infixo then. - Agora é possível adicionar metadados dinamicamente 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 estas confirmações.

Correções de bugs

  • NavDisplay agora garante que as entradas mostradas 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 em NavDisplay em que navegar entre as mesmas telas e interromper as animações entre elas poderia 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 parâmetro SceneStrategy único anterior que foi encadeado pelo infixo then. Isso se alinha melhor com o List<SceneDecoratorStrategy<T>> que as duas 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 fornecido. (Ic30db, b/485311895)
  • Adição de 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

  • A 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 de NavDisplay, para que possam ser usados com a nova DSL de metadata para 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 backstack, 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 uma nova 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

  • Correção de um erro em que transmitir um SharedTransitionLayout para NavDisplay ou rememberSceneState e usar qualquer OverlayScene causava uma falha, porque o uso de SharedTransitionLayout só funciona com NavEntries renderizados como parte do AnimatedContent, e os OverlayScene são renderizados nas próprias janelas separadamente. (I1bb76, b/478664101).

Atualização de dependências

  • Do Navigation3 1.0.1: o Navigation3 agora depende do NavigationEvent 1.0.2. Isso corrige um IllegalStateException causado pelo uso de NavDisplay durante as prévias do 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 é possível adicionar metadados dinamicamente 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 SceneStrategys podem ser personalizados para fornecer mais funcionalidades a outras cenas. (I5df7c,b/440333896)

Versão 1.1.0-alpha01

3 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 permite tratar cenas como objetos de elementos compartilhados. Isso significa que, quando as cenas mudam, é possível garantir uma transição suave. Para ativar esse recurso, 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 estas confirmações.

Atualização de dependências

  • Navigation3 agora depende de NavigationEvent 1.0.2. Isso corrige um IllegalStateException causado 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 a Navigation3

  • A biblioteca Navigation3 agora está estável. A Navigation3 é a primeira abordagem do AndroidX Compose para navegação.
  • Para mais informações, consulte nosso post de anúncio, acesse os recursos e teste 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

  • A NavDisplay agora define um LocalLifecycleOwner no nível da Scene que permite que os autores de cenas determinem se todas as transições foram concluídas verificando se o Lifecycle.State é RESUMED. O comportamento do LocalLifecycleOwner no nível NavEntry não muda: ele também permanece limitado a STARTED se uma transição estiver em andamento e também a CREATED se esse NavEntry tiver sido removido da backstack e estiver no processo de animação de saída. (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 estas confirmações.

Mudanças na API

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

Correções de bugs

  • Correção do loop infinito ao encadear SceneStrategy com then. (Iba3f0, b/450323470).
  • Correção da oscilação 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 método SceneStrategy (ou seja, em um método rememberMySceneStrategy()) que permite definir totalmente o ciclo de vida de qualquer valor rememberSaveable ou instrução de chave remember com base nos valores corretos. (If1733, b/448709506).
  • O parâmetro onBack para SceneStrategy.calculateScene foi movido para o novo escopo do 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 o SceneStrategy não fornece mais um parâmetro count: Int para indicar quando várias entradas precisam ser removidas. Em vez disso, o lambda () -> Unit agora será chamado várias vezes seguidas no caso raro em que a cena solicitar a remoção de 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 que o suporte para encapsular uma entrada com novo conteúdo continue. (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 subclasses. (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator foi renomeado como SaveableStateHolderNavEntryDecorator, já que ele 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 telas 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 para o NavDisplay. Isso permite que uma cena substitua os metadados no NavDisplay, por exemplo, com transições. (I1fd96, b/443955625)
  • Simplifique a assinatura de 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 sejam chamadas em todas as plataformas. (I71af9, b/447147159).
  • Renomeação de 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

  • O 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 o requisito de que todos os subtipos de NavKey precisam ser 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 estas confirmações.

Mudanças na API

  • Adicionamos uma nova sobrecarga de NavDisplay que usa uma lista de NavEntry<T> decorada por rememberDecoratedNavEntries. (I4025b, b/441940314)
  • DialogScene foi movido para um novo pacote. (Ia5840).
  • Remoção da API pública DecorateNavEntry. Em vez disso, use rememberDecoratedNavEntries para unir uma NavEntry com uma lista de decoradores. (Id8c09).
  • A interface do Navigation3 agora oferece novas propriedades padrão de transitionSpec. (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).
  • Agora, o NavDisplay permite personalizar as transições com base no Scene de origem e de destino, 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 do gerenciador navigationevent-compose foram atualizadas. NavigationEventHandler e NavigationBackHandler (e variantes) agora oferecem suporte a uma nova sobrecarga que aceita NavigationEventStates elevados. As sobrecargas simples (que usam currentInfo) são preservadas e agora usam esse novo modelo de estado internamente. (Ic3251, b/444734264).
  • Todas as APIs Scene foram movidas de navigation3-ui para navigation3-runtime. Isso significa que eles já estão disponíveis em todas as plataformas compatíveis com navigation3-runtime. (I431d0, b/444449993)
  • Adicionamos 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).
  • Remoção dos parâmetros de tipo de caractere curinga do navigation3 (I02540).
  • Melhoria no processamento de genéricos para a DSL entryProvider. Se você já importava androidx.navigation3.runtime.entry, isso não é mais necessário. (I299fc).
  • Restrinja a sobrecarga de NavBackStackSerializer baseada em reflexão ao Android. Isso evita falhas de serialização de ambiente de execução implícitas em plataformas que não são Android, aplicando o uso da sobrecarga explícita de SavedStateConfiguration no código multiplataforma. (I73313, b/420443609).
  • Tornar o swipeEdge de NavigationEvent um @IntDef (Icee54, b/443950342)
  • Restringir a serialização de NavBackStack ao Android. Isso evita falhas 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 uma falha durante a volta preditiva quando o NavDisplay aninhado tem uma única entrada filha. (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 chave personalizados para as backstacks, em vez de ficarem restritos a NavKey. (I4d190,Iad2f4, b/420443609)
  • NavBackStack agora é @kotlinx.serialization.Serializable, o que possibilita salvar e restaurar o estado de navegação em encerramentos de processos e mudanças de configuração sem código boilerplate extra. (I2c3cf, b/420443609).
  • RememberNavBackStack foi movido para commonMain para garantir que seja fornecido em todos os destinos da plataforma. (Id69e7, b/420443609).

Correções de bugs

  • O NavDisplay agora move corretamente cada NavEntry individual para o Lifecycle.State correto. (I30aac, b/440145700).
  • Correção de um problema em que NavDisplay ignorava qualquer NavigationEventDispatcherOwner aninhado definido pelo 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

  • Novos destinos do Kotlin Multiplatform (KMP) foram adicionados aos artefatos Navigation3 Runtime. Navigation3 Runtime agora oferece suporte às 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 de KMP para o artefato Navigation3 UI. Em outras plataformas, você precisará 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 recuperar a lista de entradas visíveis do NavDisplay. (Ibc91f).

Mudanças na API

  • Adição de um novo NavBackStackSerializer para ser usado em conjunto com rememberNavBackStack para realizar a restauração de estado. rememberNavBackStack() agora 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 acionamento de eventos de ciclo de vida incorretos. (I8bf6d, b/425901162, b/434109022).

Problemas conhecidos

  • Havia um bug introduzido por I8bf6d que fazia com que os ciclos de vida fossem baseados em cenas em vez de entradas individuais, o que interrompia o ciclo de vida em todos os casos em que o key fornecido ao NavEntry não era um String ou o NavEntry não substituía o contentKey e o definia como igual ao key. Isso garante que a chave possa ser salva em um Bundle. Isso foi corrigido para a próxima versão. (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

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

Correções de bugs

  • Correção de 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 para o NavDisplay. Isso significa que os decoradores precisam ser trocados nas 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 de 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 precisam ser identificados pelo novo campo contentKey, que é gerado pela nova lambda contentKeyFactory e usa como padrão um hash salvável gerado de 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

  • O 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

  • Correção de 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

A 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 elementos básicos, enquanto o artefato androidx.navigation3.ui fornece a camada de interface pela API NavDisplay. Os desenvolvedores podem fornecer o próprio estado diretamente para a 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.