Navegação
Atualização mais recente | Versão estável | Versão candidata a lançamento | Versão Beta | Versão Alfa |
---|---|---|---|---|
7 de agosto de 2024 | 2.7,7 | - | 2.8.0-beta07 (link em inglês) | - |
Declarar dependências
Para adicionar uma dependência à Navigation, é preciso adicionar 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 no arquivo build.gradle
para
seu app ou módulo:
Groovy
dependencies { def nav_version = "2.7.7" // Jetpack Compose Integration implementation "androidx.navigation:navigation-compose:$nav_version" // Views/Fragments Integration implementation "androidx.navigation:navigation-fragment:$nav_version" implementation "androidx.navigation:navigation-ui:$nav_version" // Feature module Support for Fragments implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version" // Testing Navigation androidTestImplementation "androidx.navigation:navigation-testing:$nav_version" }
Kotlin
dependencies { val nav_version = "2.7.7" // Java language implementation implementation("androidx.navigation:navigation-fragment:$nav_version") implementation("androidx.navigation:navigation-ui:$nav_version") // Kotlin implementation("androidx.navigation:navigation-fragment-ktx:$nav_version") implementation("androidx.navigation:navigation-ui-ktx:$nav_version") // Feature module Support implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version") // Testing Navigation androidTestImplementation("androidx.navigation:navigation-testing:$nav_version") // Jetpack Compose Integration implementation("androidx.navigation:navigation-compose:$nav_version") }
Safe Args
Para adicionar Safe Args
ao seu projeto, inclua o seguinte classpath
no seu arquivo build.gradle
de nível superior:
Groovy
buildscript { repositories { google() } dependencies { def nav_version = "2.7.7" classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version" } }
Kotlin
buildscript { repositories { google() } dependencies { val nav_version = "2.7.7" classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version") } }
Você também precisa aplicar um dos dois plug-ins disponíveis.
Para gerar um código de linguagem Java adequado para módulos Java ou Java e Kotlin mistos, adicione
esta linha ao arquivo build.gradle
do seu app ou módulo:
Groovy
plugins { id 'androidx.navigation.safeargs' }
Kotlin
plugins { id("androidx.navigation.safeargs") }
Como alternativa, para gerar o código Kotlin adequado para módulos somente Kotlin, adicione:
Groovy
plugins { id 'androidx.navigation.safeargs.kotlin' }
Kotlin
plugins { id("androidx.navigation.safeargs.kotlin") }
Você precisa ter android.useAndroidX=true
no
arquivo gradle.properties
, como mostrado em
Migrar para o AndroidX.
Para ver mais informações sobre o uso de extensões Kotlin, consulte a documentação do Android KTX.
Para ver 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.
Consulte a documentação do Issue Tracker para saber mais.
Versão 2.8
Versão 2.8.0-beta07
7 de agosto de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta07
. A versão 2.8.0-beta07 contém estas confirmações.
Problemas conhecidos
- Devido a b/358137294, apenas tipos enumerados aninhados em outra classe têm suporte imediato. Enums de nível superior terão suporte na próxima versão.
Correções de bugs
- Ao navegar para destinos duplicados ou compartilhados, a navegação vai priorizar o direcionamento ao destino correspondente mais próximo da localização atual no gráfico. (Ic89a4, b/352006850).
- A navegação em Safe Args agora adicionou um novo
NavType.EnumType
. Isso significa que os tipos deEnum
não exigem maisNavType
s personalizados. OSerialName
deEnum
precisa ser o nome totalmente qualificado padrão. (I66d22, b/346475493). - A navegação em Safe Args adicionou suporte integrado para tipos de argumento anuláveis,incluindo
Int?
,Long?
,Float?
,Boolean?
eEnum<*>?
. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237). - O
startDestination
doNavGraph
agora vai usar os valores de argumento padrão se a rotastartDestination
transmitida para oNavGraph
for exatamente igual aostartDestination.route
. (I13762, b/354046047).
Versão 2.8.0-beta06
24 de julho de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta06
. A versão 2.8.0-beta06 contém estas confirmações.
Correções de bugs
- Correção de um problema em que as verificações de lint
WrongStartDestinationType
não procuravam objetos Companion no tipo de classe transmitido, fazendo com que o lint não detectasse o erro. (I92b09).
Versão 2.8.0-beta05
10 de julho de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta05
. A versão 2.8.0-beta05 contém estas confirmações.
Correções de bugs
- Correção da falha de navegação da
singleTop
quandoNavGraphs
aninhados compartilham a mesma rotastartDestination
(I17b94, b/294408596).
Versão 2.8.0-beta04
26 de junho de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta04
. A versão 2.8.0-beta04 contém estas confirmações.
Correções de bugs
- O Navigation agora oferece suporte à navegação com strings vazias em argumentos de caminho. (Ic5dbd, b/339481310).
- Melhoria na mensagem de erro para serializadores personalizados declarados diretamente nos campos de classe via
@Serializable(with =...)
para esclarecer que esse recurso não é compatível no momento. (I052b0, b/341319151). - A API de teste
SavedStateHandleFactory
agora pode ser usada em testes que não sejam do Android, mas vai exigir que o Robolectric seja compatível com a análise de argumentos com Bundles (I76cdc, b/340966212). - Correção da falha ao restaurar o estado ao retomar o app após o encerramento do processo com o uso da navegação com segurança de tipos no Compose. (Ia8f38, b/341801005).
- Correção de um problema no Navigation Compose em que, após cancelar o gesto de volta preditivo, a
NavBackStackEntry
para que o usuário retorna nunca retorna ao estado do ciclo de vidaRESUMED
Isso também garante que o destino retornado seja animado corretamente de volta em vez de se ajustar ao lugar após uma rolagem rápida. (I97a0c, b/346608857). - Ao usar a volta preditiva com o Navigation Compose, o destino que está sendo mostrado terá a ordem z adequada, animado corretamente sobre o destino de entrada. (I2077b, b/345993681).
Versão 2.8.0-beta03
12 de junho de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta03
. A versão 2.8.0-beta03 contém estas confirmações.
Mudanças na API
CollectionNavType
tem um novo método abstratoemptyCollection()
. Modifique-o para processar uma coleção vazia transmitida como um argumento. (Ie4d84, b/341723133).
Correções de bugs
- Adicionamos documentação sobre
NavType.serializeAsValue
eserializeAsValues
para destacar que as saídas finais precisam ser codificadas pelo URI. (Ida6bd, b/344943214). - Foi corrigida uma falha ao chamar
toRoute<T>
com um argumentoCollectionNavType
nulo Ao navegar com umCollectionNavType
nulo, o argumento de saída será o valor padrão declarado na classe serializável ou o valor de retorno deemptyCollection()
se não houver um valor padrão. (I84158, Id630f, b/342672856).
Versão 2.8.0-beta02
29 de maio de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta02
. A versão 2.8.0-beta02 contém estas confirmações.
Correções de bugs
- Correção da falha de
ClassCastException
ao usarNavBackStackEntry.toRoute
com umNavType
personalizado anulável (I1c29b, b/342239473). - Correção de problemas de restauração do estado da backstack do Navigation causados ao tentar restaurar uma entrada da backstack que não era acessível pelo ID do destino atual Como as rotas têm o suporte de IDs, os destinos criados com rotas também foram afetados. Isso também corrige uma falha causada ao chamar
clearBackStack()
que tinha o mesmo problema. (I423c3, b/339908057).
Versão 2.8.0-beta01
14 de maio de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-beta01
. A versão 2.8.0-beta01 contém estas confirmações.
Mudanças na API
SavedStateHandle.toRoute()
agora usa um parâmetrotypeMap
para tipos de argumentos personalizados. (Ie39fb, b/339026523).- Adicionamos uma API de teste a
navigation-testing
para criar umSavedStateHandle
com base em um objeto Serializável do Kotlin. (Id4867, b/339080702).
Correções de bugs
- Os documentos de parâmetros ausentes para as funções DSL do Kotlin de navegação foram adicionados. (I26a36).
Versão 2.8.0-alpha08
1o de maio de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha08
. A versão 2.8.0-alpha08 contém estas confirmações.
Safe Args no Navigation Compose
- O trabalho para oferecer suporte à segurança de tipo no tempo de compilação para o Navigation Compose e os usuários da DSL do Kotlin de Navigation com base na serialização do Kotlin foi concluído, e as APIs anteriormente experimentais agora estão estáveis. {1-2.Iea94d, Iea94d, Iea94d, Iea94d, I0eb0d, I873b7, I3a64b., I6c3a2, I6c3a2, I111f0b, I111f0b, I111f0b, I111f0b, I111f0b, Ic3032, Ic3032 a I873b7, I3a64b, I6c3a2, I6c3a2, I111f0b.
Essa funcionalidade usa a Serialização do Kotlin para permitir que você defina destinos no gráfico de navegação usando classes de dados e objetos com segurança de tipo:
// Define a home destination that doesn't take any arguments
@Serializable
object Home
// Define a profile destination that takes an ID
@Serializable
data class Profile(val id: String)
// Now define your NavHost using type safe objects
NavHost(navController, startDestination = Home) {
composable<Home> {
HomeScreen(onNavigateToProfile = { id ->
navController.navigate(Profile(id))
})
}
composable<Profile> { backStackEntry ->
val profile: Profile = backStackEntry.toRoute()
ProfileScreen(profile)
}
}
Confira mais informações na postagem do blog Navigation Compose e Type Safety (em inglês).
Novos recursos
- O artefato
navigation-fragment-compose
agora fornece uma composição deLocalFragment
local para métodos combináveis em umaComposableFragment
(If35e5). NavType
agora tem suporte integrado para listas de int, string, booleanos, flutuantes e longos. (I4b6dd, Ia914c, b/188693139).
Versão 2.8.0-alpha07
17 de abril de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha07
. A versão 2.8.0-alpha07 contém estas confirmações.
Novos recursos
Adiciona um novo artefato
navigation-fragment-compose
que inclui uma alternativaComposableNavHostFragment
paraNavHostFragment
que permite adicionar destinoscomposable
aos seus arquivos XML de navegação. Cada destinocomposable
precisa ser expresso como um nível superior, sem método@Composable
de argumento que tenha um nome totalmente qualificado usado como o atributoandroid:name
em cada destino. Ao navegar para um desses destinos, um fragmento contêiner é criado para mostrar o conteúdo combinável. (I0ef2e, b/265480755).// In HomeScreen.kt @Composable fun HomeScreen() { // Your Composable content here }
// In your navigation.xml <composable android:id="@+id/home_screen" android:name="com.example.HomeScreenKt\$HomeScreen" />
Mudanças na API
- Suporte a Safe Args no Navigation Compose usando uma abordagem baseada na serialização do Kotlin (continuação) Essas APIs não estão concluídas e estão marcadas com a anotação
ExperimentalSafeArgsApi
. Essa anotação será removida quando toda a superfície da API for concluída em uma versão futura. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db20}I,36/16I554db25
Versão 2.8.0-alpha06
3 de abril de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha06
. A versão 2.8.0-alpha06 contém estas confirmações.
Mudanças na API
- O suporte ao Safe Args no Navigation Compose usando uma abordagem baseada na serialização do Kotlin já foi iniciado. Essas APIs não estão concluídas e estão marcadas com a anotação
ExperimentalSafeArgsApi
. Essa anotação será removida quando toda a superfície da API for concluída em uma versão futura. {1..........................., I43a51, I8366a1, I836a1, I836a1, Ic5eec, Ic5eec a Ic5eec, I39407 a I39407 a I2a1c5, I43a51, I8366a1, I836a1, Ic5.
Correções de bugs
NavHost
agora usouAlignment.TopStart
como o argumento contentAlignment padrão Isso alinha o mapa com o padrão deAnimatedContent
e corrige algumas instâncias de uma escala inesperada da transição central. (I09e72, b/330111602).- Ao virar o gesto de volta preditivo ao usar o Navigation Compose, o
NavHost
agora completará corretamente a transição personalizada, em vez de terminar imediatamente (I99017, b/327292110).
Versão 2.8.0-alpha05
20 de março de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha05
. A versão 2.8.0-alpha05 contém estas confirmações.
Novos recursos
- Agora você pode transmitir argumentos para o
startDestination
doNavGraph
diretamente na rotastartDestination
sem depender dedefaultValue
. Isso também se aplica aNavGraph
startDestinations
aninhadas. (I0e0b5, b/109505019, b/188693139).
Mudanças na API
- Foi adicionada a nova classe
CollectionNavType<T>
abstrata, uma subclasse deNavType<T>
para argumentos baseados em coleção, como listas, matrizes e mapas. (Ic6d63, b/188693139). - Todas as matrizes
NavType
padrão (IntArrayType
,LongArrayType
,FloatArrayType
,BoolArrayType
eStringArrayType
) agora são do tipoCollectionNavType
(Idcf79, b/188693139). NavType
agora fornece uma nova APIvalueEquals
aberta que determina se dois valores do mesmo tipo são iguais. (I6cb97, b/327229511).
Correções de bugs
- Os parâmetros de consulta em links diretos agora permitem valores na forma de chaves em torno do nome do argumento (por exemplo,
{argName}
) como valores válidos paraNavTypes
baseado em string. Isso corrige um problema em que esse valor era considerado inválido (ou ausência de valor) para todos os tipos. (I18302, b/327274038). - As funções
NavController
que oferecem suporte a rotas comonavigate
oupopBackStack
agora podem corresponder corretamente a rotas preenchidas com argumentos da matrizNavTypes
. (Iea805, b/327229511).
Versão 2.8.0-alpha04
6 de março de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha04
. A versão 2.8.0-alpha04 contém estas confirmações.
Novos recursos
- Agora você pode especificar as
SizeTranform
para suas transições no Navigation Compose, definindo-as como parte da inicialização das funçõescomposable
e/ounavigation
. (I91062, b/296912651).
Correções de bugs
- Correção de um problema em que o
NavHost
na navegação do Compose não mostrava corretamente a transição ao usar o recurso "Voltar do sistema" sem um gesto. (Iceeae, b/325998468).
Versão 2.8.0-alpha03
21 de fevereiro de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha03
. A versão 2.8.0-alpha03 contém estas confirmações.
Mudanças na API
NavBackStackEntry.savedStateHandle
agora está marcado como@MainThread
, porque usa o código que precisa estar na linha de execução principal. (Ibb988, b/299523245).
Correções de bugs
- Correção de um problema na navegação que fazia com que os ViewModels
NavGraph
fossemDESTROYED
muito cedo, porque oViewModel
da entrada associada não fazia parte do estado salvo (Ib6bb7, b/317581849).
Atualização de dependências
- O Navigation Compose agora depende do Compose 1.7.0-alpha03.
Versão 2.8.0-alpha02
7 de fevereiro de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha02
. A versão 2.8.0-alpha02 contém estas confirmações.
Novos recursos
- O Navigation Compose agora oferece suporte à volta preditiva no app usando as novas APIs
SeekableTransitionState
do compose-Animation. Isso permite que você use o gesto "Voltar" para ver o destino anterior com sua transição personalizada antes de decidir confirmar a transação por meio do gesto concluído ou cancelar. (I8b8e9).
Versão 2.8.0-alpha01
24 de janeiro de 2024
Lançamento de androidx.navigation:navigation-*:2.8.0-alpha01
. A versão 2.8.0-alpha01 contém estas confirmações.
Correções de bugs
- Correção do vazamento de
BackStackState
em que várias chamadassaveState
em um destino resultariam em vários estados a serem salvos, mas apenas a primeira poderia ser restaurada (I598b0, b/309559751). - Correção de um problema em que argumentos não String não eram exibidos corretamente ao usar os auxiliares
NavigationUI
para preencher o título das barras de apps. (#636, b/316676794).
Atualização de dependências
- O Navigation Compose agora depende do Compose
1.7.0-alpha01
para corrigir um problema que poderia causar uma animação de escala inesperada (b/297258205).
Contribuição externa
- Agradecemos a SimonMarquis (link em inglês) por corrigir o problema de exibição de argumentos não string ao usar os auxiliares
NavigationUI
para preencher o título das barras de apps.
Versão 2.7.7
Versão 2.7.7
7 de fevereiro de 2024
Lançamento de androidx.navigation:navigation-*:2.7.7
. A versão 2.7.7 contém estas confirmações.
Correções de bugs
- Backport do Navigation
2.8.0-alpha01
: correção do vazamento deBackStackState
em que várias chamadassaveState()
em uma únicaNavBackStackEntry
resultariam em vários estados salvos, mas apenas o primeiro estado salvo podia ser restaurado (I598b0, b/309559751). - Backport do Navigation
2.8.0-alpha01
: foi corrigido um problema em que argumentos não String não eram exibidos corretamente ao usar os auxiliaresNavigationUI
para preencher o título das barras de apps. (#636, b/316676794).
Contribuição externa
- Agradecemos a SimonMarquis (link em inglês) por corrigir o problema de exibição de argumentos não string ao usar os auxiliares
NavigationUI
para preencher o título das barras de apps.
Versão 2.7.6
Versão 2.7.6
13 de dezembro de 2023
Lançamento de androidx.navigation:navigation-*:2.7.6
. A versão 2.7.6 contém estas confirmações.
Correções de bugs
- A função
equals()
NavGraph
agora considera corretamente os nós do outro gráfico em vez de apenas o de chamada. Isso garante que os gráficos que têm nós com IDs diferentes não sejam mais considerados iguais (I401cb, b/311414915).
Versão 2.7.5
Versão 2.7.5
1º de novembro de 2023
Lançamento de androidx.navigation:navigation-*:2.7.5
. A versão 2.7.5 contém estas confirmações.
Melhorias no desempenho
- A comparação entre dois gráficos melhorou significativamente o desempenho (em termos de tempo e número de alocações). Isso significa que chamadas como
setGraph
, que comparam internamente o novo gráfico ao atual, são muito mais rápidas e resultam em menos frames ignorados. Agradecemos a Michal Z (link em inglês) pela análise detalhada que levou a essa melhoria. (I6ad62). NavHost
agora vai renderizar o destino inicial no primeiro cartão de composição, em vez de esperar que o segundo passe para ler o estado atualizado. (I439a7, b/304852206).
Correções de bugs
- Foi corrigido um problema em que a backstack era exibida se você chamasse
setGraph
mais de uma vez com exatamente o mesmo gráfico apenas se houvesse um destino no seu gráfico com uma ação que vinculasse dois destinos. (Ieaed7). - As caixas de diálogo acessadas e dispensadas em rápida sucessão não vão mais vazar para a lista de
NavController.visibleEntries
. (I67586, b/287969970). - Quando uma entrada for exibida seguida por uma mudança de configuração, o
ViewModel
da entrada será apagado corretamente sesaveState
for falso. (Idf242, b/298164648). - Foi corrigido um problema em que
NavController
podia processar o mesmo link direto mais de uma vez se a backstack estivesse totalmente vazia antes de uma mudança de configuração ou chamada parasetGraph
somente quando a intent recebida tinha a flagFLAG_ACTIVITY_NEW_TASK
definida (I73c7f).
Atualizações de dependência
- A navegação com fragmentos agora depende do Fragment 1.6.2, corrigindo um problema em que as instâncias
ViewModel
de fragmentos aninhados não eram limpas ao chamarclearBackStack
Versão 2.7.4
Versão 2.7.4
4 de outubro de 2023
Lançamento de androidx.navigation:navigation-*:2.7.4
. A versão 2.7.4 contém estas confirmações.
Novos recursos
- Foi adicionado suporte ao
popUpTo
para usar rotas com argumentos e permitir o retorno a uma entrada específica que usa esses argumentos exatos, correspondendo ao suporte encontrado empopBackStack
. (I731f4, b/299255572).
Correções de bugs
- Foi corrigido o problema em que a interrupção de uma navegação com outra usando
popUpTo
fazia com que oFragmentNavigator
falhasse. (I3c848, b/301887045). - Correção do problema em que o pressionamento do sistema faz com que
currentDestination
não fosse atualizado corretamente para corresponder ao fragmento exibido (Id0d6c, b/289877514). - O ciclo de vida do
DialogFragment
agora será movido corretamente para o estadoRESUMED
quando a caixa de diálogo acima for dispensada (I88f0d, b/301811387).
Versão 2.7.3
Versão 2.7.3
20 de setembro de 2023
Lançamento de androidx.navigation:navigation-*:2.7.3
. A versão 2.7.3 contém estas confirmações.
Correções de bugs
- Correção de um problema na navegação com fragmentos que fazia com que a lista
visibleEntries
contivesse entradas incorretas (I5caa9, b/288520638). - Correção de um problema que fazia com que o destino da janela flutuante (por exemplo,
Dialogs
,Bottomsheets
etc.) nunca recebesse um callback do LifecycleRESUMED
(I3b866, b/287505132).
Versão 2.7.2
Versão 2.7.2
6 de setembro de 2023
Lançamento de androidx.navigation:navigation-*:2.7.2
. A versão 2.7.2 contém estas confirmações.
Correções de bugs
- O Navigation agora depende do Lifecycle
2.6.2
, corrigindo uma interação entre orememberSaveable
e oNavHost
do Navigation Compose que fazia com que o estado de destinosrememberSaveable
e todas as instâncias deSavedStateHandle
de propriedade doViewModel
fossem restaurados corretamente após o encerramento e a recriação do processo (b/298059596, b/289436035). - Correção de um problema ao mostrar várias caixas de diálogo no Navigation Compose simultaneamente, em que as caixas de diálogo parcialmente obscurecidas (por exemplo, não a caixa de diálogo superior) ficavam no estado do Lifecycle
CREATED
em vez do estadoSTARTED
(aosp/2728520, b/289257213). - Correção de um problema ao mostrar várias caixas de diálogo no Navigation Compose simultaneamente, em que dispensar a caixa mais acima fazia com que a nova caixa de diálogo ficasse presa no estado do Lifecycle
STARTED
em vez de ser movida corretamente paraRESUMED
. (aosp/2629401, b/286371387). - O Safe Args do Navigation não instancia mais a tarefa prontamente se ela não está sendo executada. (I0e385, b/260322841).
Atualização de dependências
- O Navigation Compose agora depende do Compose 1.5.1.
Versão 2.7.1
Versão 2.7.1
23 de agosto de 2023
Lançamento de androidx.navigation:navigation-*:2.7.1
. A versão 2.7.1 contém estas confirmações.
Correções de bugs
- Correção de um problema na navegação com o Compose em que, ao usar um
Scaffold
, era possível receber um erro ao tentar acessar umViewModel
Lifecycle.State.DESTROYED
(I1dc11, b/268422136).
Versão 2.7.0
Versão 2.7.0
9 de agosto de 2023
Lançamento de androidx.navigation:navigation-*:2.7.0
. A versão 2.7.0 contém estas confirmações.
Mudanças importantes desde a versão 2.6.0
Animações do Accompanist
Agora que o AnimatedContent
está estável, pudemos mover o código da Animação de navegação do Accompanist de volta para o próprio Navigation Compose.
Isso significa que todo o suporte à definição de transições personalizadas que existiam no AnimatedNavHost
é diretamente compatível com NavHost
.
Nenhuma outra mudança será feita na animação de navegação do Accompanist, e ela será descontinuada formalmente em breve, além de orientações sobre como migrar de volta para o Navigation Compose, mas será o inverso do guia de migração, sem precisar de outras mudanças de API se você já estiver usando a versão Alfa mais recente do Accompanist (0.31.2-alpha
). (b/197140101, link em inglês)
Correções de bugs
- O NavHost no Navigation Compose agora intercepta corretamente as chamadas de retorno do sistema, mesmo depois que a atividade é INTERROMADA e RETOMADA. (Icb6de, b/279118447).
Atualizações de dependência
- A navegação agora depende do Compose
1.5.0
de1.1.0
Versão 2.7.0-rc01
26 de julho de 2023
Lançamento de androidx.navigation:navigation-*:2.7.0-rc01
. A versão 2.7.0-rc01 contém estas confirmações.
Correções de bugs
- Foi corrigido um problema em que as lambdas
EnterTransition
eExitTransition
criadas como parte doNavHost
podiam permanecer na memória mesmo após a remoção doNavHost
da composição (I893d0).
Problemas conhecidos
- Há um problema do Navigation 2.6.x que, ao navegar com popUpTo, pode causar uma
IllegalArgumentException
. Para evitar essa exceção, reestruture seu gráfico, conforme sugerido aqui. (b/287133013).
Versão 2.7.0-beta02
28 de junho de 2023
Lançamento de androidx.navigation:navigation-*:2.7.0-beta02
. A versão 2.7.0-beta02 contém estas confirmações.
Correções de bugs
- O Navigation Compose agora tem a ordem z correta para transições personalizadas que usam a navegação com a opção
popUpTo
(/Ib1c3a, b/285153947).
Versão 2.7.0-beta01
7 de junho de 2023
Lançamento de androidx.navigation:navigation-*:2.7.0-beta01
. A versão 2.7.0-beta01 contém estas confirmações.
Correções de bugs
- O
NavHost
no Navigation Compose agora intercepta corretamente as chamadas de retorno do sistema, mesmo depois que oActivity
éSTOPPED
eRESUMED
. (Icb6de, b/279118447).
Versão 2.7.0-alpha01
24 de maio de 2023
Lançamento de androidx.navigation:navigation-*:2.7.0-alpha01
. A versão 2.7.0-alpha01 contém estas confirmações
Animações do Accompanist
Agora que o AnimatedContent
está estável, pudemos mover o código da Animação de navegação do Accompanist de volta para o próprio Navigation Compose.
Isso significa que todo o suporte à definição de transições personalizadas que existiam no AnimatedNavHost
é diretamente compatível com NavHost
.
Nenhuma outra mudança será feita na animação de navegação do Accompanist. Ela será descontinuada formalmente em breve, além de orientações sobre como migrar de volta para o Navigation Compose, mas será o inverso do guia de migração, sem precisar de outras mudanças de API se você já estiver usando a versão Alfa mais recente do Accompanist (0.31.2-alpha
). (b/197140101, link em inglês)
Correções de bugs
- No Navigation
2.6.0-rc02
: foi corrigido um problema com a navegação em fragmentos, em que navegar compopUpTo
e remover um fragmento da backstack sem recriar a visualização fazia com que o sistema pare de funcionar de novo (Ieb8d4, b/281726455).
Atualizações de dependência
- O Navigation agora depende do Compose
1.5.0-beta01
.
Versão 2.6.0
Versão 2.6.0
7 de junho de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0
. A versão 2.6.0 contém estas confirmações.
Mudanças importantes no Navigation desde a versão 2.5.0
- O
arguments
doNavBackStackEntry
e oarguments
transmitido para umOnDestinationChangedListener
agora são apenas uma cópia dos argumentos imutáveis que foram criados quando você navegava até o destino. Isso significa que as mudanças feitas nesses pacotes não vão ser refletidas nos acessos subsequentes à instânciaarguments
ou outras instâncias doOnDestinationChangedListener
. NavDeepLink
agora oferece suporte a valores padrão para matrizes, o que permite suporte para o mapeamento de parâmetros de consulta repetidos para o tipo de matriz do argumento.NavType
agora também inclui um método padrão que pode ser substituído para combinar dois valores analisados- As subclasses personalizadas de
NavType
agora podem modificarserializeAsValue
para serializar um valor em uma string, permitindo que a serialização e desserialização (viaparseValue
) sejam totalmente encapsuladas na classeNavType
.StringType
agora substitui esse método para chamarUri.encode
noString
especificado
Mudanças importantes no Navigation Compose desde a versão 2.5.0
- Ao visualizar um elemento combinável com
NavHost
, ele mostra ostartDestination
do NavGraph por padrão NavController.popBackStack(route)
,NavController.getBackStackEntry(route)
,NavController.clearBackStack(route)
agora oferecem suporte a rotas com argumentos preenchidos de forma parcial ou total. Os argumentos precisam ser uma correspondência exata com os argumentos da entrada- A tentativa de criar um
NavDeepLink
vazio usando a DSLnavDeepLink
do Kotlin agora vai resultar em um aviso de lint indicando que um link direto precisa de um URI, ação e/ou tipo MIME para ser válido
Mudanças importantes na navegação com fragmentos desde a versão 2.5.0
NavHostFragment
não intercepta mais o botão "Voltar" do sistema Isso permite que oFragmentManager
processe o sistema de volta. Isso permite que o Fragment1.7.0-alpha01
e versões mais recentes forneçam uma animação de volta preditiva no app em dispositivos Android U.- Ao usar a navegação com fragmentos, tentar executar manualmente um
FragmentTransaction
que adicione um fragmento à backstack doFragmentManager
vai gerar umaIllegalArgumentException
Sempre adicione fragmentos usando a APInavigate()
. - Ao usar a string exata
${applicationId}
como o marcador nos atributosapp:data
eapp:dataPattern
no elemento de atividade de um arquivo XML de navegação, o marcador vai ser preenchido automaticamente com apackageName
do contexto com a inflação - O
FragmentNavigator
agora usa as APIs de transição ao navegar e mostrarNavBackStackEntries
. Isso significa que o objetoLifecycle
doNavBackStackEntry
agora aguarda a conclusão dos efeitos especiais de entrada e saída antes de mudar oLifecycle.State
final - O
DialogFragmentNavigator
agora usa as APIs de transição ao navegar e mostrarNavBackStackEntries
. Isso significa que o objetoLifecycle
doNavBackStackEntry
vai esperar que oLifecycle
doDialogFragment
mude para o estadoDESTROYED
antes de mudar a si mesmo paraDESTROYED
- O
NavHostFragment
agora permite que você extraia oNavController
assim que oNavHostFragment
é anexado aoFragmentManager
, em vez de somente após oonCreate()
. - O suporte ao Navigation para módulos de recursos dinâmicos agora depende da biblioteca granular Play Feature Delivery
- O Safe Args do Navigation agora depende do Plug-in do Android para Gradle versão 7.3.0. Isso significa que agora ele é compatível apenas com as versões 7.3.0+.
Mudanças importantes na NavigationUI desde a versão 2.5.0
- Na transmissão do ID de um gráfico de navegação para
AppBarConfiguration
(por exemplo, usando umMenu
), aNavigationUI
agora considera apenas o destino inicial desse gráfico como um nível superior em vez de marcar incorretamente cada destino no gráfico como um destino de nível superior. O comportamento da transmissão do ID de um destino individual não foi alterado. Essa mesma funcionalidade está disponível para seu próprio código com a nova funçãoisTopLevelDestination
emAppBarConfiguration
- As integrações de
setupWithNavController
emNavigationUI
para trabalhar com a barra de apps da parte de cima agora vão analisar os valoresR.string
dos argumentosReferenceType
encontrados noandroid:label
nos valores de string em vez de transmitir o número inteiro do recurso gerado automaticamente NavigationUI
agora fornece registros quando não é possível navegar por umMenuItem
selecionado
Versão 2.6.0-rc02
24 de maio de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-rc02
. A versão 2.6.0-rc02 contém estas confirmações.
Correções de bugs
- Correção de um problema com a navegação em fragmentos, em que a navegação com
popUpTo
e a remoção de um fragmento da backstack sem recriar a visualização fazia com que o sistema pare de funcionar (Ieb8d4, b/281726455).
Versão 2.6.0-rc01
10 de maio de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-rc01
. A versão 2.6.0-rc01 contém estas confirmações.
Correções de bugs
- Correção de um problema na navegação com fragmentos em que a remoção de um fragmento pela navegação com
popUpTo
no callback do ciclo de vida deonResume()
causava umaIllegalStateException
(I21884, b/279644470).
Versão 2.6.0-beta01
19 de abril de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-beta01
. A versão 2.6.0-beta01 contém estas confirmações.
Novos recursos
NavBackStackEntry
agora fornece uma implementação personalizada detoString
. (Iff00b).
Correções de bugs
- Ao usar a navegação com fragmentos, tentar executar manualmente um
FragmentTransaction
que adicione um fragmento à backstack doFragmentManager
vai gerar umaIllegalArgumentException
Sempre adicione fragmentos usando a APInavigate()
. (I6d38e). - Quando há um
navigate
que adiciona uma entrada e umpopBackStack
que a remove no mesmo frame, a entrada superior resultante na backstack agora volta para oRESUMED
Lifecycle.State
de forma consistente. (Id8067, b/276495952).
Versão 2.6.0-alpha09
5 de abril de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha09
. A versão 2.6.0-alpha09 contém estas confirmações.
Correções de bugs
- Correção das verificações de rota inválida. Assim, se um
NavDestination
contiver umNavArgument
não anulável, a rota desse destino precisará conter marcadores para argumentos com o mesmo nome doNavArgument
não anulável. (Ic62bf, b/274697949). - As navegações de link direto baseadas em
Action/MimeType
agora vão falhar se a operação de navegação não tiver umNavArgument
não anulável exigido peloNavDestination
a que oAction/MimeType
corresponde (Ibfa17, b/271777424). - Quando
NavController
define um gráfico com a mesma rota e destinos que o gráfico anterior, ele substitui corretamente os nós do gráfico atuais e os destinos da backstack por novas instâncias. Isso corrige uma falha ao usaronLaunchSingleTop
sem salvar o estado no Navigation Compose Isso também corrige um erro em que a navegação para destinos associados aos builds do gráfico raiz e à backstack incorreta (I5bc58, b/275258161, b/275407804).
Versão 2.6.0-alpha08
22 de março de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha08
. A versão 2.6.0-alpha08 contém estas confirmações.
Novos recursos
- O
NavHostFragment
agora permite que você extraia oNavController
assim que oNavHostFragment
é anexado aoFragmentManager
, em vez de somente após oonCreate()
. (Ic6382, b/220186282).
Correções de bugs
- Correção de uma
NullPointerException
ao exibir um gráfico aninhado que inclui um argumento não anulável (6b3581, b/249988437). - Ao usar o sistema de volta depois de navegar com
popUpTo
, o estado deNavController
aparecerá para a entrada correta. (I3a8ec, b/270447657). FragmentNavigator
agora vai destacar corretamente as entradas quando a backstack for retirada pelo retorno do sistema ou pelopopBackStack()
e se a transação usar efeitos ou não para o fragmento. (I81bdf).- Adicionar fragmentos aos
FragmentNavigator
FragmentManager
sem usar a navegação não vai mais causar uma falha. (b17204, b/274167493).
Atualizações de dependência
- O Navigation agora depende do Lifecycle
2.6.1
. (586fe7). - O Navigation agora depende de SavedState
1.2.1
. (078e4e). - O Navigation agora depende do ProfileInstaller
1.3.0
. (512f0c).
Versão 2.6.0-alpha07
8 de março de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha07
. A versão 2.6.0-alpha07 contém estas confirmações.
Correções de bugs
- As variantes da API
getBackStackEntry
,popBackStack
eclearBackStack
que usam rotas agora usam padrões de rota com argumentos anuláveis e parâmetros de consulta anuláveis (I22294, b/269302500). - Correção de um problema em que chamar
clearBackStack()
doNavController
não limpava o estado salvo no gerenciador de fragmentos associado à backstack limpa (Ic1cce, b/271190202). - Correção de uma regressão na versão 2.6.0-alpha06 que fazia com que o
MenuItem
errado naBottomNavigationView
fosse destacado ao usar o sistema novamente entre guias (I634f6, b/270447657). - Foi corrigida a regressão em 2.6.0-alpha06 que fazia com que
NavBackStackEntry
s não fossem movidos para o estado RESUMED ao usarAnimation
s. (Ib3589, b/269646882).
Versão 2.6.0-alpha06
22 de fevereiro de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha06
. A versão 2.6.0-alpha06 contém estas confirmações.
Novos recursos
- Ao visualizar um elemento combinável com
NavHost
, ele mostra ostartDestination
do NavGraph por padrão (I2b89f).
Mudanças na API
- Todas as sobrecargas de
navigate
doNavController
agora têm a anotação@MainThread
para garantir que elas sejam chamadas na linha de execução principal (I2c0b0, b/263427111).
Correções de bugs
- Correção de uma falha ao tentar navegar durante o uso da Dynamic Fragment Navigation (I3ee29, b/268360479).
- Correção de bug em que a navegação para outro fragmento pelo botão "Voltar" do sistema não atualiza a barra da parte de baixo do item selecionado (If559f, b/269044426).
Problemas conhecidos
- Ao usar a navegação com fragmentos, o ciclo de vida do
NavBackStackEntry
não alcançaRESUMED
ao usar as APIsAnimation
. (b/269646882). - Ao usar a navegação com fragmentos e a navegação com
BottomNavigation
, se você tentar restaurar uma backstack com várias entradas, oBottomMenuItem
não será atualizado corretamente. (b/270447657). - Ao usar a navegação com fragmentos, depois de restaurar o estado, o
NavBackStackEntry
Lifecycle
não recebeDESTROYED
quando o fragmento éDESTROYED
. (b/270610768).
Versão 2.6.0-alpha05
8 de fevereiro de 2023
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha05
. A versão 2.6.0-alpha05 contém estas confirmações.
Novos recursos
NavController.popBackStack(route)
,NavController.getBackStackEntry(route)
,NavController.clearBackStack(route)
agora oferecem suporte a rotas com argumentos preenchidos de forma parcial ou total. Os argumentos precisam ser uma correspondência exata com os argumentos da entrada (Iebd28, Ic678c, I3b37b, b/257514373).- O
FragmentNavigator
agora usa as APIs de transição ao navegar e mostrarNavBackStackEntries
. Isso significa que o objetoLifecycle
doNavBackStackEntry
agora aguarda a conclusão dos efeitos especiais de entrada e saída antes de mudar oLifecycle.State
final (I3cb19, b/238686802). - O
DialogFragmentNavigator
agora usa as APIs de transição ao navegar e mostrarNavBackStackEntries
. Isso significa que o objetoLifecycle
doNavBackStackEntry
vai esperar que oLifecycle
doDialogFragment
mude para o estadoDESTROYED
antes de mudar a si mesmo paraDESTROYED
(I53ee5, b/261213893).
Mudanças na API
- O
NavigatorState
agora fornece a APIprepareForTransition
para permitir queNavigator
s movamNavBackStackEntries
paraLifecycle.State
s intermediários (I42c21, b/238686802). - Agora você pode acessar a backstack associada a um
NavGraphNavigator
ou umComposeNavigator
usando uma propriedadebackstack
. OComposeNavigator
agora também expõe o callbackonTransitionComplete()
para marcar umaNavBackStackEntry
que executou uma operação depopBackStack
ou navegação como concluída (I02062, I718db, b/257519195).
Correções de bugs
- O estado do navegador não vai mais funcionar ao usar as APIs
push/popWithTransition
e quando a entrada já estiver sendo processada (Iadbfa, b/261213893). - Ao usar
launchSingleTop
com umNavGraph
aninhado, todos os destinos que começam no destino original para ostartDestination
vão ser adicionados corretamente apenas para a parte de cima da backstack (Id4bea, b/253256629). - A navegação agora substitui corretamente a instância de
DialogFragment
ao navegar para o mesmo destino com a flaglaunchSingleTop
definida como verdadeira (I45b5a, b/149572817). - O SafeArgs do Navigation não vai mais causar um erro de compilação ao usar argumentos com exatamente 19 caracteres (Id60bc, b/257110095).
Versão 2.6.0-alpha04
9 de novembro de 2022
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha04
. A versão 2.6.0-alpha04 contém estas confirmações.
Novos recursos
- As subclasses personalizadas de
NavType
agora podem modificarserializeAsValue
para serializar um valor em uma string, permitindo que a serialização e desserialização (viaparseValue
) sejam totalmente encapsuladas na classeNavType
.StringType
agora substitui esse método para chamarUri.encode
noString
especificado (Ie5213, b/247637434). NavigationUI
agora fornece registros quando não é possível navegar por umMenuItem
selecionado (I2af5a, b/247730357).
Correções de bugs
- Agora, os links diretos de navegação são analisados lentamente em vez de inicializados pelo gráfico, o que pode melhorar a performance do app na inicialização (Iab0ab).
- Correção da falha causada pela navegação após o link direto para um destino com argumentos padrão nulos (I51c24, b/243183636).
Atualização de dependências
- O suporte ao Navigation para módulos de recursos dinâmicos agora depende da biblioteca granular Play Feature Delivery (Ib4ddc).
- O Safe Args do Navigation agora depende do Plug-in do Android para Gradle versão 7.3.0. Isso significa que ele só é compatível com as versões 7.3.0 e mais recentes (I47e49).
Versão 2.6.0-alpha03
24 de outubro de 2022
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha03
. A versão 2.6.0-alpha03 contém estas confirmações.
Correções de bugs
- No Navigation
2.5.3
:NavHost
não vai mais causar umaNoSuchElementException
quando não houver destino disponível paraCrossfade
compor. Agora, a composição vai ser ignorada (Ieb46e, b/253299416). - No Navigation
2.5.3
: correção de um problema em que o estado salvo do Compose (por exemplo, os usos derememberSaveable
) não era esquecido e removido quando um destino era retirado da backstack (I64949).
Atualizações de dependência
- O Navigation agora depende do Fragment
1.5.4
(Icd424)
Versão 2.6.0-alpha02
5 de outubro de 2022
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha02
. A versão 2.6.0-alpha02 contém estas confirmações.
Mudanças de comportamento
- Na transmissão do ID de um gráfico de navegação para
AppBarConfiguration
(por exemplo, usando umMenu
), aNavigationUI
agora considera apenas o destino inicial desse gráfico como um nível superior em vez de marcar incorretamente cada destino no gráfico como um destino de nível superior. O comportamento da transmissão do ID de um destino individual não foi alterado. Essa mesma funcionalidade está disponível para seu próprio código com a nova funçãoisTopLevelDestination
emAppBarConfiguration
(Ie936e, b/238496771).
Correções de bugs
- O componente
navigation:navigation-fragment
agora depende da versão1.5.2
do fragmento (I00ba4). - O item de menu selecionado não é mais atualizado durante a navegação para um destino
FloatingWindow
, como uma caixa de diálogo (I4cde8, b/240308330).
Versão 2.6.0-alpha01
7 de setembro de 2022
Lançamento de androidx.navigation:navigation-*:2.6.0-alpha01
. A versão 2.6.0-alpha01 contém estas confirmações.
Novos recursos
- As integrações de
setupWithNavController
emNavigationUI
para trabalhar com a barra de apps da parte de cima agora vão analisar os valoresR.string
dos argumentosReferenceType
encontrados noandroid:label
nos valores de string em vez de transmitir o número inteiro do recurso gerado automaticamente (I5f803, b/167959935). NavDeepLink
agora oferece suporte a valores padrão para matrizes, o que permite suporte para o mapeamento de parâmetros de consulta repetidos para o tipo de matriz do argumento.NavType
agora também inclui um método padrão que pode ser substituído para combinar dois valores analisados (Id68c3, b/209977108).- Ao usar a string exata
${applicationId}
como o marcador nos atributosapp:data
eapp:dataPattern
no elemento de atividade de um arquivo XML de navegação, o marcador vai ser preenchido automaticamente com apackageName
do contexto com a inflação (Iaabde, b/234223561). - A tentativa de criar um
NavDeepLink
vazio usando a DSLnavDeepLink
do Kotlin agora vai resultar em um aviso de lint indicando que um link direto precisa de um URI, ação e/ou tipo MIME para ser válido (I08d2f, b/154038883).
Mudanças na API
- Foi adicionada a nova função de extensão
NavDestination
para analisar rótulos dinâmicos com argumentos na forma deandroid:label="{arg}"
em string. Ela oferece suporte a argumentosReferenceType
, analisando valoresR.string
nos valores de string (I07d89, b/236269380).
Mudanças de comportamento
- Os
arguments
do NavBackStackEntry e osarguments
transmitidos para umOnDestinationChangedListener
agora são apenas uma cópia dos argumentos imutáveis que foram criados ao navegar para o destino. Isso significa que as mudanças feitas nesses pacotes não vão ser aplicadas nos acessos subsequentes às instânciasarguments
ou outrasOnDestinationChangedListener
(I676f5).
Correções de bugs
- No Navigation
2.5.2
: a navegação dinâmica agora tenta instalar corretamente os destinos de atividade de outros módulos antes de navegar até eles (Ia2c16, b/240292838). - No Navigation
2.5.2
: a navegação agora substitui corretamente a instância do fragmento ao navegar para o mesmo destino e definir a sinalizaçãolaunchSingleTop
como "true" (I5a2f1, b/237374580). - No Navigation
2.5.2
: correção deIllegalStateException
causada ao navegar para um gráfico aninhado duplo que compartilha um pai com um novo destino inicial mostrado (I9f7cb, b/243778589).
Versão 2.5
Versão 2.5.3
24 de outubro de 2022
Lançamento de androidx.navigation:navigation-*:2.5.3
. A versão 2.5.3 contém estas confirmações.
Correções de bugs
NavHost
não vai mais causar umaNoSuchElementException
quando não houver destino disponível paraCrossfade
compor. Agora, a composição vai ser ignorada (Ieb46e, b/253299416).- Correção de um problema em que o estado salvo do Compose (por exemplo, os usos de
rememberSaveable
) não era esquecido e removido quando um destino era retirado da backstack (I64949).
Versão 2.5.2
7 de setembro de 2022
Lançamento de androidx.navigation:navigation-*:2.5.2
. A versão 2.5.2 contém estas confirmações.
Correções de bugs
- A navegação dinâmica agora tenta instalar corretamente os destinos de atividade de outros módulos antes de navegar até eles (Ia2c16, b/240292838).
- O Navigation agora substitui corretamente a instância do fragmento ao navegar para o mesmo destino e definir a sinalização
launchSingleTop
como "true" (I5a2f1, b/237374580). - Correção de
IllegalStateException
causada ao navegar para um gráfico aninhado duplo que compartilha um pai com um novo destino inicial mostrado (I9f7cb, b/243778589).
Atualização de dependências
- O Navigation
2.5.2
agora depende do Fragment1.5.2
. (aosp/2178734).
Versão 2.5.1
27 de julho de 2022
Lançamento de androidx.navigation:navigation-*:2.5.1
. A versão 2.5.1 contém estas confirmações.
Correções de bugs
- O
Navigation Safe Args
não vai mais causar avisos de descontinuação nas classes geradas ao usar tipos de argumento personalizados salvos em umBundle
(Id86ed, b/237725966).
Atualizações de dependência
- A biblioteca Navigation agora depende do Lifecycle
2.5.1
(Ib4451). - A biblioteca Navigation agora depende da Activity
1.5.1
(I3efe8). - A biblioteca Navigation agora depende do Fragment
1.5.1
(I56177).
Versão 2.5.0
29 de junho de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0
. A versão 2.5.0 contém estas confirmações.
Mudanças importantes desde a versão 2.4.0
- Integração de CreationExtras: a
Navigation
agora pode fornecer uma interfaceViewModelProvider.Factory
sem estado usando a classeCreationExtras
do Lifecycle2.5.0
.
SafeArgs do Navigation
- O
Navigation Safe Args
fez o upgrade da dependênciaAndroid Gradle Plugin
para usar7.0.4
, não oferecendo mais suporte a versões do AGP anteriores a7.0
. - Inclusão de suporte para o atributo build.gradle do namespace, que será usado em vez de applicationId.
Outras mudanças
- A API
visibleEntries
não é mais experimental e oferece uma função para recuperar todas as entradas que tenham destinos visíveis de acordo com oNavController
.
Versão 2.5.0-rc02
15 de junho de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-rc02
. A versão 2.5.0-rc02 contém estas confirmações.
Correções de bugs
- Foi corrigida uma falha causada pela alternância rápida entre destinos inferiores ao usar o Navigation Compose
NavHost
(I3979a, b/234054916). - O
Navigation SafeArgs
não vai falhar mais ao usar umapplicationIdSuffix
e um namespace sem oapplicationId
ou quando oapplicationId
e o namespace forem diferentes (I754b1, b/233119646). - O
NavArgument
agora tem uma funçãotoString()
personalizada para mostrar os valores internos do argumento (I900a8).
Versão 2.5.0-rc01
11 de maio de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-rc01
. A versão 2.5.0-rc01 contém estas confirmações.
Novos recursos
- Uma nova regra de lint foi adicionada para alertar sobre a inserção de elementos
<deeplink>
dentro de elementos<activity>
no arquivonavigation.xml
(Ic15a5, b/178403185).
Correções de bugs
- Os escopos combináveis em
NavHost
eDialogHost
agora são descartados na ordem esperada, ou seja, os elementos combináveis internos são descartados antes dos elementos externos (I157e6) - O SafeArgs do Navigation agora usa
PathSensitivity.RELATIVE
noArgumentsGenerationTask
para permitir a realocação do cache. Isso significa que a entrada de cache agora pode ser reutilizada de um build de CI para um build local (I5f67c, b/173420454). - A regra de lint
UnrememberedGetBackStackEntryDetector
foi atualizada para garantir que a chamada deremember
ao redor da chamada paragetBackStackEntry()
também transmita um objetoNavBackStackEntry
como uma chave (Ib7081, b/227382831).
Versão 2.5.0-beta01
20 de abril de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-beta01
. A versão 2.5.0-beta01 contém estas confirmações.
Correções de bugs
- A
DialogNavigator
agora usapopWithTransition
ao executar uma chamadadismiss()
. Isso corrige uma disputa ao usar umViewModel
no destinodialog
, que causaria umaIllegalStateException
ao dispensar a caixa de diálogo usando o sistema ou tocando fora da caixa de diálogo para sair (Id7376, b/226552301).
Atualizações de dependência
- O Navigation agora depende do Lifecycle
2.5.0-beta01
, corrigindo umaIllegalStateException
ao aninhar umNavHost
em outroNavHost
em uma guia de navegação não primária na parte inferior da tela ao usar várias backstacks.
Versão 2.5.0-alpha04
6 de abril de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-alpha04
. A versão 2.5.0-alpha04 contém estas confirmações.
Mudanças na API
visibleEntries
não é mais experimental (I4829f, b/225394514).
Correções de bugs
- O NavHost agora depende das
visibleEntries
doNavController
para determinar quais entradas vão ser compostas. Isso significa que, ao usar o NavHost aninhado, oNavHost
interno vai ser animado corretamente (I4ba2b, b/225394514). - O
StateFlow
devisibleEntries
fornecido peloNavController
agora se baseia no estado máximo do Lifecycle da entrada, em vez de no estado atual. Isso significa que, mesmo que o ciclo de vida do host donavController
fique abaixo de "STARTED" (iniciado), a lista de partes visíveis permanece a mesma (I9e2a8, b/225394514). SavedStateViewFactory
agora oferece suporte ao uso deCreationExtras
mesmo quando inicializada com umSavedStateRegistryOwner
. Se extras forem fornecidos, os argumentos inicializados serão ignorados (I6c43b, b/224844583).NavDeepLink
agora pode analisar URIs com um único parâmetro de consulta sem valor (I0efe8, b/148905489).- Strings vazias agora são consideradas argumentos válidos em links diretos (I70a0d, b/217399862).
Navigation Safe Args
não vai falhar mais quando nenhumAndroidManifest.xml
estiver presente ao usar namespaces (I17ccf, b/227229815).
Versão 2.5.0-alpha03
23 de fevereiro de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-alpha03
. A versão 2.5.0-alpha03 contém estas confirmações.
Mudanças na API
- Agora é possível transmitir
CreationExtras
aby navGraphViewModels
para criar umViewModel
(I29217, b/217618359).
Correções de bugs
NavDeepLinks
agora oferece suporte aos novos caracteres de linha incorporados em rotas/URIs de link direto (I513d1, b/217815060).CreationExtras
agora vai funcionar corretamente quando usado comNavBackStackEntries
para criar ViewModels (I69161, b/217617710).- O Safe Args de navegação agora oferece suporte ao uso do namespace definido
no
build.gradle
em vez do pacote no AndroidManifest (I659ef, b/217414933).
Versão 2.5.0-alpha02
9 de fevereiro de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-alpha02
. A versão 2.5.0-alpha02 contém estas confirmações.
Correções de bugs
- No Navigation
2.4.1
: oNavHostFragment
agora define corretamente a classeOnBackPressedDispatcher
ao usar a vinculação de visualizações com gráficos aninhados (Ifbb51, b/214577959). - No Navigation
2.4.1
: quando os links diretos usam váriosNavGraph
s aninhados, o backstack inclui corretamente os destinos iniciais intermediários (I504c0, b/214383060).
Versão 2.5.0-alpha01
26 de janeiro de 2022
Lançamento de androidx.navigation:navigation-*:2.5.0-alpha01
. A versão 2.5.0-alpha01 contém estas confirmações.
Novos recursos
NavBackStackEntry
agora se integra ao ViewModel CreationExtras, introduzido como parte do Lifecycle2.5.0-alpha01
(Ib9fe2, b/207012490).
Correções de bugs
- Um problema em que o acesso a um
ViewModel
criado porby navGraphViewModels()
do métodoonCreate()
de um fragmento falhava com umaIllegalStateException
foi corrigido (I8a14d). NavDeepLink
s não vão decodificar mais desnecessariamente os argumentos duas vezes, ou seja, os argumentos adequados agora vão ser transmitidos para o destino final (I31b0a, b/210711399).
Safe Args
- O Safe Args agora depende do Plug-in do Android para Gradle versão 7.0.4. Isso significa que o Navigation Safe Args não é mais compatível com as versões do Android Studio anteriores à 7.0, mas agora é compatível com o Plug-in do Android para Gradle 7.1.0 e versões mais recentes (I41c88, b/213086135, b/207670704).
Versão 2.4.2
Versão 2.4.2
6 de abril de 2022
Lançamento de androidx.navigation:navigation-*:2.4.2
. A versão 2.4.2 contém estas confirmações.
Correções de bugs
- Backport do Navigation
2.5.0-alpha03
:NavDeepLinks
agora oferece suporte aos novos caracteres de linha incorporados em rotas/URIs de link direto (I513d1, b/217815060). - Backport do Navigation
2.5.0-alpha03
: o Navigation SafeArgs agora oferece suporte ao namespace definido nobuild.gradle
no lugar do pacote no AndroidManifest (I659ef, b/217414933). - Backport do Navigation
2.5.0-alpha04
:Navigation Safe Args
não vai falhar mais quando nenhumAndroidManifest.xml
estiver presente ao usar namespaces (I17ccf, b/227229815). - Backport do Navigation
2.5.0-alpha04
: strings vazias agora são consideradas argumentos válidos em links diretos (I70a0d, b/217399862).
Versão 2.4.1
Versão 2.4.1
9 de fevereiro de 2022
Lançamento de androidx.navigation:navigation-*:2.4.1
. A versão 2.4.1 contém estas confirmações.
Correções de bugs
- O
NavHostFragment
agora define corretamente a classeOnBackPressedDispatcher
ao usar a vinculação de visualizações com gráficos aninhados (Ifbb51, b/214577959). - Agora, quando há links diretos usando vários
NavGraph
s aninhados, a pilha de retorno inclui corretamente destinos iniciais intermediários (I504c0, b/214383060). - Backport do Navigation
2.5.0-alpha01
: correção de um problema em que o acesso a um ViewModel criado peloby navGraphViewModels()
usando oonCreate()
de um fragmento falhava com umaIllegalStateException
(I8a14d). - Backport do Navigation
2.5.0-alpha01
:NavDeepLink
s deixaram de decodificar argumentos desnecessariamente duas vezes, ou seja, os argumentos decodificados da maneira correta agora vão ser transmitidos para o destino final (I31b0a, b/210711399). - Backport do Navigation
2.5.0-alpha01
: o Safe Args agora depende do Plug-in do Android para Gradle versão 7.0.4. Isso significa que o Navigation Safe Args não oferece mais suporte a versões do Android Studio anteriores à 7.0, mas agora é compatível com o Plug-in do Android para Gradle 7.1.0 e versões mais recentes (I41c88, b/213086135, b/207670704).
Versão 2.4.0
Versão 2.4.0
26 de janeiro de 2022
Lançamento de androidx.navigation:navigation-*:2.4.0
. A versão 2.4.0 contém estas confirmações.
Mudanças importantes desde a versão 2.3.0
- Todos os artefatos de navegação foram reescritos em Kotlin. Isso melhorou a nulidade de classes usando a generalização (como subclasses
NavType
). Todas as funções de extensão do Kotlin que costumavam fazer parte dos artefatos-ktx
foram movidas para os respectivos artefatos principais. Os artefatos-ktx
vão continuar sendo publicados, mas estão completamente vazios - O artefato
navigation-fragment
agora contém uma implementação pré-criada de um layout de dois painéis pelo novoAbstractListDetailFragment
. Esse fragmento usa umSlidingPaneLayout
para gerenciar um painel de lista (que a subclasse fornece) e um painel de detalhes, que usa umNavHostFragment
como implementação, conforme mostrado no nosso exemplo de implementação. - O método
currentBackStackEntryAsFlow()
noNavController
fornece umFlow
que é emitido sempre que aNavBackStackEntry
atual muda. Esse fluxo pode ser usado como uma alternativa ao gerenciamento manual de umOnDestinationChangedListener
- O NavController agora permite extrair uma lista de todas as instâncias
NavBackStackEntry
visíveis como umStateFlow
usando a propriedadevisibleEntries
experimental. - Agora é possível estender a classe
NavType
para criar NavTypes personalizados. Só há suporte para tipos personalizados ao criar o gráfico de navegação de maneira programática, por exemplo, usando a DSL do Kotlin para gráficos de navegação. A navegação agora fornece APIs
findStartDestination()
egetHierarchy()
que podem ser usadas para ajudar a implementar a NavigationUI personalizada.findStartDestination()
é uma função de extensão deNavGraph
que localiza o destino inicial real que é exibido quando você navega até o gráfico, mesmo que ostartDestination
seja umNavGraph
aninhado. AgetHierarchy()
é uma função doNavDestination
que pode ser usada para verificar se determinado destino está na hierarquia de outro.val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
Os métodos da
NavigationUI
que usavam umaBottomNavigationView
foram atualizados para usar a superclasseNavigationBarView
, introduzida no Material1.4.0
. Isso permite que esses métodos sejam usados comNavigationRailView
.Ao inflar um elemento
<action>
via XML, os atributos de animação podem usar atributos extraídos do tema com a sintaxeapp:enterAnim="?attr/transitionEnter"
.O Safe Args agora gera um método
fromSavedStateHandle()
para cada classeNavArgs
(#122 (link em inglês), b/136967621).class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() { // Create a HomeDestinationArgs class with type safe accessors for each argument // defined on your destination private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle) }
Rotas de navegação e a DSL do Kotlin
As versões anteriores do componente de navegação dependiam de cada destino ter um ID de constante inteiro que o identificava exclusivamente em destinos irmãos e permitiam que você enviasse navigate()
diretamente para esse destino ou por uma ação. Embora isso continue sendo válido e útil, principalmente nos casos em que você define o gráfico de navegação em XML e pode usar constantes R.id
geradas automaticamente ou o Safe Args, que usa essas constantes para gerar código durante a compilação, esse sistema de números inteiros únicos não capturava o significado semântico e a expressividade necessária para oferecer suporte a gráficos totalmente dinâmicos criados programaticamente durante a execução pela DSL de navegação do Kotlin.
Esta versão introduz uma nova opção para identificar exclusivamente um destino em um gráfico de navegação pela rota dele. Uma rota é uma String
que define o caminho exclusivo de um destino. Todos os métodos da DSL do Kotlin que receberam um ID de destino foram descontinuados e substituídos por uma API equivalente que usa uma rota.
Cada rota precisa ser tratada como a parte "path" (caminho) de um Uri
que define o destino, por exemplo, home
, profile/{userId}
, profile/{userId}/friends
etc. Quando a identidade de um destino é associada a um conteúdo específico, esses argumentos dinâmicos precisam fazer parte do trajeto, seguindo as mesmas regras de links diretos implícitos.
Todas as APIs NavController
que recebiam apenas um ID agora têm uma sobrecarga que usa uma String
de rota. Isso inclui navigate()
, popBackStack()
, popUpTo()
e getBackStackEntry()
.
Isso teve algumas implicações na API:
- A propriedade
popUpTo
na DSL do Kotlin foi descontinuada e substituída porpopUpToId
. - A API
getStartDestination()
foi descontinuada e substituída porgetStartDestinationId()
.
Diferente da navegação por ID, a navegação por rota segue as mesmas regras dos links diretos implícitos, em que é possível navegar diretamente para qualquer destino em qualquer gráfico aninhado, garantindo que essas rotas sejam utilizáveis em vários módulos sem adicionar explicitamente um link direto visível externamente para cada destino.
Navigation Compose
O artefato navigation-compose
fornece integração entre o componente de navegação e o Jetpack Compose. Ele usa funções @Composable
como destinos no aplicativo.
Novidades desta versão:
- Um elemento
NavHost
combinável que permite construir o gráfico de navegação com uma DSL do Kotlin, usando destinoscomposable
edialog
, além de suporte a navegadores opcionais, como os do Material de navegação do Accompanist. - Suporte obrigatório com fading cruzado entre destinos. A Animação de navegação do Accompanist pode ser usada para controlar as transições de entrada e saída usando APIs experimentais do Compose.
- Escopo de um
Lifecycle
para cada destino de composição. Cada destino só chega ao estadoRESUMED
(retomado) quando uma transição de entrada termina e cai imediatamente emSTARTED
(iniciado) quando uma transição de saída começa, permitindo que você evite todos os problemas deIllegalStateException
e multitoque, acionando apenas uma chamadanavigate
quando oLifecycle
forRESUMED
(retomado). - Escopo de
ViewModel
(pela APIviewModel()
do Lifecycle ViewModel Compose2.4.0
ouhiltViewModel()
do Hilt Navigation Compose1.0.0
no nível de destino), fornecendo um escopo que sobrevive a mudanças de configuração e ficando na backstack (quando o conteúdo de composição é descartado) e um sinal noonCleared()
do ViewModel que indica o descarte permanente e a limpeza do estado associado àNavBackStackEntry
. - Escopo do estado
rememberSaveable
no nível do destino, garantindo que todo o estado combinável seja salvo e restaurado automaticamente quando você retornar a um destino. - Suporte total ao salvamento e à restauração do estado do
NavController
e o estado do destino após a interrupção e a recriação do processo. - Integração automática com o botão "Voltar" do sistema.
Suporte à transmissão de argumentos, anexação de links diretos para destinos e retorno de um resultado para destinos anteriores.
Auxiliares específicos do Compose em
rememberNavController()
ecurrentBackStackEntryAsState()
para permitir a elevação do estado e conectarNavController
a elementos combináveis fora doNavHost
, como uma barra de navegação inferior.
val navController = rememberNavController()
Scaffold { innerPadding ->
NavHost(navController, "home", Modifier.padding(innerPadding)) {
composable("home") {
// This content fills the area provided to the NavHost
HomeScreen()
}
dialog("detail_dialog") {
// This content will be automatically added to a Dialog() composable
// and appear above the HomeScreen or other composable destinations
DetailDialogContent()
}
}
}
Consulte o guia de navegação do Compose para ver mais informações.
Várias backstacks
O NavController é responsável por gerenciar a backstack dos destinos, adicionando destinos a ela quando o método navigate()
navega até eles e os removendo ao chamar popBackStack()
ou acionar o botão "Voltar" do sistema. A classe NavOptions
existente e a integração com elementos <action>
no XML dos gráficos de navegação foram expandidas para oferecer suporte ao salvamento e à restauração da backstack.
Como parte dessa mudança, os métodos NavigationUI
de onNavDestinationSelected()
, BottomNavigationView.setupWithNavController()
e NavigationView.setupWithNavController()
agora salvam e restauram automaticamente o estado dos destinos removidos, permitindo o suporte a várias backstacks sem mudanças no código. Ao usar a navegação com fragmentos, essa é a forma recomendada para integrar várias backstacks
As APIs de base para salvar e restaurar o estado são expostas por várias superfícies:
No XML de navegação, o elemento
<action>
agora pode usar os atributos booleanos deapp:popUpToSaveState
eapp:restoreState
para salvar o estado de quaisquer destinos removidos usandoapp:popUpTo
e restaurar o estado associado ao destino transmitido como oapp:destination
:<action android:id=”@+id/swap_stack” app:destination=”@id/second_stack” app:restoreState=”true” app:popUpTo=”@id/first_stack_start_destination” app:popUpToSaveState=”true” />
Nas
navOptions
da DSL do Kotlin, é possível adicionar as propriedades booleanasrestoreState
esaveState
no builderpopUpTo
:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.findStartDestination().id) { saveState = true } }
Ao criar manualmente um objeto
NavOptions
usando oNavOptions.Builder
, é possível usarsetRestoreState()
e a nova sobrecarga parasetPopUpTo()
que recebe um parâmetrosaveState
extra.NavOptions navOptions = new NavOptions.Builder() .setLaunchSingleTop(true) .setRestoreState(true) .setPopUpTo(NavGraph.findStartDestination(navController.getGraph()).getId(), false, // inclusive true) // saveState .build(); navController.navigate(selectedBottomNavId, null, navOptions);
As chamadas programáticas para
popBackStack()
agora podem incluir um parâmetrosaveState
extra.Agora você pode usar o método
clearBackStack()
para limpar qualquer estado salvo compopBackStack()
oupopUpToSaveState
.
Em todos os casos, o NavController
salva e restaura o estado de cada NavBackStackEntry
, incluindo qualquer instância de destino ViewModel
com escopo. As APIs Navigator
foram atualizadas para permitir que cada Navigator
aceite o salvamento e a restauração do próprio estado.
Mudanças de comportamento
- O
NavDeepLinkBuilder
agora adicionaPendingIntent.FLAG_IMMUTABLE
àPendingIntent
retornada porcreatePendingIntent()
, garantindo que essa API funcione conforme esperado quando destinada ao Android 12. - O Navigation agora depende do
Lifecycle
2.3.1
e marcasetGraph()
,popBackStack()
,navigateUp()
enavigate()
como os métodos que atualizam oLifecycle
daNavBackStackEntry
, como@MainThread
, alinhando o componente de navegação à aplicação da linha de execução principal introduzida no Lifecycle2.3.0
- Os links diretos agora verificam se todos os argumentos necessários (aqueles sem valores padrão) estão presentes no
Uri
. - Os argumentos analisados de
NavDeepLink
agora consideram símbolos de libra da mesma forma que os pontos de interrogação como separador entre segmentos de caminho, impedindo que um argumento se estenda pelo símbolo de libra. - Ao gerar ações, o código Kotlin criado pelo Safe Args agora coloca argumentos sem valores padrão antes daqueles com valores padrão como parâmetros
- Ao gerar argumentos, o Safe Args agora coloca os parâmetros sem valores padrão antes daqueles com valores padrão
- O Safe Args agora depende do Plug-in do Android para Gradle 4.2.0. Isso significa que você não vai receber mais o aviso sobre o uso do
applicationIdTextResource
.
Problemas conhecidos
- Correção no Navigation
2.5.0-alpha01
: o acesso a umViewModel
criado usandoby navGraphViewModels()
pelo métodoonCreate()
de um fragmento falha com umaIllegalStateException
(b/213504272). - Correção np Navigation
2.5.0-alpha01
: o Safe Args 2.4.0 não oferece suporte ao Plug-in do Android para Gradle 7.1.0 e versões mais recentes (b/213086135). - Link direto com vários gráficos de navegação aninhados não criam corretamente a backstack completa (b/214383060).
Versão 2.4.0-rc01
15 de dezembro de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-rc01
. A versão 2.4.0-rc01 contém estas confirmações.
Mudanças de comportamento
- Os argumentos analisados de
NavDeepLink
agora consideram símbolos de libra da mesma forma que os pontos de interrogação como um separador entre argumentos (I21309, b/180042703).
Correções de bugs
- Os links diretos não vão mais ignorar argumentos com valores iguais ao nome do marcador (If8017, b/207389470).
- O
NavController
não falhará mais ao exibir um destino aninhado usando transições depois que oNavController
for restaurado (I0f7c9, b/205021623). - A mensagem de erro ao usar um
startDestination
inválido passará a usar a rota de destino inicial, se disponível (I86b9d, b/208041894).
Correções de bugs do Navigation Compose
- Correção da possível falha causada pela alternância rápida entre o destino inicial e outro destino usando os itens do menu de navegação inferior (Ic8976, b/208887901).
- O destino da caixa de diálogo agora é restaurado corretamente na parte superior da tela após alterações de configuração ou encerramento de processo (I4c0dc, b/207386169).
- Correção de um problema em que a tentativa de recuperar um
ViewModel
doNavBackStackEntry
de uma caixa de diálogo falhava quando ela era dispensada (I6b96d, b/206465487). - Correção de um problema que resultava em recomposições infinitas ao usar destinos
activity
com oNavHost
do Navigation Compose (I8f64c). - Correção de um vazamento no Navigation Compose em que ele se prendia a uma referência da atividade antiga após uma alteração de configuração ou encerramento de processo (I4efcb, b/204905432).
Correções de bugs do Safe Args
SafeArgs
não falha mais ao tentar restaurar matrizes comparáveis personalizadas após a interrupção do processo (I618e8, b/207315994).- Correção de um bug em Safe Args que não permitia que matrizes booleanas tivessem um valor
null
(I8c396, b/174787525).
Versão 2.4.0-beta02
3 de novembro de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-beta02
. A versão 2.4.0-beta02 contém estas confirmações.
Mudanças em APIs
- Agora, o gerenciamento de links diretos explícitos e implícitos
adiciona automaticamente a sinalização
saveState
ao navegar para outro gráfico, garantindo que esse código, comoNavigationUI.setupWithNavController
, e códigos que usam várias backstacks funcionam conforme o esperado (Ic8807).
Mudanças de comportamento
- Os padrões de links diretos agora são compilados lentamente em NavDeepLink, em vez de durante a inflação. Isso melhora o tempo de inflação dos gráficos de navegação que incluem links diretos (b8d257, b/184149935).
Correções de bugs
- Foi corrigido um problema em que NavBackStackEntries eram enviadas ao
Lifecycle.State.CREATED
depois de passar para o estadoLifecycle.State.STARTED
quando oNavHost
era adicionado diretamente ao métodosetContent()
da atividade (Ia5ac1, b/203536683). - Uma disputa em que
a saída de um destino
DialogFragment
da backstack antes da exibição da caixa de diálogo não dispensava a caixa de diálogo que resultava em uma falha quando a caixa de diálogo era dispensada manualmente pelo usuário foi corrigida (I687e5). - Corrigido um problema em que a
API
onNavDestinationSelected
naNavigationUI
retornavatrue
mesmo que você não tivessenavigate()
(navegado) para esse gráfico de navegação. Agora, a API usa a mesma lógica usada internamente pelosetupWithNavController
para selecionar apenas oMenuItem
associado ao destino atual usando ahierarchy
do destino (I2b053).
Versão 2.4.0-beta01
27 de outubro de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-beta01
. A versão 2.4.0-beta01 contém estas confirmações.
Novos recursos
- Agora, é possível usar o
by navGraphViewModel
com uma rota como alternativa ao uso de um ID. Assim, você pode oferecer mais suporte ao uso da DSL de navegação do Kotlin com fragmentos (I901e3, b/201446416).
Mudanças na API
- A API
visibleEntries
agora é experimental (I93f6f).
Correções de bugs
- Os ViewModels não serão mais destruídos quando as transições forem interrompidas na navegação entre as mesmas telas (Id52d8, b/200817333).
- Os argumentos
NavDeepLink
anuláveis não exigem mais um valor padrão ao adicionar links diretos paraNavDestination
s (I5aad4, b/201320030). - NavBackStackEntries com ciclos de vida diferentes não são mais consideradas iguais. Isso significa que o NavHost poderá recompor corretamente todos os destinos ao fazer a navegação usando singleTop e selecionar novamente os itens do menu de baixo (I1b351, b/196997433).
- Corrigido um problema com o
AbstractListDetailFragment
que fazia com que os atributoslayout_width
elayout_weight
no painel de listas retornado poronCreateListPaneView()
fossem processados incorretamente ou ignorados (f5fbf3). - O estado visual dos destinos de caixas de diálogo agora
está corretamente sincronizado com o estado do
DialogFragmentNavigator
. Isso significa que chamar manualmente a APIdismiss()
assíncrona para oDialogFragment
agora limpa corretamente todos os destinos de caixas de diálogo acima da caixa de diálogo dispensada. Isso não afeta casos em que você usapopUpTo
oupopBackStack()
para dispensar a caixa de diálogo (I77ba2). - O
AbstractAppBarOnDestinationChangedListener
agora tem mensagens de erro mais claras paraonDestinationChanged()
(Ie742d).
Versão 2.4.0-alpha10
29 de setembro de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha10
. A versão 2.4.0-alpha10 contém estas confirmações.
Novos recursos
- O NavController agora permite acessar uma lista de todas as
instâncias
NavBackStackEntry
visíveis usando o StateFlowvisibleEntries
(Ia964e). - O método
rememberNavController()
agora usa um conjunto opcional de instânciasNavigator
que vão ser adicionadas aoNavController
retornado para oferecer melhor suporte a navegadores opcionais, como os do Material de navegação do Accompanist (I4619e).
Correções de bugs
- A navegação dinâmica não falhará mais quando a atividade for recriada (Ifa6a3, b/197942869).
- Corrigido um problema com o botão "Voltar" do sistema, que ocorre somente depois de retornar a um destino de composição que contém um
NavHost
(3ed148, b/195668143). - SafeArgs agora gera os argumentos para
fromBundle()
efromSavedStateHandle()
na ordem correta dos parâmetros (I824a8, b/200059831).
Versão 2.4.0-alpha09
15 de setembro de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha09
. A versão 2.4.0-alpha09 contém estas confirmações.
Novos recursos
- Agora você pode usar o método
clearBackStack()
para limpar qualquer estado salvo compopBackStack()
oupopUpToSaveState
(I80a0f). - Agora você pode transmitir uma lista de argumentos e/ou links diretos para o builder do gráfico de navegação aninhado. Eles vão ser adicionados automaticamente ao gráfico resultante (I8a470, b/182545357).
Mudanças na API
- A função
navArgument
do DSL do Kotlin agora faz parte denavigation-common
em vez denavigation-compose
. Para continuar usando essa função, você precisará atualizar as importações (I1d095).
Mudanças de comportamento
- Ao gerar argumentos, o Safe Args agora coloca os parâmetros sem valores padrão antes daqueles com valores padrão (I89709, b/198493585).
Correções de bugs
- Ao usar o Navigation Compose, o NavGraphs só será
DESTROYED
(destruído) depois que todos os filhos também tiverem sidoDESTROYED
(I86552, b/198741720). - Os argumentos
NavDeepLink
anuláveis não exigem mais um valor padrão (Ia14ef, b/198689811). - Chamar
setGraph()
com um novo gráfico agora também limpa todas as backstacks salvas, além do comportamento anterior de visualizar a backstack (I97f96). - Foi corrigido um problema em que
instâncias de
OnDestinationChangedListener
e ocurrentBackStackEntryFlow
não eram notificadas ao usarlaunchSingleTop
(Iaaebc).
Atualizações de dependência
- O Navigation Compose agora depende da Activity Compose 1.3.1 (I05829).
- O Navigation Compose agora depende da
Lifecycle ViewModel Compose
2.4.0-beta01
(Ib86a3).
Versão 2.4.0-alpha08
1.º de setembro de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha08
. A versão 2.4.0-alpha08 contém estas confirmações.
Novos recursos
- Agora é possível estender a classe
NavType
para criar NavTypes personalizados. Só há suporte para tipos personalizados ao criar o gráfico de navegação de maneira programática, por exemplo, usando a DSL do Kotlin para gráficos de navegação. (I78440, b/196871885).
Mudanças de comportamento
- Ao gerar ações, o código Kotlin criado pelo Safe Args agora coloca argumentos sem valores padrão antes daqueles com valores padrão como parâmetros (Idb697, b/188855904).
- Os links diretos agora verificam se todos os argumentos necessários (aqueles sem valores padrão) estão presentes no
Uri
. (#204, em inglês, e b/185527157).
Correções de bugs
- O uso de
getBackStackEntry
epreviousBackStackEntry
no método composable(), em conjunto comremember()
, não vai causar mais uma exceção se não houver nenhum destino na backstack (I75138, b/194313238). - O Navigation Compose agora faz a recomposição corretamente ao mudar argumentos da
backstack e usar
launchSingleTop=true
(Iebd69, b/186392337). - Uma
ArrayIndexOutOfBoundsException
não ocorrerá mais ao chamar o métodosetGraph
usando um gráfico com 13 ou 29 destinos (I1a9f1, b/195171984). - O gerador Java do Safe Args não causará mais avisos de lint ao gerar classes Args (I1a666, b/185843837).
Contribuição externa
- Agradecemos a ospixd (link em inglês) por garantir que os links diretos verifiquem se todos os argumentos necessários (aqueles sem valores padrão) estão presentes no
Uri
(#204, em inglês, e b/185527157).
Versão 2.4.0-alpha07
18 de agosto de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha07
. A versão 2.4.0-alpha07 contém estas confirmações.
Correções de bugs
- O Navigation Compose agora salva corretamente o estado após mudanças na configuração e ao alterar gráficos usando o recurso de várias backstacks (If5a3d, b/195141957).
- Selecionar novamente a mesma guia ao usar o Navigation Compose com várias backstacks não resultará mais em uma tela em branco (I860dc, b/194925622).
- O
NavHost
agora observa mudanças noLifecycle.State
deNavBackStackEntry
s, o que significa que umNavHost
em um fragmento agora será recomposto corretamente à medida que o ciclo de vida muda, em vez de resultar em uma tela em branco (I4eb85, b/195864489). - Foi corrigido um problema em que a ação de dispensar um
DialogFragment
não atualizava corretamente o estadoNavController
depois de recriar a atividade, por exemplo, após uma mudança de configuração (Icd72b). - Foi corrigido um problema em que mostrar um destino de caixa de diálogo não atualizava o processamento do botão "Voltar" do sistema para o NavController, possivelmente fazendo com que o NavController interceptasse o botão, mesmo que ele não tivesse nenhuma backstack para mostrar (If3b34).
- O Safe Args agora gera automaticamente um método
toSavedStateHandle
para argumentos que podem ser usados para testar seu códigoViewModel
(If1e2d, b/193353880).
Versão 2.4.0-alpha06
4 de agosto de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha06
. A versão 2.4.0-alpha06 contém estas confirmações.
Mudanças na API
- Os métodos
requireSlidingPaneLayout()
erequireDetailPaneNavHostFragment()
noAbstractListDetailFragment
foram renomeados comogetSlidingPaneLayout()
egetDetailPaneNavHostFragment()
, respectivamente (I34a08).
Mudanças de comportamento
- Ao navegar com animações (como
Crossfade
), oLifecycle
do novo destino agora só alcança o estadoRESUMED
(retomado) quando a animação é concluída (If0543, b/172112072, b/194301889). - O
NavHost
do Navigation Compose agora define o gráfico como parte da primeira composição (Ieb7be).
Correções de bugs
- Abrir o último destino de um gráfico de navegação não gera mais uma
ClassCastException
(If0543, b/172112072, b/194301889). - Corrigida uma
NullPointerException
que ocorria ao adicionar um link direto sem umUri
e navegar por uma rota ou link direto (938a0c, b/193805425). - Um problema no Navigation Compose, em que
uma
NavBackStackEntry
de link direto não alcançava o estadoRESUMED
(retomado) foi corrigido (I192c5). - Foi corrigido um problema em que mostrar um destino de caixa de diálogo não atualizava o processamento do botão "Voltar" do NavController do sistema, possivelmente fazendo com que o NavController interceptasse o botão, mesmo que ele não tivesse nenhuma backstack para mostrar (aosp/1782668).
Versão 2.4.0-alpha05
21 de julho de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha05
. A versão 2.4.0-alpha05 contém estas confirmações.
Mudanças de comportamento
- O
NavHost
do Navigation Compose agora sempre usa Crossfades ao navegar por destinos (I07049, b/172112072). - Agora é possível fazer mudanças no gráfico de um NavHost. Gráficos
com o mesmo startDestination e destinos no gráfico vão ser considerados
iguais e não apagarão o backstack de
NavController
(I0b8db, b/175392262).
Correções de bugs
- Correção de uma
NoSuchElementException
ao chamarpopBackStack()
de dentro de umLifecycleObserver
anexado a umaNavBackStackEntry
causada por atualizações reentrantes ao estado do NavController (I64621). - O
AbstractListDetailFragment
agora permite que oSlidingPaneLayout
seja completamente removido do seu APK quando oAbstractListDetailFragment
não for usado (I611ad). - O
NavGraph
e oNavDestination
agora substituem o método equals para que dois objetos com os mesmos valores sejam considerados iguais (I166eb, b/175392262).
Versão 2.4.0-alpha04
1º de julho de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha04
. A versão 2.4.0-alpha04 contém essas confirmações.
Novos recursos
- O artefato
navigation-fragment
agora contém uma implementação pré-criada de um layout de dois painéis pelo novoAbstractListDetailFragment
. Esse fragmento usa umSlidingPaneLayout
para gerenciar um painel de lista (que a subclasse fornece) e um painel de detalhes, que usa umNavHostFragment
como implementação, conforme mostrado no nosso exemplo de implementação (Iac4be, b/191276636). - O
NavHost
do artefatonavigation-compose
agora é compatível com destinosdialog
, além decomposable
. Esses destinos de caixas de diálogo serão exibidos dentro de umaDialog
de composição, flutuando acima do destinocomposable
atual (I011d0).
val navController = rememberNavController()
Scaffold { innerPadding ->
NavHost(navController, "home", Modifier.padding(innerPadding)) {
composable("home") {
// This content fills the area provided to the NavHost
HomeScreen()
}
dialog("detail_dialog") {
// This content will be automatically added to a Dialog() composable
// and appear above the HomeScreen or other composable destinations
DetailDialogContent()
}
}
}
Mudanças na API
- A função
add
emNavigatorState
foi renomeada comopush
. Todas as chamadas atuais paraadd()
precisarão ser mudadas para push() (Ie89fc, b/172112072). - As instâncias
Navigator
personalizadas agora podem usar as APIspushWithTransaction
epopWithTransition
emNavigatorState
para enviar ou inserir um destino de forma assíncrona. Observe que essas APIs ainda não são usadas por nenhum dos navegadores incluídos (Ic4d7c, b/172112072).
Mudanças de comportamento
- O
NavDeepLinkBuilder
agora adicionaPendingIntent.FLAG_IMMUTABLE
àPendingIntent
retornada porcreatePendingIntent()
, garantindo que essa API funcione conforme esperado quando destinada ao Android 12 (If8c52).
Correções de bugs
- Correção de um problema com
<include-dynamic>
em que os argumentos passados para o gráfico não eram transmitidos corretamente para o gráfico incluído dinamicamente (I3e115). - Correção de uma
NullPointerException
ao navegar para um destino usando um argumentostring[]
com um valor padrão de@null
(I1fbe8). - Adição de regras do ProGuard para
@Navigator.Name
, corrigindo problemas ao usar o modo completo R8 3.1 (I2add9, b/191654433). - O SafeArgs não falhará mais ao criar seu app com versões de
Kotlin
antes de1.5.0
(Icd1ff, b/190739257).
Versão 2.4.0-alpha03
16 de junho de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha03
. A versão 2.4.0-alpha03 contém estas confirmações.
Correções de bugs
- Correção de um problema em que duas chamadas
navigate()
eram necessárias para navegar até um gráfico dinâmico incluído (I7785c, b/188859835). - Foi corrigida uma regressão introduzida no
Navigation
2.4.0-alpha01
, em quesetupActionBarWithNavController()
não removia corretamente o ícone "Para cima" quando em um destino de nível superior (I5d443, b/189868637). - Correção de um
IllegalStateException
ao chamarpopBackStack()
após destacar anteriormente o gráfico raiz do NavController (I2a330, b/190265699). - As regras do ProGuard para
by navArgs()
agora são aplicadas corretamente ao usarnavigation-common
ou quaisquer artefatos que dependam dele (I68800, b/190082521). - Um
OnDestinationChangedListener
que chamanavigate()
na primeira vez que recebe um callback agora recebe corretamente um segundo callback com o destino para o qual ele navegou (Ie5f9e, b/190228815). - O Safe Args não falha mais ao ser usado com módulos de recursos dinâmicos e o AGP 7.0+ (I69518, b/189966576).
Problema conhecido
- O Safe Args falhará com um erro
Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’
ao usar o Gradle6.7.0
devido a uma dependência em uma versão mais antiga do Kotlin. Para resolver isso, atualize para usar o Gradle 7.0 (b/190739257).
Versão 2.4.0-alpha02
2 de junho de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha02
. A versão 2.4.0-alpha02 contém estas confirmações.
Novos recursos
- O Routes agora oferece suporte a destinos de atividade, fragmento e caixa de diálogo, assim como em toda a DSL DynamicNavigation do Kotlin (Ib5544, Ia617b, I22f96, b/188914648, b/188901565).
- A
NavigationUI
adicionou temporariamente APIs experimentais para permitir a desativação da opção de salvar seu estado. Embora salvar o estado seja o comportamento correto, algumas bibliotecas descontinuadas sendo usadas (por exemplo, fragmentos retidos) não têm suporte para o salvamento do estado. Isso dá aos apps a oportunidade de fazer lentamente a conversão e deixar de usar APIs sem suporte (Idf93c). A navegação agora fornece APIs
findDestination()
egetHierarchy()
que podem ser usadas para ajudar a implementar a NavigationUI personalizada. AfindDestination()
é uma função de extensão noNavGraph
que localizará um destino no gráfico. AgetHierarchy()
é uma função noNavDestination
que pode ser usada para verificar se um determinado destino está na hierarquia de outro (I2932f, b/188183365).val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
Os métodos da NavigationUI que usavam um
BottomNavigationView
foram atualizados para usar a superclasse introduzida no Material1.4.0
,NavigationBarView
. Isso permite que esses métodos sejam usados comNavigationRailView
(Ib0b36, b/182938895).Ao inflar um elemento
<action>
via XML, os atributos de animação podem usar atributos extraídos do tema usando a sintaxeapp:enterAnim="?attr/transitionEnter"
(I07bc1, b/178291654).
Mudanças na API
- Os builders DSL do Kotlin que usam um ID foram descontinuados e precisa ser substituído por builders que usam rotas (I85b42, b/188816479). (I9f58f, b/188816479).
Correções de bugs
DialogFragmentNavigator
agora usa a APINavigatorState.pop()
para informar aoNavController
quando uma caixa de diálogo é dispensada pressionando o botão "Voltar" do sistema ou clicando fora dela. Isso garante que o estado doNavController
vai estar sempre sincronizado com o estado do Navigator (I2ead9).A navegação não fornece mais uma
ConcurrentModificationException
ao usar a manipulação da lista deOnDestinationChangedListeners
com um callbackonDestinationChanged
(Ib1707, b/188860458).O Safe Args não apresenta mais falhas ao tentar gerar propriedades de direção no Kotlin (Id2416, b/188564435).
O método setId em NavDestination agora está devidamente anotado com
@IdRes
, então ele aceita apenas IDs de recursos (I69b80).O parâmetro int de
findNode
agora éresId
em vez deresid
(I7711d).
Atualização de dependências
- O Safe Args agora depende do Plug-in do Android para Gradle 4.2.0. Isso significa que você não vai receber mais o aviso sobre o uso do
applicationIdTextResource
(I6d67b, b/172824579).
Versão 2.4.0-alpha01
18 de maio de 2021
Lançamento de androidx.navigation:navigation-*:2.4.0-alpha01
. A versão 2.4.0-alpha01 contém estas confirmações.
Novos recursos
- O método
currentBackStackEntryAsFlow()
noNavController
fornece umFlow
que é emitido sempre que aNavBackStackEntry
atual muda. Esse fluxo pode ser usado como uma alternativa ao gerenciamento manual de umOnDestinationChangedListener
(I19c4a, #89, b/163947280).
Várias backstacks
O NavController é responsável por gerenciar a backstack dos destinos, adicionando destinos a ela quando o método navigate()
navega até eles e os removendo ao chamar popBackStack()
ou acionar o botão "Voltar" do sistema. A classe NavOptions
existente e a integração com entradas <action>
no XML dos gráficos de navegação foram expandidas para oferecer suporte ao salvamento e à restauração da backstack (b/80029773).
Como parte dessa mudança, os métodos NavigationUI
de onNavDestinationSelected()
, BottomNavigationView.setupWithNavController()
e NavigationView.setupWithNavController()
agora salvam e restauram automaticamente o estado dos destinos removidos, permitindo o suporte a várias backstacks sem mudanças no código. Ao usar a navegação com fragmentos, essa é a forma recomendada para integrar várias backstacks (Ie07ca).
As APIs de base para salvar e restaurar o estado são expostas por várias superfícies:
No XML de navegação, o elemento
<action>
agora pode usar os atributos booleanos deapp:popUpToSaveState
eapp:restoreState
para salvar o estado de quaisquer destinos removidos usandoapp:popUpTo
e restaurar o estado associado ao destino transmitido como oapp:destination
:<action android:id=”@+id/swap_stack” app:destination=”@id/second_stack” app:restoreState=”true” app:popUpTo=”@id/first_stack_start_destination” app:popUpToSaveState=”true” />
Nas
navOptions
da DSL do Kotlin, é possível adicionar as propriedades booleanasrestoreState
esaveState
no builderpopUpTo
:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.startDestinationId) { saveState = true } }
Ao criar manualmente um objeto
NavOptions
usando oNavOptions.Builder
, é possível usarsetRestoreState()
e a nova sobrecarga parasetPopUpTo()
que recebe um parâmetrosaveState
extra.NavOptions navOptions = new NavOptions.Builder() .setLaunchSingleTop(true) .setRestoreState(true) .setPopUpTo(navController.getGraph().getStartDestinationId(), false, // inclusive true) // saveState .build(); navController.navigate(selectedBottomNavId, null, navOptions);
As chamadas programáticas para
popBackStack()
agora podem incluir um parâmetrosaveState
extra.
Em todos os casos, o NavController
salva e restaura o estado de cada NavBackStackEntry
, incluindo qualquer instância de destino ViewModel
com escopo. As APIs Navigator
foram atualizadas para permitir que cada Navigator
aceite o salvamento e a restauração do próprio estado.
O ComposeNavigator
usado para destinos composable
no Navigation Compose e os FragmentNavigator
e DynamicFragmentNavigator
usados para destinos <fragment>
no Navigation com fragmentos foram atualizados para usar as novas APIs Navigator e oferecer suporte ao salvamento e à restauração do estado.
Rotas de navegação
Uma rota é uma String
que identifica um destino exclusivamente. Embora fosse usado anteriormente apenas no Navigation Compose, esse conceito passou a ser parte das principais APIs Navigation. Isso fornece uma alternativa ao uso de IDs de números inteiros ao criar seu gráfico usando a DSL de navegação do Kotlin (b/172823546).
Todas as APIs que recebiam apenas um ID agora têm uma sobrecarga que usa uma String
de rota. Isso inclui navigate()
, popBackStack()
, popUpTo()
e getBackStackEntry()
.
Isso teve algumas implicações na API:
- A propriedade
popUpTo
na DSL do Kotlin foi descontinuada e substituída porpopUpToId
(I59c73, b/172823546). - A API
getStartDestination()
foi descontinuada e substituída porgetStartDestinationId()
(I0887f, b/172823546).
Para desenvolvedores que fizeram upgrade de versões anteriores do Navigation Compose para o Navigation Compose 2.4.0-alpha01
, isso significa que as importações de métodos de extensão a seguir não são mais necessárias e precisam ser removidas:
import androidx.navigation.compose.navigation
import androidx.navigation.compose.createGraph
import androidx.navigation.compose.getBackStackEntry
import androidx.navigation.compose.navigate
import androidx.navigation.compose.popUpTo
O argumento KEY_ROUTE
foi substituído pela propriedade route
em NavDestination
, permitindo que você chame navBackStackEntry.destination.route
diretamente.
Mudanças na API
- Todos os artefatos de navegação foram reescritos em Kotlin. Isso melhorou a nulidade de classes usando a generalização (como subclasses
NavType
). Todas as funções de extensão do Kotlin que costumavam fazer parte dos artefatos-ktx
foram movidas para os respectivos artefatos principais. Os artefatos-ktx
vão continuar sendo publicados, mas estão completamente vazios (b/184292145). - Agora, o
NavDeepLinkBuilder
é compatível com a adição de vários destinos distintos à backstack gerada (I3ee0d, b/147913689). - Funções de fábrica para
DynamicNavHostFragment
foram adicionadas (Icd515, b/175222619). - O ID exclusivo de uma
NavBackStackEntry
agora é exposto como parte da API pública dela (Ie033a). - Os campos
name
eargument
e as funções de desestruturação deNamedNavArgument
agora são públicos (#174 (link em inglês), b/181320559). - Uma nova extensão
NavBackStackEntry#provideToCompositionLocals
que fornece oNavBackStackEntry
para os locais de composição relevantes foi adicionada (#175 (link em inglês), b/187229439).
Safe Args
O Safe Args agora gera um método
fromSavedStateHandle()
para cada classeNavArgs
(#122 (link em inglês), b/136967621).class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() { // Create a HomeDestinationArgs class with type safe accessors for each argument // defined on your destination private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle) }
O Safe Args foi atualizado para usar o KotlinPoet
1.8.0
(#172 (link em inglês), b/183990444).
Mudanças de comportamento
- O Navigation agora depende do
Lifecycle
2.3.1
e marcasetGraph()
,popBackStack()
,navigateUp()
enavigate()
como os métodos que atualizam oLifecycle
daNavBackStackEntry
, como@MainThread
, alinhando o componente de navegação à aplicação da linha de execução principal introduzida no Lifecycle2.3.0
(b/171125856). - A análise de argumentos de enumeração de links diretos agora é indiferente a maiúsculas. Isso permite que um link direto, como
http://www.example.com/red
, corresponda a um link diretowww.example.com/{color}
mesmo quando a enumeração tiver o valorRED
(#152 (link em inglês), b/135857840).
Compatibilidade do Compose
androidx.navigation:navigation-compose:2.4.0-alpha01
só é compatível com a versão1.0.0-beta07
do Compose e mais recentes.
Correções de bugs
- Correção de um problema em que marcadores de argumentos à direita tinham prioridade sobre links diretos que tinham um sufixo exato correspondente (#153 (link em inglês), b/184072811).
NavHostFragment
agora oferece suporte a navegadores personalizados que usam o mesmo@Navigator.Name("dialog")
doDialogFragmentNavigator
padrão (Ib1c2c, b/175979140).- Melhoria no comportamento de
NavigatorProvider#addNavigator
para garantir que chamá-lo repetidamente com a mesma instância não cause problemas (#176 (link em inglês), b/187443146).
Contribuições externas
- Agradecemos a simonschiller (em inglês) pela criação do suporte ao Safe Args, gerando um método
fromSavedStateHandle()
para cada classeNavArgs
(#122 (link em inglês), b/136967621). - Agradecemos a Bradleycorn (em inglês) por tornar a análise de argumentos de tipo enumerado de links diretos indiferente a maiúsculas (#152 (link em inglês), b/135857840).
- Agradecemos a osipxd (link em inglês) por corrigir um problema em que os marcadores de argumentos à direita tinham precedência sobre links diretos com um sufixo exato correspondente (#153 (link em inglês), b/184072811).
- Agradecemos a tatocaster (link em inglês) por atualizar o Safe Args para depender do KotlinPoet
1.8.0
(#172 (link em inglês), b/183990444). - Agradecemos a jossiwolf (em inglês) por tornar os campos
name
eargument
e as funções de desestruturação doNamedNavArgument
públicos (#174 (link em inglês), b/181320559). - Agradecemos a jossiwolf (link em inglês) por apresentar uma nova extensão
NavBackStackEntry#provideToCompositionLocals
que fornece aNavBackStackEntry
aos locais de composição relevantes (#175 (link em inglês), b/187229439). - Agradecemos a jossiwolf (em inglês) por melhorar o comportamento do
NavigatorProvider#addNavigator
, garantindo que chamá-lo repetidamente com a mesma instância não cause problemas (#176 (link em inglês), b/187443146).
Navigation Compose versão 1.0.0
Versão 1.0.0-alpha10
7 de abril de 2021
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha10
. A versão 1.0.0-alpha10 contém estas confirmações.
Mudanças na API
NavHost
agora aceita umModifier
, que é transmitido para o contêiner combinável que encapsula os elementos combináveis de destino (I85aca, b/175125483).
Correções de bugs
NavHost
agora funciona mesmo quando umOnBackPressedDispatcherOwner
não é encontrado, por exemplo, ao visualizar oNavHost
(I7d8b4).- O Navigation Compose agora depende do Navigation
2.3.5
, corrigindo um problema ao usarBackHandler
dentro de um destinoNavHost
(I7e63b, b/182284739).
Versão 1.0.0-alpha09
10 de Março de 2021
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha09
. A versão 1.0.0-alpha09 contém estas confirmações.
Mudanças na API
LocalViewModelStoreOwner.current
agora retorna umViewModelStoreOwner
anulável para determinar melhor se umViewModelStoreOwner
está disponível na composição atual. As APIs que exigem umViewModelStoreOwner
, comoviewModel()
eNavHost
, ainda geram uma exceção se umViewModelStoreOwner
não está definido (Idf39a).
Correções de bugs
- O Navigation Compose agora depende do Navigation 2.3.4, que inclui a correção para tentar definir o mesmo objeto do ViewModelStore depois que o gráfico foi definido (I65c24, b/177825470).
Versão 1.0.0-alpha08
24 de fevereiro de 2021
Lançamento do androidx.navigation:navigation-compose:1.0.0-alpha08
. A versão 1.0.0-alpha08 contém estas confirmações.
Novos recursos
NavHost
agora preenche o CompositionLocal doLocalSavedStateRegistryOwner
com aNavBackStackEntry
desse destino, garantindo que todos os estados salvos diretamente noSavedStateRegistry
serão salvos e restaurados com o destino (I435d7, b/179469431).
Versão 1.0.0-alpha07
10 de fevereiro de 2021
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha07
. A versão 1.0.0-alpha07 contém estas confirmações.
Atualizações de dependência
- O Navigation Compose depende do Lifecycle ViewModel Compose 1.0.0-alpha01 para oferecer compatibilidade com
viewModel()
a destinoscomposable
(I7a374). NavHost
agora usa o novoLocalOnBackPressedDispatcherOwner
do Activity-Compose 1.3.0-alpha01 para acessar oOnBackPressedDispatcher
definido noNavController
(I65b12).
Versão 1.0.0-alpha06
28 de janeiro de 2021
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha06
. A versão 1.0.0-alpha06 contém estas confirmações.
Mudanças na API
- Adição de um método de extensão
getBackStackEntry(route: String)
emNavController
que retorna aNavBackStackEntry
associada (If8931).
Versão 1.0.0-alpha05
13 de janeiro de 2021
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha05
. A versão 1.0.0-alpha05 contém estas confirmações.
Atualizada para depender do Compose 1.0.0-alpha10.
Versão 1.0.0-alpha04
16 de dezembro de 2020
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha04
. A versão 1.0.0-alpha04 contém estas confirmações.
- Atualizada para compatibilidade com o Compose
1.0.0-alpha09
.
Versão 1.0.0-alpha03
2 de dezembro de 2020
Lançamento de androidx.navigation:navigation-compose:1.0.0-alpha03
. A versão 1.0.0-alpha03 contém estas confirmações.
Correções de bugs
- Correção de um problema em que
popBackStack()
enavigateUp()
não funcionavam após uma mudança de configuração ou da interrupção e recriação de um processo (Icea47, b/173281473). - A navegação até um gráfico aninhado no NavHost agora funciona corretamente (I0948d, b/173647694).
Versão 1.0.0-alpha02
11 de novembro de 2020
androidx.navigation:navigation-compose:1.0.0-alpha02
é lançado. A versão 1.0.0-alpha02 contém estas confirmações.
Mudanças na API
- O Navigation Compose agora oferece suporte ao NavOptions para uso de operações popUpTo e launchSingleTop (If96c3, b/171468994).
- Adição de uma função de navegação que usa uma rota em vez de um ID, permitindo construir gráficos aninhados na DSL do Navegation Compose (I1661d).
- startDestination agora vem antes da rota na lista de parâmetros para um NavHost (Ie620e).
- Agora, você pode criar um gráfico usando a rota como um destino inicial fora de um elemento combinável do NavHost (Iceb75).
Versão 1.0.0-alpha01
28 de outubro de 2020
android.navigation:navigation-compose:1.0.0-alpha01
é lançado. A versão 1.0.0-alpha01 contém estas confirmações.
Novos recursos
O artefato navigation-compose
fornece integração entre o componente de navegação e o Jetpack Compose. Ele usa funções @Composable
como destinos no aplicativo.
Esta versão inicial oferece:
- Um elemento
NavHost
combinável que permite construir seu gráfico de navegação por uma DSL do Kotlin. - Escopo do ciclo de vida,
ViewModel
, e estado memorizado no nível de destino. - Integração automática com o botão "Voltar" do sistema.
- Suporte à transmissão de argumentos, anexação de links diretos para destinos e retorno de um resultado para destinos anteriores.
- Auxiliares específicos do Compose em
rememberNavController()
ecurrentBackStackEntryAsState()
para permitir a elevação do estado e conectarNavController
a elementos combináveis fora doNavHost
, como uma barra de navegação inferior.
Consulte o guia de navegação do Compose para ver mais informações.
Versão 2.3.5
Versão 2.3.5
7 de abril de 2021
Lançamento de androidx.navigation:navigation-*:2.3.5
. A versão 2.3.5 contém estas confirmações.
Novos recursos
- Ao navegar usando um
NavDeepLinkRequest
ouUri
, agora é possível acessar oUri
, a ação e o tipo MIME no destino resultante, conseguindo a intent dos argumentos pelaKEY_DEEP_LINK_INTENT
, espelhando a funcionalidade já disponível para links diretos externos (I975c3, b/181521877).
Correções de bugs
OnBackPressedCallbacks
foi adicionado a um agente com aNavBackStackEntry
agora que o LifecycleOwner intercepta pressionamentos para voltar de forma correta após o ciclo de vida da atividade serSTOPPED
e depoisSTARTED
(Iff94f, b/182284739).- Agora, a análise de domínio de link direto não diferencia maiúsculas de minúsculas, garantindo que
www.example.com
corresponda awww.example.com
ewww.Example.com
. Os nomes dos parâmetros de consulta ainda diferenciam maiúsculas de minúsculas (#144, b/153829033). - Correção de uma
NullPointerException
que podia ocorrer quando um destino tem vários argumentos padrão não anuláveis e você navega até esse destino modificando apenas um subconjunto desses argumentos (aosp/1644827).
Atualizações de dependência
- O plug-in do Gradle do Navigation Safe Args agora depende do plug-in do Gradle do Kotlin 1.4.31 (aosp/1661058, b/181156413).
Contribuição externa
- Agradecemos a
bentrengrove
(em inglês) pela solicitação de envio que tornou a análise de domínios de link direto indiferente a maiúsculas (#144, b/153829033).
Versão 2.3.4
Versão 2.3.4
10 de Março de 2021
Lançamento de androidx.navigation:navigation-*:2.3.4
. A versão 2.3.4 contém estas confirmações.
Novos recursos
- Os argumentos
ReferenceType
agora podem ser analisados corretamente quando enviados como parte de um URI de link direto. Eles oferecem suporte ao valor inteiro bruto e aos valores hexadecimais prefixados por0x
(#127 em inglês, b/179166693). - O
android:defaultValue
para um argumento comapp:argType="float"
agora oferece suporte a valores padrão inteiros, permitindo que você useandroid:defaultValue="0"
em vez de exigir o uso de0.0
(#117 em inglês, b/173766247).
Correções de bugs
- Foi corrigido o travamento do progresso de instalação ao usar a compatibilidade do Navigation para recursos dinâmicos (Ib27a7, b/169636207).
- Chamar
setViewModelStore
ousetLifecycleOwner
com o mesmo objeto que já foi definido resulta em um ambiente autônomo (Idf491, b/177825470). - O Safe-Args agora adiciona anotações de supressão nos métodos adequados ao usar Java (I8fbc5, b/179463137).
Contribuições externas
- Agradecemos a
JvmName
(link em inglês) pela solicitação de envio para garantir que os argumentosReferenceType
agora possam ser analisados corretamente quando enviados como parte de um URI de link direto (#127 em inglês, b/179166693). - Agradecemos a
tatocaster
(em inglês) pela solicitação de envio para permitir o suporte a valores padrão para odefaultValue
de um argumento comapp:argType=”float”
(#117 em inglês, b/173766247).
Versão 2.3.3
Versão 2.3.3
27 de janeiro de 2021
Lançamento de androidx.navigation:navigation-*:2.3.3
. A versão 2.3.3 contém estas confirmações.
Correções de bugs
- Não há mais uma falha ao exibir uma
NavBackStackEntry
antes que oLifecycle
dela seja mudado paraCREATED
(Ie3ba3). - Correção da regressão causada por b/171364502, em que a navegação para uma
atividade com um valor de recurso de animação de
0
causava umaResourceNotFoundException
(I7aedb, b/176819931).
Versão 2.3.2
Versão 2.3.2
2 de dezembro de 2020
Lançamento de androidx.navigation:navigation-*:2.3.2
. A versão 2.3.2 contém estas confirmações.
Correções de bugs
- Correção de uma regressão na
NavigationUI
, em que o uso de um destino<activity>
comonNavDestinationSelected
falhava ao navegar para a Activity (I22e34, b/171364502). - Correção de um problema em que o
navigation-dynamic-features-fragment
resultava na navegação para o destino recém-instalado várias vezes (aosp/1486056, b/169636207). - Correção de um problema em que os argumentos padrão não eram enviados para instâncias de
OnDestinationChangedListener
ao usarlaunchSingleTop
(I2c5cb). - Correção de um problema em que a navegação para um gráfico de navegação aninhado não criava uma nova instância de gráfico na pilha de retorno (Ifc831).
- Correção de um problema em que o uso de
navigate()
com umpopUpTo
que removia o último destino em um gráfico de navegação não destruiria nem removeria imediatamente o gráfico de navegação da backstack (I910a3). - O SafeArgs do Navigation agora usa o KotlinPoet versão 1.7.2, que adiciona suporte ao modo explícito de API do Kotlin (I918b5).
- O
NavHostFragment.findNavController(Fragment)
agora também verifica a visualização de decoração raiz de um DialogFragment, além das verificações existentes da hierarquia do Fragment e da hierarquia de visualização do Fragment. Isso permite que você teste fragmentos de caixas de diálogo que usam o Navigation comFragmentScenario
eNavigation.setViewNavController()
(I69e0d).
Versão 2.3.1
Versão 2.3.1
14 de outubro de 2020
androidx.navigation:navigation-*:2.3.1
é lançado. A versão 2.3.1 contém estas confirmações.
Novos recursos
- Recursos padrão do Animator foram adicionados à IU do Navigation e são recomendados no lugar dos recursos de animação padrão (b/167430145).
- Agora, NavOptions substitui o hashcode e os métodos equals (b/161586466).
- Agora, o Navigation inclui o destino atual na IllegalArgumentException "Não há destinos com o ID", o que deve melhorar a experiência de depuração do desenvolvedor (b/168311416).
Correções de bugs
- O Safe Args não une mais a linha de retorno, mesmo se o nome da classe do argumento gerado tiver mais de 100 caracteres (b/168584987).
Mudanças na dependência
navigation-ui
agora depende do DrawerLayout 1.1.1, garantindo que aNavigationUI
é capaz de abrir a gaveta mesmo quando usarLOCK_MODE_LOCKED_CLOSED
ouLOCK_MODE_LOCKED_OPEN
(b/162253907).- O Safe Args agora depende do KotlinPoet 1.6.0. (aosp/1435911).
- O Safe Args agora depende do AGP 4.0.1 (aosp/1442337).
Versão 2.3.0
Versão 2.3.0
24 de junho de 2020
androidx.navigation:navigation-*:2.3.0
é lançado. A versão 2.3.0 contém estas confirmações.
Principais mudanças desde a versão 2.2.0
- Integração do módulo de recursos: os artefatos
navigation-dynamic-features-runtime
enavigation-dynamic-features-fragment
permitem navegar para destinos definidos em módulos de recursos, gerenciando automaticamente a instalação conforme necessário. Consulte Navegar com módulos de recursos para ver mais informações. - Testes de navegação: o artefato
navigation-testing
fornece umTestNavHostController
que permite definir o destino atual e verificar o backstack após as operações de navegação. Consulte Testar a navegação para ver mais informações. - Retornar um resultado: o
NavBackStackEntry
associado a cada destino no backstack do Navigation agora permite que você acesse umSavedStateHandle
adequado para armazenar pequenas quantidades de estado salvo que precisa ser associado a uma entrada específica do backstack. Consulte Retornar um resultado ao destino anterior para ver mais informações. - Suporte de
NavigationUI
aOpenable
: todos os usos deDrawerLayout
emNavigationUI
foram substituídos pela interfaceOpenable
mais genérica adicionada em CustomView1.1.0
e implementada porDrawerLayout
em DrawerLayout1.1.0
. - Suporte à ação e ao Tipo MIME em links diretos: houve a expansão dos links diretos para oferecer suporte a
app:action
eapp:mimeType
, além doapp:uri
disponível anteriormente.NavController
agora oferece suporte à navegação por qualquer combinação desses campos graças à nova classeNavDeepLinkRequest
. Consulte Navegar usando NavDgleLinkRequest para ver mais informações.
Problemas conhecidos
- O suporte a ações de link direto e tipos MIME ainda não está disponível no Manifest Merger. Até que esse trabalho seja concluído, os elementos
<intent-filter>
gerados a partir do elemento<nav-graph>
no manifesto não vão incluir o tipo MIME no elemento<data>
ou na sua<action>
personalizada. Adicione manualmente ao manifesto um<intent-filter>
apropriado.
Versão 2.3.0-rc01
10 de junho de 2020
androidx.navigation:navigation-*:2.3.0-rc01
é lançado. A versão 2.3.0-rc01 contém estas confirmações.
Correções de bugs
- Foi corrigido um
NullPointerException
ao substituir uma instância de um destino sem argumentos por outra instância com argumentos comsingleTop
(b/158006669). - Todas as exceções
destination is unknown
geradas porNavController
agora têm mais informações de depuração para ajudar a determinar o estado doNavController
(b/157764916)
Versão 2.3.0-beta01
20 de maio de 2020
Lançamento de androidx.navigation:navigation-*:2.3.0-beta01
. A versão 2.3.0-beta01 contém estas confirmações.
Correções de bugs
- Foi corrigido um problema em que o
Lifecycle
doNavBackStackEntry
não era atualizado corretamente após a interrupção do processo (b/155218371). - As instâncias
OnDestinationChangedListener
registradas antes de chamarsetGraph()
agora recebem o destino restaurado corretamente após a interrupção do processo (b/155218371). - Ao usar
singleTop
, oNavBackStackEntry
agora tem os argumentos atualizados corretamente e enviados para todas as instâncias deOnDestinationChangeListener
(b/156545508).
Atualizações de dependência
- O artefato
NavigationUI
agora depende de CustomView1.1.0-rc01
e DrawerLayout1.1.0-rc01
(aosp/1309696).
Versão 2.3.0-alpha06
29 de abril de 2020
androidx.navigation:navigation-*:2.3.0-alpha06
é lançado. A versão 2.3.0-alpha06 contém estas confirmações.
Novos recursos
- Os links diretos foram expandidos para serem compatíveis com
app:action
eapp:mimeType
, além doapp:uri
disponível anteriormente. O NavController agora oferece suporte a navegação por qualquer combinação desses campos pela nova classeNavDeepLinkRequest
(b/136573074, b/135334841).
Mudanças na API
- Ampliamos o suporte a DSL do Kotlin para destinos Dynamic Navigation (b/148969800)
Correções de bugs
- Foi corrigido um problema em que as intents de link direto eram ignoradas ao usar um destino inicial aninhado (b/154532067).
Versão 2.3.0-alpha05
15 de abril de 2020
androidx.navigation:navigation-*:2.3.0-alpha05
é lançado. A versão 2.3.0-alpha05 contém estas confirmações.
Novos recursos
- Para gráficos dinâmicos incluídos usando
<include-dynamic>
, você não precisa mais especificarapp:graphPackage
, e um padrão vai ser usado adicionando o sufixomoduleName
aoapplicationId
após um ponto. Se você precisa personalizar seugraphPackage
, agora há suporte a um marcador${applicationId}
(b/152696768). - Agora, a DSL Kotlin de Navigation Graph expõe um
Map
defaultArguments
para ações, espelhando a capacidade de definir valores padrão em elementos<action>
em arquivos XML de Navigation (b/150345605, link em inglês)
Correções de bugs
- No Navigation 2.2.2: correção de uma
IllegalStateException
quando há links diretos para o destino inicial do seu gráfico com várias instânciasNavHostFragment
na sua Activity (b/147378752, link em inglês)
Atualizações de dependência
- O Navigation agora depende do Fragment
1.2.4
(aosp/1277325). - Dynamic Navigation agora depende do Play Core
1.7.2
(aosp/1282257).
Versão 2.3.0-alpha04
18 de março de 2020
androidx.navigation:navigation-*:2.3.0-alpha04
é lançado. A versão 2.3.0-alpha04 contém estas confirmações.
Novos recursos
- Foi adicionado suporte a atividades de módulo de recursos e destinos de fragmento na DSL Kotlin de navegação (b/148969800)
Mudanças na API
- Agora, a classe
DynamicExtras
não usa mais um padrão de construtor e pode ser construída diretamente (aosp/1253671). DynamicActivityNavigator
agora usa umContext
no construtor em vez de umaActivity
(aosp/1250252).
Correções de bugs
NavigationUI
não ignora mais rótulos vazios (ou seja, um destino comandroid:label=””
) e agora define corretamente o título como uma string vazia (b/148679860).
Atualizações de dependência
- Os artefatos Navigation Dynamic Features agora dependem do Play Core
1.6.5
(b/149556401).
Versão 2.3.0-alpha03
4 de março de 2020
androidx.navigation:navigation-*:2.3.0-alpha03
é lançado. A versão 2.3.0-alpha03 contém estas confirmações.
Mudanças na API
- Em vez de confiar na classe concreta
DrawerLayout
,AppBarConfiguration
agora usa a interfaceOpenable
introduzida em CustomView1.1.0-alpha02
, queDrawerLayout
implementa usando o DrawerLayout1.1.0-alpha04
, permitindo que você use implementações personalizadas deOpenable
comNavigationUI
(b/129030452).
Correções de bugs
- As regras
navigation-common-ktx
do ProGuard agora mantêm corretamente apenas as classesNavArgs
que são usadas, em vez de todas as instânciasNavArgs
(b/150213558).
Mudanças na dependência
- O Navigation reverteu a dependência no Core
1.2.0
e agora depende do Core1.1.0
para evitar forçar que os desenvolvedores migrem para uma dependência mais recente quando o Navigation não depender de novas APIs no Core1.2.0
.
Versão 2.3.0-alpha02
19 de fevereiro de 2020
androidx.navigation:navigation-*:2.3.0-alpha02
é lançado. A versão 2.3.0-alpha02 contém estas confirmações.
Novos recursos
NavBackStackEntry
agora permite que você acesse umSavedStateHandle
adequado para armazenar pequenas quantidades de estados salvos que precisam ser associados a uma entrada de pilha de retorno específica. Consulte Como retornar um resultado para ver um exemplo de caso de uso. (b/79672220).
Mudanças na API
- Os métodos de conveniência de
getCurrentBackStackEntry()
egetPreviousBackStackEntry()
foram adicionados para facilitar a recuperação de umNavBackStackEntry
para os destinos atuais e anteriores (b/79672220).
Correções de bugs
navigateUp()
agora transmite os argumentos do destino atual eKEY_DEEP_LINK_INTENT
para o destino anterior ao iniciar o app na sua pilha de tarefas (b/147456890).
Mudanças na dependência
- O Navigation agora depende do Core
1.2.0
.
Versão 2.3.0-alpha01
5 de fevereiro de 2020
androidx.navigation:navigation-*:2.3.0-alpha01
é lançado. A versão 2.3.0-alpha01 contém estas confirmações.
Novos recursos
- O novo artefato
navigation-testing
fornece uma classeTestNavHostController
. Essa classe oferece uma alternativa ao uso de umNavController
simulado ao testar o Navigation, o que permite definir o destino atual e verificar a backstack após as operações de navegação (b/140884273). - O novo
navigation-dynamic-features-fragment
(e a dependência transitiva dele,navigation-dynamic-features-runtime
) permite que você inclua destinos ou gráficos de navegação inteiros (via<include-dynamic>
) de módulos de recursos, oferecendo uma instalação simples de módulos de recursos on demand ao navegar para esses destinos. Consulte Navegar com módulos de recursos para ver mais informações. (b/132170186)
Correções de bugs
- No Navigation
2.2.1
: links diretos sem parâmetros de consulta agora ignoram corretamente todos os parâmetros de consulta em vez de os anexar a elementos{argument}
no início ou no fim ou a elementos sem correspondência com o link direto (b/147447512). - No Navigation
2.2.1
: as regras do ProGuardnavigation-ui
paraDrawerArrowDrawable
foram atualizadas para garantir queandroid.enableJetifier=true
não seja obrigatório (b/147610424). - No Navigation
2.2.1
: o módulonavigation-common-ktx
agora tem um nome de pacote de manifesto exclusivo em vez do mesmo nome de pacote de manifesto quenavigation-runtime-ktx
(aosp/1141947).
Atualizações de dependência
- No Navigation
2.2.1
: a navegação2.2.1
agora depende do Lifecycle ViewModel SavedState2.2.0
e do Fragment1.2.1
.
Versão 2.2.2
Versão 2.2.2
15 de abril de 2020
Lançamento de androidx.navigation:navigation-*:2.2.2
. A versão 2.2.2 contém estas confirmações.
Correções de bugs
- Correção de
IllegalStateException
quando há links diretos para o destino inicial do seu gráfico com várias instânciasNavHostFragment
na sua Activity (b/147378752). NavigationUI
não ignora mais rótulos vazios (ou seja, um destino comandroid:label=””
) e agora define corretamente o título como uma string vazia Isso foi lançado anteriormente no Navigation 2.3.0-alpha04 (b/148679860).- As regras
navigation-common-ktx
do ProGuard agora mantêm corretamente apenas as classesNavArgs
que são usadas, em vez de todas as instânciasNavArgs
. Isso foi lançado anteriormente no Navigation 2.3.0-alpha03 (b/150213558, link em inglês)
Atualizações de dependência
- O Navigation agora depende do Fragment
1.2.4
(aosp/1277325).
Versão 2.2.1
Versão 2.2.1
5 de fevereiro de 2020
androidx.navigation:navigation-*:2.2.1
é lançado. A versão 2.2.1 contém estas confirmações.
Correções de bugs
- Agora, os links diretos sem parâmetros de consulta ignoram corretamente todos os parâmetros de consulta em vez de os anexar a elementos
{argument}
no início ou no fim ou elementos sem correspondência com o link direto (b/147447512). - As regras do ProGuard
navigation-ui
paraDrawerArrowDrawable
foram atualizadas para garantir que o uso deandroid.enableJetifier=true
não seja obrigatório (b/147610424). - O módulo
navigation-common-ktx
agora tem um nome de pacote de manifesto exclusivo em vez de compartilhar o mesmo nome de pacote de manifesto quenavigation-runtime-ktx
(aosp/1141947).
Atualizações de dependência
- O Navigation
2.2.1
agora depende do Lifecycle ViewModel SavedState2.2.0
e do Fragment1.2.1
.
Versão 2.2.0
Versão 2.2.0
22 de janeiro de 2020
androidx.navigation:navigation-*:2.2.0
é lançado. A versão 2.2.0 contém estas confirmações.
Mudanças importantes desde a versão 2.1.0
- NavBackStackEntry: agora você pode chamar
NavController.getBackStackEntry()
, passando o ID de um destino ou gráfico de navegação na pilha de retorno. ONavBackStackEntry
retornado fornece umLifecycleOwner
acionado pela navegação,ViewModelStoreOwner
(o mesmo retornado porNavController.getViewModelStoreOwner()
) eSavedStateRegistryOwner
, além de fornecer os argumentos usados para iniciar o destino. - Integração do Lifecycle ViewModel SavedState:
SavedStateViewModelFactory
agora é a fábrica padrão empregada ao usarby navGraphViewModels()
ou o construtorViewModelProvider
com umViewModelStoreOwner
retornado porNavController.getBackStackEntry()
ouNavController.getViewModelStoreOwner()
. - Suporte a links diretos com parâmetros de consulta: links diretos com parâmetros de consulta agora oferecem suporte aos parâmetros de consulta reordenados. Argumentos que têm um valor padrão ou são anuláveis agora são opcionais na correspondência de links diretos.
- Melhoria no suporte a animação:
NavHostFragment
agora usaFragmentContainerView
do Fragment 1.2.0, corrigindo problemas relacionados à ordem z de animações e a inserções de janelas enviadas para o Android Fragments.
Versão 2.2.0-rc04
18 de dezembro de 2019
androidx.navigation:navigation-*:2.2.0-rc04
é lançado. A versão 2.2.0-rc04 contém estas confirmações.
Correções de bugs
- Ajuste das animações de esmaecimento padrão usadas por
navigation-ui
para corresponder às animações de esmaecimento ajustadas no Fragment1.2.0-rc04
(b/145769814).
Versão 2.2.0-rc03
4 de dezembro de 2019
androidx.navigation:navigation-*:2.2.0-rc03
é lançado. A versão 2.2.0-rc03 contém estas confirmações.
Correções de bugs
- Foi corrigido um problema na análise de links diretos ao usar parâmetros de consulta e um argumento como a última parte do caminho, o que impedia que mais de um caractere do argumento de caminho final fosse analisado (b/144554689).
- Correção de um problema na análise de links diretos em que parâmetros opcionais recebem
"@null"
em vez denull
(b/141613546). NavHostFragment
agora restaura corretamente o gráfico após uma mudança de configuração quando usado comFragmentContainerView
(b/143752103).
Mudanças na dependência
- A navegação agora depende do Lifecycle
2.2.0-rc03
, do Lifecycle ViewModel SavedState1.0.0-rc03
, da Activity1.1.0-rc03
e do Fragment1.2.0-rc03
quando apropriado.
Versão 2.2.0-rc02
7 de novembro de 2019
androidx.navigation:navigation-*:2.2.0-rc02
é lançado. A versão 2.2.0-rc02 contém estas confirmações.
Mudanças na dependência
- A navegação agora depende do androidx.lifecycle
2.2.0-rc02
.
Versão 2.2.0-rc01
23 de outubro de 2019
androidx.navigation:navigation-*:2.2.0-rc01
é lançado sem mudanças desde 2.2.0-beta01
. A versão 2.2.0-rc01 contém estas confirmações.
Versão 2.2.0-beta01
9 de outubro de 2019
androidx.navigation:navigation-*:2.2.0-beta01
é lançado. A versão 2.2.0-beta01 contém estas confirmações.
Novos recursos
NavDestination
e as subclasses dele agora substituemtoString()
para fornecer informações mais úteis durante a depuração (b/141264986).
Mudanças de comportamento
- Parâmetros de consulta extra agora são ignorados ao fazer a correspondência com links diretos, em vez de fazer com que a correspondência falhe (b/141482822).
Correções de bugs
- Correção de um problema em que os argumentos no caminho de um link direto seriam ignorados se os parâmetros de consulta também fossem especificados (b/141505755).
- A extensão Kotlin
navArgs()
emActivity
agora tem uma mensagem de erro melhor quando não há extras (b/141408999). - As classes Java
Directions
geradas pelo Safe Args agora contêm valores padrão (b/141099045). - As classes Java
Args
geradas pelo Safe Args agora contêm valores padrão (b/140123727). - Ao usar um
Toolbar
,NavigationUI
não anima mais a alteração do texto ao se mover entre dois destinos de nível superior (b/140848160).
Versão 2.2.0-alpha03
18 de setembro de 2019
androidx.navigation:navigation-*:2.2.0-alpha03
é lançado. A versão 2.2.0-alpha03 contém estas confirmações.
Mudanças de comportamento
- Chamar
setViewModelStore()
depois de chamarsetGraph
agora resulta em umIllegalStateException
. Isso sempre tem que ser definido peloNavHost
como parte da configuração inicial para garantir que todas as instâncias deNavBackStackEntry
tenham um armazenamento consistente para instâncias deViewModel
(aosp/1111821).
Correções de bugs
- Correção de uma
ConcurrentModificationException
ao usar instâncias deViewModel
anexadas a várias instâncias deViewModelStore
com escopo no gráfico de navegação (aosp/1112257).
Versão 2.2.0-alpha02
5 de setembro de 2019
Lançamento de androidx.navigation:navigation-*:2.2.0-alpha02
. As confirmações incluídas nessa versão podem ser encontradas neste link.
Novos recursos
- Agora, os links diretos com parâmetros de consulta são compatíveis com os parâmetros de consulta reordenados. Argumentos que têm um valor padrão ou são anuláveis agora são opcionais na correspondência de links diretos (b/133273839).
- Agora você pode chamar
NavController.getBackStackEntry()
, passando o código de um destino ou gráfico de navegação na pilha de retorno. ANavBackStackEntry
retornada fornece umLifecycleOwner
acionado pelo Navigation,ViewModelStoreOwner
(o mesmo retornado porNavController.getViewModelStoreOwner()
) eSavedStateRegistryOwner
, além de fornecer os argumentos usados para iniciar o destino (aosp/1101691, aosp/1101710)
Correções de bugs
- Correção de um problema no qual a adição de
NavHostFragment
aViewPager2
falhou com umIllegalArgumentException
(b/133640271). NavInflater
agora evita chamargetResourceName()
desnecessariamente, acelerando o tempo de inflação em até 40% (b/139213740).
Versão 2.2.0-alpha01
7 de agosto de 2019
androidx.navigation:navigation-*:2.2.0-alpha01
é lançado. As confirmações incluídas nessa versão podem ser encontradas neste link.
Novos recursos
SavedStateViewModelFactory
agora é padrão de fábrica para o uso deby navGraphViewModels()
ou do construtorViewModelProvider
com umViewModelStoreOwner
retornado porNavController.getViewModelStoreOwner()
(b/135716331).
Mudanças na API
- No Navigation
2.1.0-rc01
: a APIgetViewModelStore()
descontinuada foi removida doNavController
que foi introduzido na versão2.1.0-alpha02
(aosp/1091021).
Correções de bugs
NavHostFragment
agora usaFragmentContainerView
, corrigindo problemas relacionados à ordem z de animações e a inserções de janelas enviadas para o Android Fragments (b/137310379).
Versão 2.1.0
Versão 2.1.0
5 de setembro de 2019
Lançamento de androidx.navigation:navigation-*:2.1.0
. As confirmações incluídas nessa versão podem ser encontradas neste link.
Mudanças importantes desde a versão 2.0.0
- Como usar o ViewModels no escopo de um gráfico de navegação: agora você pode criar ViewModels com escopo no nível do gráfico de navegação usando a propriedade
by navGraphViewModels()
delegada para usuários de Kotlin usando as bibliotecas-ktx
ou a APIgetViewModelStoreOwner()
adicionada aNavController
. Consulte Compartilhar dados relacionados à IU entre os destinos para mais informações. - Destinos de caixa de diálogo: agora você pode criar destinos
<dialog>
que vão mostrar umDialogFragment
quando vocênavigate
para eles.NavHostFragment
aceita destinos de caixas de diálogo por padrão. Consulte Criar um destino a partir de um DialogFragment para mais informações. - Navegação pelo URI: agora você pode
navigate
com umUri
, que usa o<deepLink>
adicionado a um destino para navegar por ele. Consulte Navegar usando o URI para mais informações. - NavHostController: APIs usadas especificamente para a construção de um
NavHost
personalizado foram movidas paraNavHostController
, permitindo que implementações conectassemNavController
ao hostLifecycleOwner
,OnBackPressedDispatcher
eViewModelStore
.
Versão 2.1.0-rc01
7 de agosto de 2019
androidx.navigation:navigation-*:2.1.0-rc01
é lançado. As confirmações incluídas nessa versão podem ser encontradas neste link.
Mudanças na API
- A API
getViewModelStore()
descontinuada noNavController
que foi introduzida na versão2.1.0-alpha02
foi removida (aosp/1091021).
Versão 2.1.0-beta02
19 de julho de 2019
androidx.navigation:*:2.1.0-beta02
é lançado. As confirmações incluídas nessa versão podem ser encontradas neste link.
Correções de bugs
- Removida dependência não intencional do Jacoco, introduzida no
2.1.0-beta01
(b/137782950).
Versão 2.1.0-beta01
17 de julho de 2019
androidx.navigation:*:2.1.0-beta01
é lançado. As confirmações incluídas nessa versão podem ser encontradas neste link.
Novos recursos
NavigationUI
agora anima a remoção do botão para cima ao usarsetupWithNavController()
comToolbar
ouCollapsingToolbarLayout
(b/131403621).
Correções de bugs
- Correção de um problema de tempo ao usar vários NavHostFragments com o mesmo contêiner com
findNavController()
(b/136021571).
Versão 2.1.0-alpha06
2 de julho de 2019
Lançamento de androidx.navigation:*:2.1.0-alpha06
. As confirmações incluídas nessa versão podem ser encontradas neste link.
Novos recursos
- O atributo
app:navGraph
usado por NavHostFragment agora foi movido para o artefatonavigation-runtime
. Navegadores personalizados que podem ser adicionados via XML precisam usar esse atributo para ter integração com o painel "Host" do Navigation Editor (b/133880955).
Mudanças na API
- A API
getViewModelStore()
noNavController
foi descontinuada e substituída pelo novo métodogetViewModelStoreOwner()
, que retorna umViewModelStoreOwner
(aosp/987010). - A implementação de destinos de janelas flutuantes, como destinos
<dialog>
, foi generalizada em uma interface de marcador,FloatingWindow
, que agora todos os destinos<dialog>
implementam. Agora, os métodos NavigationUI para interação com a barra de apps superior ignoram os destinosFloatingWindow
(b/133600763)
Mudanças de comportamento
- O Navigation agora mantém corretamente o estado sincronizado com o que é visto na tela ao usar um destino
<dialog>
. Como consequência, o Navigation agora exibe automaticamente destinos<dialog>
quando você navega para um destino que não tem caixas de diálogo ou atividades, como um destino<fragment>
(b/134089818, link em inglês)
Correções de bugs
- O Navigation agora suprime a animação que ocorre ao recriar a atividade durante a manipulação de um link direto, corrigindo um flash visual (b/130362979).
- Corrigido um bug em que a backstack do Navigation ficava dessincronizada ao mostrar um novo fragmento enquanto o fragmento inicial estava sendo adicionado (b/133832218).
Versão 2.1.0-alpha05
5 de junho de 2019
androidx.navigation:*:2.1.0-alpha05
é lançado. As confirmações incluídas nessa versão podem ser encontradas neste link.
Mudanças na API
- As APIs relacionadas ao host em
NavController
foram renomeadas e movidas para uma nova subclasse deNavController
,NavHostController
(aosp/966091). - O método
setHostOnBackPressedDispatcherOwner()
doNavController
foi substituído pelo métodosetOnBackPressedDispatcher()
doNavHostController
e agora exige que você chamesetLifecycleOwner()
antes dele (aosp/965409). NavHostController
agora contém um métodoenableOnBackPressed(boolean)
que substitui a classeNavHostOnBackPressedManager
que foi retornada anteriormente porsetHostOnBackPressedDispatcherOwner()
(aosp/966091).
Correções de bugs
- Correção de um problema em que a backstack ficava incorreta depois da navegação pelo URI (b/132509387).
- Os links diretos manipulados automaticamente pelo NavController agora são acionados apenas uma vez (b/132754763).
Versão 2.1.0-alpha04
16 de maio de 2019
androidx.navigation:*:2.1.0-alpha04
é lançado. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).
Correções de bugs
NavHostFragment
respeita corretamente oapp:defaultNavHost
ao interceptar os eventos do botão "Voltar" do sistema, corrigindo uma regressão no Navigation2.1.0-alpha03
b/132077777.DialogFragmentNavigator
agora lida corretamente com as operaçõespopBackStack()
enavigateUp()
b/132576764.- Correção de um problema
IllegalStateException: unknown destination during restore
ao navegar repetidamente entre gráficos aninhados (b/131733658).
Versão 2.1.0-alpha03
7 de maio de 2019
Lançamento de androidx.navigation:*:2.1.0-alpha03
. As confirmações incluídas nessa versão podem ser encontradas neste link.
Problemas conhecidos
- NavHostFragment continua a interceptar o botão "Voltar" do sistema apesar de usar
app:defaultNavHost="false"
(b/132077777).
Novos recursos
- Agora você pode criar destinos
<dialog>
que mostrarão umDialogFragment
quando vocênavigate
para eles.NavHostFragment
aceita destinos de caixas de diálogo por padrão (b/80267254). - Agora, além de chamar
navigate
com um código de recurso ou uma instânciaNavDirections
, você pode navegar com umUri
, que usa o<deepLink>
que você adicionou a um destino para navegar para o destino correto (b/110412864).
Mudanças de comportamento
- As animações padrão fornecidas pela NavigationUI foram aceleradas de 400 ms para 220 ms a fim de corresponder à velocidade de animação padrão de atividades e fragmentos (b/130055522).
Mudanças na API
- O uso do método
createFragmentNavigator()
doNavHostFragment
foi descontinuado, e a funcionalidade dele foi movida para o novo métodoonCreateNavController()
para deixar mais claro que esse é o ponto de entrada correto para adicionar navegadores personalizados ao criar subclasses deNavHostFragment
b/122802849. - Um método
hasDeepLink()
foi adicionado aNavDestination
para permitir que você verifique se um determinadoUri
pode ser manipulado por esse destino ou, no caso de umNavGraph
, por qualquer destino no gráfico de navegação (b/117437718).
Correções de bugs
- Os argumentos padrão agora são transmitidos corretamente para instâncias
OnDestinationChangedListener
(b/130630686). NavHostFragment
agora intercepta os eventos do botão "Voltar" do sistema usandoOnBackPressedDispatcher
. Isso corrige o problema que ocorria durante uma navegação condicional nos métodos de ciclo de vida do Fragment ao retornar para um Fragment (b/111598096).- Para o Safe Args, um
android:defaultValue=”@null”
comapp:argType
não especificado agora é inferido corretamente como um argumentostring
b/129629192.
Versão 2.1.0-alpha02
3 de abril de 2019
Lançamento de androidx.navigation:*:2.1.0-alpha02
. As confirmações incluídas nessa versão podem ser encontradas neste link.
Novos recursos
- Agora você pode criar ViewModels com escopo no nível do gráfico de navegação usando a propriedade
by navGraphViewModels()
delegada para usuários do Kotlin ou a APIgetViewModelStore()
adicionada aNavController
b/111614463.
Mudanças na API
- Agora você pode adicionar um
app:targetPackage
a um destino<activity>
para limitar o nome do pacote correspondente. Ele oferece suporte aapp:targetPackage="${applicationId}"
para restringir o pacote ao ID do seu aplicativo (b/110975456).
Correções de bugs
- Os destinos
android:name
para<activity>
não são mais analisados em uma classe durante a inflação, evitando ClassNotFoundExceptions ao usar recursos dinâmicos (b/124538597).
Versão 2.1.0-alpha01
19 de março de 2019
Esta é a primeira versão alfa do Navigation 2.1.0
.
Mudanças na dependência
- O Navigation agora depende de
androidx.core:core:1.0.1
eandroidx.fragment:fragment:1.1.0-alpha05
. Esta versão também remove a dependência deandroidx.legacy:legacy-support-core-utils:1.0.0
b/128632612.
Mudanças na API
- Um novo método
Navigation.createNavigateOnClickListener(NavDirections)
foi adicionado como alternativa à criação de um listener de clique com um pacote e ID de recurso (b/127631752). - O
FragmentNavigator.instantiateFragment
foi descontinuado. A implementação padrão agora usaFragmentFactory
para instanciar fragmentos (b/119054429).
Correções de bugs
- O Navigation não envia mais um
Bundle
nulo quando há argumentos anexados a um destino, corrigindo um problema ao usarandroid:defaultValue="@null"
b/128531879. - O Safe Args agora depende do KotlinPoet 1.1.0, o que corrige um problema com nomes de pacotes extremamente longos (b/123654948).
Versão 2.0.0
Versão 2.0.0
14 de março de 2019
Lançamento do Navigation 2.0.0
sem mudanças de 2.0.0-rc02
.
Versão 2.0.0-rc02
6 de março de 2019
O Navigation 2.0.0-rc02 oferece novos artefatos com o ID do grupo androidx.navigation
e muda as dependências para os equivalentes do AndroidX.
O comportamento do 2.0.0-rc02 é idêntico ao do Navigation 1.0.0-rc02, e nenhuma mudança no código será necessária para atualizar a 1.0.0-rc02, além da atualização das suas dependências para corresponder às novas dependências.
Seu projeto precisa ter migrado para o AndroidX para usar as versões 2.X do Navigation. O Navigation 1.0 estável será a última versão que vai usar as dependências da Biblioteca de Suporte. Todo o desenvolvimento futuro além da versão 1.0 vai ser baseado no AndroidX e na versão estável 2.0.
Dependências anteriores ao AndroidX
Para as versões anteriores ao AndroidX do Navigation, inclua estas dependências:
dependencies {
def nav_version = "1.0.0"
implementation "android.arch.navigation:navigation-fragment:$nav_version" // For Kotlin use navigation-fragment-ktx
implementation "android.arch.navigation:navigation-ui:$nav_version" // For Kotlin use navigation-ui-ktx
}
Para Safe Args, adicione o
seguinte classpath ao arquivo build.gradle
de nível superior:
buildscript {
repositories {
google()
}
dependencies {
classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
}
}
Versão 1.0.0
Versão 1.0.0
14 de março de 2019
Lançamento do Navigation 1.0.0
sem mudanças de 1.0.0-rc02
.
Versão 1.0.0-rc02
26 de fevereiro de 2019
Este é o segundo candidato a lançamento da versão estável do Navigation 1.0.0. Essa versão contém várias correções de bugs.
Correções de bugs
- Corrigido um problema em que
popBackStack()
era ignorado se o gráfico raiz não tivesse um ID (b/126251695). navigateUp()
agora gerencia corretamente a navegação de volta à tarefa do app quando é chamado depois de processar um link direto semFLAG_ACTIVITY_NEW_TASK
(b/126082008).- Foi corrigido um problema com o
ActivityNavigator.applyPopAnimationsToPendingTransition
, que não aplicava a animação correta de saída (b/126237567). - O código Kotlin gerado pelo Safe Args agora faz corretamente o escape das palavras-chave do Kotlin,
como
in
efun
no nome do pacote associado à classeR
(b/126020455).
Versão 1.0.0-rc01
21 de fevereiro de 2019
Este é um candidato a lançamento da versão estável do Navigation 1.0.0. Essa versão contém uma correção de bug.
Correções de bugs
- Correção de um problema ao usar o Android Fragments e operações de navegação (
singleTop
b/124294805).
Versão 1.0.0-beta02
12 de fevereiro de 2019
Esta versão inclui uma série de pequenas melhorias e correções de bugs importantes.
Novos recursos
- Agora você pode usar
0
como umandroid:defaultValue
para argumentosreference
(b/124248602).
Mudanças de comportamento
- As correspondências exatas dos links diretos agora são priorizadas em relação aos links diretos com
.*
ou correspondências de argumentos (b/123969518).
Correções de bugs
popBackStack()
enavigateUp
agora retornam corretamentefalse
ao colocar o último destino na pilha de retorno, corrigindo uma regressão introduzida em1.0.0-beta01
b/123933201.- O Navigation agora define corretamente o
ClassLoader
durante a restauração do estado salvo da instância, evitando problemas ao usar classes personalizadas no estado salvo doNavigator
ou em argumentos enviados a umNavDestination
b/123893858 - As classes NavArgs geradas pelo Safe Args não falham mais ao restaurar
um argumento
Parcelable[]
do estado da instância salva b/123963545. - O Safe Args agora limpa corretamente as classes Kotlin geradas sem necessidade (b/124120883).
Versão 1.0.0-beta01
4 de fevereiro de 2019
Esta é a primeira versão beta do Navigation. Daqui em diante, espera-se que a API do Navigation permaneça estável até a próxima versão, a menos que haja um problema crítico. Essa versão contém algumas correções de bugs e mudanças de comportamento.
Mudanças de comportamento
- O Navigation agora garante que os valores padrão do argumento sejam tratados de forma idêntica
durante a execução e pelo Safe Args. Como consequência, somente argumentos com
app:argType="reference"
podem ter um ponto de valor padrão para outro recurso (por exemplo,@color/colorPrimary
). A tentativa de usar um valor padrão de referência com umapp:argType
diferente resultará em uma exceção ao analisar o XML de navegação b/123551990. - O Safe Args agora depende do Plug-in do Android para Gradle 3.3.0 (aosp/888413).
- O Safe Args agora depende do Kotlin 1.3.20 (aosp/888414).
Correções de bugs
- O Safe Args agora pode ser usado em módulos de biblioteca e de recursos em todas as versões do Plug-in do Android para Gradle (b/121304903).
- Foi corrigida uma regressão que fazia com que uma única operação
popBackStack()
exibisse todas as cópias de um destino da parte de cima do backstack em vez de apenas um destino por vez (b/123552990). - Foi corrigido um problema em que o estado
FragmentNavigator
ficava dessincronizado com o doNavController
, causando umaIllegalStateException
ao tentar restaurar o backstack (b/123803044). - Correção de um problema em que a seta para voltar gerenciada pela
NavigationUI
não aparecia ao usar o ProGuard com ofuscação b/123449431. - O código gerado pelo Safe Args agora é processado corretamente com o uso de um
app:argType
apontando para uma classe interna estática no formato.OuterClass$InnerClass
b/123736741. - O código Java gerado pelo Safe Args agora processa corretamente ações globais e destinos profundamente aninhados (b/123347762).
Versão 1.0.0-alpha11
23 de janeiro de 2019
Esta é uma versão hotfix de 1.0.0-alpha10
que corrige um problema com o Safe Args.
Correções de bugs
- Correção de um problema em que o Safe Args falhava ao importar a classe Directions associada às ações globais (b/123307342).
Versão 1.0.0-alpha10
23 de janeiro de 2019
Problemas conhecidos
- O Safe Args falha ao importar a classe Directions associada às ações globais b/123307342.
Esta versão contém alterações interruptivas da API. Consulte a seção Alterações interruptivas abaixo.
Novos recursos
- Os usuários do Kotlin agora podem usar a delegação da propriedade
by navArgs()
para receber lentamente uma referência a uma classeNavArgs
gerada pelo Safe Args em umaActivity
ouFragment
b/122603367. - O Safe Args agora permite gerar o código Kotlin aplicando o
plug-in
androidx.navigation.safeargs.kotlin
. O código Kotlin foi criado especificamente para módulos exclusivos do Kotlin, usando argumentos padrão e classes imutáveis sobre o padrão do builder, que ainda está disponível no plug-inandroidx.navigation.safeargs
(b/110263087).
Mudanças de comportamento
- Os links diretos correspondentes agora são direcionados ao link direto que tem os argumentos com nível mais alto de correspondência (b/118393029).
- Agora, a ação de chamar
setGraph()
em umNavController
vai redefinir a backstack (b/111450672). - Os links diretos desconhecidos não geram mais uma
IllegalStateException
, mas são ignorados, corrigindo problemas comNavHostFragment
s aninhados ou múltiplos (b/121340440).
Alterações interruptivas
- O método
NavOptions.applyPopAnimationsToPendingTransition()
para aplicar animações de destaque a uma atividade foi movido paraActivityNavigator
b/122413117. - O Safe Args agora evita duplicar classes idênticas para ações sem
argumentos. O tipo de retorno para métodos sem argumento nas classes NavDirections geradas é
NavDirections
b/123233147 - As classes Directions geradas pelo Safe Args não têm mais um construtor público. Interaja somente com os métodos estáticos gerados b/123031660.
- As classes
NavDirections
geradas pelo Safe Args não têm mais um construtor público. Elas só podem ser geradas por um dos métodos estáticos nas classes Directions geradas (b/122963206). - O
Bundle
retornado degetArguments()
doNavDirections
agora está marcado como@NonNull
, em vez de@Nullable
(b/123243957).
Correções de bugs
- Agora,
NavDeepLinkBuilder
processa corretamente váriosPendingIntent
s simultâneos para o mesmo destino usando os argumentos que você transmite para determinar a exclusividade (b/120042732). - Agora,
NavController
processa corretamente as operaçõespopBackStack()
ao usar umNavHostFragment
aninhado ou outros fragmentos filhos com uma backstack (b/122770335). - Agora,
NavigationUI
define corretamente a descrição do conteúdo do botão "Para cima" (b/120395362). - As classes Directions geradas pelo Safe Args agora processam corretamente ações globais que têm o mesmo ID que uma ação de um destino (b/122962504).
- As classes
NavDirections
geradas pelo Safe Args agora têm valoreshashCode()
iguais corretos quandoequals()
retorna "true" b/123043662. FragmentNavigator
agora gera uma mensagem de erro melhor se você tenta fazerFragmentTransactions
personalizadas noFragmentManager
doNavHostFragment
. Sempre usegetChildFragmentManager()
. b/112927148.
Versão 1.0.0-alpha09
18 de dezembro de 2018
Esta versão contém alterações interruptivas da API. Consulte a seção Alterações interruptivas abaixo.
Optamos por não continuar o desenvolvimento do
artefato android.arch.navigation:navigation-testing
. Embora ele tenha se mostrado
útil nos testes internos do NavController
, é altamente recomendável
usar estratégias de teste alternativas, como a simulação da instância NavController
,
para verificar se as chamadas de navigate()
corretas estão sendo feitas. Essa
abordagem é discutida em detalhes na
palestra Atividade Única na Conferência de Desenvolvedores Android 2018
(vídeo em inglês), e vamos providenciar outra documentação, especificamente com relação a testes
com Navigation.
Novos recursos
MenuItem
s commenuCategory="secondary"
não vão mais ser exibidos na backstack quando usados com métodosNavigationUI
(b/120104424).AppBarConfiguration
agora permite que você defina uma instância substituta deOnNavigateUpListener
que é chamada quandonavController.navigateUp()
retornafalse
b/79993862 b/120690961.
Alterações interruptivas
- Ao usar um
<argument>
com umargType="reference"
, o Navigation não vai mais analisar a referência, mas vai fornecer o próprio ID de recurso bruto (b/111736515). - Agora,
onNavDestinationSelected()
retorna ao destino inicial do seu gráfico de navegação por padrão, tornando-o consistente com os métodossetup
. AdicionemenuCategory="secondary"
ao seuMenuItem
para evitar a exibição da pilha de retorno (aosp/852869). - Os métodos
fromBundle()
das classesArgs
geradas agora assumem um valorBundle
não nulo em vez de um valor anulável deBundle
(aosp/845616).
Correções de bugs
- Agora, os argumentos são analisados corretamente nos links diretos como o
argType
correto, em vez de sempre como strings (b/110273284). - O Navigation agora exporta corretamente os próprios recursos públicos (b/121059552).
- O Safe Args agora oferece suporte ao Plug-in do Android para Gradle 3.4 Canary 4 e versões mais recentes (b/119662045).
Versão 1.0.0-alpha08
6 de dezembro de 2018
Esta versão contém alterações interruptivas da API. Consulte a seção Alterações interruptivas abaixo.
Novos recursos
- Os rótulos de destino, quando usados com os métodos
NavigationUI
, vão substituir automaticamente as instâncias do{argName}
no seuandroid:label
com o argumento correto (b/80267266). - O Navigation agora depende da Biblioteca de Suporte 28.0.0 (b/120293333).
Alterações interruptivas
OnNavigatedListener
foi renomeado comoOnDestinationChangedListener
(b/118670572).OnDestinationChangedListener
agora também transmite oBundle
de argumentos (aosp/837142).- Os atributos
app:clearTask
eapp:launchDocument
e os métodos associados foram removidos. Useapp:popUpTo
com a raiz do seu gráfico para remover todos os destinos da backstack (b/119628354). ActivityNavigator.Extras
agora usa um padrãoBuilder
e adiciona a capacidade de definir qualquer flagIntent.FLAG_ACTIVITY_
(aosp/828140).NavController.onHandleDeepLink
foi renomeado comohandleDeepLink
aosp/836063.- Muitas classes e métodos que não se destinam à subclassificação, como
NavOptions
,NavInflater
,NavDeepLinkBuilder
eAppBarConfiguration
, se tornaramfinal
(aosp/835681). - O método
NavHostFragment.setGraph()
descontinuado foi removido (aosp/835684). - O método
NavigationUI.navigateUp(DrawerLayout, NavController)
descontinuado foi removido (aosp/835684). - A criação de Fragment foi movida para
FragmentNavigator
, facilitando a delegação da criação de Fragment para umFragmentFactory
(b/119054429). - O construtor para
NavGraphNavigator
não usa mais umContext
aosp/835340. - NavigatorProvider agora é
uma classe, em vez de uma interface. O
NavigatorProvider
retornado porgetNavigatorProvider()
não mudou a funcionalidade aosp/830660. - O
NavDestination.navigate()
foi removido. Em vez disso, chamenavigate()
noNavigator
(aosp/830663). - Refatoração significativa do
Navigator
, removendo a necessidade deOnNavigatorNavigatedListener
e fazendo com quenavigate
retorne oNavDestination
a que a navegação ocorreu. - As instâncias do
Navigator
não podem mais enviar eventos de pop para oNavController
. Considere usar umOnBackPressedCallback
para interceptar o pressionamento do botão "Voltar" e chamarnavController.popBackStack()
(aosp/833716).
Correções de bugs
popUpTo
agora funciona consistentemente quando o destino é um elemento<navigation>
(b/116831650).- Diversos bugs que resultavam em uma
IllegalArgumentException
ao usar gráficos aninhados foram corrigidos (b/118713731, b/113611083, b/113346925, b/113305559). - O atributo
dataPattern
de destinos<activity>
agora preencherá argumentos de argumentos não String chamandotoString()
b/120161365.
Safe Args
- Safe Args compatível com objetos Serializable, incluindo valores Enum. Tipos Enum
podem definir um valor padrão usando a enumeração literal sem o nome da classe,
por exemplo,
app:defaultValue="READ"
(b/111316353). - O Safe Args funciona com matrizes de todos os tipos com suporte (b/111487504).
- O Safe Args agora ignora subpastas de diretórios de recursos (b/117893516).
- O Safe Args adiciona anotações
@Override
quando apropriado (b/117145301).
Versão 1.0.0-alpha07
29 de outubro de 2018
Novos recursos
- Uma nova classe AppBarConfiguration permite personalizar quais destinos são considerados destinos de nível superior. Consulte a documentação atualizada para ver mais detalhes (b/117333663).
- Agora você pode transferir argumentos para o destino inicial do seu gráfico (b/110300470).
- Os links diretos agora oferecem suporte a esquemas personalizados com pontos, hífens e sinais de adição (b/112806402).
Alterações interruptivas
- O módulo
navigation-testing-ktx
foi incorporado nonavigation-testing artifact
e não vai mais ser publicado. - O artefato
navigation-testing
agora depende da biblioteca padrão Kotlin. A API foi alterada para ser mais consistente com as convenções do Kotlin, mas você pode continuar a usá-la para testes escritos em Java. - Não há mais suporte a gráficos de navegação registrados com manifestos de metadados (b/118355937).
- As ações não podem mais ser anexadas a destinos de <activity> aosp/785539.
Correções de bugs
- Os links diretos agora analisam os parâmetros de consulta corretamente (b/110057514).
- Os destinos de atividade agora aplicam corretamente todas as animações de entrada e saída (b/117145284).
- Corrigidas falhas que ocorrem depois que a configuração é alterada ao usar Navigators personalizados (b/110763345).
Safe Args
- Safe Args agora tem uma dependência fixa no Android Gradle Plugin 3.2.1 (b/113167627).
- Diretivas agora podem ser geradas para classes internas (b/117407555).
- Correção de um problema ao gerar diretivas para um gráfico <include> (b/116542123).
Versão 1.0.0-alpha06
20 de setembro de 2018
Novos recursos
- Foi adicionado suporte às transições de elementos compartilhados para destinos de fragmentos e atividades (b/79665225). Para ver mais informações, consulte Implementar a navegação com o componente de arquitetura Navigation.
- A seleção de um item no
NavigationView
agora fecha qualquer página inferior inclusa (b/112158843).
Mudanças na API
- Alteração interruptiva: o método
navigate()
do Navigator agora usa um parâmetroNavigator.Extras
. - O método
getGraph()
do NavController agora éNonNull
b/112243286.
Correções de bugs
NavigationUI.setupWithNavController()
não vaza mais visualizações se usado com visualizações de destinos individuais (b/111961977).- O
onSaveState()
do Navigator agora é chamado apenas uma vez (b/112627079).
Safe Args
- As classes de diretivas do destino do Navigation agora estendem a classe do pai correspondente, se ele existir (b/79871405).
- As classes Directions e Args agora têm uma implementação
toString()
b/111843389.
Versão 1.0.0-alpha05
10 de agosto de 2018
Correções de bugs
- Correção de um bug que causa um comportamento incorreto da backstack (b/111907708).
- Correção de um bug em
equals()
de classes Generated Args (b/111450897). - Correção de um erro de compilação no Safe Args (b/109409713).
- Correção de uma conversão de identificadores de recursos para nomes Java. b/111602491
- Correção de mensagens de erro sobre a capacidade de anulação no plug-in Safe Args.
- Adição de anotações de anulação ausentes.
Versão 1.0.0-alpha04
19 de julho de 2018
O Navigation 1.0.0-alpha04
e o plug-in Safe Args associado do Gradle contêm várias mudanças da API, mudanças de comportamento e correções de bugs.
Mudanças de API / comportamento
- O NavHostFragment sempre vai definir o Fragment atual como o fragmento de navegação principal, garantindo que os gerenciadores de fragmentos filhos sejam abertos antes que o NavController externo seja exibido (b/111345778).
Safe Args
- Alteração interruptiva:
app:type
mudou paraapp:argType
para evitar conflitos com outras bibliotecas, como ConstraintLayout 2.0.0-alpha1 (b/111110548). - Agora é possível clicar em mensagens de erro de Safe Args (b/111534438).
- Agora, as classes Args confirmam se os atributos
NonNull
realmente não são nulos (b/111451769). - Adição de outras anotações
NonNull
às classes NavDirections e Args geradas b/111455455 (b/111455456).
Correções de bugs
- Correção de um problema com o botão "Voltar" do sistema depois de um link direto para um destino de fragmento (b/111515685).
Versão 1.0.0-alpha03
12 de julho de 2018
O Navigation 1.0.0-alpha03
e o plug-in Safe Args associado do Gradle contêm várias mudanças da API, mudanças de comportamento e correções de bugs.
Mudanças de API / comportamento
- Adição de um método NavigationUI.setupWithNavController para a Barra de Ferramentas Google. b/109868820
- Adição de um método NavigationUI.setupWithNavController para CollapsingToolbarLayout (b/110887183).
- popBackStack() agora retorna "false" quando o backstack está vazio ou quando o código de destino fornecido não consta no backstack (b/110893637).
- O FragmentNavigator agora ignora as operações de navegação após o FragmentManager ter salvo o estado, evitando as exceções “Não foi possível realizar esta ação depois de onSaveInstanceState” (b/110987825).
Safe Args
- Alteração interruptiva: caracteres não alfanuméricos em nomes de ação e argumento vão ser substituídos pelo estilo CamelCase nos respectivos nomes de método do NavDirections.
- Por exemplo,
DemoController.index
se tornasetDemoControllerIndex
(b/79995048). - Por exemplo,
action_show_settings
se tornaactionShowSettings
(b/79642240).
- Por exemplo,
- Alteração interruptiva: os argumentos agora são considerados não nulos por padrão. Para permitir valores nulos em argumentos parceláveis e de string, adicione
app:nullable="true"
(b/79642307). - Agora é possível usar
app:type="long"
com defaultValues na forma de "123L" (b/79563966). - Os argumentos parcelable agora são compatíveis, usando um nome de classe totalmente qualificado para
app:type
. O único valor padrão compatível é"@null"
(b/79563966). - As classes de Args agora implementam
equals()
ehashCode()
(b/79642246). - O plug-in Safe Args agora pode ser aplicado a projetos de biblioteca (b/80036553).
- O plug-in Safe Args agora pode ser aplicado a projetos de recursos. b/110011752
Correções de bugs
- Correção de problemas de navegação durante os métodos de ciclo de vida do Fragment. b/109916080
- Correção de problemas de navegação por gráficos aninhados várias vezes (b/110178671).
- Correção de problemas ao usar
setPopUpTo
com o primeiro destino no gráfico (b/109909461). - Correção de problemas em que todos os valores
app:defaultValue
estavam sendo transmitidos como Strings (b/110710788). - O AAPT2 incluído no Plug-in do Android para Gradle 3.2 Beta 01 agora mantém regras para todos os atributos
android:name
em arquivos XML do Navigation (b/79874119). - Correção de vazamento de memória ao substituir o FragmentNavigator padrão (b/110900142).
Versão 1.0.0-alpha02
7 de junho de 2018
Mudanças de comportamento
FragmentNavigator
agora usasetReorderingAllowed(true)
b/109826220.O Navigation agora aplica URLDecodes a argumentos analisados de URLs de links diretos (b/79982454).
Correções de bugs
Correção de uma
IllegalStateException
ao chamar a navegação dos métodos de ciclo de vida do Fragment (b/79632233).O Navigation agora depende da Biblioteca de Suporte 27.1.1 para corrigir a tremulação ao usar animações (b/80160903).
Correção de uma
IllegalArgumentException
ao usar defaultNavHost="true" como um fragmento filho (b/79656847).Correção de um
StackOverflowError
ao usar o NavDeepLinkBuilder (b/109653065).Correção de um
IllegalArgumentException
ao navegar de volta para um gráfico aninhado (b/80453447).Correção de um problema com a sobreposição de fragmentos ao usar
launchSingleTop
(b/79407969).O Navigation agora cria a backstack sintética correta para gráficos aninhados (b/79734195).
A NavigationUI agora destaca o item correto ao usar um gráfico aninhado como um
MenuItem
(b/109675998).
Mudanças na API
O atributo
clearTask
das ações e a API associada emNavOptions
foram descontinuados (b/80338878).O atributo
launchDocument
das ações e a API associada emNavOptions
foram descontinuados (b/109806636).
Versão 1.0.0-alpha01
8 de maio de 2018
O Navigation oferece um framework para criar a navegação
no app. Essa versão inicial é 1.0.0-alpha01
.