Navigation

A navegação é um framework para navegar entre "destinos" em um app Android que oferece uma API consistente, independentemente dos destinos serem implementados como fragmentos, atividades ou outros componentes.
Atualização mais recente Versão estável Candidata a lançamento Versão Beta Versão Alfa
27 de julho de 2022 2.5.1 - - -

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.5.1"

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

Kotlin

dependencies {
  val nav_version = "2.5.1"

  // 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.5.0"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

Kotlin

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.5.0"
        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 Java ou módulos 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 versão.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 2.5

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 um Bundle (Id86ed, b/237725966).

Atualizações de dependência

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 interface ViewModelProvider.Factory sem estado usando a classe CreationExtras do Lifecycle 2.5.0.

SafeArgs do Navigation

  • O Navigation Safe Args fez o upgrade da dependência Android Gradle Plugin para usar 7.0.4, não sendo mais compatível com as versões do AGP anteriores a 7.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 o NavController.

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 um applicationIdSuffix e um namespace sem o applicationId ou quando o applicationId e o namespace forem diferentes (I754b1, b/233119646).
  • O NavArgument agora tem uma função toString() 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 arquivo navigation.xml (Ic15a5, b/178403185).

Correções de bugs

  • Os escopos de composição em NavHost e DialogHost agora são descartados na ordem esperada, ou seja, os elementos de composição internos são descartados antes dos elementos externos (I157e6)
  • O SafeArgs do Navigation agora usa PathSensitivity.RELATIVE no ArgumentsGenerationTask 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 remember ao redor da chamada para getBackStackEntry() também transmita um objeto NavBackStackEntry 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 usa popWithTransition ao executar uma chamada dismiss(). Isso corrige uma disputa ao usar um ViewModel no destino dialog, que causaria uma IllegalStateException 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

  • A navegação agora depende do Lifecycle 2.5.0-beta01, corrigindo uma IllegalStateException ao aninhar um NavHost em outro NavHost 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

Correções de bugs

  • O NavHost agora depende das visibleEntries do NavController para determinar quais entradas vão ser compostas. Isso significa que, ao usar o NavHost aninhado, o NavHost interno vai ser animado corretamente (I4ba2b, b/225394514).
  • O visibleEntries StateFlow fornecido pelo NavController agora se baseia no estado máximo do Lifecycle da entrada, em vez do estado atual. Isso significa que, mesmo que o ciclo de vida do host do navController fique abaixo de "STARTED" (iniciado), a lista de partes visíveis permanece a mesma (I9e2a8, b/225394514).
  • A SavedStateViewFactory agora oferece suporte ao uso de CreationExtras mesmo quando foi inicializada com um SavedStateRegistryOwner. 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 nenhum AndroidManifest.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 a by navGraphViewModels para criar um ViewModel (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 com NavBackStackEntries 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

  • Da Navigation 2.4.1: o NavHostFragment agora define corretamente a classe OnBackPressedDispatcher ao usar a vinculação de visualizações com gráficos aninhados (Ifbb51, b/214577959).
  • Da Navigation 2.4.1: quando os links diretos usam vários NavGraphs aninhados, a pilha de retorno 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

Correções de bugs

  • Um problema em que o acesso a um ViewModel criado por by navGraphViewModels() do método onCreate() de um fragmento falhava com uma IllegalStateException foi corrigido (I8a14d).
  • NavDeepLinks não vão decodificar mais desnecessariamente os argumentos duas vezes, ou seja, os argumentos adequados vão ser agora 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

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 classe OnBackPressedDispatcher ao usar a vinculação de visualizações com gráficos aninhados (Ifbb51, b/214577959).
  • Agora, quando há links diretos usando vários NavGraphs aninhados, a pilha de retorno inclui corretamente destinos iniciais intermediários (I504c0, b/214383060).
  • Backport da Navigation 2.5.0-alpha01: correção de um problema em que o acesso a um ViewModel criado pelo by navGraphViewModels() usando o onCreate() de um fragmento falhava com uma IllegalStateException (I8a14d).
  • Backport da Navigation 2.5.0-alpha01: NavDeepLinks deixaram de decodificar argumentos desnecessariamente duas vezes. Isso significa que os argumentos decodificados corretamente são transmitidos para seu destino final (I31b0a, b/210711399).
  • Backport da 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 plug-in Navigation Safe Args não é mais compatível com as versões do Android Studio anteriores à 7.0, mas agora ele é 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 novo AbstractListDetailFragment. Esse fragmento usa um SlidingPaneLayout para gerenciar um painel de lista (que a subclasse fornece) e um painel de detalhes, que usa um NavHostFragment como implementação, conforme mostrado no nosso exemplo de implementação.
  • O método currentBackStackEntryAsFlow() no NavController fornece um Flow que é emitido sempre que a NavBackStackEntry atual muda. Esse fluxo pode ser usado como uma alternativa ao gerenciamento manual de um OnDestinationChangedListener.
  • O NavController agora permite extrair uma lista de todas as instâncias NavBackStackEntry visíveis como um StateFlow usando a propriedade visibleEntries experimental.
  • Agora é possível estender a classe NavType para criar NavTypes personalizados. Só há suporte para os tipos personalizados ao criar o gráfico de navegação de maneira programática, como ao usar a DSL do Kotlin para gráficos de navegação.
  • A navegação agora fornece APIs findStartDestination() e getHierarchy() que podem ser usadas para ajudar a implementar a NavigationUI personalizada. findStartDestination() é uma função de extensão de NavGraph que localiza o destino inicial real que é exibido quando você navega até o gráfico, mesmo que o startDestination seja um NavGraph aninhado. A getHierarchy() é uma função do NavDestination 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 uma BottomNavigationView foram atualizados para usar a superclasse NavigationBarView, introduzida no Material 1.4.0. Isso permite que esses métodos sejam usados com NavigationRailView.

  • Ao inflar um elemento <action> via XML, os atributos de animação podem usar atributos extraídos do tema com a sintaxe app:enterAnim="?attr/transitionEnter".

  • O Safe Args agora gera um método fromSavedStateHandle() para cada classe NavArgs (#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 capturavam 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 por popUpToId.
  • A API getStartDestination() foi descontinuada e substituída por getStartDestinationId().

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 que pode ser composto e permite construir o gráfico de navegação com uma DSL do Kotlin, usando destinos composable e dialog, 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 que pode ser composto. Cada destino só chega ao estado RESUMED (retomado) quando uma transição de entrada termina e cai imediatamente em STARTED (iniciado) quando uma transição de saída começa, permitindo que você evite todos os problemas de IllegalStateException e multitoque, acionando apenas uma chamada navigate quando o Lifecycle for RESUMED (retomado).
  • Escopo de ViewModel (pela API viewModel() do Lifecycle ViewModel Compose 2.4.0 ou hiltViewModel() do Hilt Navigation Compose 1.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 que pode ser composto é descartado) e um sinal nos onCleared() 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 que pode ser composto seja salvo e restaurado automaticamente quando você retornar a um destino.
  • Suporte total para salvar e restaurar o 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.
  • compatibilidade com a 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() e currentBackStackEntryAsState() para permitir a elevação do estado e conectar NavController a elementos que podem ser compostos fora do NavHost, 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 de app:popUpToSaveState e app:restoreState para salvar o estado de quaisquer destinos removidos usando app:popUpTo e restaurar o estado associado ao destino transmitido como o app: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 booleanas restoreState e saveState no builder popUpTo:

    // 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 o NavOptions.Builder, é possível usar setRestoreState() e a nova sobrecarga para setPopUpTo() que recebe um parâmetro saveState 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âmetro saveState extra.

  • Agora você pode usar o método clearBackStack() para limpar qualquer estado salvo com popBackStack() ou popUpToSaveState.

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 adiciona PendingIntent.FLAG_IMMUTABLE à PendingIntent retornada por createPendingIntent(), garantindo que essa API funcione conforme esperado quando destinada ao Android 12.
  • O componente de navegação agora depende do Lifecycle 2.3.1 e marca setGraph(), popBackStack(), navigateUp() e navigate(), como os métodos que atualizam o Lifecycle da NavBackStackEntry, como @MainThread, alinhando o componente de navegação à aplicação da linha de execução principal introduzida no Lifecycle 2.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

  • O componente de navegação 2.5.0-alpha01 foi corrigido: o acesso a um ViewModel criado usando by navGraphViewModels() pelo método onCreate() de um fragmento falha com uma IllegalStateException (b/213504272).
  • O componente de navegação 2.5.0-alpha01 foi corrigido: o Safe Args 2.4.0 é incompatível com o 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 o NavController 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 do NavBackStackEntry 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 o NavHost 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, como NavigationUI.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

  • Um problema em que NavBackStackEntries eram enviadas ao Lifecycle.State.CREATED depois de mover para o estado Lifecycle.State.STARTED quando o NavHost era adicionado diretamente ao método setContent() da atividade foi corrigido (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).
  • Um problema em que a API onNavDestinationSelected na NavigationUI retornava true mesmo que você não tivesse navigate() (navegado) para esse gráfico de navegação foi corrigido. Agora, a API usa a mesma lógica usada internamente pelo setupWithNavController para selecionar apenas o MenuItem associado ao destino atual usando a hierarchy 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 para NavDestinations (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).
  • Um problema com o AbstractListDetailFragment que fazia com que os atributos layout_width e layout_weight no painel de listas retornado por onCreateListPaneView() fossem processados incorretamente ou ignorados foi corrigido (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 API dismiss() assíncrona para o DialogFragment 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ê usa popUpTo ou popBackStack() para dispensar a caixa de diálogo (I77ba2).
  • O AbstractAppBarOnDestinationChangedListener agora tem mensagens de erro mais claras para onDestinationChanged() (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 StateFlow visibleEntries (Ia964e).
  • O método rememberNavController() agora usa um conjunto opcional de instâncias Navigator que vão ser adicionadas ao NavController 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).
  • Um problema com o botão "Voltar" do sistema, que ocorre somente depois de retornar a um destino que pode ser composto que contém um NavHost foi corrigido (3ed148, b/195668143).
  • SafeArgs agora gera os argumentos para fromBundle() e fromSavedStateHandle() 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 com popBackStack() ou popUpToSaveState (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 de navigation-common em vez de navigation-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 sido DESTROYED (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 o currentBackStackEntryFlow não eram notificadas ao usar launchSingleTop (Iaaebc).

Atualizações de dependência

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

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 e previousBackStackEntry no método composable(), em conjunto com remember(), 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étodo setGraph 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 no Lifecycle.State de NavBackStackEntrys, o que significa que um NavHost 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 estado NavController 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ódigo ViewModel (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() e requireDetailPaneNavHostFragment() no AbstractListDetailFragment foram renomeados como getSlidingPaneLayout() e getDetailPaneNavHostFragment(), respectivamente (I34a08).

Mudanças de comportamento

  • Ao navegar com animações (como Crossfade), o Lifecycle do novo destino agora só alcançará o estado RESUMED (retomado) quando a animação for 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).
  • Uma NullPointerException que ocorria ao adicionar um link direto sem um Uri e navegar por uma rota ou link direto foi corrigida (938a0c, b/193805425).
  • Um problema no Navigation Compose, em que uma NavBackStackEntry de link direto não alcançava o estado RESUMED (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 serão considerados iguais e não apagarão o backstack de NavController (I0b8db, b/175392262).

Correções de bugs

  • Correção de uma NoSuchElementException ao chamar popBackStack() de dentro de um LifecycleObserver anexado a uma NavBackStackEntry causada por atualizações reentrantes ao estado do NavController (I64621).
  • O AbstractListDetailFragment agora permite que o SlidingPaneLayout seja completamente removido do seu APK quando o AbstractListDetailFragment não for usado (I611ad).
  • O NavGraph e o NavDestination 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 novo AbstractListDetailFragment. Esse fragmento usa um SlidingPaneLayout para gerenciar um painel de lista (que a subclasse fornece) e um painel de detalhes, que usa um NavHostFragment como implementação, conforme mostrado no nosso exemplo de implementação (Iac4be, b/191276636).
  • O NavHost do artefato navigation-compose agora é compatível com destinos dialog, além de composable. Esses destinos de caixas de diálogo serão exibidos dentro de uma Dialog que pode ser composta, flutuando acima do destino composable 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 em NavigatorState foi renomeada como push. Todas as chamadas atuais para add() precisarão ser mudadas para push() (Ie89fc, b/172112072).
  • As instâncias Navigator personalizadas agora podem usar as APIs pushWithTransaction e popWithTransition em NavigatorState 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 adiciona PendingIntent.FLAG_IMMUTABLE à PendingIntent retornada por createPendingIntent(), 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 argumento string[] 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 de 1.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 que setupActionBarWithNavController() 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 chamar popBackStack() 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 usar navigation-common ou quaisquer artefatos que dependam dele (I68800, b/190082521).
  • Um OnDestinationChangedListener que chama navigate() 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 Gradle 6.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 é compatível com 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 sempre salvar o estado seja o comportamento correto, ainda há bibliotecas que foram descontinuadas sendo usadas (por exemplo, fragmentos retidos), que não têm suporte ao salvar o estado. Isso dá os apps a oportunidade de fazer lentamente a conversão e deixar de usar APIs sem suporte (Idf93c).
  • A navegação agora fornece APIs findDestination() e getHierarchy() que podem ser usadas para ajudar a implementar a NavigationUI personalizada. A findDestination() é uma função de extensão no NavGraph que localizará um destino no gráfico. A getHierarchy() é uma função no NavDestination 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 Material 1.4.0, NavigationBarView. Isso permite que esses métodos sejam usados com NavigationRailView (Ib0b36, b/182938895).

  • Ao inflar um elemento <action> via XML, os atributos de animação podem usar atributos extraídos do tema usando a sintaxe app:enterAnim="?attr/transitionEnter" (I07bc1, b/178291654).

Mudanças na API

Correções de bugs

  • O DialogFragmentNavigator agora usa a API NavigatorState.pop() para informar ao NavController quando uma caixa de diálogo é dispensada pressionando o botão "Voltar" do sistema ou clicando fora dela. Isso garante que o estado do NavController 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 de OnDestinationChangedListeners com um callback onDestinationChanged (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 de resid (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() no NavController fornece um Flow que é emitido sempre que a NavBackStackEntry atual muda. Esse fluxo pode ser usado como uma alternativa ao gerenciamento manual de um OnDestinationChangedListener (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 de app:popUpToSaveState e app:restoreState para salvar o estado de quaisquer destinos removidos usando app:popUpTo e restaurar o estado associado ao destino transmitido como o app: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 booleanas restoreState e saveState no builder popUpTo:

    // 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 o NavOptions.Builder, é possível usar setRestoreState() e a nova sobrecarga para setPopUpTo() que recebe um parâmetro saveState 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âmetro saveState 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> na navegação 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 por popUpToId (I59c73, b/172823546).
  • A API getStartDestination() foi descontinuada e substituída por getStartDestinationId() (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 e argument e as funções de desestruturação de NamedNavArgument agora são públicos (#174 (link em inglês), b/181320559).
  • Uma nova extensão NavBackStackEntry#provideToCompositionLocals que fornece o NavBackStackEntry 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 classe NavArgs (#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 componente de navegação agora depende do Lifecycle 2.3.1 e marca setGraph(), popBackStack(), navigateUp() e navigate(), como os métodos que atualizam o Lifecycle da NavBackStackEntry, como @MainThread, alinhando o componente de navegação à aplicação da linha de execução principal introduzida no Lifecycle 2.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 direto www.example.com/{color} mesmo quando a enumeração tiver o valor RED (#152 (link em inglês), b/135857840).

Compatibilidade do Compose

  • androidx.navigation:navigation-compose:2.4.0-alpha01 só é compatível com a versão 1.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 é compatível com navegadores personalizados que usam o mesmo @Navigator.Name("dialog") do DialogFragmentNavigator 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 (link em inglês) pela criação de compatibilidade com o Safe Args gerando um método fromSavedStateHandle() para cada classe NavArgs (#122 (link em inglês), b/136967621).
  • Agradecemos a Bradleycorn (link em inglês) por tornar a análise de argumentos de enumeração 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 (link em inglês) por tornar os campos name e argument e as funções de desestruturação do NamedNavArgument 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 a NavBackStackEntry para os locais de composição relevantes (#175 (link em inglês), b/187229439).
  • Agradecemos a jossiwolf (link em inglês) por melhorar o comportamento do NavigatorProvider#addNavigator para garantir que chamá-lo repetidamente com a mesma instância não causará problemas (#176 (link em inglês), b/187443146).

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 um Modifier, que é transmitido para o contêiner combinável que encapsula os compostos de destino (I85aca, b/175125483).

Correções de bugs

  • NavHost agora funciona mesmo quando um OnBackPressedDispatcherOwner não é encontrado, como esse é o caso ao visualizar o NavHost (I7d8b4).
  • O Navigation Compose agora depende da Navigation 2.3.5, corrigindo um problema ao usar BackHandler dentro de um destino NavHost (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 um ViewModelStoreOwner anulável para determinar melhor se um ViewModelStoreOwner está disponível na composição atual. As APIs que exigem um ViewModelStoreOwner, como viewModel() e NavHost, ainda geram uma exceção se um ViewModelStoreOwner não está definido (Idf39a).

Correções de bugs

  • O Navigation Compose agora depende da 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 do LocalSavedStateRegistryOwner com a NavBackStackEntry desse destino, garantindo que todos os estados salvos diretamente no SavedStateRegistry 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

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) em NavController que retorna a NavBackStackEntry 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() e navigateUp() 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 é compatível com o 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 que permite 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 do NavHost que pode ser composto (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 que pode ser composto 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;
  • compatibilidade com a 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() e currentBackStackEntryAsState() para permitir a elevação do estado e conectar NavController a elementos que podem ser compostos fora do NavHost, 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 ou Uri, agora é possível acessar o Uri, a ação e o tipo MIME no destino resultante ao conseguir a intent dos argumentos pela KEY_DEEP_LINK_INTENT, espelhando a funcionalidade já disponível para links diretos externos (I975c3, b/181521877).

Correções de bugs

  • OnBackPressedCallbacks adicionado a um agente com a NavBackStackEntry, agora que o LifecycleOwner intercepta pressionamentos para voltar de forma correta após o ciclo de vida da atividade ser STOPPED, e depois STARTED (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 a www.example.com e www.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 bentrengrove 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 são compatíveis com o valor inteiro bruto e os valores hexadecimais prefixados por 0x (#127 em inglês, b/179166693).
  • O android:defaultValue para um argumento com app:argType="float" agora é compatível com valores padrão inteiros, permitindo que você use android:defaultValue="0" em vez de exigir o uso de 0.0 (#117 em inglês, b/173766247).

Correções de bugs

  • Correção do travamento do progresso de instalação ao usar a compatibilidade do Navigation para recursos dinâmicos (Ib27a7, b/169636207).
  • Chamar setViewModelStore ou setLifecycleOwner com o mesmo objeto que já foi definido resultará 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 argumentos ReferenceType agora possam ser analisados corretamente quando enviados como parte de um URI de link direto (#127 em inglês, b/179166693).
  • Agradecemos tatocaster (link em inglês) pela solicitação de envio para permitir a compatibilidade com valores padrão para o defaultValue de um argumento com app: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 o Lifecycle dela seja mudado para CREATED (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 uma ResourceNotFoundException (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> com onNavDestinationSelected 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 usar launchSingleTop (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 um popUpTo 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 compatibilidade com o 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 com FragmentScenario e Navigation.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 a NavigationUI é capaz de abrir a gaveta mesmo quando usar LOCK_MODE_LOCKED_CLOSED ou LOCK_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 e navigation-dynamic-features-fragment permitem navegar para destinos definidos em módulos de recursos, gerenciando automaticamente a instalação dos módulos de recursos conforme necessário. Consulte Navegar com módulos de recursos para ver mais informações.
  • Teste de navegação: o artefato navigation-testing fornece um TestNavHostController que permite definir o destino atual e verificar a pilha de retorno 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 na pilha de retorno de navegação agora permite que você acesse um SavedStateHandle adequado para armazenar pequenas quantidades de estado salvo que precisa ser associado a uma entrada específica da pilha de retorno. Consulte Retornar um resultado ao destino anterior para ver mais informações.
  • Compatibilidade de NavigationUI com Openable: todos os usos de DrawerLayout em NavigationUI foram substituídos pela interface Openable mais genérica adicionada em CustomView 1.1.0 e implementada por DrawerLayout em DrawerLayout 1.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 e app:mimeType, além do app:uri disponível anteriormente. NavController agora oferece suporte à navegação por qualquer combinação desses campos graças à nova classe NavDeepLinkRequest. 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 incluirão 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

  • Correção de um NullPointerException ao substituir uma instância de um destino sem argumentos por outra instância com argumentos com singleTop (b/158006669).
  • Todas as exceções destination is unknown geradas por NavController agora têm mais informações de depuração para ajudar a determinar o estado do NavController (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

  • Correção de um problema em que o Lifecycle do NavBackStackEntry não era atualizado corretamente após a interrupção do processo (b/155218371).
  • As instâncias OnDestinationChangedListener registradas antes de chamar setGraph() agora recebem o destino restaurado corretamente após a interrupção do processo (b/155218371).
  • Ao usar singleTop, o NavBackStackEntry agora tem os argumentos atualizados corretamente e enviados para todas as instâncias de OnDestinationChangeListener (b/156545508).

Atualizações de dependência

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 e app:mimeType, além do app:uri disponível anteriormente. O NavController agora é compatível com a navegação por qualquer combinação desses campos por meio da nova classe NavDeepLinkRequest (b/136573074, b/135334841).

Mudanças na API

  • Ampliamos a compatibilidade com DSL do Kotlin para destinos Dynamic Navigation (b/148969800)

Correções de bugs

  • Correção de 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 especificar app:graphPackage, e um padrão será usado adicionando o sufixo moduleName ao applicationId após um ponto. Se você precisa personalizar seu graphPackage, um marcador ${applicationId} agora é compatível. (b/152696768).
  • Agora, a DSL Kotlin de Navigation Graph expõe um defaultArguments Map 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

  • Do 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âncias NavHostFragment na sua Activity (b/147378752, link em inglês)

Atualizações de dependência

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 um Context no construtor em vez de uma Activity (aosp/1250252).

Correções de bugs

  • NavigationUI não ignora mais rótulos vazios (ou seja, um destino com android: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 interface Openable introduzida em CustomView 1.1.0-alpha02, que DrawerLayout implementa usando o DrawerLayout 1.1.0-alpha04, permitindo que você use implementações personalizadas de Openable com NavigationUI (b/129030452).

Correções de bugs

  • As regras navigation-common-ktx do ProGuard agora mantêm corretamente apenas as classes NavArgs que são usadas, em vez de todas as instâncias NavArgs (b/150213558).

Mudanças na dependência

  • O Navigation reverteu a dependência no Core 1.2.0 e agora depende do Core 1.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 Core 1.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 um SavedStateHandle 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() e getPreviousBackStackEntry() foram adicionados para facilitar a recuperação de um NavBackStackEntry para os destinos atuais e anteriores (b/79672220).

Correções de bugs

  • O navigateUp() agora transmite os argumentos do destino atual e KEY_DEEP_LINK_INTENT para o destino anterior ao iniciar o app na sua pilha de tarefas (b/147456890).

Mudanças na dependência

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 classe TestNavHostController. Essa classe oferece uma alternativa ao uso de um NavController 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

  • Do Navigation 2.2.1: os 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).
  • Do Navigation 2.2.1: as regras do ProGuard navigation-ui para DrawerArrowDrawable foram atualizadas para garantir que android.enableJetifier=true não seja obrigatório (b/147610424).
  • Do Navigation 2.2.1: o módulo navigation-common-ktx agora tem um nome de pacote de manifesto exclusivo em vez de ter o mesmo nome de pacote de manifesto que navigation-runtime-ktx (aosp/1141947).

Atualizações de dependência

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âncias NavHostFragment na sua Activity (b/147378752).
  • NavigationUI não ignora mais rótulos vazios (ou seja, um destino com android: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 classes NavArgs que são usadas, em vez de todas as instâncias NavArgs Isso foi lançado anteriormente no Navigation 2.3.0-alpha03. (b/150213558, link em inglês)

Atualizações de dependência

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 a elementos sem correspondência com o link direto (b/147447512).
  • As regras do ProGuard navigation-ui para DrawerArrowDrawable foram atualizadas para garantir que o uso de android.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 que navigation-runtime-ktx (aosp/1141947, link em inglês)

Atualizações de dependência

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. O NavBackStackEntry retornado fornece um LifecycleOwner acionado pela navegação, ViewModelStoreOwner (o mesmo retornado por NavController.getViewModelStoreOwner()), e SavedStateRegistryOwner, 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 usar by navGraphViewModels() ou o construtor ViewModelProvider com um ViewModelStoreOwner retornado por NavController.getBackStackEntry() ou NavController.getViewModelStoreOwner().
  • Compatibilidade de links diretos com parâmetros de consulta: links diretos com parâmetros de consulta agora 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.
  • Melhoria na compatibilidade com animação: NavHostFragment agora usa FragmentContainerView 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 Fragment 1.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

  • Correção de 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 de null (b/141613546).
  • NavHostFragment agora restaura corretamente o gráfico após uma mudança de configuração quando usado com FragmentContainerView (b/143752103).

Mudanças na dependência

  • A navegação agora depende do Lifecycle 2.2.0-rc03, do Lifecycle ViewModel SavedState 1.0.0-rc03, da Activity 1.1.0-rc03 e do Fragment 1.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 suas subclasses agora modificam toString() 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() em Activity 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 chamar setGraph agora resulta em um IllegalStateException. Isso sempre tem que ser definido pelo NavHost como parte da configuração inicial para garantir que todas as instâncias de NavBackStackEntry tenham um armazenamento consistente para instâncias de ViewModel (aosp/1111821).

Correções de bugs

  • Correção de um ConcurrentModificationException ao usar instâncias de ViewModel anexadas a várias instâncias de ViewModelStore 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. A NavBackStackEntry retornada fornece um LifecycleOwner acionado pela navegação, ViewModelStoreOwner (o mesmo retornado por NavController.getViewModelStoreOwner()), e SavedStateRegistryOwner, além de fornecer os argumentos usados para iniciar o destino (aosp/1101691, aosp/1101710, links em inglês)

Correções de bugs

  • Correção de um problema no qual a adição de NavHostFragment a ViewPager2 falhou com um IllegalArgumentException (b/133640271).
  • NavInflater agora evita chamar getResourceName() 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 é a fábrica padrão usada ao usar o by navGraphViewModels() ou o construtor ViewModelProvider com um ViewModelStoreOwner retornado por NavController.getViewModelStoreOwner() (b/135716331).

Mudanças na API

Correções de bugs

  • NavHostFragment agora usa FragmentContainerView, 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 API getViewModelStoreOwner() adicionada a NavController. 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 mostrarão um DialogFragment 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 um Uri, 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 para NavHostController, permitindo que implementações conectassem NavController ao host LifecycleOwner, OnBackPressedDispatcher e ViewModelStore.

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 no NavController que foi introduzida na versão 2.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 usar setupWithNavController() com Toolbar ou CollapsingToolbarLayout (b/131403621, link em inglês)

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 artefato navigation-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() no NavController foi descontinuada e substituída pelo novo método getViewModelStoreOwner(), que retorna um ViewModelStoreOwner (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 destinos FloatingWindow (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).
  • Foi 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 de NavController, NavHostController (aosp/966091).
  • O método setHostOnBackPressedDispatcherOwner() do NavController foi substituído pelo método setOnBackPressedDispatcher() do NavHostController e agora exige que você chame setLifecycleOwner() antes dele (aosp/965409).
  • NavHostController agora contém um método enableOnBackPressed(boolean) que substitui a classe NavHostOnBackPressedManager que foi retornada anteriormente por setHostOnBackPressedDispatcherOwner() (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 o app:defaultNavHost ao interceptar os eventos do botão "Voltar" do sistema, corrigindo uma regressão no Navigation 2.1.0-alpha03 b/132077777.
  • DialogFragmentNavigator agora lida corretamente com as operações popBackStack() e navigateUp() 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 um DialogFragment quando você navigate para eles. O 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ância NavDirections, você pode navegar com um Uri, 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 para corresponder à velocidade de animação padrão de atividades e fragmentos b/130055522.

Mudanças na API

  • O uso do método createFragmentNavigator() do NavHostFragment foi descontinuado, e a funcionalidade dele foi movida para o novo método onCreateNavController() para deixar mais claro que esse é o ponto de entrada correto para adicionar navegadores personalizados ao criar subclasses de NavHostFragment b/122802849.
  • Um método hasDeepLink() foi adicionado a NavDestination para permitir que você verifique se um determinado Uri pode ser manipulado por esse destino ou, no caso de um NavGraph, 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 Back de sistema usando OnBackPressedDispatcher. Isso corrige o problema ao fazer a 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” com app:argType não especificado agora é inferido corretamente como um argumento string 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 de Kotlin ou a API getViewModelStore() adicionada a NavController 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 a app: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 e androidx.fragment:fragment:1.1.0-alpha05. Esta versão também remove a dependência de androidx.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 usa FragmentFactory 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 usar android: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 usará as dependências da Biblioteca de Suporte. Todo o desenvolvimento futuro além da versão 1.0 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

  • Correção de 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 sem FLAG_ACTIVITY_NEW_TASK b/126082008.
  • Correção de 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 e fun no nome do pacote associado à classe R 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 um android:defaultValue para argumentos reference 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() e navigateUp agora retornam corretamente false ao colocar o último destino na pilha de retorno, corrigindo uma regressão introduzida em 1.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 do Navigator ou em argumentos enviados a um NavDestination 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 um app: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).
  • Correção de uma regressão que fazia com que uma única operação popBackStack() exibisse todas as cópias de um destino da parte superior da pilha de retorno, em vez de apenas um destino por vez b/123552990.
  • Correção de um problema em que o estado FragmentNavigator ficava dessincronizado com o do NavController, causando uma IllegalStateException ao tentar restaurar a pilha de retorno 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 classe NavArgs gerada pelo Safe Args em uma Activity ou Fragment b/122603367.
  • O Safe Args agora permite gerar o código Kotlin aplicando o plug-in androidx.navigation.safeargs.kotlin. O código Kotlin é compilado especificamente para módulos exclusivamente Kotlin, usando argumentos padrão e classes imutáveis sobre o padrão do builder, que ainda está disponível no plug-in androidx.navigation.safeargs b/110263087.

Mudanças de comportamento

  • Os links diretos correspondentes agora são direcionados para o link direto que tem os argumentos com nível mais alto de correspondência b/118393029.
  • Agora, a ação de chamar setGraph() em um NavController vai redefinir a backstack (b/111450672).
  • Os links diretos desconhecidos não geraram mais uma IllegalStateException, mas são ignorados, corrigindo problemas com NavHostFragments 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 para ActivityNavigator 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 de getArguments() do NavDirections agora está marcado como @NonNull em vez de @Nullable (b/123243957).

Correções de bugs

  • Agora, NavDeepLinkBuilder processa corretamente vários PendingIntents simultâneos para o mesmo destino usando os argumentos que você transmite para determinar a exclusividade b/120042732.
  • Agora, NavController processa corretamente as operações popBackStack() ao usar um NavHostFragment 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 valores hashCode() iguais corretos quando equals() retorna "true" b/123043662.
  • FragmentNavigator agora gera uma mensagem de erro melhor se você tenta fazer FragmentTransactions personalizadas no FragmentManager do NavHostFragment. Sempre use getChildFragmentManager(). 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

  • MenuItems com menuCategory="secondary" não vão ser mais exibidos na backstack quando usados com métodos NavigationUI b/120104424.
  • AppBarConfiguration agora permite que você defina uma instância substituta de OnNavigateUpListener que será chamada quando navController.navigateUp() retornar false b/79993862 b/120690961.

Alterações interruptivas

  • Ao usar um <argument> com um argType="reference", o Navigation não analisará mais a referência, mas 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étodos setup. Adicione menuCategory="secondary" ao seu MenuItem para evitar a exibição da pilha de retorno aosp/852869.
  • Os métodos fromBundle() das classes Args geradas agora assumem um valor Bundle não nulo em vez de um valor anulável de Bundle (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 é compatível com o 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, substituirão automaticamente as instâncias do {argName} no seu android:label com o argumento correto b/80267266.
  • Navigation agora depende da Biblioteca de suporte 28.0.0 (b/120293333).

Alterações interruptivas

  • OnNavigatedListener foi renomeado como OnDestinationChangedListener b/118670572.
  • OnDestinationChangedListener agora também transmite o Bundle de argumentos aosp/837142.
  • Os atributos app:clearTask e app:launchDocument e os métodos associados foram removidos. Use app:popUpTo com a raiz do seu gráfico para remover todos os destinos da backstack b/119628354.
  • ActivityNavigator.Extras agora usa um padrão Builder e adiciona a capacidade de definir qualquer sinalização Intent.FLAG_ACTIVITY_ aosp/828140.
  • NavController.onHandleDeepLink foi renomeado como handleDeepLink aosp/836063.
  • Muitas classes e métodos que não se destinam à subclassificação, como NavOptions, NavInflater, NavDeepLinkBuilder e AppBarConfiguration, tornaram-se final 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 um FragmentFactory b/119054429.
  • O construtor para NavGraphNavigator não usa mais um Context aosp/835340.
  • NavigatorProvider agora é uma classe, em vez de uma interface. O NavigatorProvider retornado por getNavigatorProvider() não mudou a funcionalidade aosp/830660.
  • O NavDestination.navigate() foi removido. Em vez disso, chame navigate() no Navigator aosp/830663.
  • Refatoração significativa do Navigator, removendo a necessidade de OnNavigatorNavigatedListener e fazendo com que navigate retorne o NavDestination a que a navegação ocorreu.
  • As instâncias do Navigator não podem mais enviar eventos de pop para o NavController. Considere usar um OnBackPressedCallback para interceptar o pressionamento do botão "Voltar" e chamar navController.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 chamando toString() 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 são compatíveis com esquemas personalizados com pontos, hífens e sinais de adição b/112806402.

Alterações interruptivas

  • O módulo navigation-testing-ktx foi incorporado no navigation-testing artifact e não será mais 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.
  • Os gráficos de navegação registrados com manifestos de metadados não são mais compatíveis 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.
  • Correção de 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.
  • Directions agora podem ser geradas para classes internas b/117407555.
  • Correção de um problema ao gerar Directions para um gráfico <include> b/116542123.

Versão 1.0.0-alpha06

20 de setembro de 2018

Novos recursos

Mudanças na API

  • Alteração interruptiva: o método navigate() do Navigator agora usa um parâmetro Navigator.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 Directions do destino Navigation agora estendem a classe Directions 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 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 para app: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 falso quando a pilha de retorno está vazia ou quando o código de destino fornecido não consta na pilha de retorno. 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 serão substituídos pelo estilo CamelCase nos respectivos nomes de método do NavDirections.
    • Por exemplo, DemoController.index se tornará setDemoControllerIndex b/79995048.
    • Por exemplo, action_show_settings se tornará actionShowSettings b/79642240.
  • 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() e hashCode() (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 usa setReorderingAllowed(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 em NavOptions foram descontinuados (b/80338878).

  • O atributo launchDocument das ações e a API associada em NavOptions 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.