Navigazione

Navigation è un framework per la navigazione tra "destinazioni" all'interno di un'app per Android che fornisce un'API coerente, indipendentemente dal fatto che le destinazioni siano implementate come frammenti, attività o altri componenti.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
23 settembre 2026 2.10.2 - - -

Dichiara le dipendenze

Per aggiungere una dipendenza da Navigation, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

Groovy

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21'
}
  
dependencies {
  def nav_version = "2.10.2"

  // Jetpack Compose Integration
  implementation "androidx.navigation:navigation-compose:$nav_version"

  // Views/Fragments Integration
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Feature module support for Fragments
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

  // Testing Navigation
  androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

  // JSON serialization library, works with the Kotlin serialization plugin.
  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3"
}

Kotlin

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  kotlin("plugin.serialization") version "2.0.21"
}

dependencies {
  val nav_version = "2.10.2"

  // Jetpack Compose integration
  implementation("androidx.navigation:navigation-compose:$nav_version")

  // Views/Fragments integration
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Feature module support for Fragments
  implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

  // Testing Navigation
  androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

  // JSON serialization library, works with the Kotlin serialization plugin
  implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

Safe Args

Per aggiungere Safe Args al tuo progetto, includi il seguente classpath nel file build.gradle di primo livello:

Groovy

buildscript {
    repositories {
        google()
    }
    dependencies {
        def nav_version = "2.10.2"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

Kotlin

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.10.2"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

Devi anche applicare uno dei due plug-in disponibili.

Per generare codice del linguaggio Java adatto a moduli Java o misti Java e Kotlin, aggiungi questa riga al file build.gradle della tua app o del tuo modulo:

Groovy

plugins {
  id 'androidx.navigation.safeargs'
}

Kotlin

plugins {
    id("androidx.navigation.safeargs")
}

In alternativa, per generare codice Kotlin adatto a moduli solo Kotlin, aggiungi:

Groovy

plugins {
  id 'androidx.navigation.safeargs.kotlin'
}

Kotlin

plugins {
    id("androidx.navigation.safeargs.kotlin")
}

Devi avere android.useAndroidX=true nel tuo file gradle.properties come indicato in Migrazione ad AndroidX.

Per informazioni sull'utilizzo delle estensioni Kotlin, consulta la documentazione di ktx.

Per saperne di più sulle dipendenze, consulta Aggiungi dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Versione 2.10.2

23 settembre 2026

androidx.navigation:navigation-*:2.10.2 è stato rilasciato. La versione 2.10.2 contiene questi commit.

Aggiornamenti delle dipendenze

  • Aggiornamento delle dipendenze androidx.lifecycle alla versione 2.10.0. I4505a9f9a

Versione 2.10.1

9 settembre 2026

androidx.navigation:navigation-*:2.10.1 è stato rilasciato. La versione 2.10.1 contiene questi commit.

Correzioni di bug

  • Nei casi in cui NavHost salta le animazioni, ora considererà anche sizeTransform come parte dell'animazione saltata per evitare eventuali ritagli imprevisti. (I4f995, b/550924680)

Versione 2.10.0

26 agosto 2026

androidx.navigation:navigation-*:2.10.0 è stato rilasciato. La versione 2.10.0 contiene questi commit.

Modifiche importanti rispetto alla versione 2.9.0:

  • NavHost ora fornisce un overload che accetta i parametri predictivePopEnterTransition e predictivePopExitTransition per consentire la transizione personalizzata durante il gesto Indietro predittivo.
  • handleDeepLink è stato modificato per garantire che vengano gestiti solo i deep link riconosciuti, mentre tutti gli altri verranno ignorati. Se questo causa un errore nella tua app, valuta la possibilità di passare alla navigazione tramite deep link definiti nel grafico di navigazione. Per i test Robolectric, potrebbe essere necessario utilizzare il metodo setPackage per un pacchetto attendibile.
  • È stato aggiunto NavBackStackEntryInfo per esporre gli snapshot del back stack durante gli eventi di navigazione. In questo modo, è possibile creare animazioni Indietro predittivo personalizzate più complete.

Supporto di piattaforme aggiuntive

  • I moduli navigation-common, navigation-runtime e navigation-testing hanno aggiunto il supporto per desktop, linux, macOS, iOS, javascript, WASM, watchos e tvos.

Versione 2.10.0-rc01

12 agosto 2026

androidx.navigation:navigation-*:2.10.0-rc01 è stato rilasciato. La versione 2.10.0-rc01 contiene questi commit.

Modifiche del comportamento

  • L'SDK minimo per la navigazione è stato spostato all'API 24 insieme al resto delle librerie AndroidX. (I972da, b/474169350)

Versione 2.10.0-beta01

29 luglio 2026

androidx.navigation:navigation-*:2.10.0-beta01 è stato rilasciato. La versione 2.10.0-beta01 contiene questi commit.

Modifiche alle API

  • Introduzione di NavBackStackEntryInfo per esporre gli snapshot del back stack durante gli eventi di navigazione. In questo modo, è possibile creare animazioni Indietro predittivo personalizzate più complete. (Icb3b8)

Versione 2.10.0-alpha06

1° luglio 2026

androidx.navigation:navigation-*:2.10.0-alpha06 è stato rilasciato. La versione 2.10.0-alpha06 contiene questi commit.

Correzioni di bug

  • Modificato handleDeepLink per garantire che vengano gestiti solo i deep link riconosciuti (Id4fe3, b/509640056)
  • ComposableFragment è stato modificato per utilizzare il nome completo della destinazione anziché un argomento del frammento per espandere le funzioni componibili. (I65ded, b/509640586)
  • Risolto un arresto anomalo in FragmentNavigator che causava la generazione di un'eccezione IllegalArgumentException da parte di frammenti legittimi quando le operazioni venivano ottimizzate. (I093b0, b/340202276)
  • È stato corretto un errore in Navigazione con frammenti per cui l'impostazione del grafico in modo programmatico non veniva ripristinata correttamente. (I41251, b/321147435)

Versione 2.10.0-alpha05

19 maggio 2026

androidx.navigation:navigation-*:2.10.0-alpha05 è stato rilasciato. La versione 2.10.0-alpha05 contiene questi commit.

Versione 2.10.0-alpha04

6 maggio 2026

androidx.navigation:navigation-*:2.10.0-alpha04 è stato rilasciato. La versione 2.10.0-alpha04 contiene questi commit.

Correzioni di bug

  • NavHost migliorato per rafforzare la protezione contro possibili NullPointerException causati da una race condition con Indietro predittivo. (Ie36c6, b/500945998)

Versione 2.10.0-alpha03

22 aprile 2026

androidx.navigation:navigation-*:2.10.0-alpha03 è stato rilasciato. La versione 2.10.0-alpha03 contiene questi commit.

Correzioni di bug

  • Aggiornamento di Compose compileSdk all'API 37. Ciò significa che, se utilizzi Compose, è richiesta una versione minima di AGP 9.2.0. (Id45cd, b/413674743)

Contributo esterno

  • watchos e tvos target aggiunti ai moduli navigation-common, navigation-runtime e navigation-testing (I60e46)
  • Rendi pubblico DefaultNavTransitions (Ide293)

Versione 2.10.0-alpha02

25 marzo 2026

androidx.navigation:navigation-*:2.10.0-alpha02 è stato rilasciato. La versione 2.10.0-alpha02 contiene questi commit.

Versione 2.10.0-alpha01

11 marzo 2026

androidx.navigation:navigation-*:2.10.0-alpha01 è stato rilasciato. La versione 2.10.0-alpha01 contiene questi commit.

Nuove funzionalità

  • NavHost ora fornisce un overload che accetta i parametri predictivePopEnterTransition e predictivePopExitTransition per consentire la transizione personalizzata durante il gesto Indietro predittivo. (Iac9b0, b/478294569)

Aggiornamento dell'SDK minimo

Contributo esterno

  • navigation:navigation-common, navigation:navigation-runtime e navigation:navigation-testing ora supportano desktop, Linux, macOS, iOS, JavaScript e WASM, oltre ad Android. Grazie a Konstantin Tskhovrebov. (I035d9, Iec624, I1615d)

Versione 2.9

Versione 2.9.8

22 aprile 2026

androidx.navigation:navigation-*:2.9.8 è stato rilasciato. La versione 2.9.8 contiene questi commit.

Correzioni di bug

  • NavHost migliorato per rafforzare la protezione contro possibili NullPointerException causati da una race condition con Indietro predittivo. (Ie36c6, b/500945998)

Versione 2.9.7

28 gennaio 2026

androidx.navigation:navigation-*:2.9.7 è stato rilasciato. La versione 2.9.7 contiene questi commit.

Correzioni di bug

  • La navigazione SafeArgs non presenta più problemi di memorizzazione nella cache della configurazione quando viene utilizzata con i servizi Google. (I57cda, b/458071608)
  • Risolto il problema per cui il costruttore di test SavedStateHandle in navigation-testing non decodificava List<String>. (I26aac,b/454180135)

Versione 2.9.6

5 novembre 2025

androidx.navigation:navigation-*:2.9.6 è stato rilasciato. La versione 2.9.6 contiene questi commit.

Correzioni di bug

  • È stata eseguita la migrazione del plug-in Navigation SafeArgs alle moderne API del plug-in Android per Gradle, il che dovrebbe garantire la compatibilità con tutte le release di AGP 8.4.2 e versioni successive. A seguito di queste modifiche, la directory di output per i file generati dal plug-in è stata modificata nella posizione predefinita fornita da AGP. (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197)
  • Il plug-in di navigazione SafeArgs non richiederà più l'impostazione della proprietà useAndroidX se utilizzato con AGP 9.0.0-alpha04+. (I6c3a4, b/444746731, b/443106400)

Versione 2.9.5

24 settembre 2025

androidx.navigation:navigation-*:2.9.5 è stato rilasciato. La versione 2.9.5 contiene questi commit.

Correzioni di bug

  • Navigation Safe Args ora può gestire il supporto di AGP 9.0 per Kotlin integrato. (I1d9d76)

Aggiornamento delle dipendenze

  • Il plug-in Navigation Safe Args ora dipende dalla versione 8.4.2 del plug-in Android per Gradle. (b/431847270, I5932a)

Versione 2.9.4

10 settembre 2025

androidx.navigation:navigation-*:2.9.4 è stato rilasciato. La versione 2.9.4 contiene questi commit.

Correzioni di bug

  • Risolto un arresto anomalo che si verificava quando un evento Indietro predittivo veniva inviato a metà frame dopo la disattivazione del gestore in una transizione NavHost. (I5667c, b/384186542)

Versione 2.9.3

30 luglio 2025

androidx.navigation:navigation-*:2.9.3 è stato rilasciato. La versione 2.9.3 contiene questi commit.

Correzioni di bug

  • Risolto un errore in NavController che causava un ConcurrentModificationException quando si utilizzava OnDestinationChangedListeners. (If7406, b/417784831)
  • È stato corretto un errore durante l'utilizzo di navigate(uri, navOptions,navigationExtras) in cui gli extra venivano ignorati. (I67fb7, b/430336813)

Versione 2.9.2

16 luglio 2025

androidx.navigation:navigation-*:2.9.2 è stato rilasciato. La versione 2.9.2 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema per cui la voce non veniva ripresa quando la finestra di dialogo sopra la voce veniva chiusa (Idb20e, b/418746335)
  • Risolto l'errore MissingFieldException durante il test di SavedStateHandle con route con sicurezza dei tipi durante l'utilizzo di NavTypes personalizzati. (I2f843, b/421002511)

Versione 2.9.1

2 luglio 2025

androidx.navigation:navigation-*:2.9.1 è stato rilasciato. La versione 2.9.1 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui le NavEntries di cui era stata creata un'istanza utilizzando single top non andavano mai oltre CREATED nel loro Lifecycle.State. (I043ba, b/421095236)

Versione 2.9.0

7 maggio 2025

androidx.navigation:navigation-*:2.9.0 è stato rilasciato. La versione 2.9.0 contiene questi commit.

Modifiche importanti dalla versione 2.8.0

  • Le azioni di Navigation Safe Args ora vengono generate con l'annotazione @CheckResult per garantire che vengano utilizzate.

Interfaccia SupportingPane

  • I navigatori personalizzati ora possono contrassegnare le loro destinazioni come implementazioni dell'interfaccia SupportingPane, il che indica a NavController che queste destinazioni verranno mostrate insieme ad altre. Ad esempio, utilizzando questa interfaccia, è possibile RESUMED più destinazioni contemporaneamente.

Compose Kotlin Multiplatform

  • La navigazione ora offre una nuova funzione NavController.handleDeepLink() comune che accetta un NavDeepLinkRequest anziché un Intent. In questo modo, le piattaforme diverse da Android possono gestire correttamente i deep link. Grazie Konstantin Tskhovrebov!
  • La navigazione ora offre NavUri, una nuova funzione di analisi comune che è un'API compatibile con l'URI di Android su altre piattaforme. In questo modo è possibile creare un URI in modo indipendente dalla piattaforma. Grazie Konstantin Tskhovrebov!

Funzioni Type Safe

  • Le API type-safe, che in precedenza erano accessibili solo tramite i metodi reified, ovvero composable<YourScreen> ora ha versioni non reificate che accettano direttamente un'istanza KClass.
  • La sicurezza dei tipi di navigazione ora supporta le classi di valore come route o come tipo di argomento di una route.

Versione 2.9.0-rc01

23 aprile 2025

androidx.navigation:navigation-*:2.9.0-rc01 è stato rilasciato. La versione 2.9.0-rc01 contiene questi commit.

Correzioni di bug

  • Sono stati rimossi tutti i target di piattaforme non Android da Jetpack Navigation, poiché non funzionano. Ora vengono forniti stub per piattaforme diverse.(I2877d)

Versione 2.9.0-beta01

9 aprile 2025

androidx.navigation:navigation-*:2.9.0-beta01 è stato rilasciato. La versione 2.9.0-beta01 contiene questi commit.

Modifiche alle API

  • L'API comune di parseStringAsNavUri è stata modificata in una funzione factory NavUri che accetta una stringa. (I4db6e, b/403616316)

Aggiornamenti delle dipendenze

  • Questa libreria ora ha come target il livello di linguaggio Kotlin 2.0 e richiede KGP 2.0.0 o versioni successive. (Idb6b5)

Versione 2.9.0-alpha09

26 marzo 2025

androidx.navigation:navigation-*:2.9.0-alpha09 è stato rilasciato. La versione 2.9.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Il modulo navigation-testing ora supporta desktop, Linux, macOS e iOS, oltre ad Android. (I2b770, b/398265336)
  • NavType è ora supportato su computer, Linux, macOS e iOS, oltre che su Android. (I297d8)

Versione 2.9.0-alpha08

12 marzo 2025

androidx.navigation:navigation-*:2.9.0-alpha08 è stato rilasciato. La versione 2.9.0-alpha08 contiene questi commit.

Correzioni di bug

  • Da Navigation 2.8.9: è stata corretta una regressione rilevata in Navigation 2.8.8 che richiedeva che un deep link corrispondesse esattamente a tutti i campi di una richiesta di collegamento o di un intent di deep link per essere considerato una corrispondenza. Ciò ha causato il mancato funzionamento dei deep link che contenevano corrispondenze parziali dei campi e non ne avevano altre. (Ie5e36, b/399826566)

Contributo esterno

  • Nuova funzione di parser comune per creare un NavUri. Grazie Konstantin Tskhovrebov! (If0a6a)

Versione 2.9.0-alpha07

26 febbraio 2025

androidx.navigation:navigation-*:2.9.0-alpha07 è stato rilasciato. La versione 2.9.0-alpha07 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui il tentativo di saveState con un pop non inclusivo generava un savedState nullo che poteva causare un arresto anomalo durante il ripristino. (I9f3e8, b/395091644)
  • A partire da Navigation 2.8.8: la corrispondenza di NavDeepLink è stata corretta in modo che un deep link e una richiesta di deep link debbano corrispondere esattamente per URI, azione e MIME. La corrispondenza non è più consentita se corrisponde solo uno o due campi. (I3b029, b/395712033)
  • Da Navigation 2.8.8: è stato corretto un bug per cui i percorsi con percorsi con caratteri jolly non corrispondono a un deep link aggiunto (I7ea92, b/389970341)

Contributo esterno

  • Estrai le API navigation-common, navigation-runtime e navigation-compose nella piattaforma comune. Grazie Konstantin Tskhovrebov! (I1e626, Ica76f, Idf479)

Problemi noti

  • A causa del lavoro per risolvere il problema b/395712033, i deep link devono erroneamente avere tutti gli stessi campi della richiesta di deep link e/o di Intent. I deep link devono corrispondere solo ai campi che contengono, mentre i campi non inclusi devono essere ignorati. Questo problema è stato risolto per una release successiva nell'ambito di b/399826566.

Versione 2.9.0-alpha06

12 febbraio 2025

androidx.navigation:navigation-*:2.9.0-alpha06 è stato rilasciato. La versione 2.9.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Le azioni di Navigation Safe Args ora vengono generate con l'annotazione @CheckResult per garantire che vengano utilizzate. (I14d4c, b/356323084)

Correzioni di bug

  • È stato corretto un errore in NavController per cui veniva eseguito un tentativo errato di ripristinare gli stati backStack in un array quando venivano salvati in un elenco. (Idfb9b)
  • Da Navigation 2.8.7: Navigation Safe Args ora supporta le destinazioni componibili. (I35320, b/362791955)

Versione 2.9.0-alpha05

29 gennaio 2025

androidx.navigation:navigation-*:2.9.0-alpha05 è stato rilasciato. La versione 2.9.0-alpha05 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema che causava un'animazione di scalabilità imprevista durante l'utilizzo di Navigation Compose. (I480f4, b/353294030)
  • Da Navigazione 2.8.6: le etichette NavDestination fornite tramite XML verranno analizzate tramite NavType.get per garantire il rispetto della logica NavType personalizzata. (I7ec2f, b/388100796)
  • Da Navigation 2.8.6: quando si passa all'attività con dataPattern, ActivityNavigator ora tenta di codificare il valore dell'argomento con il relativo NavType. (I16376, b/383616432)
  • Da Navigation 2.8.5: è stato risolto un problema che causava un'animazione di scalabilità imprevista quando si utilizzava Navigation Compose e si chiamava navigate nello stesso frame in cui termina l'animazione corrente. (I26cb1, b/353294030)

Versione 2.9.0-alpha04

11 dicembre 2024

androidx.navigation:navigation-*:2.9.0-alpha04 è stato rilasciato. La versione 2.9.0-alpha04 contiene questi commit.

Nuove funzionalità

La tabella seguente fornisce le API reificate e KClass.

reified KClass
composable<TestClass> { } composable(TestClass::class) { }
navigation<NestedGraph>(startDestination = TestClass::class) navigation(route = NestedGraph::class, startDestination = TestClass::class)
dialog<TestClass> {} dialog(TestClass::class) {}
navDeepLink<TestClass>(baseUri) navDeepLink(TestClass::class, baseUri)
NavDeepLink.Builder.setUriPattern<TestClass>(baseUri) NavDeepLink.Builder.setUriPattern(TestClass::class, baseUri)
NavDestinationBuilder.deepLink<TestDeepLink>(baseUri) { } NavDestinationBuilder.deepLink(TestDeepLink::class, baseUri) { }
navController.getBackStackEntry<TestClass>() navController.getBackStackEntry(TestClass::class)
navController.popBackStack<TestClass>(true) navController.popBackStack(TestClass::class, true)
navController.clearBackStack<TestClass>() navController.clearBackStack(TestClass::class)
NavOptions.setPopUpTo<TestClass>() NavOptions.setPopUpTo(TestClass::class)
navOptions { popUpTo<TestClass> {...} } navOptions { popUpTo(TestClass::class) {...} }
NavGraph.setStartDestination<TestClass>() NavGraph.setStartDestination(TestClass::class)
NavGraph.findNode<TestClass>() NavGraph.findNode(TestClass::class)
backStackEntry.toRoute<TestClass>() backStackEntry.toRoute(TestClass::class)
savedStateHandle.toRoute<TestClass>() savedStateHandle.toRoute(TestClass::class)

Modifiche alle API

  • L'overload NavGraph.setStartDestination specifico di Kotlin per la sicurezza dei tipi è nascosto dalle origini Java. (Ic640c, b/364634035)

Correzioni di bug

  • Da Navigation 2.8.5: è stato risolto un problema per cui NavHost poteva generare un'eccezione all'interno di PredictiveBackHandler se il back stack viene ridotto a 1 voce e un back di sistema viene attivato nello stesso frame. (I1a429, b/375343407)
  • Da Navigazione 2.8.5: è stato corretto NavDestination NullPointerException durante l'aggiornamento di startDestination di un grafico. (I99421, b/361560785)

Contributo esterno

Versione 2.9.0-alpha03

13 novembre 2024

androidx.navigation:navigation-*:2.9.0-alpha03 è stato rilasciato. La versione 2.9.0-alpha03 contiene questi commit.

Nuove funzionalità

  • La sicurezza dei tipi di navigazione ora supporta le classi di valore come route o come tipo di argomento di una route. (I9344a, b/374347483)

Correzioni di bug

  • È stato risolto un ConcurrentModificationException che poteva verificarsi quando un LifecycleObserver collegato a un NavBackStackEntry attivava una modifica al back stack quando l'LifecycleOwner host, ad esempio l'attività o il frammento contenente, cambiava lo stato del ciclo di vita. (Ia9494)

Versione 2.9.0-alpha02

30 ottobre 2024

androidx.navigation:navigation-*:2.9.0-alpha02 è stato rilasciato. La versione 2.9.0-alpha02 contiene questi commit.

Contributo esterno

  • Nuovo metodo NavController.handleDeepLink(request: NavDeepLinkRequest) comune. Grazie Konstantin Tskhovrebov! (I3e228)

Versione 2.9.0-alpha01

16 ottobre 2024

androidx.navigation:navigation-*:2.9.0-alpha01 è stato rilasciato. La versione 2.9.0-alpha01 contiene questi commit.

Nuove funzionalità

  • I navigatori personalizzati ora possono contrassegnare le loro destinazioni come implementazioni dell'interfaccia SupportingPane, il che indica a NavController che queste destinazioni verranno mostrate insieme ad altre. Ad esempio, utilizzando questa interfaccia, è possibile RESUMED più destinazioni contemporaneamente. (Id5559)
  • Da Navigation 2.8.3: sono stati aggiunti nuovi controlli lint per i moduli navigation-common, navigation-runtime e navigation-compose per identificare i percorsi con sicurezza dei tipi che non sono annotati correttamente con @Serializable. Questo controllo viene applicato a tutte le funzioni di estensione NavGraphBuilder e NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Da Navigation 2.8.3: sono stati aggiunti nuovi controlli lint per i moduli navigation-common, navigation-runtime e navigation-compose per identificare eventuali route con sicurezza dei tipi con argomenti Enum non annotati correttamente con @Keep. Questo controllo viene applicato a tutte le funzioni di estensione NavGraphBuilder e NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Modifiche del comportamento

  • Il tentativo di utilizzare un NavController che è stato precedentemente DESTROYED ora causerà un IllegalStateException. (I520da, b/369616172)

Correzioni di bug

  • Aggiorna l'eccezione di classe Enum non trovata per suggerire l'utilizzo dell'annotazione @Keep nel caso in cui la classe Enum venga cancellata nelle build minimizzate. (I90e79, b/358137294)

Problemi noti

  • Si è verificato un problema con le nuove regole di lint aggiunte in Navigation 2.8.* che causano un errore Obsolete custom lint check quando si tenta di eseguire lint con il plug-in Android per Gradle 8.4+. (b/368070326, b/371463741)

Versione 2.8

Versione 2.8.9

12 marzo 2025

androidx.navigation:navigation-*:2.8.9 è stato rilasciato. La versione 2.8.9 contiene questi commit.

Correzioni di bug

  • È stata corretta una regressione rilevata in Navigation 2.8.8 che richiedeva che un deep link corrispondesse esattamente a tutti i campi di una richiesta di collegamento o di un intent di deep link per essere considerato una corrispondenza. Ciò ha causato il mancato funzionamento dei deep link che contenevano corrispondenze parziali dei campi e non ne avevano altre. (Ie5e36, b/399826566)

Versione 2.8.8

26 febbraio 2025

androidx.navigation:navigation-*:2.8.8 è stato rilasciato. La versione 2.8.8 contiene questi commit.

Correzioni di bug

  • Risolto un bug per cui i percorsi con caratteri jolly non corrispondevano a un deep link aggiunto. (I7ea92, b/389970341)
  • La corrispondenza di NavDeepLink è stata corretta in modo che un deep link e una richiesta di deep link debbano corrispondere esattamente per URI, azione e MIME. La corrispondenza non è più consentita se corrisponde solo uno o due campi. (I3227f, b/395712033)

Problemi noti

  • A causa del lavoro per risolvere il problema b/395712033, i deep link devono erroneamente avere tutti gli stessi campi della richiesta di deep link e/o di Intent. I deep link devono corrispondere solo ai campi che contengono, mentre i campi non inclusi devono essere ignorati. Questo problema è stato risolto per una release successiva nell'ambito di b/399826566.

Versione 2.8.7

12 febbraio 2025

androidx.navigation:navigation-*:2.8.7 è stato rilasciato. La versione 2.8.7 contiene questi commit.

Correzioni di bug

  • Navigation Safe Args ora fornisce il supporto per le destinazioni componibili. (I35320, b/362791955)

Versione 2.8.6

29 gennaio 2025

androidx.navigation:navigation-*:2.8.6 è stato rilasciato. La versione 2.8.6 contiene questi commit.

Correzioni di bug

  • Le etichette NavDestination fornite tramite XML verranno analizzate tramite NavType.get per garantire il rispetto della logica NavType personalizzata. (Id366d, b/388100796)
  • Quando si passa all'attività con dataPattern, ActivityNavigator ora tenterà di codificare il valore dell'argomento con il NavType dell'argomento. (I1a71d, b/383616432)

Versione 2.8.5

11 dicembre 2024

androidx.navigation:navigation-*:2.8.5 è stato rilasciato. La versione 2.8.5 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui NavHost poteva generare un'eccezione all'interno di PredictiveBackHandler se il back stack viene ridotto a una voce e viene attivato un pulsante Indietro di sistema nello stesso frame. (I1a429, b/375343407)
  • Risolto il problema NavDestination NullPointerException durante l'aggiornamento di startDestination di un grafico. (I99421, b/361560785)
  • È stato risolto un problema che causava un'animazione di scalabilità imprevista quando si utilizzava Navigation Compose e si chiamava navigate nello stesso frame in cui termina l'animazione corrente. (I26cb1, b/353294030)
  • È stato risolto un ConcurrentModificationException che poteva verificarsi quando un LifecycleObserver collegato a un NavBackStackEntry attivava una modifica al back stack quando l'LifecycleOwner host, ad esempio l'attività o il frammento contenente, cambiava lo stato del ciclo di vita. (Ia9494)

Contributo esterno

  • La sicurezza dei tipi di navigazione ora supporta List<Enum> come tipo di argomento di un percorso senza richiedere NavType personalizzati. Grazie Csaba Kozák. (GH-725, b/375559962)

Versione 2.8.4

13 novembre 2024

androidx.navigation:navigation-*:2.8.4 è stato rilasciato. La versione 2.8.4 contiene questi commit.

Nuove funzionalità

Correzioni di bug

Versione 2.8.3

16 ottobre 2024

androidx.navigation:navigation-*:2.8.3 è stato rilasciato. La versione 2.8.3 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti nuovi controlli lint per i moduli navigation-common, navigation-runtime e navigation-compose per identificare i percorsi con sicurezza dei tipi che non sono annotati correttamente con @Serializable. Questo controllo viene applicato a tutte le funzioni di estensione NavGraphBuilder e NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Sono stati aggiunti nuovi controlli lint per i moduli navigation-common, navigation-runtime e navigation-compose per identificare eventuali route con sicurezza dei tipi con argomenti Enum non annotati correttamente con @Keep. Questo controllo viene applicato a tutte le funzioni di estensione NavGraphBuilder e NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Correzioni di bug

  • Risolto un problema per cui le nuove regole di lint aggiunte in Navigation 2.8.* causavano un errore Obsolete custom lint check quando si tentava di eseguire lint con il plug-in Android per Gradle 8.4 e versioni successive. (I1be3d, b/368070326, b/371463741)

Problemi noti

  • Il lint di navigazione genera un errore di controllo lint personalizzato obsoleto quando si tenta di eseguire il lint con Lint 16 (AGP 8.7) o versioni successive. (b/371926651)

Versione 2.8.2

2 ottobre 2024

androidx.navigation:navigation-*:2.8.2 è stato rilasciato. La versione 2.8.2 contiene questi commit.

Nuove funzionalità

  • La sicurezza dei tipi di navigazione ora supporta le classi Serializable che includono Double, Double?, DoubleArray, DoubleArray?, List<Double> e List<Double>? senza richiedere NavType personalizzati. (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)

Correzioni di bug

  • È stato migliorato il messaggio di errore visualizzato quando Navigation non riesce a mappare l'argomento di un percorso a un NavType. Il nuovo messaggio di errore conterrà il nome dell'argomento, il nome completo dell'argomento e il nome completo del percorso. (Id8416, b/346264232)

Versione 2.8.1

18 settembre 2024

androidx.navigation:navigation-*:2.8.1 è stato rilasciato. La versione 2.8.1 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta una nuova regola lint per garantire l'utilizzo della funzione popBackStack che accetta un tipo di classe reificata quando si tenta di eseguire popBackStack utilizzando API con sicurezza dei tipi. (Ief161, b/358095343)

Correzioni di bug

  • La navigazione ora richiede che il percorso passato a un startDestination di un NavGraph contenga i valori per tutti gli argomenti obbligatori, inclusi gli argomenti non nullabili e senza valore predefinito. (I18e74, b/362594265)
  • Navigation Safe Args ha aggiunto il supporto per le stringhe non nullable, in modo che i valori "null" vengano analizzati e archiviati nel bundle così come sono. Questo comportamento si discosta da quello esistente, in cui i valori "null" vengono analizzati in un oggetto null. Questa modifica si applica solo ai tipi String non nullable. Le stringhe che ammettono valori null rimangono invariate. (I08b4a, b/348936238)
  • Un NavDestination non può più essere collegato tramite deep link, se non tramite un deep link aggiunto esplicitamente alla destinazione. Ciò significa anche che puoi navigare verso il percorso di una destinazione solo con l'overload della funzione di navigazione che accetta un percorso di stringa. In questo modo viene corretta una vulnerabilità che consentiva di creare un deep link a una destinazione potenzialmente protetta. (Ie30e6)

Aggiornamento delle dipendenze

  • Navigation Safe Args ora dipende da Kotlin 1.9.24, anziché da Kotlin 2.X, per garantire che gli sviluppatori non siano costretti a eseguire l'aggiornamento. (a4129a)
  • Navigation Compose ora dipende da Compose 1.7.2.

Versione 2.8.0

4 settembre 2024

androidx.navigation:navigation-*:2.8.0 è stato rilasciato. La versione 2.8.0 contiene questi commit.

Modifiche importanti dalla versione 2.7.0

Sicurezza dei tipi di DSL Kotlin di navigazione

  • Navigation ora fornisce la sicurezza dei tipi per il DSL Kotlin (utilizzato da Navigation Compose) utilizzando la serializzazione Kotlin per consentirti di definire le destinazioni nel grafico di navigazione tramite oggetti e classi di dati con sicurezza dei tipi:
    // Define a home destination that doesn't take any arguments
    @Serializable
    object Home

    // Define a profile destination that takes an ID
    @Serializable
    data class Profile(val id: String)

    // Now define your NavHost using type safe objects
    NavHost(navController, startDestination = Home) {
        composable<Home> {
            HomeScreen(onNavigateToProfile = { id ->
                navController.navigate(Profile(id))
            })
        }
        composable<Profile> { backStackEntry ->
            val profile: Profile = backStackEntry.toRoute()
            ProfileScreen(profile)
        }
    }

Per saperne di più, consulta il blog post Navigation Compose meet Type Safety.

Indietro predittivo di Navigation Compose

  • Navigation Compose ora supporta l'indietro predittivo in-app tramite le nuove API SeekableTransitionState di compose-animation. In questo modo, puoi utilizzare il gesto Indietro per visualizzare la destinazione precedente con la transizione personalizzata prima di decidere se eseguire il commit della transazione tramite il gesto completato o annullarla.

Frammento componibile di navigazione

  • È stato aggiunto un nuovo artefatto navigation-fragment-compose che include un'alternativa ComposableNavHostFragment a NavHostFragment che ti consente di aggiungere destinazioni componibili ai tuoi file XML di navigazione. Ogni destinazione composable deve essere espressa come metodo @Composable di primo livello senza argomenti, il cui nome completo viene utilizzato come attributo android:name in ogni destinazione. Quando si accede a una di queste destinazioni, viene creato un frammento contenitore per visualizzare i contenuti componibili.
  // In HomeScreen.kt
  @Composable
  fun HomeScreen() {
    // Your Composable content here
  }

  // In your navigation.xml
  <composable
    android:id="@+id/home_screen"
    android:name="com.example.HomeScreenKt\$HomeScreen" />

Altre modifiche

  • Navigation Compose ora dipende da Compose 1.7.0.
  • Navigation ora fornisce una nuova classe CollectionNavType<T>, una sottoclasse di NavType<T> per gli argomenti basati su raccolte, come elenchi, array e mappe. Tutti gli array NavType predefiniti (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType e StringArrayType) ora ereditano da questa nuova classe.
  • NavType ora supporta in modo nativo gli elenchi di Int, String, Boolean, Float e Long.

Versione 2.8.0-rc01

21 agosto 2024

androidx.navigation:navigation-*:2.8.0-rc01 è stato rilasciato. La versione 2.8.0-rc01 contiene questi commit.

Correzioni di bug

  • È stato corretto l'arresto anomalo della navigazione quando si passano classi Enum di primo livello come argomenti di sicurezza dei tipi. (I0ba76, b/358137294)
  • Navigation 2.8 ora funziona correttamente con l'SDK 34 e non passerà all'SDK 35 fino alla release 2.9, insieme al resto delle librerie AndroidX. (b/358798728)

Versione 2.8.0-beta07

7 agosto 2024

androidx.navigation:navigation-*:2.8.0-beta07 è stato rilasciato. La versione 2.8.0-beta07 contiene questi commit.

Problemi noti

  • A causa di b/358137294, sono supportati solo gli enum nidificati in un'altra classe. Gli enum di primo livello saranno supportati nella prossima release.

Correzioni di bug

  • Quando si naviga verso destinazioni duplicate o condivise, la navigazione darà la priorità alla destinazione corrispondente più vicina dalla posizione corrente nel grafico. (Ic89a4, b/352006850)
  • La navigazione in Safe Args ora ha un nuovo NavType.EnumType. Ciò significa che i tipi Enum non richiedono più NavType personalizzati. Tieni presente che il SerialName di Enum deve essere il nome completo predefinito. (I66d22, b/346475493)
  • La navigazione in Safe Args ha aggiunto il supporto integrato per i tipi di argomenti che ammettono valori null, tra cui Int?, Long?, Float?, Boolean? e Enum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237)
  • startDestination di NavGraph ora utilizzerà i valori degli argomenti predefiniti se il percorso startDestination passato a NavGraph è esattamente uguale a startDestination.route. (I13762, b/354046047)

Versione 2.8.0-beta06

24 luglio 2024

androidx.navigation:navigation-*:2.8.0-beta06 è stato rilasciato. La versione 2.8.0-beta06 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui i controlli lint di WrongStartDestinationType non controllavano gli oggetti Companion sul tipo di classe passato, impedendo a lint di rilevare l'errore. (I92b09)

Versione 2.8.0-beta05

10 luglio 2024

androidx.navigation:navigation-*:2.8.0-beta05 è stato rilasciato. La versione 2.8.0-beta05 contiene questi commit.

Correzioni di bug

  • È stato corretto l'arresto anomalo della navigazione di singleTop quando NavGraphs nidificati condividono lo stesso percorso startDestination. (I17b94, b/294408596)

Versione 2.8.0-beta04

26 giugno 2024

androidx.navigation:navigation-*:2.8.0-beta04 è stato rilasciato. La versione 2.8.0-beta04 contiene questi commit.

Correzioni di bug

  • La navigazione ora supporta la navigazione con stringhe vuote negli argomenti del percorso. (Ic5dbd, b/339481310)
  • Miglioramento del messaggio di errore per i serializzatori personalizzati dichiarati direttamente nei campi della classe tramite @Serializable(with =...) per chiarire che si tratta di una funzionalità attualmente non supportata. (I052b0, b/341319151)
  • L'API di test SavedStateHandleFactory ora può essere utilizzata nei test non Android, ma richiederà Robolectric per supportare l'analisi degli argomenti con i bundle. (I76cdc, b/340966212)
  • Risolto un arresto anomalo durante il ripristino dello stato quando l'app viene ripresa dopo l'interruzione del processo con l'utilizzo della navigazione type-safe in Compose. (Ia8f38, b/341801005)
  • È stato risolto un problema in Navigation Compose per cui, dopo aver annullato il gesto Indietro predittivo, l'elemento NavBackStackEntry a cui l'utente torna non torna mai allo stato del ciclo di vita RESUMED. In questo modo, inoltre, la destinazione di ritorno viene animata correttamente anziché scattare in posizione dopo un movimento rapido. (I97a0c, b/346608857)
  • Quando utilizzi Indietro predittivo con Navigation Compose, la destinazione che viene rimossa ora avrà l'ordine z corretto, con un'animazione corretta sopra la destinazione in arrivo. (I2077b, b/345993681)

Versione 2.8.0-beta03

12 giugno 2024

androidx.navigation:navigation-*:2.8.0-beta03 è stato rilasciato. La versione 2.8.0-beta03 contiene questi commit.

Modifiche alle API

  • CollectionNavType ha un nuovo metodo astratto emptyCollection(). Esegui l'override di questo metodo per gestire una raccolta vuota passata come argomento. (Ie4d84, b/341723133)

Correzioni di bug

  • È stata aggiunta la documentazione su NavType.serializeAsValue e serializeAsValues per evidenziare che gli output finali devono essere codificati in URI. (Ida6bd, b/344943214)
  • Risolto un arresto anomalo durante la chiamata di toRoute<T> con un argomento CollectionNavType nullo. Quando navighi con un CollectionNavType null, l'argomento di output sarà il valore predefinito dichiarato nella classe Serializable o il valore restituito di emptyCollection() se non esiste un valore predefinito. (I84158, Id630f, b/342672856)

Versione 2.8.0-beta02

29 maggio 2024

androidx.navigation:navigation-*:2.8.0-beta02 è stato rilasciato. La versione 2.8.0-beta02 contiene questi commit.

Correzioni di bug

  • È stato corretto l'arresto anomalo di ClassCastException quando si utilizza NavBackStackEntry.toRoute con un NavType personalizzato che ammette valori null. (I1c29b, b/342239473)
  • Risolti i problemi di ripristino dello stato del back stack di navigazione causati dal tentativo di ripristinare una voce del back stack non raggiungibile tramite ID dalla destinazione corrente. Poiché le route sono supportate da ID, anche le destinazioni create con le route sono state interessate. Inoltre, viene corretto un arresto anomalo causato dalla chiamata di clearBackStack() che presentava lo stesso problema di fondo. (I423c3, b/339908057)

Versione 2.8.0-beta01

14 maggio 2024

androidx.navigation:navigation-*:2.8.0-beta01 è stato rilasciato. La versione 2.8.0-beta01 contiene questi commit.

Modifiche alle API

  • SavedStateHandle.toRoute() ora accetta un parametro typeMap per i tipi di argomenti personalizzati. (Ie39fb, b/339026523)
  • È stata aggiunta un'API di test a navigation-testing per creare un SavedStateHandle da un oggetto serializzabile Kotlin. (Id4867, b/339080702)

Correzioni di bug

  • Sono stati aggiunti i documenti dei parametri mancanti per le funzioni DSL di Kotlin per la navigazione. (I26a36)

Versione 2.8.0-alpha08

1° maggio 2024

androidx.navigation:navigation-*:2.8.0-alpha08 è stato rilasciato. La versione 2.8.0-alpha08 contiene questi commit.

Safe Args in Navigation Compose

Questa funzionalità utilizza la serializzazione Kotlin per consentirti di definire le destinazioni nel grafico di navigazione tramite oggetti e classi di dati con sicurezza dei tipi:

  // Define a home destination that doesn't take any arguments
  @Serializable
  object Home

  // Define a profile destination that takes an ID
  @Serializable
  data class Profile(val id: String)

  // Now define your NavHost using type safe objects
  NavHost(navController, startDestination = Home) {
      composable<Home> {
          HomeScreen(onNavigateToProfile = { id ->
              navController.navigate(Profile(id))
          })
      }
      composable<Profile> { backStackEntry ->
          val profile: Profile = backStackEntry.toRoute()
          ProfileScreen(profile)
      }
  }

Per saperne di più, consulta il blog post Navigation Compose meet Type Safety.

Nuove funzionalità

  • L'artefatto navigation-fragment-compose ora fornisce un LocalFragment CompositionLocal ai metodi componibili all'interno di un ComposableFragment. (If35e5)
  • NavType ora supporta in modo nativo gli elenchi di Int, String, Boolean, Float e Long. (I4b6dd, Ia914c, b/188693139)

Versione 2.8.0-alpha07

17 aprile 2024

androidx.navigation:navigation-*:2.8.0-alpha07 è stato rilasciato. La versione 2.8.0-alpha07 contiene questi commit.

Nuove funzionalità

  • Aggiunge un nuovo artefatto navigation-fragment-compose che include un'alternativa ComposableNavHostFragment a NavHostFragment che ti consente di aggiungere destinazioni composable ai file XML di navigazione. Ogni destinazione composable deve essere espressa come metodo @Composable di primo livello senza argomenti, il cui nome completo viene utilizzato come attributo android:name in ogni destinazione. Quando si accede a una di queste destinazioni, viene creato un frammento contenitore per visualizzare i contenuti componibili. (I0ef2e, b/265480755)

    // In HomeScreen.kt
    @Composable
    fun HomeScreen() {
      // Your Composable content here
    }
    
    // In your navigation.xml
    <composable
      android:id="@+id/home_screen"
      android:name="com.example.HomeScreenKt\$HomeScreen" />
    

Modifiche alle API

  • È stato mantenuto il supporto di Safe Args in Navigation Compose utilizzando un approccio basato sulla serializzazione di Kotlin. Queste API non sono state finalizzate e sono contrassegnate con l'annotazione ExperimentalSafeArgsApi. Questa annotazione verrà rimossa quando l'intera superficie dell'API sarà completa in una release futura. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)

Versione 2.8.0-alpha06

3 aprile 2024

androidx.navigation:navigation-*:2.8.0-alpha06 è stato rilasciato. La versione 2.8.0-alpha06 contiene questi commit.

Modifiche alle API

Correzioni di bug

  • NavHost ora utilizza Alignment.TopStart come argomento contentAlignment predefinito. In questo modo, l'impostazione è in linea con l'impostazione predefinita per AnimatedContent e vengono risolti alcuni casi di transizione di ridimensionamento dal centro imprevista. (I09e72, b/330111602)
  • Quando si utilizza il gesto Indietro predittivo con Navigation Compose, NavHost ora completa correttamente la transizione personalizzata anziché terminare immediatamente. (I99017, b/327292110)

Versione 2.8.0-alpha05

20 marzo 2024

androidx.navigation:navigation-*:2.8.0-alpha05 è stato rilasciato. La versione 2.8.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Ora puoi passare gli argomenti ai startDestination di NavGraph direttamente nella route startDestination senza fare affidamento su defaultValue. Questo vale anche per i startDestinations NavGraph nidificati. (I0e0b5, b/109505019, b/188693139)

Modifiche alle API

  • È stata aggiunta una nuova classe astratta CollectionNavType<T>, una sottoclasse di NavType<T> per gli argomenti basati su raccolte, come elenchi, array e mappe. (Ic6d63, b/188693139)
  • Tutti gli array NavType predefiniti (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType e StringArrayType) ora sono di tipo CollectionNavType (Idcf79, b/188693139)
  • NavType ora fornisce una nuova API valueEquals aperta che determina se due valori dello stesso tipo sono uguali tra loro. (I6cb97, b/327229511)

Correzioni di bug

  • I parametri di query nei deep link ora consentono di utilizzare valori sotto forma di parentesi graffe attorno al nome dell'argomento (ad es. {argName}) come valori validi per NavTypes basati su stringhe. In questo modo viene risolto un problema per cui un valore di questo tipo veniva considerato non valido (o assente) per tutti i tipi. (I18302, b/327274038)
  • Le funzioni NavController che supportano route come navigate o popBackStack ora possono trovare correttamente le route compilate con argomenti di tipo Array NavTypes. (Iea805, b/327229511)

Versione 2.8.0-alpha04

6 marzo 2024

androidx.navigation:navigation-*:2.8.0-alpha04 è stato rilasciato. La versione 2.8.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Ora puoi specificare SizeTranform per le transizioni in Navigation Compose definendole nell'ambito dell'inizializzazione delle funzioni composable e/o navigation. (I91062, b/296912651)

Correzioni di bug

  • È stato risolto un problema per cui NavHost in Compose Navigation non mostrava correttamente la transizione quando si utilizzava il pulsante Indietro di sistema senza un gesto. (Iceeae, b/325998468)

Versione 2.8.0-alpha03

21 febbraio 2024

androidx.navigation:navigation-*:2.8.0-alpha03 è stato rilasciato. La versione 2.8.0-alpha03 contiene questi commit.

Modifiche alle API

  • NavBackStackEntry.savedStateHandle è ora contrassegnato come @MainThread perché utilizza un codice che deve comunque trovarsi nel thread principale. (Ibb988, b/299523245)

Correzioni di bug

  • È stato risolto un problema in Navigazione che causava la DESTROYED dei ViewModel NavGraph troppo presto perché il ViewModel della voce associata non faceva parte dello stato salvato. (Ib6bb7, b/317581849)

Aggiornamento delle dipendenze

Versione 2.8.0-alpha02

7 febbraio 2024

androidx.navigation:navigation-*:2.8.0-alpha02 è stato rilasciato. La versione 2.8.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Navigation Compose ora supporta l'indietro predittivo in-app tramite le nuove API SeekableTransitionState di compose-animation. In questo modo, puoi utilizzare il gesto Indietro per visualizzare la destinazione precedente con la transizione personalizzata prima di decidere se eseguire il commit della transazione tramite il gesto completato o annullarla. (I8b8e9)

Versione 2.8.0-alpha01

24 gennaio 2024

androidx.navigation:navigation-*:2.8.0-alpha01 è stato rilasciato. La versione 2.8.0-alpha01 contiene questi commit.

Correzioni di bug

  • È stato corretto un leak di BackStackState per cui più chiamate saveState su una destinazione comportavano il salvataggio di più stati, ma solo il primo poteva essere ripristinato. (I598b0, b/309559751)
  • Risolto un problema per cui gli argomenti non di tipo String non venivano visualizzati correttamente quando si utilizzavano gli helper NavigationUI per compilare il titolo delle barre delle app. (#636, b/316676794)

Aggiornamento delle dipendenze

Contributo esterno

  • Grazie a SimonMarquis per aver risolto il problema di visualizzazione degli argomenti non di tipo String quando si utilizzano gli helper NavigationUI per compilare il titolo delle barre delle app.

Versione 2.7.7

Versione 2.7.7

7 febbraio 2024

androidx.navigation:navigation-*:2.7.7 è stato rilasciato. La versione 2.7.7 contiene questi commit.

Correzioni di bug

  • Backport da Navigation 2.8.0-alpha01: è stato corretto un leak di BackStackState in cui più chiamate saveState() su un singolo NavBackStackEntry comportavano il salvataggio di più stati, ma era possibile ripristinare solo il primo stato salvato. (I598b0, b/309559751)
  • Backport da Navigation 2.8.0-alpha01: è stato risolto un problema per cui gli argomenti non di tipo String non venivano visualizzati correttamente quando si utilizzavano gli helper NavigationUI per compilare il titolo delle barre delle app. (#636, b/316676794)

Contributo esterno

  • Grazie a SimonMarquis per aver risolto il problema di visualizzazione degli argomenti non di tipo String quando si utilizzano gli helper NavigationUI per compilare il titolo delle barre delle app.

Versione 2.7.6

Versione 2.7.6

13 dicembre 2023

androidx.navigation:navigation-*:2.7.6 è stato rilasciato. La versione 2.7.6 contiene questi commit.

Correzioni di bug

  • La funzione NavGraph equals() ora considera correttamente i nodi dell'altro grafico anziché solo quello chiamante. In questo modo, i grafici con nodi con ID diversi non verranno più considerati uguali (I401cb, b/311414915)

Versione 2.7.5

Versione 2.7.5

1° novembre 2023

androidx.navigation:navigation-*:2.7.5 è stato rilasciato. La versione 2.7.5 contiene questi commit.

Miglioramenti delle prestazioni

  • Le prestazioni (sia in termini di tempo che di numero di allocazioni) del confronto di due grafici sono state notevolmente migliorate. Ciò significa che le chiamate come setGraph, che confrontano internamente il nuovo grafico con quello esistente, sono molto più veloci e generano meno frame saltati. Ringraziamo Michał Z per l'analisi approfondita che ha portato a questo miglioramento. (I6ad62)
  • NavHost ora eseguirà il rendering della destinazione iniziale al primo passaggio di composizione, anziché dover attendere il secondo passaggio per leggere lo stato aggiornato. (I439a7, b/304852206)

Correzioni di bug

  • Risolto un problema per cui il back stack veniva rimosso se chiamavi setGraph più di una volta con lo stesso grafo, solo se nel grafo era presente una destinazione contenente un link all'azione che collegava due destinazioni. (Ieaed7)
  • Le finestre di dialogo aperte e chiuse in rapida successione non verranno più visualizzate nell'elenco di NavController.visibleEntries. (I67586, b/287969970)
  • Quando una voce viene estratta e poi viene apportata una modifica alla configurazione, l'aspetto ViewModel della voce verrà ora cancellato correttamente se saveState è false. (Idf242, b/298164648)
  • Risolto un problema per cui NavController poteva gestire lo stesso deep link più di una volta se il back stack era completamente vuoto prima di una modifica della configurazione o di una chiamata a setGraph solo quando l'intent in entrata aveva il flag FLAG_ACTIVITY_NEW_TASK impostato. (I73c7f)

Aggiornamenti delle dipendenze

  • La navigazione con i frammenti ora dipende da Fragment 1.6.2, risolvendo un problema per cui le istanze ViewModel dei frammenti nidificati non venivano cancellate quando veniva chiamato clearBackStack.

Versione 2.7.4

Versione 2.7.4

4 ottobre 2023

androidx.navigation:navigation-*:2.7.4 è stato rilasciato. La versione 2.7.4 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto il supporto per popUpTo per utilizzare i percorsi con argomenti per consentire il ritorno a una voce specifica che utilizza quegli argomenti esatti, in linea con il supporto trovato in popBackStack. (I731f4, b/299255572)

Correzioni di bug

  • Risolto il problema per cui l'interruzione di una navigazione con un'altra navigazione con popUpTo causava l'arresto anomalo di FragmentNavigator. (I3c848, b/301887045)
  • Risolto il problema per cui la pressione del tasto Indietro del sistema causava l'aggiornamento non corretto di currentDestination in modo che corrispondesse al frammento visualizzato. (Id0d6c, b/289877514)
  • Il ciclo di vita di DialogFragment ora passerà correttamente allo stato RESUMED quando la finestra di dialogo sopra viene chiusa. (I88f0d, b/301811387)

Versione 2.7.3

Versione 2.7.3

20 settembre 2023

androidx.navigation:navigation-*:2.7.3 è stato rilasciato. La versione 2.7.3 contiene questi commit.

Correzioni di bug

  • Risolto un problema nella navigazione con i frammenti che causava la presenza di voci errate nell'elenco visibleEntries. (I5caa9, b/288520638)
  • Risolto un problema che impediva alla destinazione della finestra mobile (ad es. Dialogs, Bottomsheets e così via) di ricevere un callback del ciclo di vita RESUMED. (I3b866, b/287505132)

Versione 2.7.2

Versione 2.7.2

6 settembre 2023

androidx.navigation:navigation-*:2.7.2 è stato rilasciato. La versione 2.7.2 contiene questi commit.

Correzioni di bug

  • La navigazione ora dipende da Lifecycle 2.6.2, correggendo un'interazione tra rememberSaveable e NavHost di Navigation Compose che impediva il corretto ripristino dello stato rememberSaveable delle destinazioni e di eventuali istanze SavedStateHandle di proprietà di ViewModel dopo l'interruzione e la ricreazione del processo. (b/298059596, b/289436035)
  • È stato risolto un problema relativo alla visualizzazione simultanea di più finestre di dialogo in Navigation Compose, in cui le finestre di dialogo parzialmente oscurate (ad esempio, non la finestra di dialogo più in alto) si trovavano nello stato del ciclo di vita CREATED anziché nello stato STARTED. (aosp/2728520, b/289257213)
  • È stato risolto un problema relativo alla visualizzazione simultanea di più finestre di dialogo in Navigation Compose, per cui la chiusura della finestra di dialogo in primo piano causava il blocco della nuova finestra di dialogo in primo piano nello stato del ciclo di vita STARTED anziché passare correttamente a RESUMED. (aosp/2629401, b/286371387)
  • Navigation Safe Args non crea più un'istanza della sua attività in modo eager se non viene effettivamente eseguita. (I0e385, b/260322841)

Aggiornamento delle dipendenze

  • Navigation Compose ora dipende da Compose 1.5.1.

Versione 2.7.1

Versione 2.7.1

23 agosto 2023

androidx.navigation:navigation-*:2.7.1 è stato rilasciato. La versione 2.7.1 contiene questi commit.

Correzioni di bug

  • Risolto un problema in Navigation con Compose per cui, quando si utilizzava un Scaffold, era possibile ricevere un errore per il tentativo di accedere a un Lifecycle.State.DESTROYED ViewModel. (I1dc11, b/268422136)

Versione 2.7.0

Versione 2.7.0

9 agosto 2023

androidx.navigation:navigation-*:2.7.0 è stato rilasciato. La versione 2.7.0 contiene questi commit.

Modifiche importanti dalla versione 2.6.0

Animazioni di Accompanist

Ora che AnimatedContent è stabile, abbiamo potuto spostare il codice da Accompanist Navigation Animation di nuovo in Navigation Compose.

Ciò significa che tutto il supporto per l'impostazione di transizioni personalizzate esistente in AnimatedNavHost è supportato direttamente in NavHost.

Non verranno apportate ulteriori modifiche ad Accompanist Navigation Animation e presto verrà ritirato formalmente, insieme alle indicazioni su come eseguire la migrazione a Navigation Compose, ma sarà l'opposto della guida alla migrazione senza altre modifiche alle API richieste se utilizzi già l'ultima versione alpha di Accompanist (0.31.2-alpha). (b/197140101)

Correzioni di bug

  • NavHost in Navigation Compose ora intercetta correttamente le chiamate di ritorno del sistema anche dopo che l'attività è stata interrotta e ripresa. (Icb6de, b/279118447)

Aggiornamenti delle dipendenze

  • La navigazione ora dipende da Compose 1.5.0 anziché da 1.1.0.

Versione 2.7.0-rc01

26 luglio 2023

androidx.navigation:navigation-*:2.7.0-rc01 è stato rilasciato. La versione 2.7.0-rc01 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui le espressioni lambda EnterTransition e ExitTransition create nell'ambito di NavHost potevano potenzialmente rimanere in memoria anche dopo la rimozione di NavHost dalla composizione. (I893d0)

Problemi noti

  • Si è verificato un problema con Navigation 2.6.x per cui, quando si naviga con popUpTo, è possibile causare un IllegalArgumentException. È possibile evitare questa eccezione ristrutturando il grafico, in modo simile ai consigli suggeriti qui. (b/287133013)

Versione 2.7.0-beta02

28 giugno 2023

androidx.navigation:navigation-*:2.7.0-beta02 è stato rilasciato. La versione 2.7.0-beta02 contiene questi commit.

Correzioni di bug

  • Navigation Compose ora ha l'ordine z corretto per le transizioni personalizzate che utilizzano la navigazione con l'opzione popUpTo.(/Ib1c3a, b/285153947)

Versione 2.7.0-beta01

7 giugno 2023

androidx.navigation:navigation-*:2.7.0-beta01 è stato rilasciato. La versione 2.7.0-beta01 contiene questi commit.

Correzioni di bug

  • NavHost in Navigation Compose ora intercetta correttamente le chiamate di ritorno del sistema anche dopo che Activity è stato STOPPED e RESUMED. (Icb6de, b/279118447)

Versione 2.7.0-alpha01

24 maggio 2023

androidx.navigation:navigation-*:2.7.0-alpha01 è stato rilasciato. La versione 2.7.0-alpha01 contiene questi commit.

Animazioni di Accompanist

Ora che AnimatedContent è stabile, abbiamo potuto spostare il codice da Accompanist Navigation Animation di nuovo in Navigation Compose.

Ciò significa che tutto il supporto per l'impostazione di transizioni personalizzate esistente in AnimatedNavHost è supportato direttamente in NavHost.

Non verranno apportate ulteriori modifiche ad Accompanist Navigation Animation e presto verrà ritirato formalmente, insieme alle indicazioni su come eseguire la migrazione a Navigation Compose, ma sarà l'opposto della guida alla migrazione senza altre modifiche alle API richieste se utilizzi già l'ultima versione alpha di Accompanist (0.31.2-alpha). (b/197140101)

Correzioni di bug

  • Da Navigation 2.6.0-rc02: è stato risolto un problema relativo alla navigazione nei frammenti per cui la navigazione con popUpTo e l'estrazione di un frammento dal back stack senza ricreare la relativa visualizzazione causavano l'interruzione del funzionamento del pulsante Indietro del sistema. (Ieb8d4, b/281726455)

Aggiornamenti delle dipendenze

  • La navigazione ora dipende da Compose 1.5.0-beta01.

Versione 2.6.0

Versione 2.6.0

7 giugno 2023

androidx.navigation:navigation-*:2.6.0 è stato rilasciato. La versione 2.6.0 contiene questi commit.

Modifiche importanti alla navigazione dalla versione 2.5.0

  • arguments di NavBackStackEntry e arguments passati a un OnDestinationChangedListener ora sono solo una copia degli argomenti immutabili creati quando hai navigato verso la destinazione. Ciò significa che le modifiche apportate a questi bundle non verranno applicate agli accessi successivi a arguments o ad altre istanze di OnDestinationChangedListener.
  • NavDeepLink ora supporta i valori predefiniti per gli array, il che consente di supportare i parametri di query ripetuti che verranno mappati al tipo di array dell'argomento. NavType ora include anche un metodo predefinito di cui è possibile eseguire l'override per combinare due valori analizzati.
  • Le sottoclassi personalizzate di NavType ora possono eseguire l'override di serializeAsValue per serializzare un valore in una stringa, consentendo di incapsulare completamente sia la serializzazione che la deserializzazione (tramite parseValue) nella classe NavType. StringType ora esegue l'override di questo metodo per chiamare Uri.encode sull'oggetto String specificato.

Modifiche importanti a Navigation Compose dalla versione 2.5.0

  • Quando visualizzi l'anteprima di un composable con NavHost, ora viene mostrato il startDestination di NavGraph per impostazione predefinita.
  • NavController.popBackStack(route), NavController.getBackStackEntry(route), NavController.clearBackStack(route) ora supportano tutti i percorsi con argomenti parzialmente o completamente compilati. Tieni presente che gli argomenti devono corrispondere esattamente a quelli della voce.
  • Il tentativo di creare un NavDeepLink vuoto utilizzando il DSL Kotlin navDeepLink ora genera un avviso lint che indica che un deep link richiede un URI, un'azione e/o un tipo MIME per essere valido.

Modifiche importanti alla navigazione con i frammenti dalla versione 2.5.0

  • NavHostFragment non intercetta più il pulsante Indietro del sistema. In questo modo, l'elemento FragmentManager sottostante può gestire il pulsante Indietro del sistema. In questo modo, Fragment 1.7.0-alpha01 e versioni successive possono fornire un'animazione di Indietro predittivo in-app sui dispositivi Android U.
  • Quando utilizzi la navigazione con i frammenti, il tentativo di eseguire manualmente un FragmentTransaction che aggiunge un frammento al back stack di FragmentManager ora genera un IllegalArgumentException. Devi sempre aggiungere i frammenti tramite l'API navigate().
  • Quando utilizzi la stringa esatta ${applicationId} come segnaposto negli attributi app:data e app:dataPattern nell'elemento di attività di un file XML di navigazione, il segnaposto verrà compilato automaticamente con il packageName del contesto al momento dell'inflazione.
  • FragmentNavigator ora utilizza le API di transizione durante la navigazione e il popping di NavBackStackEntries. Ciò significa che NavBackStackEntry Lifecycle ora attenderà il completamento degli effetti speciali dei frammenti in entrata e in uscita prima di spostare il relativo Lifecycle.State finale.
  • DialogFragmentNavigator ora utilizza le API di transizione durante la navigazione e il popping di NavBackStackEntries. Ciò significa che NavBackStackEntry Lifecycle ora attenderà che DialogFragment Lifecycle passi a DESTROYED prima di passare a DESTROYED.
  • NavHostFragment ora ti consente di recuperare NavController non appena NavHostFragment viene collegato a FragmentManager, anziché solo dopo onCreate().
  • Il supporto della navigazione per i moduli delle funzionalità dinamiche ora dipende dalla libreria Play Feature Delivery granulare.
  • Navigation Safe Args ora dipende dalla versione 7.3.0 del plug-in Android per Gradle. Ciò significa che ora è compatibile solo con le versioni 7.3.0 e successive.

Modifiche importanti a NavigationUI dalla versione 2.5.0

  • Quando passi l'ID di un grafico di navigazione a AppBarConfiguration (ad esempio tramite un Menu), NavigationUI ora considera solo la destinazione iniziale di quel grafico di navigazione come destinazione di primo livello, anziché contrassegnare erroneamente ogni destinazione all'interno del grafico come destinazione di primo livello. Il comportamento di trasmissione dell'ID di una singola destinazione rimane invariato. Questa stessa funzionalità è disponibile per il tuo codice tramite la nuova funzione isTopLevelDestination su AppBarConfiguration.
  • Le integrazioni di setupWithNavController in NavigationUI per l'utilizzo della barra delle app in alto ora analizzeranno i valori R.string per gli argomenti ReferenceType trovati in android:label nei relativi valori String anziché restituire l'intero della risorsa generato automaticamente.
  • NavigationUI ora fornisce i log quando non riesce a navigare tramite un MenuItem selezionato.

Versione 2.6.0-rc02

24 maggio 2023

androidx.navigation:navigation-*:2.6.0-rc02 è stato rilasciato. La versione 2.6.0-rc02 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema relativo alla navigazione nei frammenti per cui la navigazione con popUpTo e l'estrazione di un frammento dal back stack senza ricreare la relativa visualizzazione causavano l'interruzione del funzionamento del pulsante Indietro del sistema. (Ieb8d4, b/281726455)

Versione 2.6.0-rc01

10 maggio 2023

androidx.navigation:navigation-*:2.6.0-rc01 è stato rilasciato. La versione 2.6.0-rc01 contiene questi commit.

Correzioni di bug

  • Risolto un problema nella navigazione con frammenti per cui la rimozione di un frammento tramite la navigazione con popUpTo nel relativo callback del ciclo di vita onResume() causava un IllegalStateException. (I21884, b/279644470)

Versione 2.6.0-beta01

19 aprile 2023

androidx.navigation:navigation-*:2.6.0-beta01 è stato rilasciato. La versione 2.6.0-beta01 contiene questi commit.

Nuove funzionalità

  • NavBackStackEntry ora fornisce un'implementazione toString personalizzata. (Iff00b)

Correzioni di bug

  • Quando utilizzi la navigazione con i frammenti, il tentativo di eseguire manualmente un FragmentTransaction che aggiunge un frammento al back stack di FragmentManager ora genera un IllegalArgumentException. Devi sempre aggiungere i frammenti tramite l'API navigate(). (I6d38e)
  • Quando nello stesso frame è presente un navigate che aggiunge una voce e un popBackStack che la rimuove, la voce in alto risultante nel back stack ora tornerà in modo coerente a RESUMED Lifecycle.State. (Id8067, b/276495952)

Versione 2.6.0-alpha09

5 aprile 2023

androidx.navigation:navigation-*:2.6.0-alpha09 è stato rilasciato. La versione 2.6.0-alpha09 contiene questi commit.

Correzioni di bug

  • Sono stati corretti i controlli per i percorsi non validi, in modo che se un NavDestination contiene NavArgument non null, il percorso di questa destinazione deve contenere segnaposto per gli argomenti con lo stesso nome di NavArgument non null. (Ic62bf, b/274697949)
  • Le navigazioni tramite deep link basate su Action/MimeType ora non andranno a buon fine se nell'operazione di navigazione manca un NavArgument non nullable richiesto dal NavDestination con cui corrisponde Action/MimeType. (Ibfa17, b/271777424)
  • Quando NavController imposta un grafico con lo stesso percorso e le stesse destinazioni del grafico precedente, ora sostituisce correttamente i nodi del grafico corrente e le destinazioni del back stack con nuove istanze. In questo modo viene corretto un arresto anomalo quando si utilizza onLaunchSingleTop senza salvare lo stato in Navigation Compose. In questo modo viene risolto anche un errore per cui la navigazione verso le destinazioni associate al grafico principale crea un back stack errato. (I5bc58, b/275258161, b/275407804)

Versione 2.6.0-alpha08

22 marzo 2023

androidx.navigation:navigation-*:2.6.0-alpha08 è stato rilasciato. La versione 2.6.0-alpha08 contiene questi commit.

Nuove funzionalità

  • NavHostFragment ora ti consente di recuperare NavController non appena NavHostFragment viene collegato a FragmentManager, anziché solo dopo onCreate(). (Ic6382, b/220186282)

Correzioni di bug

  • Risolto un problema di NullPointerException durante l'estrazione di un grafico nidificato che include un argomento non nullable. (6b3581, b/249988437)
  • Quando utilizzi il pulsante Indietro del sistema dopo aver eseguito una navigazione con popUpTo, lo stato di NavController passa alla voce corretta. (I3a8ec, b/270447657)
  • FragmentNavigator ora rimuoverà correttamente le voci quando il back stack viene rimosso tramite il pulsante Indietro del sistema o popBackStack() e indipendentemente dal fatto che la transazione utilizzi o meno gli effetti per il frammento. (I81bdf)
  • L'aggiunta di frammenti a FragmentManager di FragmentNavigator senza utilizzare la navigazione non causerà più un arresto anomalo. (b17204, b/274167493)

Aggiornamenti delle dipendenze

Versione 2.6.0-alpha07

8 marzo 2023

androidx.navigation:navigation-*:2.6.0-alpha07 è stato rilasciato. La versione 2.6.0-alpha07 contiene questi commit.

Correzioni di bug

  • Le varianti delle API getBackStackEntry, popBackStack, clearBackStack che accettano route ora accettano pattern di route con argomenti nullable e parametri di query nullable (I22294, b/269302500)
  • Risolto un problema per cui la chiamata di clearBackStack() da NavController non cancellava lo stato salvato nel gestore dei frammenti associato al back stack cancellato. (Ic1cce, b/271190202)
  • Risolta una regressione nella versione 2.6.0-alpha06 che causava l'evidenziazione di MenuItem errato in BottomNavigationView quando si utilizzava il pulsante Indietro del sistema tra le schede. (I634f6, b/270447657)
  • È stata corretta la regressione nella versione 2.6.0-alpha06 che impediva lo spostamento di NavBackStackEntry allo stato RESUMED quando si utilizzavano Animation. (Ib3589, b/269646882)

Versione 2.6.0-alpha06

22 febbraio 2023

androidx.navigation:navigation-*:2.6.0-alpha06 è stato rilasciato. La versione 2.6.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Quando visualizzi l'anteprima di un composable con NavHost, ora viene mostrato il startDestination di NavGraph per impostazione predefinita. (I2b89f)

Modifiche alle API

  • Tutti gli overload NavController navigate sono ora annotati con @MainThread per garantire che vengano chiamati sul thread principale. (I2c0b0, b/263427111)

Correzioni di bug

  • Risolto un arresto anomalo durante il tentativo di navigazione con la navigazione dinamica dei frammenti. (I3ee29, b/268360479)
  • È stato corretto il bug per cui la navigazione verso un altro frammento tramite il pulsante Indietro del sistema non aggiornava la barra in basso con l'elemento selezionato corretto (If559f, b/269044426)

Problemi noti

  • Quando si utilizza la navigazione con i frammenti, il ciclo di vita di NavBackStackEntry non riesce a raggiungere RESUMED quando si utilizzano le API Animation. (b/269646882)
  • Quando utilizzi la navigazione con i frammenti e navighi con BottomNavigation, se provi a ripristinare un back stack con più voci, BottomMenuItem non viene aggiornato correttamente. (b/270447657)
  • Quando utilizzi la navigazione con i frammenti, dopo aver ripristinato lo stato, NavBackStackEntry Lifecycle non riceve DESTROYED quando il relativo frammento è DESTROYED . (b/270610768)

Versione 2.6.0-alpha05

8 febbraio 2023

androidx.navigation:navigation-*:2.6.0-alpha05 è stato rilasciato. La versione 2.6.0-alpha05 contiene questi commit.

Nuove funzionalità

  • NavController.popBackStack(route), NavController.getBackStackEntry(route), NavController.clearBackStack(route) ora supportano tutti i percorsi con argomenti parzialmente o completamente compilati. Tieni presente che gli argomenti devono corrispondere esattamente a quelli della voce. (Iebd28, Ic678c, I3b37b, b/257514373)
  • FragmentNavigator ora utilizza le API di transizione durante la navigazione e il popping di NavBackStackEntries. Ciò significa che NavBackStackEntry Lifecycle ora attenderà il completamento degli effetti speciali dei frammenti in entrata e in uscita prima di spostare il relativo Lifecycle.State finale. (I3cb19, b/238686802)
  • DialogFragmentNavigator ora utilizza le API di transizione durante la navigazione e il popping di NavBackStackEntries. Ciò significa che NavBackStackEntry Lifecycle ora attenderà che DialogFragment Lifecycle passi a DESTROYED prima di passare a DESTROYED. (I53ee5, b/261213893)

Modifiche alle API

  • NavigatorState ora fornisce l'API prepareForTransition per consentire ai Navigator di spostare NavBackStackEntries in Lifecycle.State intermedi. (I42c21, b/238686802)
  • Ora puoi accedere al back stack associato a un NavGraphNavigator o a un ComposeNavigator tramite una proprietà backstack. ComposeNavigator ora espone anche il callback onTransitionComplete() per contrassegnare come completata una NavBackStackEntry che ha eseguito un'operazione di navigazione o popBackStack. (I02062, I718db, b/257519195)

Correzioni di bug

  • Lo stato del navigatore ora non eseguirà alcuna operazione quando utilizzi le API push/popWithTransition e la voce è già in fase di gestione. (Iadbfa, b/261213893)
  • Quando utilizzi launchSingleTop con un NavGraph nidificato, tutte le destinazioni a partire dalla destinazione originale fino alla relativa startDestination verranno aggiunte correttamente solo all'inizio del backstack. (Id4bea, b/253256629)
  • La navigazione ora sostituirà correttamente l'istanza DialogFragment quando si naviga verso la stessa destinazione con il flag launchSingleTop impostato su true. (I45b5a, b/149572817)
  • Navigation SafeArgs non causerà più un errore di compilazione quando utilizzi argomenti di esattamente 19 caratteri. (Id60bc, b/257110095)

Versione 2.6.0-alpha04

9 novembre 2022

androidx.navigation:navigation-*:2.6.0-alpha04 è stato rilasciato. La versione 2.6.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Le sottoclassi personalizzate di NavType ora possono eseguire l'override di serializeAsValue per serializzare un valore in una stringa, consentendo di incapsulare completamente sia la serializzazione che la deserializzazione (tramite parseValue) nella classe NavType. StringType ora esegue l'override di questo metodo per chiamare Uri.encode sull'oggetto String specificato. (Ie5213, b/247637434)
  • NavigationUI ora fornisce i log quando non riesce a navigare tramite un MenuItem selezionato. (I2af5a, b/247730357)

Correzioni di bug

  • I deep link di navigazione ora vengono analizzati in modo lazy anziché durante l'inizializzazione del grafico, il che potrebbe migliorare le prestazioni dell'app all'avvio. (Iab0ab)
  • È stato corretto un arresto anomalo causato dalla navigazione verso l'alto dopo il deep linking a una destinazione con argomenti predefiniti nulli. (I51c24, b/243183636)

Aggiornamento delle dipendenze

  • Il supporto della navigazione per i moduli delle funzionalità dinamiche ora dipende dalla libreria Play Feature Delivery granulare. (Ib4ddc)
  • Navigation Safe Args ora dipende dalla versione 7.3.0 del plug-in Android per Gradle. Ciò significa che ora è compatibile solo con le versioni 7.3.0 e successive. (I47e49)

Versione 2.6.0-alpha03

24 ottobre 2022

androidx.navigation:navigation-*:2.6.0-alpha03 è stato rilasciato. La versione 2.6.0-alpha03 contiene questi commit.

Correzioni di bug

  • Da Navigazione 2.5.3: NavHost non causerà più un NoSuchElementException quando non è disponibile una destinazione per la composizione di Crossfade. Ora salterà semplicemente la composizione. (Ieb46e, b/253299416)
  • Da Navigation 2.5.3: è stato risolto un problema per cui lo stato di Compose salvato (ad es. gli utilizzi di rememberSaveable) non veniva dimenticato e rimosso quando una destinazione veniva rimossa dal back stack. (I64949)

Aggiornamenti delle dipendenze

Versione 2.6.0-alpha02

5 ottobre 2022

androidx.navigation:navigation-*:2.6.0-alpha02 è stato rilasciato. La versione 2.6.0-alpha02 contiene questi commit.

Modifiche del comportamento

  • Quando passi l'ID di un grafico di navigazione a AppBarConfiguration (ad esempio tramite un Menu), NavigationUI ora considera solo la destinazione iniziale di quel grafico di navigazione come destinazione di primo livello, anziché contrassegnare erroneamente ogni destinazione all'interno del grafico come destinazione di primo livello. Il comportamento di trasmissione dell'ID di una singola destinazione rimane invariato. Questa stessa funzionalità è disponibile per il tuo codice tramite la nuova funzione isTopLevelDestination su AppBarConfiguration. (Ie936e, b/238496771)

Correzioni di bug

  • Il componente navigation:navigation-fragment ora dipende dalla versione 1.5.2 di Fragment. (I00ba4)
  • La voce di menu selezionata non verrà più aggiornata quando si passa a una destinazione FloatingWindow, ad esempio una finestra di dialogo. (I4cde8, b/240308330)

Versione 2.6.0-alpha01

7 settembre 2022

androidx.navigation:navigation-*:2.6.0-alpha01 è stato rilasciato. La versione 2.6.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Le integrazioni di setupWithNavController in NavigationUI per l'utilizzo della barra delle app in alto ora analizzeranno i valori R.string per gli argomenti ReferenceType trovati in android:label nei relativi valori String anziché restituire l'intero della risorsa generato automaticamente. (I5f803, b/167959935)
  • NavDeepLink ora supporta i valori predefiniti per gli array, il che consente di supportare i parametri di query ripetuti che verranno mappati al tipo di array dell'argomento. NavType ora include anche un metodo predefinito di cui è possibile eseguire l'override per combinare due valori analizzati. (Id68c3, b/209977108)
  • Quando utilizzi la stringa esatta ${applicationId} come segnaposto negli attributi app:data e app:dataPattern nell'elemento di attività di un file XML di navigazione, il segnaposto verrà compilato automaticamente con il packageName del contesto al momento dell'inflazione. (Iaabde, b/234223561)
  • Il tentativo di creare un NavDeepLink vuoto utilizzando il DSL Kotlin navDeepLink ora genera un avviso lint che indica che un deep link richiede un URI, un'azione e/o un tipo MIME per essere valido. (I08d2f, b/154038883)

Modifiche alle API

  • È stata aggiunta una nuova funzione di estensione NavDestination per analizzare le etichette dinamiche con argomenti nel formato android:label="{arg}" in String. Supporta gli argomenti ReferenceType analizzando i valori R.string nei relativi valori String. (I07d89, b/236269380)

Modifiche del comportamento

  • arguments di NavBackStackEntry e arguments passati a un OnDestinationChangedListener ora sono solo una copia degli argomenti immutabili creati quando hai eseguito la navigazione verso la destinazione. Ciò significa che le modifiche apportate a questi bundle non verranno applicate agli accessi successivi a arguments o ad altre istanze di OnDestinationChangedListener. (I676f5)

Correzioni di bug

  • Da Navigation 2.5.2: la navigazione dinamica ora tenta correttamente di installare le destinazioni delle attività da altri moduli prima di accedervi. (Ia2c16, b/240292838)
  • Da Navigation 2.5.2: Navigation ora sostituirà correttamente l'istanza Fragment quando si passa alla stessa destinazione e si imposta il flag launchSingleTop su true. (I5a2f1, b/237374580)
  • Da Navigation 2.5.2: è stato corretto l'errore IllegalStateException causato dalla navigazione verso un grafico nidificato doppio che condivide un elemento principale con una nuova destinazione di partenza mostrata. (I9f7cb, b/243778589)

Versione 2.5

Versione 2.5.3

24 ottobre 2022

androidx.navigation:navigation-*:2.5.3 è stato rilasciato. La versione 2.5.3 contiene questi commit.

Correzioni di bug

  • NavHost non causerà più un NoSuchElementException quando non è disponibile una destinazione per la composizione di Crossfade. Ora salterà semplicemente la composizione. (Ieb46e, b/253299416)
  • È stato risolto un problema per cui lo stato di Compose salvato (ad es. gli utilizzi di rememberSaveable) non veniva dimenticato e rimosso quando una destinazione veniva rimossa dal back stack. (I64949)

Versione 2.5.2

7 settembre 2022

androidx.navigation:navigation-*:2.5.2 è stato rilasciato. La versione 2.5.2 contiene questi commit.

Correzioni di bug

  • La navigazione dinamica ora tenta correttamente di installare le destinazioni delle attività da altri moduli prima di accedervi. (Ia2c16, b/240292838)
  • Ora Navigation sostituirà correttamente l'istanza Fragment quando si passa alla stessa destinazione e si imposta il flag launchSingleTop su true. (I5a2f1, b/237374580)
  • Risolto il problema IllegalStateException causato dalla navigazione a un grafico con doppio nidificazione che condivide un elemento principale con una nuova destinazione di inizio mostrata. (I9f7cb, b/243778589)

Aggiornamento delle dipendenze

Versione 2.5.1

27 luglio 2022

androidx.navigation:navigation-*:2.5.1 è stato rilasciato. La versione 2.5.1 contiene questi commit.

Correzioni di bug

  • Navigation Safe Args non causerà più avvisi di ritiro nelle classi generate quando si utilizzano tipi di argomenti personalizzati salvati in un Bundle. (Id86ed, b/237725966)

Aggiornamenti delle dipendenze

Versione 2.5.0

29 giugno 2022

androidx.navigation:navigation-*:2.5.0 è stato rilasciato. La versione 2.5.0 contiene questi commit.

Modifiche importanti dalla versione 2.4.0

  • Integrazione di CreationExtras - Navigation ora ha la possibilità di fornire un ViewModelProvider.Factory stateless tramite CreationExtras di Lifecycle 2.5.0.

Navigation SafeArgs

  • Navigation Safe Args ha eseguito l'upgrade della dipendenza Android Gradle Plugin per fare affidamento su 7.0.4, eliminando la compatibilità con le versioni di AGP precedenti alla 7.0.
  • Aggiunto il supporto per l'attributo build.gradle dello spazio dei nomi da utilizzare al posto di applicationId.

Altre modifiche

  • L'API visibleEntries non è più sperimentale e fornisce una funzione per recuperare tutte le voci la cui destinazione è attualmente visibile in base a NavController.

Versione 2.5.0-rc02

15 giugno 2022

androidx.navigation:navigation-*:2.5.0-rc02 è stato rilasciato. La versione 2.5.0-rc02 contiene questi commit.

Correzioni di bug

  • È stato corretto un arresto anomalo causato dal passaggio rapido tra le destinazioni in basso quando si utilizza Navigation Compose NavHost. (I3979a, b/234054916)
  • Navigation SafeArgs non si arresterà più in modo anomalo quando utilizzi un applicationIdSuffix e uno spazio dei nomi senza applicationId o quando applicationId e lo spazio dei nomi sono diversi. (I754b1, b/233119646)
  • NavArgument ora ha una funzione toString() personalizzata per mostrare i valori interni dell'argomento. (I900a8)

Versione 2.5.0-rc01

11 maggio 2022

androidx.navigation:navigation-*:2.5.0-rc01 è stato rilasciato. La versione 2.5.0-rc01 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta una nuova regola lint per avvisare di non inserire elementi <deeplink> all'interno di elementi <activity> nel file navigation.xml.(Ic15a5, b/178403185)

Correzioni di bug

  • Gli ambiti componibili in NavHost e DialogHost ora vengono eliminati nell'ordine previsto, ovvero i componibili interni vengono eliminati prima di quelli esterni. (I157e6)
  • Navigation SafeArgs ora utilizza PathSensitivity.RELATIVE in ArgumentsGenerationTask per consentire la rilocabilità della cache. Ciò significa che la voce della cache ora può essere riutilizzata da una build CI a una build locale. (I5f67c, b/173420454)
  • La regola lint UnrememberedGetBackStackEntryDetector è stata aggiornata per garantire che la chiamata remember che circonda la chiamata a getBackStackEntry() passi anche un oggetto NavBackStackEntry come chiave.(Ib7081, b/227382831)

Versione 2.5.0-beta01

20 aprile 2022

androidx.navigation:navigation-*:2.5.0-beta01 è stato rilasciato. La versione 2.5.0-beta01 contiene questi commit.

Correzioni di bug

  • DialogNavigator ora utilizza popWithTransition quando esegue una chiamata dismiss(). In questo modo viene corretta una race condition quando si utilizza un elemento ViewModel all'interno di una destinazione dialog che causerebbe un errore IllegalStateException quando si chiude la finestra di dialogo utilizzando il pulsante Indietro del sistema o toccando all'esterno della finestra di dialogo per uscire. (Id7376, b/226552301)

Aggiornamenti delle dipendenze

  • La navigazione ora dipende da Lifecycle 2.5.0-beta01, correggendo un IllegalStateException quando si nidifica un NavHost all'interno di un altro NavHost in una scheda di navigazione in basso non principale quando si utilizzano più back stack.

Versione 2.5.0-alpha04

6 aprile 2022

androidx.navigation:navigation-*:2.5.0-alpha04 è stato rilasciato. La versione 2.5.0-alpha04 contiene questi commit.

Modifiche alle API

Correzioni di bug

  • NavHost ora dipende da visibleEntries di NavController per determinare quali voci comporre. Ciò significa che, quando utilizzi NavHost nidificati, l'elemento NavHost interno ora dovrebbe uscire correttamente dall'animazione. (I4ba2b, b/225394514)
  • La visibleEntries StateFlow fornita da NavController ora si basa sullo stato del ciclo di vita massimo della voce anziché sullo stato del ciclo di vita corrente. Ciò significa che anche se il ciclo di vita dell'host di navController scende al di sotto di STARTED, l'elenco delle voci visibili rimarrà invariato. (I9e2a8, b/225394514)
  • SavedStateViewFactory ora supporta l'utilizzo di CreationExtras anche se è stato inizializzato con un SavedStateRegistryOwner. Se vengono forniti extra, gli argomenti inizializzati vengono ignorati. (I6c43b, b/224844583)
  • NavDeepLink ora può analizzare gli URI con un singolo parametro di query senza valore. (I0efe8, b/148905489)
  • Le stringhe vuote sono ora considerate argomenti validi nei deep link. (I70a0d, b/217399862)
  • Navigation Safe Args non si arresterà più in modo anomalo quando utilizzi gli spazi dei nomi e non è presente AndroidManifest.xml. (I17ccf, b/227229815)

Versione 2.5.0-alpha03

23 febbraio 2022

androidx.navigation:navigation-*:2.5.0-alpha03 è stato rilasciato. La versione 2.5.0-alpha03 contiene questi commit.

Modifiche alle API

  • Ora puoi passare CreationExtras a by navGraphViewModels per creare un ViewModel. (I29217, b/217618359)

Correzioni di bug

  • NavDeepLinks ora supporta correttamente i caratteri di nuova riga codificati incorporati negli URI di route/deep link. (I513d1, b/217815060)
  • CreationExtras ora funzionerà correttamente se utilizzato con NavBackStackEntries per creare ViewModel. (I69161, b/217617710)
  • Navigation Safe Args ora supporta l'utilizzo dello spazio dei nomi definito in build.gradle al posto del pacchetto in AndroidManifest. (I659ef, b/217414933)

Versione 2.5.0-alpha02

9 febbraio 2022

androidx.navigation:navigation-*:2.5.0-alpha02 è stato rilasciato. La versione 2.5.0-alpha02 contiene questi commit.

Correzioni di bug

  • Da Navigation 2.4.1: NavHostFragment ora imposterà correttamente OnBackPressedDispatcher quando utilizzi l'associazione delle visualizzazioni con grafici nidificati. (Ifbb51, b/214577959)
  • Da Navigation 2.4.1: quando si esegue il deep linking tramite più NavGraph nidificati, il back stack ora includerà correttamente le destinazioni di partenza intermedie. (I504c0, b/214383060)

Versione 2.5.0-alpha01

26 gennaio 2022

androidx.navigation:navigation-*:2.5.0-alpha01 è stato rilasciato. La versione 2.5.0-alpha01 contiene questi commit.

Nuove funzionalità

Correzioni di bug

  • Risolto un problema per cui l'accesso a un ViewModel creato tramite by navGraphViewModels() da un onCreate() di un frammento non andava a buon fine con un IllegalStateException. (I8a14d)
  • NavDeepLink non decodificherà più inutilmente gli argomenti due volte, il che significa che ora gli argomenti corretti vengono passati alla destinazione finale. (I31b0a, b/210711399)

Safe Args

  • Safe Args ora dipende dalla versione 7.0.4 del plug-in Android per Gradle. Ciò significa che Navigation Safe Args non sarà più compatibile con le versioni di Android Studio precedenti alla 7.0, ma ora è compatibile con il plug-in Android per Gradle 7.1.0 e versioni successive. (I41c88, b/213086135, b/207670704)

Versione 2.4.2

Versione 2.4.2

6 aprile 2022

androidx.navigation:navigation-*:2.4.2 è stato rilasciato. La versione 2.4.2 contiene questi commit.

Correzioni di bug

Versione 2.4.1

Versione 2.4.1

9 febbraio 2022

androidx.navigation:navigation-*:2.4.1 è stato rilasciato. La versione 2.4.1 contiene questi commit.

Correzioni di bug

  • NavHostFragment ora imposterà correttamente OnBackPressedDispatcher quando utilizzi l'associazione delle visualizzazioni con grafici nidificati. (Ifbb51, b/214577959)
  • Quando esegui il deep linking tramite più NavGraph nidificati, il back stack ora includerà correttamente le destinazioni di partenza intermedie. (I504c0, b/214383060)
  • Backport da Navigation 2.5.0-alpha01: è stato risolto un problema per cui l'accesso a un ViewModel creato tramite by navGraphViewModels() da un onCreate() di un Fragment non andava a buon fine con un IllegalStateException. (I8a14d)
  • Backport da Navigation 2.5.0-alpha01: NavDeepLink non decodifica più inutilmente gli argomenti due volte, il che significa che gli argomenti decodificati correttamente vengono ora passati alla destinazione finale. (I31b0a, b/210711399)
  • Backport da Navigation 2.5.0-alpha01: Safe Args ora dipende dalla versione 7.0.4 del plug-in Android per Gradle. Ciò significa che Navigation Safe Args non sarà più compatibile con le versioni di Android Studio precedenti alla 7.0, ma ora è compatibile con il plug-in Android per Gradle 7.1.0 e versioni successive. (I41c88, b/213086135, b/207670704)

Versione 2.4.0

Versione 2.4.0

26 gennaio 2022

androidx.navigation:navigation-*:2.4.0 è stato rilasciato. La versione 2.4.0 contiene questi commit.

Modifiche importanti dalla versione 2.3.0

  • Tutti gli artefatti di navigazione sono stati riscritti in Kotlin. In questo modo è stata migliorata l'annullabilità delle classi che utilizzano i generici (come le sottoclassi NavType). Tutte le funzioni di estensione Kotlin che facevano parte degli artefatti -ktx sono state spostate nei rispettivi artefatti principali. Gli artefatti -ktx continueranno a essere pubblicati, ma saranno completamente vuoti.
  • L'artefatto navigation-fragment ora contiene un'implementazione predefinita di un layout a due riquadri tramite il nuovo AbstractListDetailFragment. Questo frammento utilizza un SlidingPaneLayout per gestire un riquadro elenco (fornito dalla tua sottoclasse) e un riquadro dei dettagli, che utilizza un NavHostFragment come implementazione, come mostrato nella nostra implementazione di esempio.
  • Il metodo currentBackStackEntryAsFlow() su NavController fornisce un Flow che viene emesso ogni volta che cambia il NavBackStackEntry corrente. Questo flusso può essere utilizzato come alternativa alla gestione manuale di un OnDestinationChangedListener.
  • NavController ora offre la possibilità di recuperare un elenco di tutte le istanze NavBackStackEntry visibili come StateFlow tramite la proprietà sperimentale visibleEntries.
  • Ora è possibile estendere la classe NavType per creare NavType personalizzati. I tipi personalizzati sono supportati solo quando crei il grafico di navigazione in modo programmatico, ad esempio tramite il DSL Kotlin del grafico di navigazione.
  • La navigazione ora fornisce le API findStartDestination() e getHierarchy() che possono essere utilizzate per implementare la NavigationUI personalizzata. findStartDestination() è una funzione di estensione su NavGraph che individua la destinazione di partenza effettiva che verrà visualizzata quando accedi al grafico, anche se startDestination è un NavGraph nidificato. getHierarchy() è una funzione di NavDestination che può essere utilizzata per verificare se una determinata destinazione si trova all'interno della gerarchia di un'altra.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • I metodi NavigationUI che accettavano un BottomNavigationView sono stati aggiornati per accettare la relativa superclasse introdotta in Material 1.4.0, NavigationBarView. In questo modo, questi metodi possono essere utilizzati con NavigationRailView.

  • Quando si esegue l'inflation di un elemento <action> tramite XML, gli attributi di animazione possono utilizzare attributi estratti dal tema utilizzando la sintassi app:enterAnim="?attr/transitionEnter".

  • Safe Args ora genera un metodo fromSavedStateHandle() per ogni classe NavArgs. (#122, 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)
    }
    

Percorsi di navigazione e DSL Kotlin

Le versioni precedenti di Navigation si basavano sul fatto che ogni destinazione avesse un ID intero costante che la identificasse in modo univoco rispetto alle destinazioni di pari livello e ti consentisse di navigate() a quella destinazione direttamente o tramite un'azione. Sebbene questo continui a essere valido e utile, in particolare nei casi in cui definisci il grafico di navigazione in XML e puoi utilizzare costanti R.id generate automaticamente o Safe Args (che utilizza queste costanti per generare codice in fase di build), questo sistema di numeri interi univoci non ha catturato il significato semantico e l'espressività necessari per supportare grafici completamente dinamici creati in modo programmatico in fase di runtime tramite il DSL di navigazione Kotlin.

Questa release introduce una nuova opzione per identificare in modo univoco una destinazione in un grafico di navigazione in base al relativo percorso. Una route è un String che definisce il percorso univoco verso una destinazione. Tutti i metodi DSL Kotlin che accettavano un ID destinazione sono ora deprecati e sostituiti da un'API equivalente che accetta un percorso.

Ogni percorso deve essere trattato come la parte "path" di un Uri che definisce la destinazione, ad esempio home, profile/{userId}, profile/{userId}/friends e così via. Quando l'identità di una destinazione è associata a un contenuto specifico, questi argomenti dinamici devono far parte del percorso, seguendo le stesse regole dei deep link impliciti.

Tutte le API NavController che in precedenza accettavano solo un ID ora hanno un overload che accetta un percorso String. Sono inclusi navigate(), popBackStack(), popUpTo() e getBackStackEntry().

Ciò ha avuto alcune implicazioni per le API:

  • La proprietà Kotlin popUpTo nel DSL Kotlin è stata deprecata a favore di popUpToId.
  • L'API getStartDestination() è stata ritirata a favore di getStartDestinationId().

A differenza della navigazione per ID, la navigazione per percorso segue le stesse regole dei deep link impliciti, in quanto puoi navigare direttamente verso qualsiasi destinazione in qualsiasi grafico nidificato, assicurando che questi percorsi siano utilizzabili in progetti multimodulo senza aggiungere esplicitamente un deep link visibile esternamente a ogni destinazione.

Navigation Compose

L'artefatto navigation-compose fornisce l'integrazione tra il componente di navigazione e Jetpack Compose. Utilizza le funzioni @Composable come destinazioni nell'applicazione.

Questa release fornisce:

  • Un composable NavHost che ti consente di creare il grafico di navigazione tramite un DSL Kotlin, utilizzando le destinazioni composable e dialog, oltre al supporto per i navigatori facoltativi come quelli di Accompanist Navigation Material.
  • Supporto obbligatorio per la dissolvenza incrociata tra le destinazioni. Accompanist Navigation Animation può essere utilizzato per controllare le transizioni di entrata e uscita utilizzando le API Compose sperimentali.
  • Definizione dell'ambito di un Lifecycle per ogni destinazione componibile. Ogni destinazione raggiunge lo stato RESUMED solo quando terminano le transizioni in entrata e passa immediatamente a STARTED quando iniziano le transizioni in uscita, consentendoti così di evitare tutti i problemi di IllegalStateException e multi-touch attivando una chiamata navigate solo quando Lifecycle è RESUMED.
  • Definizione dell'ambito di ViewModel (tramite l'API viewModel() di Lifecycle ViewModel Compose 2.4.0 o hiltViewModel() di Hilt Navigation Compose 1.0.0 a livello di destinazione, fornendo un ambito che sopravvive alle modifiche alla configurazione e si trova nel back stack (quando i contenuti componibili vengono altrimenti eliminati) e un indicatore in onCleared() di ViewModel che indica l'eliminazione definitiva e la pulizia dello stato associato a NavBackStackEntry.
  • Definizione dell'ambito dello stato di rememberSaveable a livello di destinazione, per garantire che tutto lo stato componibile venga salvato e ripristinato automaticamente quando torni a una destinazione.
  • Supporto completo per il salvataggio e il ripristino dello stato di NavController e della relativa destinazione dopo l'interruzione del processo e la ricreazione.
  • Integrazione automatica con il pulsante Indietro del sistema.
  • Supporto per il passaggio di argomenti, l'associazione di deep link alle destinazioni e la restituzione di un risultato alle destinazioni precedenti.

  • Crea helper specifici in rememberNavController() e currentBackStackEntryAsState() per consentire l'elevazione dello stato e il collegamento di NavController a elementi componibili esterni a NavHost (ad esempio una barra di navigazione in basso).

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()
        }
    }
}

Per saperne di più, consulta la guida alla navigazione di Compose.

Più back stack

Il NavController è responsabile della gestione del back stack delle destinazioni, dell'aggiunta di destinazioni al back stack quando le navigate() e della loro rimozione quando chiami popBackStack() o attivi il pulsante Indietro del sistema. La classe NavOptions esistente e l'integrazione negli elementi <action> nell'XML del grafico di navigazione sono state ampliate per supportare il salvataggio e il ripristino del back stack.

Nell'ambito di questa modifica, i metodi NavigationUI di onNavDestinationSelected(), BottomNavigationView.setupWithNavController() e NavigationView.setupWithNavController() ora salvano e ripristinano automaticamente lo stato delle destinazioni rimosse, consentendo il supporto di più back stack senza modifiche al codice. Quando utilizzi la navigazione con i frammenti, questo è il modo consigliato per l'integrazione con più back stack.

Le API sottostanti per il salvataggio e il ripristino dello stato sono esposte tramite una serie di piattaforme:

  • In Navigation XML, l'elemento <action> ora può utilizzare gli attributi booleani di app:popUpToSaveState e app:restoreState per salvare lo stato di tutte le destinazioni rimosse tramite app:popUpTo e ripristinare lo stato associato alla destinazione passata come 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” />
    
  • Nel navOptions Kotlin DSL, puoi aggiungere la proprietà booleana restoreState e la proprietà booleana saveState nel 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
      }
    }
    
  • Quando crei manualmente un oggetto NavOptions tramite NavOptions.Builder, puoi utilizzare setRestoreState() e il nuovo overload per setPopUpTo() che accetta un parametro saveState aggiuntivo.

    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);
    
  • Le chiamate programmatiche a popBackStack() ora possono includere un parametro saveState aggiuntivo.

  • Puoi utilizzare il metodo clearBackStack() per cancellare qualsiasi stato salvato con popBackStack() o popUpToSaveState.

In tutti i casi, NavController salverà e ripristinerà lo stato di ogni NavBackStackEntry, incluse le istanze ViewModel con ambito di destinazione di navigazione. Le API Navigator sono state aggiornate per consentire a ogni Navigator di supportare il salvataggio e il ripristino del proprio stato.

Modifiche del comportamento

  • NavDeepLinkBuilder ora aggiunge PendingIntent.FLAG_IMMUTABLE a PendingIntent restituito da createPendingIntent(), garantendo che questa API funzioni come previsto quando il target è Android 12.
  • La navigazione ora dipende da Lifecycle 2.3.1 e ora contrassegna setGraph(), popBackStack(), navigateUp() e navigate(), i metodi che aggiornano NavBackStackEntry Lifecycle, come @MainThread, allineando la navigazione con l'applicazione del thread principale introdotta in Lifecycle 2.3.0.
  • I deep link ora verificano che tutti gli argomenti obbligatori (quelli senza valori predefiniti) siano presenti in Uri.
  • Gli argomenti analizzati di NavDeepLink ora considerano i cancelletti allo stesso modo dei punti interrogativi come separatore tra i segmenti di percorso, impedendo a un argomento di estendersi oltre il cancelletto.
  • Durante la generazione delle azioni, il codice Kotlin generato da Safe Args ora inserisce gli argomenti senza valori predefiniti prima di quelli con valori predefiniti come parametri.
  • Durante la generazione degli argomenti, Safe Args ora inserisce i parametri senza valori predefiniti prima di quelli con valori predefiniti.
  • Safe Args ora dipende dal plug-in Android per Gradle 4.2.0. Ciò significa che non dovresti più ricevere l'avviso sull'utilizzo di applicationIdTextResource.

Problemi noti

  • Risolto in Navigation 2.5.0-alpha01: l'accesso a un ViewModel creato tramite by navGraphViewModels() da un onCreate() di un frammento non andrà a buon fine con un IllegalStateException. (b/213504272)
  • Problema risolto in Navigation 2.5.0-alpha01: Safe Args 2.4.0 non è compatibile con il plug-in Android per Gradle 7.1.0 e versioni successive. (b/213086135)
  • Il deep linking con più grafici di navigazione nidificati non crea correttamente il backstack completo. (b/214383060)

Versione 2.4.0-rc01

15 dicembre 2021

androidx.navigation:navigation-*:2.4.0-rc01 è stato rilasciato. La versione 2.4.0-rc01 contiene questi commit.

Modifiche del comportamento

  • Gli argomenti analizzati NavDeepLink ora considerano i simboli di cancelletto allo stesso modo dei punti interrogativi come separatore tra gli argomenti. (I21309, b/180042703)

Correzioni di bug

  • I deep link non ignoreranno più gli argomenti con valori uguali al nome del segnaposto. (If8017, b/207389470)
  • NavController non si arresterà più in modo anomalo quando viene visualizzata una destinazione nidificata utilizzando le transizioni dopo il ripristino di NavController. (I0f7c9, b/205021623)
  • Il messaggio di errore quando si utilizza un startDestination non valido ora verrà impostato per impostazione predefinita sul percorso della destinazione iniziale, se disponibile. (I86b9d, b/208041894)

Correzioni di bug di Navigation Compose

  • Risolto un potenziale arresto anomalo causato dal passaggio rapido tra la destinazione iniziale e un'altra destinazione utilizzando le voci del menu di navigazione in basso. (Ic8976, b/208887901)
  • La destinazione della finestra di dialogo ora viene ripristinata correttamente nella parte superiore dello schermo dopo le modifiche alla configurazione o l'interruzione del processo. (I4c0dc, b/207386169)
  • Risolto un problema per cui il tentativo di recuperare un ViewModel da un NavBackStackEntry di una finestra di dialogo non andava a buon fine quando la finestra di dialogo veniva chiusa. (I6b96d, b/206465487)
  • Risolto un problema che si verificava quando si utilizzavano le destinazioni activity con NavHost di Navigation Compose, che causava ricomposizioni infinite. (I8f64c)
  • È stato corretto un leak in Navigation Compose in cui veniva mantenuto un riferimento alla vecchia attività dopo una modifica della configurazione o l'interruzione del processo. (I4efcb, b/204905432)

Correzioni di bug di Safe Args

  • SafeArgs non si arresta più in modo anomalo quando tenta di ripristinare array parcelable personalizzati dopo l'interruzione del processo. (I618e8, b/207315994)
  • È stato corretto un bug in Safe Args che non consentiva agli array booleani di avere un valore null. (I8c396, b/174787525)

Versione 2.4.0-beta02

3 novembre 2021

androidx.navigation:navigation-*:2.4.0-beta02 è stato rilasciato. La versione 2.4.0-beta02 contiene questi commit.

Modifiche alle API

  • La gestione dei deep link espliciti e impliciti ora aggiunge automaticamente il flag saveState quando si passa a un altro grafico, garantendo che il codice come NavigationUI.setupWithNavController e il codice che utilizza più back stack funzionino come previsto. (Ic8807)

Modifiche del comportamento

  • I pattern dei deep link ora vengono compilati in modo lazy in NavDeepLink anziché durante l'inflation. In questo modo, il tempo di espansione dei grafici di navigazione che includono deep link dovrebbe migliorare. (b8d257, b/184149935)

Correzioni di bug

  • È stato risolto un problema per cui le voci NavBackStackEntry venivano spostate in basso in Lifecycle.State.CREATED dopo il passaggio a Lifecycle.State.STARTED quando NavHost viene aggiunto direttamente a setContent() dell'attività. (Ia5ac1, b/203536683)
  • È stata corretta una race condition in cui la rimozione di una destinazione DialogFragment dal back stack prima che la finestra di dialogo venisse effettivamente mostrata non chiudeva la finestra di dialogo, causando un arresto anomalo quando la finestra di dialogo errata veniva chiusa manualmente dall'utente. (I687e5)
  • È stato risolto un problema per cui l'API onNavDestinationSelected su NavigationUI restituiva true anche se non avevi eseguito navigate() su quel grafico di navigazione. Ora utilizza la stessa logica utilizzata internamente da setupWithNavController per selezionare solo il MenuItem associato alla destinazione corrente utilizzando il hierarchy della destinazione. (I2b053)

Versione 2.4.0-beta01

27 ottobre 2021

androidx.navigation:navigation-*:2.4.0-beta01 è stato rilasciato. La versione 2.4.0-beta01 contiene questi commit.

Nuove funzionalità

  • Ora puoi utilizzare by navGraphViewModel con un percorso come alternativa all'utilizzo di un ID per supportare meglio l'utilizzo del DSL Kotlin di navigazione con i frammenti. (I901e3, b/201446416)

Modifiche alle API

  • L'API visibleEntries è ora sperimentale. (I93f6f)

Correzioni di bug

  • I ViewModel non verranno più eliminati quando le transizioni vengono interrotte navigando avanti e indietro tra le stesse schermate (Id52d8, b/200817333)
  • Gli argomenti NavDeepLink che ammettono valori null non richiedono più un valore predefinito quando si aggiungono deep link a NavDestination. (I5aad4, b/201320030)
  • Le voci NavBackStackEntry con cicli di vita diversi non sono più considerate uguali. Ciò significa che NavHost ricomporrà correttamente tutte le destinazioni durante la navigazione con singleTop e quando si riselezionano le voci del menu in basso. (I1b351, b/196997433)
  • Risolto un problema con AbstractListDetailFragment che causava la gestione errata o l'ignoramento degli attributi layout_width e layout_weight nel riquadro dell'elenco restituito da onCreateListPaneView(). (f5fbf3)
  • Lo stato visivo delle destinazioni della finestra di dialogo ora rimane sincronizzato correttamente con lo stato di DialogFragmentNavigator. Ciò significa che la chiamata manuale dell'API asincrona dismiss() per DialogFragment ora cancella correttamente tutte le destinazioni della finestra di dialogo sopra quella ora chiusa. Ciò non influisce sui casi in cui utilizzi popUpTo o popBackStack() per chiudere la finestra di dialogo. (I77ba2)
  • AbstractAppBarOnDestinationChangedListener ora ha messaggi di errore più chiari per onDestinationChanged(). (Ie742d)

Versione 2.4.0-alpha10

29 settembre 2021

androidx.navigation:navigation-*:2.4.0-alpha10 è stato rilasciato. La versione 2.4.0-alpha10 contiene questi commit.

Nuove funzionalità

  • NavController ora offre la possibilità di recuperare un elenco di tutte le istanze NavBackStackEntry visibili tramite visibleEntries StateFlow (Ia964e)
  • rememberNavController() ora accetta un insieme facoltativo di istanze Navigator che verranno aggiunte all'oggetto NavController restituito per supportare meglio i navigatori facoltativi, come quelli di Accompanist Navigation Material. (I4619e)

Correzioni di bug

  • La navigazione dinamica non si arresterà più in modo anomalo quando l'attività viene ricreata. (Ifa6a3, b/197942869)
  • Risolto un problema relativo al pulsante Indietro del sistema che si verifica solo dopo il ritorno a una destinazione componibile che contiene un NavHost. (3ed148, b/195668143)
  • SafeArgs ora genera gli argomenti per fromBundle() e fromSavedStateHandle() nell'ordine corretto dei parametri. (I824a8, b/200059831)

Versione 2.4.0-alpha09

15 settembre 2021

androidx.navigation:navigation-*:2.4.0-alpha09 è stato rilasciato. La versione 2.4.0-alpha09 contiene questi commit.

Nuove funzionalità

  • Ora puoi utilizzare il metodo clearBackStack() per cancellare qualsiasi stato salvato con popBackStack() o popUpToSaveState. (I80a0f)
  • Ora puoi passare un elenco di argomenti e/o deep link al builder del grafico di navigazione nidificato, che verranno aggiunti automaticamente al grafico risultante. (I8a470, b/182545357)

Modifiche alle API

  • La funzione DSL Kotlin navArgument ora fa parte di navigation-common anziché di navigation-compose. Per continuare a utilizzare questa funzione, sarà necessario aggiornare le importazioni. (I1d095)

Modifiche del comportamento

  • Durante la generazione degli argomenti, Safe Args ora inserisce i parametri senza valori predefiniti prima di quelli con valori predefiniti. (I89709, b/198493585)

Correzioni di bug

  • Quando utilizzi Navigation Compose, i NavGraph verranno DESTROYED solo dopo che tutti i relativi elementi secondari saranno stati DESTROYED. (I86552, b/198741720)
  • Gli argomenti NavDeepLink che ammettono valori null non richiedono più un valore predefinito. (Ia14ef, b/198689811)
  • La chiamata di setGraph() con un nuovo grafico ora cancella anche tutti i back stack salvati, oltre al comportamento precedente di estrazione del back stack. (I97f96)
  • Risolto un problema per cui le istanze OnDestinationChangedListener e currentBackStackEntryFlow non venivano informate quando utilizzavano launchSingleTop. (Iaaebc)

Aggiornamenti delle dipendenze

Versione 2.4.0-alpha08

1° settembre 2021

androidx.navigation:navigation-*:2.4.0-alpha08 è stato rilasciato. La versione 2.4.0-alpha08 contiene questi commit.

Nuove funzionalità

Modifiche del comportamento

  • Durante la generazione delle azioni, il codice Kotlin generato da Safe Args ora inserisce gli argomenti senza valori predefiniti prima di quelli con valori predefiniti come parametri. (Idb697, b/188855904)
  • I deep link ora verificano che tutti gli argomenti obbligatori (quelli senza valori predefiniti) siano presenti in Uri. (#204, b/185527157)

Correzioni di bug

  • L'utilizzo di getBackStackEntry e previousBackStackEntry all'interno di composable(), insieme a remember(), non causerà più un'eccezione per l'assenza di una destinazione nel back stack. (I75138, b/194313238)
  • Navigation Compose ora si ricompone correttamente quando si modificano gli argomenti del back stack e si utilizza launchSingleTop=true. (Iebd69, b/186392337)
  • Non ci sarà più un ArrayIndexOutOfBoundsException quando chiami setGraph con un grafico con 13 o 29 destinazioni. (I1a9f1, b/195171984)
  • Il generatore Java SafeArgs non dovrebbe più causare avvisi di lint durante la generazione di classi Args. (I1a666, b/185843837)

Contributo esterno

  • Grazie a ospixd per aver fatto in modo che i deep link verifichino che tutti gli argomenti obbligatori (quelli senza valori predefiniti) siano presenti in Uri. (#204, b/185527157)

Versione 2.4.0-alpha07

18 agosto 2021

androidx.navigation:navigation-*:2.4.0-alpha07 è stato rilasciato. La versione 2.4.0-alpha07 contiene questi commit.

Correzioni di bug

  • Navigation Compose ora salva correttamente lo stato dopo le modifiche alla configurazione e quando si cambiano i grafici durante l'utilizzo della funzionalità di back stack multiplo. (If5a3d, b/195141957)
  • La nuova selezione della stessa scheda quando si utilizza Navigation Compose con più back stack non comporterà più una schermata vuota. (I860dc, b/194925622)
  • NavHost ora osserva le modifiche nel Lifecycle.State di NavBackStackEntry, il che significa che l'utilizzo di un NavHost in un frammento ora verrà ricomposto correttamente man mano che il ciclo di vita cambia, anziché generare una schermata vuota. (I4eb85, b/195864489)
  • Risolto un problema per cui la chiusura di un DialogFragment non aggiornava correttamente lo stato di NavController dopo aver ricreato l'attività (ad esempio, dopo una modifica della configurazione). (Icd72b)
  • Risolto un problema per cui l'eliminazione di una destinazione della finestra di dialogo non aggiornava la gestione del pulsante Indietro di sistema del NavController, il che poteva causare l'intercettazione del pulsante Indietro da parte del NavController anche se non aveva un back stack da eliminare. (If3b34)
  • Safe Args ora genera automaticamente un metodo toSavedStateHandle per gli argomenti che possono essere utilizzati per testare il codice ViewModel. (If1e2d, b/193353880)

Versione 2.4.0-alpha06

4 agosto 2021

androidx.navigation:navigation-*:2.4.0-alpha06 è stato rilasciato. La versione 2.4.0-alpha06 contiene questi commit.

Modifiche alle API

  • I metodi requireSlidingPaneLayout() e requireDetailPaneNavHostFragment() su AbstractListDetailFragment sono stati rinominati rispettivamente in getSlidingPaneLayout() e getDetailPaneNavHostFragment(). (I34a08)

Modifiche del comportamento

  • Quando navighi con le animazioni (come Crossfade), l'elemento Lifecycle della nuova destinazione raggiungerà l'elemento RESUMED solo al termine dell'animazione. (If0543, b/172112072, b/194301889)
  • NavHost di Navigation Compose ora imposta il grafico come parte della prima composizione. (Ieb7be)

Correzioni di bug

  • La rimozione dell'ultima destinazione di un grafico di navigazione non genera più un'eccezione ClassCastException. (If0543, b/172112072, b/194301889)
  • Risolto un NullPointerException che si verificava quando si aggiungeva un deep link senza un Uri e si navigava tramite un percorso o un deep link. (938a0c, b/193805425)
  • Risolto un problema in Navigation Compose per cui un NavBackStackEntry con deep link non raggiungeva lo stato RESUMED. (I192c5)
  • È stato risolto un problema per cui l'estrazione di una destinazione della finestra di dialogo non aggiornava la gestione del pulsante Indietro di sistema del NavController, il che poteva causare l'intercettazione del pulsante Indietro da parte del NavController anche se non aveva un back stack da estrarre. (aosp/1782668)

Versione 2.4.0-alpha05

21 luglio 2021

androidx.navigation:navigation-*:2.4.0-alpha05 è stato rilasciato. La versione 2.4.0-alpha05 contiene questi commit.

Modifiche del comportamento

  • NavHost di Navigation Compose ora utilizza sempre le dissolvenze incrociate durante la navigazione tra le destinazioni. (I07049, b/172112072)
  • Ora puoi apportare modifiche al grafico di un NavHost. I grafici con la stessa startDestination e le stesse destinazioni nel grafico verranno considerati uguali e non cancelleranno il back stack di NavController. (I0b8db, b/175392262)

Correzioni di bug

  • È stato corretto un NoSuchElementException quando viene chiamato popBackStack() da un LifecycleObserver collegato a un NavBackStackEntry causato da aggiornamenti rientranti dello stato di NavController. (I64621)
  • AbstractListDetailFragment ora consente di rimuovere completamente SlidingPaneLayout dal tuo APK quando AbstractListDetailFragment non viene utilizzato. (I611ad)
  • NavGraph e NavDestination ora eseguono l'override del metodo equals, quindi due oggetti con gli stessi valori verranno considerati uguali. (I166eb, b/175392262)

Versione 2.4.0-alpha04

1° luglio 2021

androidx.navigation:navigation-*:2.4.0-alpha04 è stato rilasciato. La versione 2.4.0-alpha04 contiene questi commit.

Nuove funzionalità

  • L'artefatto navigation-fragment ora contiene un'implementazione predefinita di un layout a due riquadri tramite il nuovo AbstractListDetailFragment. Questo frammento utilizza un SlidingPaneLayout per gestire un riquadro elenco (fornito dalla tua sottoclasse) e un riquadro dei dettagli, che utilizza un NavHostFragment come implementazione, come mostrato nella nostra implementazione di esempio. (Iac4be, b/191276636)
  • La NavHost dell'artefatto navigation-compose ora supporta le destinazioni dialog oltre alle destinazioni composable. Queste destinazioni della finestra di dialogo verranno visualizzate ciascuna all'interno di un elemento componibile Dialog, che fluttua sopra la destinazione composable corrente. (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()
            }
        }
    }

Modifiche alle API

  • La funzione add in NavigatorState è stata rinominata in push. Tutte le chiamate correnti a add() dovranno essere modificate in push(). (Ie89fc, b/172112072)
  • Le istanze Navigator personalizzate ora possono utilizzare le API pushWithTransaction e popWithTransition su NavigatorState per eseguire il push o il pop di una destinazione in modo asincrono. Tieni presente che queste API non sono ancora utilizzate da nessuno dei navigatori inclusi. (Ic4d7c, b/172112072)

Modifiche del comportamento

  • NavDeepLinkBuilder ora aggiunge PendingIntent.FLAG_IMMUTABLE a PendingIntent restituito da createPendingIntent(), garantendo che questa API funzioni come previsto quando il target è Android 12. (If8c52)

Correzioni di bug

  • Risolto un problema con <include-dynamic> per cui gli argomenti passati al grafico non venivano passati correttamente al grafico incluso dinamicamente. (I3e115)
  • È stato risolto un problema di NullPointerException durante la navigazione verso una destinazione utilizzando un argomento string[] con un valore predefinito di @null. (I1fbe8)
  • Aggiungi regole di ProGuard per @Navigator.Name, risolvendo i problemi quando utilizzi la modalità completa di R8 3.1. (I2add9, b/191654433)
  • SafeArgs non genererà più errori durante la creazione dell'app con versioni di Kotlin precedenti alla 1.5.0. (Icd1ff, b/190739257)

Versione 2.4.0-alpha03

16 giugno 2021

androidx.navigation:navigation-*:2.4.0-alpha03 è stato rilasciato. La versione 2.4.0-alpha03 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui erano necessarie due chiamate navigate() per passare a un grafico dinamico incluso. (I7785c, b/188859835)
  • È stata corretta una regressione introdotta in Navigation 2.4.0-alpha01 per cui setupActionBarWithNavController() non rimuoveva correttamente l'icona Su quando ti trovi in una destinazione di primo livello. (I5d443, b/189868637)
  • Risolto un problema di IllegalStateException quando viene chiamato popBackStack() dopo aver eseguito il pop del grafico principale di NavController. (I2a330, b/190265699)
  • Le regole di ProGuard per by navArgs() ora vengono applicate correttamente quando utilizzi navigation-common o qualsiasi artefatto che dipende da questo. (I68800, b/190082521)
  • Un OnDestinationChangedListener che chiama navigate() la prima volta che riceve un callback ora riceve correttamente un secondo callback con la destinazione a cui ha navigato. (Ie5f9e, b/190228815)
  • Safe Args non si arresta più in modo anomalo quando viene utilizzato con i moduli delle funzionalità dinamiche e AGP 7.0 e versioni successive. (I69518, b/189966576)

Problema noto

  • Safe Args non funzionerà con un errore Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’ quando utilizzi Gradle 6.7.0 a causa di una dipendenza da una versione precedente di Kotlin. Per risolvere il problema, esegui l'aggiornamento per utilizzare Gradle 7.0. (b/190739257)

Versione 2.4.0-alpha02

2 giugno 2021

androidx.navigation:navigation-*:2.4.0-alpha02 è stato rilasciato. La versione 2.4.0-alpha02 contiene questi commit.

Nuove funzionalità

  • I percorsi sono ora supportati per le destinazioni Activity, Fragment e Dialog, nonché in tutto il DSL Kotlin di DynamicNavigation. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
  • NavigationUI ha aggiunto temporaneamente API sperimentali per consentire la disattivazione del salvataggio dello stato. Sebbene il salvataggio dello stato sia il comportamento corretto, esistono ancora utilizzi di librerie deprecate (ad es. frammenti conservati) che non possono essere supportati durante il salvataggio dello stato, pertanto ciò offre alle app l'opportunità di abbandonare gradualmente le API non supportate. (Idf93c)
  • La navigazione ora fornisce le API findDestination() e getHierarchy() che possono essere utilizzate per implementare la NavigationUI personalizzata. findDestination() è una funzione di estensione su NavGraph che individua una destinazione all'interno del grafico. getHierarchy() è una funzione su NavDestination che può essere utilizzata per verificare se una determinata destinazione si trova all'interno della gerarchia di un'altra.(I2932f, b/188183365)

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • I metodi NavigationUI che accettavano un BottomNavigationView sono stati aggiornati per accettare la relativa superclasse introdotta in Material 1.4.0, NavigationBarView. In questo modo, questi metodi possono essere utilizzati con NavigationRailView. (Ib0b36, b/182938895)

  • Quando esegui l'inflating di un elemento <action> tramite XML, gli attributi di animazione possono utilizzare attributi estratti dal tema utilizzando la sintassi app:enterAnim="?attr/transitionEnter". (I07bc1, b/178291654)

Modifiche alle API

Correzioni di bug

  • DialogFragmentNavigator ora utilizza l'API NavigatorState.pop() per informare NavController quando una finestra di dialogo viene chiusa premendo il pulsante Indietro del sistema o facendo clic all'esterno, assicurando che lo stato di NavController sia sempre sincronizzato con lo stato di Navigator. (I2ead9)
  • La navigazione non restituisce più un ConcurrentModificationException quando si utilizza la manipolazione dell'elenco di OnDestinationChangedListeners con un callback onDestinationChanged. (Ib1707, b/188860458)

  • Safe Args non si arresta più in modo anomalo quando tenta di generare proprietà di direzione in Kotlin. (Id2416, b/188564435)

  • Il metodo setId su NavDestination è ora annotato correttamente con @IdRes, pertanto accetta solo ID risorsa. (I69b80)

  • Il parametro int di findNode ora è resId anziché resid. (I7711d)

Aggiornamento delle dipendenze

  • Safe Args ora dipende dal plug-in Android per Gradle 4.2.0. Ciò significa che non dovresti più ricevere l'avviso sull'utilizzo di applicationIdTextResource. (I6d67b, b/172824579)

Versione 2.4.0-alpha01

18 maggio 2021

androidx.navigation:navigation-*:2.4.0-alpha01 è stato rilasciato. La versione 2.4.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Il metodo currentBackStackEntryAsFlow() su NavController fornisce un Flow che viene emesso ogni volta che cambia il NavBackStackEntry corrente. Questo flusso può essere utilizzato come alternativa alla gestione manuale di un OnDestinationChangedListener. (I19c4a, #89, b/163947280)

Più back stack

Il NavController è responsabile della gestione del back stack delle destinazioni, dell'aggiunta di destinazioni al back stack quando le navigate() e della loro rimozione quando chiami popBackStack() o attivi il pulsante Indietro del sistema. La classe NavOptions esistente e l'integrazione nelle voci <action> nel file XML del grafico di navigazione sono state ampliate per supportare il salvataggio e il ripristino del back stack. (b/80029773)

Nell'ambito di questa modifica, i metodi NavigationUI di onNavDestinationSelected(), BottomNavigationView.setupWithNavController() e NavigationView.setupWithNavController() ora salvano e ripristinano automaticamente lo stato delle destinazioni rimosse, consentendo il supporto di più back stack senza modifiche al codice. Quando utilizzi la navigazione con i frammenti, questo è il modo consigliato per l'integrazione con più back stack. (Ie07ca)

Le API sottostanti per il salvataggio e il ripristino dello stato sono esposte tramite una serie di piattaforme:

  • In Navigation XML, l'elemento <action> ora può utilizzare gli attributi booleani di app:popUpToSaveState e app:restoreState per salvare lo stato di tutte le destinazioni rimosse tramite app:popUpTo e ripristinare lo stato associato alla destinazione passata come 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” />
    
  • Nel navOptions Kotlin DSL, puoi aggiungere la proprietà booleana restoreState e la proprietà booleana saveState nel 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
      }
    }
    
  • Quando crei manualmente un oggetto NavOptions tramite NavOptions.Builder, puoi utilizzare setRestoreState() e il nuovo overload per setPopUpTo() che accetta un parametro saveState aggiuntivo.

    NavOptions navOptions = new NavOptions.Builder()
      .setLaunchSingleTop(true)
      .setRestoreState(true)
      .setPopUpTo(navController.getGraph().getStartDestinationId(),
        false, // inclusive
        true) // saveState
      .build();
    navController.navigate(selectedBottomNavId, null, navOptions);
    
  • Le chiamate programmatiche a popBackStack() ora possono includere un parametro saveState aggiuntivo.

In tutti i casi, NavController salverà e ripristinerà lo stato di ogni NavBackStackEntry, incluse le istanze ViewModel con ambito di destinazione di navigazione. Le API Navigator sono state aggiornate per consentire a ogni Navigator di supportare il salvataggio e il ripristino del proprio stato.

ComposeNavigator utilizzato per le destinazioni composable in Navigation Compose e FragmentNavigator e DynamicFragmentNavigator utilizzati per le destinazioni <fragment> in Navigation con i frammenti sono stati aggiornati per utilizzare le nuove API Navigator e supportare il salvataggio e il ripristino dello stato.

Percorsi di navigazione

Una route è un String che identifica in modo univoco una destinazione. Sebbene in precedenza fosse utilizzato solo in Navigation Compose, questo concetto è ora diventato parte delle API Navigation principali. In questo modo, puoi utilizzare un'alternativa agli ID interi quando crei il grafico tramite il DSL Kotlin di navigazione. (b/172823546)

Tutte le API che in precedenza accettavano solo un ID ora hanno un overload che accetta un percorso String. Sono inclusi navigate(), popBackStack(), popUpTo() e getBackStackEntry().

Ciò ha avuto alcune implicazioni per le API:

  • La proprietà Kotlin popUpTo nel DSL Kotlin è stata ritirata a favore di popUpToId. (I59c73, b/172823546)
  • L'API getStartDestination() è stata ritirata a favore di getStartDestinationId(). (I0887f, b/172823546)

Per gli sviluppatori che eseguono l'upgrade dalle versioni precedenti di Navigation Compose a Navigation Compose 2.4.0-alpha01, ciò significa che le seguenti importazioni sui metodi di estensione non sono più necessarie e devono essere rimosse:

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

L'argomento KEY_ROUTE è stato sostituito con la proprietà route su NavDestination, consentendoti di chiamare direttamente navBackStackEntry.destination.route.

Modifiche alle API

  • Tutti gli artefatti di navigazione sono stati riscritti in Kotlin. In questo modo è stato migliorato il supporto di valori null delle classi che utilizzano i generici (come le sottoclassi NavType). Tutte le funzioni di estensione Kotlin che facevano parte degli artefatti -ktx sono state spostate nei rispettivi artefatti principali. Gli artefatti -ktx continueranno a essere pubblicati, ma saranno completamente vuoti. (b/184292145)
  • NavDeepLinkBuilder ora supporta l'aggiunta di più destinazioni distinte al back stack generato. (I3ee0d, b/147913689)
  • Sono state aggiunte funzioni di fabbrica per DynamicNavHostFragment (Icd515, b/175222619)
  • L'ID univoco di un NavBackStackEntry è ora esposto come parte della sua API pubblica. (Ie033a)
  • I campi name e argument e le funzioni di destrutturazione di NamedNavArgument sono ora pubblici. (#174, b/181320559)
  • È stata introdotta una nuova estensione NavBackStackEntry#provideToCompositionLocals che fornisce NavBackStackEntry ai CompositionLocal pertinenti. (#175, b/187229439)

Safe Args

  • Safe Args ora genera un metodo fromSavedStateHandle() per ogni classe NavArgs. (#122, 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)
    }
    
  • È stato effettuato un aggiornamento di Safe Args in modo che dipenda da KotlinPoet 1.8.0. (#172, b/183990444)

Modifiche del comportamento

  • La navigazione ora dipende da Lifecycle 2.3.1 e ora contrassegna setGraph(), popBackStack(), navigateUp() e navigate(), i metodi che aggiornano NavBackStackEntry Lifecycle, come @MainThread, allineando la navigazione con l'applicazione del thread principale introdotta in Lifecycle 2.3.0. (b/171125856)
  • L'analisi degli argomenti Enum dai deep link ora non fa distinzione tra maiuscole e minuscole, consentendo a un deep link come http://www.example.com/red di corrispondere a un deep link www.example.com/{color} anche quando l'enum ha il valore RED. (#152, b/135857840)

Compatibilità di Compose

  • androidx.navigation:navigation-compose:2.4.0-alpha01 è compatibile solo con Compose versione 1.0.0-beta07 e successive.

Correzioni di bug

  • È stato risolto un problema per cui i segnaposto degli argomenti finali avevano la precedenza sui deep link con un suffisso esatto corrispondente. (#153, b/184072811)
  • NavHostFragment ora supporta i navigatori personalizzati che utilizzano lo stesso @Navigator.Name("dialog") del DialogFragmentNavigator predefinito. (Ib1c2c, b/175979140)
  • Migliorato il comportamento di NavigatorProvider#addNavigator per garantire che la chiamata ripetuta con la stessa istanza non causi problemi. (#176, b/187443146)

Contributi esterni

  • Grazie a simonschiller per aver creato il supporto per Safe Args che genera un metodo fromSavedStateHandle() per ogni classe NavArgs. (#122, b/136967621)
  • Grazie a Bradleycorn per aver reso l'analisi degli argomenti Enum dai deep link senza distinzione tra maiuscole e minuscole. (#152, b/135857840)
  • Grazie a osipxd per aver risolto un problema per cui i segnaposto degli argomenti finali avevano la precedenza sui deep link con un suffisso esatto corrispondente. (#153, b/184072811)
  • Grazie a tatocaster per aver aggiornato Safe Args in modo che dipenda da KotlinPoet 1.8.0. (#172, b/183990444)
  • Grazie a jossiwolf per aver reso pubblici i campi name e argument e le funzioni di destrutturazione di NamedNavArgument. (#174, b/181320559)
  • Grazie a jossiwolf per aver introdotto una nuova estensione NavBackStackEntry#provideToCompositionLocals che fornisce NavBackStackEntry ai relativi elementi locali di composizione. (#175, b/187229439)
  • Grazie a jossiwolf per aver migliorato il comportamento di NavigatorProvider#addNavigator per garantire che la chiamata ripetuta con la stessa istanza non causi problemi. (#176, b/187443146)

Versione 1.0.0-alpha10

7 aprile 2021

androidx.navigation:navigation-compose:1.0.0-alpha10 è stato rilasciato. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche alle API

  • NavHost ora accetta un Modifier, che viene passato al container componibile che aggrega i componibili di destinazione. (I85aca, b/175125483)

Correzioni di bug

  • NavHost ora funziona anche quando non viene trovato un OnBackPressedDispatcherOwner, come nel caso dell'anteprima di NavHost. (I7d8b4)
  • Navigation Compose ora dipende da Navigation 2.3.5, risolvendo un problema relativo all'utilizzo di BackHandler all'interno di una destinazione NavHost. (I7e63b, b/182284739)

Versione 1.0.0-alpha09

10 marzo 2021

androidx.navigation:navigation-compose:1.0.0-alpha09 è stato rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

  • LocalViewModelStoreOwner.current ora restituisce un ViewModelStoreOwner nullable per determinare meglio se un ViewModelStoreOwner è disponibile nella composizione corrente. Le API che richiedono un ViewModelStoreOwner, come viewModel() e NavHost, generano comunque un'eccezione se non è impostato un ViewModelStoreOwner. (Idf39a)

Correzioni di bug

  • Navigation Compose ora dipende da Navigation 2.3.4, che include la correzione per il tentativo di impostare lo stesso oggetto ViewModelStore dopo che il grafico è stato impostato. (I65c24, b/177825470)

Versione 1.0.0-alpha08

24 febbraio 2021

androidx.navigation:navigation-compose:1.0.0-alpha08 è stato rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Nuove funzionalità

  • NavHost ora compila il CompositionLocal LocalSavedStateRegistryOwner con il NavBackStackEntry di quella destinazione, assicurando che qualsiasi stato salvato direttamente nel SavedStateRegistry venga salvato e ripristinato insieme alla destinazione. (I435d7, b/179469431)

Versione 1.0.0-alpha07

10 febbraio 2021

androidx.navigation:navigation-compose:1.0.0-alpha07 è stato rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Aggiornamenti delle dipendenze

Versione 1.0.0-alpha06

28 gennaio 2021

androidx.navigation:navigation-compose:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Modifiche alle API

  • Aggiunto un metodo di estensione getBackStackEntry(route: String) su NavController che restituisce l'oggetto NavBackStackEntry associato. (If8931)

Versione 1.0.0-alpha05

13 gennaio 2021

androidx.navigation:navigation-compose:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

È stato effettuato un aggiornamento in modo che dipenda da Compose 1.0.0-alpha10.

Versione 1.0.0-alpha04

16 dicembre 2020

androidx.navigation:navigation-compose:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

  • È stato effettuato un aggiornamento per garantire la compatibilità con Compose 1.0.0-alpha09.

Versione 1.0.0-alpha03

2 dicembre 2020

androidx.navigation:navigation-compose:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui popBackStack() e navigateUp() non funzionavano dopo una modifica della configurazione o l'interruzione del processo e la ricreazione. (Icea47, b/173281473)
  • La navigazione a un grafico nidificato all'interno di NavHost ora funziona correttamente. (I0948d, b/173647694)

Versione 1.0.0-alpha02

11 novembre 2020

androidx.navigation:navigation-compose:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

  • Navigation Compose ora supporta NavOptions per l'utilizzo delle operazioni popUpTo e launchSingleTop (If96c3, b/171468994)
  • È stata aggiunta una funzione di navigazione che accetta un percorso anziché un ID che consente di creare grafici nidificati nel DSL di Navigation Compose. (I1661d)
  • startDestination ora precede il percorso nell'elenco dei parametri per un NavHost (Ie620e)
  • Ora puoi creare un grafico utilizzando il percorso come destinazione di partenza al di fuori di un elemento componibile NavHost. (Iceb75)

Versione 1.0.0-alpha01

28 ottobre 2020

android.navigation:navigation-compose:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

L'artefatto navigation-compose fornisce l'integrazione tra il componente di navigazione e Jetpack Compose. Utilizza le funzioni @Composable come destinazioni nell'applicazione.

Questa release iniziale offre:

  • Un componibile NavHost che ti consente di creare il grafico di navigazione tramite un DSL Kotlin.
  • Definizione dell'ambito del ciclo di vita, di ViewModel e dello stato memorizzato a livello di destinazione.
  • Integrazione automatica con il pulsante Indietro del sistema.
  • Supporto per il passaggio di argomenti, l'associazione di deep link alle destinazioni e la restituzione di un risultato alle destinazioni precedenti.
  • Crea helper specifici in rememberNavController() e currentBackStackEntryAsState() per consentire l'elevazione dello stato e il collegamento di NavController a elementi componibili esterni a NavHost (ad esempio una barra di navigazione in basso).

Per saperne di più, consulta la guida alla navigazione di Compose.

Versione 2.3.5

Versione 2.3.5

7 aprile 2021

androidx.navigation:navigation-*:2.3.5 è stato rilasciato. La versione 2.3.5 contiene questi commit.

Nuove funzionalità

  • Quando navighi utilizzando un NavDeepLinkRequest o un Uri, ora puoi accedere a Uri, azione e tipo MIME nella destinazione risultante recuperando l'intent dagli argomenti tramite KEY_DEEP_LINK_INTENT, rispecchiando la funzionalità già disponibile per il deep linking esterno. (I975c3, b/181521877)

Correzioni di bug

  • OnBackPressedCallbacks aggiunto a un dispatcher con NavBackStackEntry come LifecycleOwner ora intercetta correttamente il pulsante Indietro dopo che il ciclo di vita dell'attività è STOPPED, quindi STARTED (Iff94f, b/182284739)
  • L'analisi del dominio dei deep link ora non fa distinzione tra maiuscole e minuscole, garantendo che www.example.com corrisponda sia a www.example.com che a www.Example.com. Tieni presente che i nomi dei parametri di query sono ancora sensibili alle maiuscole. (#144, b/153829033)
  • Risolto un problema di NullPointerException che poteva verificarsi quando una destinazione aveva più argomenti predefiniti non nullabili e l'utente navigava verso quella destinazione eseguendo l'override solo di un sottoinsieme di questi argomenti. (aosp/1644827)

Aggiornamenti delle dipendenze

Contributo esterno

  • Grazie a bentrengrove per la richiesta di pull che rende l'analisi del dominio dei deep link senza distinzione tra maiuscole e minuscole. (#144, b/153829033)

Versione 2.3.4

Versione 2.3.4

10 marzo 2021

androidx.navigation:navigation-*:2.3.4 è stato rilasciato. La versione 2.3.4 contiene questi commit.

Nuove funzionalità

  • Ora gli argomenti ReferenceType possono essere analizzati correttamente quando vengono inviati come parte di un URI di deep link. Sono supportati sia il valore intero non elaborato sia i valori esadecimali con prefisso 0x. (#127, b/179166693)
  • android:defaultValue per un argomento con app:argType="float" ora supporta i valori predefiniti interi, consentendoti di utilizzare android:defaultValue="0" anziché richiedere l'utilizzo di 0.0. (#117, b/173766247)

Correzioni di bug

  • Risolto il problema relativo all'avanzamento dell'installazione bloccato quando si utilizza il supporto di Navigation per le funzionalità dinamiche. (Ib27a7, b/169636207)
  • La chiamata di setViewModelStore o setLifecycleOwner con lo stesso oggetto già impostato ora sarà un'operazione senza effetto (Idf491, b/177825470)
  • Safe Args ora aggiunge annotazioni di soppressione ai metodi appropriati quando si utilizza Java. (I8fbc5, b/179463137)

Contributi esterni

  • Grazie a JvmName per la richiesta di pull per garantire che gli argomenti ReferenceType possano ora essere analizzati correttamente quando vengono inviati come parte di un URI di deep link. (#127, b/179166693)
  • Grazie tatocaster per la richiesta di pull per consentire defaultValue per un argomento con app:argType=”float” che ora supporta i valori predefiniti di numeri interi. (#117, b/173766247)

Versione 2.3.3

Versione 2.3.3

27 gennaio 2021

androidx.navigation:navigation-*:2.3.3 è stato rilasciato. La versione 2.3.3 contiene questi commit.

Correzioni di bug

  • Non si verifica più un arresto anomalo quando si esegue il pop di un NavBackStackEntry prima che il relativo Lifecycle venga spostato in CREATED. (Ie3ba3)
  • È stata corretta la regressione causata da b/171364502, in cui la navigazione verso un'attività con un valore della risorsa di animazione pari a 0 causava un ResourceNotFoundException. (I7aedb, b/176819931)

Versione 2.3.2

Versione 2.3.2

2 dicembre 2020

androidx.navigation:navigation-*:2.3.2 è stato rilasciato. La versione 2.3.2 contiene questi commit.

Correzioni di bug

  • Risolta una regressione in NavigationUI per cui l'utilizzo di una destinazione <activity> con onNavDestinationSelected non consentiva di passare all'attività. (I22e34, b/171364502)
  • Risolto un problema per cui navigation-dynamic-features-fragment portava alla navigazione verso la destinazione appena installata più volte. (aosp/1486056, b/169636207)
  • Risolto un problema per cui gli argomenti predefiniti non venivano inviati alle istanze OnDestinationChangedListener quando si utilizzava launchSingleTop. (I2c5cb)
  • È stato risolto un problema per cui la navigazione a un grafico di navigazione nidificato non creava una nuova istanza del grafico nel back stack. (Ifc831)
  • È stato risolto un problema per cui l'utilizzo di navigate() con un popUpTo che rimuoveva l'ultima destinazione in un grafico di navigazione non distruggeva e rimuoveva immediatamente il grafico di navigazione stesso dal back stack. (I910a3)
  • Navigation SafeArgs ora utilizza KotlinPoet versione 1.7.2, che aggiunge il supporto della modalità API esplicita di Kotlin. (I918b5)
  • NavHostFragment.findNavController(Fragment) ora controlla anche la vista decorativa principale di un DialogFragment, oltre ai controlli esistenti della gerarchia di Fragment e della gerarchia di oggetti View di Fragment. In questo modo puoi testare i frammenti di finestre di dialogo che utilizzano la navigazione con FragmentScenario e Navigation.setViewNavController(). (I69e0d)

Versione 2.3.1

Versione 2.3.1

14 ottobre 2020

androidx.navigation:navigation-*:2.3.1 è stato rilasciato. La versione 2.3.1 contiene questi commit.

Nuove funzionalità

  • Le risorse Animator predefinite sono state aggiunte alla UI di navigazione e sono consigliate rispetto alle risorse di animazione predefinite. (b/167430145)
  • NavOptions ora esegue l'override dei metodi hashcode ed equals (b/161586466)
  • La navigazione ora include la destinazione corrente nell'IllegalArgumentException "Nessuna destinazione con ID", il che dovrebbe migliorare l'esperienza di debug degli sviluppatori. (b/168311416)

Correzioni di bug

  • Safe Args non eseguirà più il wrapping della riga di ritorno, anche se il nome della classe di argomenti generata è più lungo di 100 caratteri. (b/168584987)

Modifiche alle dipendenze

  • navigation-ui ora dipende da DrawerLayout 1.1.1, per garantire che NavigationUI sia in grado di aprire il riquadro a scomparsa anche quando utilizzi LOCK_MODE_LOCKED_CLOSED o LOCK_MODE_LOCKED_OPEN. (b/162253907)
  • Safe Args ora dipende da KotlinPoet 1.6.0 (aosp/1435911)
  • Safe Args ora dipende da AGP 4.0.1 (aosp/1442337)

Versione 2.3.0

Versione 2.3.0

24 giugno 2020

androidx.navigation:navigation-*:2.3.0 è stato rilasciato. La versione 2.3.0 contiene questi commit.

Modifiche principali dalla versione 2.2.0

  • Integrazione dei moduli delle funzionalità: gli artefatti navigation-dynamic-features-runtime e navigation-dynamic-features-fragment ti consentono di navigare verso le destinazioni definite nei moduli delle funzionalità, gestendo automaticamente l'installazione dei moduli delle funzionalità in base alle esigenze. Per saperne di più, consulta Naviga con i moduli delle funzionalità.
  • Test di navigazione: l'artefatto navigation-testing fornisce un TestNavHostController che consente di impostare la destinazione corrente e verificare il back stack dopo le operazioni di navigazione. Per saperne di più, consulta Test Navigation.
  • Restituzione di un risultato: NavBackStackEntry associato a ogni destinazione nel back stack di navigazione ora consente di accedere a un SavedStateHandle adatto per archiviare piccole quantità di stato salvato che devono essere associate a una particolare voce del back stack. Per saperne di più, consulta Restituzione di un risultato alla destinazione precedente.
  • Supporto di NavigationUI per Openable: tutti gli utilizzi di DrawerLayout in NavigationUI sono stati sostituiti con l'interfaccia più generica Openable aggiunta in CustomView 1.1.0 e implementata da DrawerLayout in DrawerLayout 1.1.0.
  • Supporto di Action e Mime Type nei deep link: il deep linking è stato ampliato per supportare app:action e app:mimeType oltre a app:uri precedentemente disponibile. NavController ora supporta la navigazione in base a qualsiasi combinazione di questi campi tramite la nuova classe NavDeepLinkRequest. Per saperne di più, consulta Naviga utilizzando NavDeepLinkRequest.

Problemi noti

  • Il supporto per le azioni di deep link e i tipi MIME non è ancora disponibile in Manifest Merger. Fino al completamento di questa operazione, gli elementi <intent-filter> generati dall'elemento <nav-graph> nel manifest non includeranno il tipo MIME nell'elemento <data> o nell'elemento <action> personalizzato. Devi aggiungere manualmente un <intent-filter> appropriato al manifest.

Versione 2.3.0-rc01

10 giugno 2020

androidx.navigation:navigation-*:2.3.0-rc01 è stato rilasciato. La versione 2.3.0-rc01 contiene questi commit.

Correzioni di bug

  • Risolto un problema di NullPointerException durante la sostituzione di un'istanza di una destinazione senza argomenti con un'altra istanza con argomenti con singleTop. (b/158006669)
  • Tutte le eccezioni destination is unknown generate da NavController ora contengono informazioni di debug aggiuntive per aiutare a determinare lo stato di NavController. (b/157764916)

Versione 2.3.0-beta01

20 maggio 2020

androidx.navigation:navigation-*:2.3.0-beta01 sono state rilasciate. La versione 2.3.0-beta01 contiene questi commit.

Correzioni di bug

  • Risolto un problema per cui l'elemento Lifecycle di NavBackStackEntry non veniva aggiornato correttamente dopo l'interruzione del processo. (b/155218371)
  • Le istanze OnDestinationChangedListener registrate prima di chiamare setGraph() ora ricevono correttamente la destinazione ripristinata dopo un'interruzione del processo. (b/155218371)
  • Quando utilizzi singleTop, gli argomenti di NavBackStackEntry ora vengono aggiornati correttamente e gli argomenti aggiornati vengono inviati a tutte le istanze OnDestinationChangeListener. (b/156545508)

Aggiornamenti delle dipendenze

Versione 2.3.0-alpha06

29 aprile 2020

androidx.navigation:navigation-*:2.3.0-alpha06 è stato rilasciato. La versione 2.3.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Il deep linking è stato ampliato per supportare app:action e app:mimeType, oltre a app:uri, che era già disponibile. NavController ora supporta la navigazione in base a qualsiasi combinazione di questi campi tramite la nuova classe NavDeepLinkRequest. (b/136573074, b/135334841)

Modifiche alle API

  • Supporto del DSL Kotlin notevolmente ampliato per le destinazioni di navigazione dinamica. (b/148969800)

Correzioni di bug

  • Risolto un problema per cui gli intent dei deep link venivano ignorati quando si utilizzava una destinazione di avvio nidificata. (b/154532067)

Versione 2.3.0-alpha05

15 aprile 2020

androidx.navigation:navigation-*:2.3.0-alpha05 è stato rilasciato. La versione 2.3.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Per le inclusioni di grafici dinamici che utilizzano <include-dynamic>, non è più necessario specificare app:graphPackage e ne verrà utilizzato uno predefinito aggiungendo il suffisso moduleName a applicationId dopo un punto. Se devi personalizzare il tuo graphPackage, ora è supportato un segnaposto ${applicationId}. (b/152696768)
  • La DSL Kotlin del grafico di navigazione ora espone un defaultArguments Map per le azioni, rispecchiando la possibilità di impostare valori predefiniti sugli elementi <action> nei file XML di navigazione. (b/150345605)

Correzioni di bug

  • Da Navigation 2.2.2: è stato corretto un IllegalStateException durante il deep linking alla destinazione iniziale del grafico quando hai più istanze NavHostFragment nella tua attività. (b/147378752)

Aggiornamenti delle dipendenze

Versione 2.3.0-alpha04

18 marzo 2020

androidx.navigation:navigation-*:2.3.0-alpha04 è stato rilasciato. La versione 2.3.0-alpha04 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto il supporto per le destinazioni di attività e frammenti dei moduli delle funzionalità nel DSL Kotlin di navigazione. (b/148969800)

Modifiche alle API

  • La classe DynamicExtras non utilizza più un pattern builder e ora può essere creata direttamente. (aosp/1253671)
  • DynamicActivityNavigator ora accetta un Context nel suo costruttore anziché un Activity. (aosp/1250252)

Correzioni di bug

  • NavigationUI non ignora più le etichette vuote (ovvero una destinazione con android:label=””) e ora imposta correttamente il titolo su una stringa vuota. (b/148679860)

Aggiornamenti delle dipendenze

  • Gli artefatti delle funzionalità dinamiche di navigazione ora dipendono dalla libreria di base Play 1.6.5. (b/149556401)

Versione 2.3.0-alpha03

4 marzo 2020

androidx.navigation:navigation-*:2.3.0-alpha03 è stato rilasciato. La versione 2.3.0-alpha03 contiene questi commit.

Modifiche alle API

  • Anziché basarsi sulla classe DrawerLayout concreta, AppBarConfiguration ora utilizza l'interfaccia Openable introdotta in CustomView 1.1.0-alpha02 (che DrawerLayout implementa a partire da DrawerLayout 1.1.0-alpha04), consentendoti di utilizzare implementazioni personalizzate di Openable con NavigationUI. (b/129030452)

Correzioni di bug

  • Le regole ProGuard di navigation-common-ktx ora mantengono correttamente solo le classi NavArgs utilizzate anziché tutte le istanze NavArgs. (b/150213558)

Modifiche alle dipendenze

  • Navigation ha ripristinato la sua dipendenza da Core 1.2.0 e ora dipende da Core 1.1.0 per evitare di costringere gli sviluppatori a passare a una dipendenza più recente quando Navigation non dipende da nuove API in Core 1.2.0.

Versione 2.3.0-alpha02

19 febbraio 2020

androidx.navigation:navigation-*:2.3.0-alpha02 è stato rilasciato. La versione 2.3.0-alpha02 contiene questi commit.

Nuove funzionalità

  • NavBackStackEntry ora ti consente di accedere a un SavedStateHandle adatto per archiviare piccole quantità di stato salvato che devono essere associate a una determinata voce del back stack. Per un esempio di caso d'uso, consulta Restituzione di un risultato. (b/79672220)

Modifiche alle API

  • Sono stati aggiunti i metodi di convenienza di getCurrentBackStackEntry() e getPreviousBackStackEntry() per semplificare il recupero di un NavBackStackEntry per le destinazioni corrente e precedente. (b/79672220)

Correzioni di bug

  • navigateUp() ora passa gli argomenti della destinazione corrente e KEY_DEEP_LINK_INTENT alla destinazione precedente quando avvii l'app nel tuo stack di attività. (b/147456890)

Modifiche alle dipendenze

Versione 2.3.0-alpha01

5 febbraio 2020

androidx.navigation:navigation-*:2.3.0-alpha01 è stato rilasciato. La versione 2.3.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Il nuovo artefatto navigation-testing fornisce una classe TestNavHostController. Questa classe fornisce un'alternativa all'utilizzo di un NavController fittizio durante il test della navigazione che consente di impostare la destinazione corrente e verificare il back stack dopo le operazioni di navigazione. (b/140884273)
  • Il nuovo navigation-dynamic-features-fragment (e la sua dipendenza transitiva, navigation-dynamic-features-runtime) ti consente di includere destinazioni o interi grafici di navigazione (tramite <include-dynamic>) dai moduli della funzionalità, fornendo un'installazione fluida dei moduli della funzionalità on demand durante la navigazione verso queste destinazioni. Per saperne di più, consulta Naviga con i moduli delle funzionalità. (b/132170186)

Correzioni di bug

  • Da Navigazione 2.2.1: i deep link senza parametri di query ora ignorano correttamente tutti i parametri di query anziché aggiungerli agli elementi {argument} finali o non corrispondere al deep link. (b/147447512)
  • Da Navigazione 2.2.1: le regole di ProGuard di navigation-ui per DrawerArrowDrawable sono state aggiornate per garantire che android.enableJetifier=true non sia obbligatorio. (b/147610424)
  • Da Navigazione 2.2.1: il modulo navigation-common-ktx ora ha un nome del pacchetto manifest univoco anziché condividere lo stesso nome del pacchetto manifest di navigation-runtime-ktx. (aosp/1141947)

Aggiornamenti delle dipendenze

Versione 2.2.2

Versione 2.2.2

15 aprile 2020

androidx.navigation:navigation-*:2.2.2 sono state rilasciate. La versione 2.2.2 contiene questi commit.

Correzioni di bug

  • Risolto un problema di IllegalStateException durante il deep linking alla destinazione iniziale del grafico quando sono presenti più istanze di NavHostFragment nell'attività. (b/147378752)
  • NavigationUI non ignora più le etichette vuote (ovvero una destinazione con android:label=””) e ora imposta correttamente il titolo su una stringa vuota. Questa funzionalità è stata rilasciata in precedenza in Navigation 2.3.0-alpha04. (b/148679860)
  • Le regole ProGuard di navigation-common-ktx ora mantengono correttamente solo le classi NavArgs utilizzate anziché tutte le istanze NavArgs. Questa funzionalità è stata rilasciata in precedenza in Navigation 2.3.0-alpha03. (b/150213558

Aggiornamenti delle dipendenze

Versione 2.2.1

Versione 2.2.1

5 febbraio 2020

androidx.navigation:navigation-*:2.2.1 è stato rilasciato. La versione 2.2.1 contiene questi commit.

Correzioni di bug

  • I deep link senza parametri di query ora ignorano correttamente tutti i parametri di query anziché aggiungerli agli elementi {argument} finali o non corrispondere al deep link. (b/147447512)
  • Le regole di ProGuard di navigation-ui per DrawerArrowDrawable sono state aggiornate per garantire che android.enableJetifier=true non sia obbligatorio. (b/147610424)
  • Il modulo navigation-common-ktx ora ha un nome del pacchetto manifest univoco anziché condividere lo stesso nome del pacchetto manifest di navigation-runtime-ktx. (aosp/1141947)

Aggiornamenti delle dipendenze

Versione 2.2.0

Versione 2.2.0

22 gennaio 2020

androidx.navigation:navigation-*:2.2.0 è stato rilasciato. La versione 2.2.0 contiene questi commit.

Modifiche importanti dalla versione 2.1.0

  • NavBackStackEntry: ora puoi chiamare NavController.getBackStackEntry(), passando l'ID di una destinazione o di un grafico di navigazione nel back stack. L'oggetto NavBackStackEntry restituito fornisce un LifecycleOwner basato sulla navigazione, ViewModelStoreOwner (lo stesso restituito da NavController.getViewModelStoreOwner()) e SavedStateRegistryOwner, oltre a fornire gli argomenti utilizzati per avviare la destinazione.
  • Integrazione di SavedState di ViewModel del ciclo di vita: SavedStateViewModelFactory è ora la factory predefinita utilizzata quando si utilizza by navGraphViewModels() o il costruttore ViewModelProvider con un ViewModelStoreOwner restituito da NavController.getBackStackEntry() o NavController.getViewModelStoreOwner().
  • Supporto dei parametri di query per i deep link: i deep link con parametri di query ora supportano i parametri di query riordinati; gli argomenti con un valore predefinito o che possono essere nulli ora sono facoltativi quando corrispondono ai deep link.
  • Supporto delle animazioni migliorato: NavHostFragment ora utilizza FragmentContainerView di Fragment 1.2.0, risolvendo i problemi di ordinamento z delle animazioni e di invio degli inset delle finestre ai frammenti.

Versione 2.2.0-rc04

18 dicembre 2019

androidx.navigation:navigation-*:2.2.0-rc04 è stato rilasciato. La versione 2.2.0-rc04 contiene questi commit.

Correzioni di bug

  • Sono state modificate le animazioni di dissolvenza predefinite utilizzate da navigation-ui in modo che corrispondano alle animazioni di dissolvenza modificate in Fragment 1.2.0-rc04. (b/145769814)

Versione 2.2.0-rc03

4 dicembre 2019

androidx.navigation:navigation-*:2.2.0-rc03 è stato rilasciato. La versione 2.2.0-rc03 contiene questi commit.

Correzioni di bug

  • Risolto un problema relativo all'analisi dei deep link quando si utilizzano parametri di query e un argomento come ultima parte del percorso che impediva l'analisi di più di un carattere dell'argomento del percorso finale. (b/144554689)
  • È stato risolto un problema relativo all'analisi dei deep link per cui i parametri facoltativi ricevevano "@null" anziché null. (b/141613546)
  • NavHostFragment ora ripristina correttamente il grafico dopo una modifica della configurazione se utilizzato con FragmentContainerView. (b/143752103)

Modifiche alle dipendenze

  • La navigazione ora dipende da Lifecycle 2.2.0-rc03, Lifecycle ViewModel SavedState 1.0.0-rc03, Activity 1.1.0-rc03 e Fragment 1.2.0-rc03, se appropriato.

Versione 2.2.0-rc02

7 novembre 2019

androidx.navigation:navigation-*:2.2.0-rc02 è stato rilasciato. La versione 2.2.0-rc02 contiene questi commit.

Modifiche alle dipendenze

  • La navigazione ora dipende da androidx.lifecycle 2.2.0-rc02.

Versione 2.2.0-rc01

23 ottobre 2019

androidx.navigation:navigation-*:2.2.0-rc01 viene rilasciato senza modifiche rispetto alla versione 2.2.0-beta01. La versione 2.2.0-rc01 contiene questi commit.

Versione 2.2.0-beta01

9 ottobre 2019

androidx.navigation:navigation-*:2.2.0-beta01 è stato rilasciato. La versione 2.2.0-beta01 contiene questi commit.

Nuove funzionalità

  • NavDestination e le relative sottoclassi ora eseguono l'override di toString() per fornire informazioni più utili durante il debug. (b/141264986)

Modifiche del comportamento

  • I parametri di query aggiuntivi ora vengono ignorati quando viene eseguita la corrispondenza dei deep link, anziché causare un errore di corrispondenza. (b/141482822)

Correzioni di bug

  • È stato risolto un problema per cui gli argomenti nel percorso di un deep link venivano ignorati se venivano specificati anche i parametri di query. (b/141505755)
  • L'estensione Kotlin navArgs() su Activity ora ha un messaggio di errore migliore quando non sono presenti extra. (b/141408999)
  • Le classi Java Directions generate da Safe Args ora contengono valori predefiniti. (b/141099045)
  • Le classi Java Args generate da Safe Args ora contengono valori predefiniti. (b/140123727)
  • Quando utilizzi un Toolbar, NavigationUI non anima più la modifica del testo quando passi da una destinazione di primo livello all'altra. (b/140848160)

Versione 2.2.0-alpha03

18 settembre 2019

androidx.navigation:navigation-*:2.2.0-alpha03 è stato rilasciato. La versione 2.2.0-alpha03 contiene questi commit.

Modifiche del comportamento

  • La chiamata a setViewModelStore() dopo la chiamata a setGraph ora genera un IllegalStateException. Questo valore deve essere sempre impostato da NavHost nell'ambito della configurazione iniziale per garantire che tutte le istanze NavBackStackEntry abbiano uno spazio di archiviazione coerente per le istanze ViewModel. (aosp/1111821)

Correzioni di bug

  • Risolto un problema di ConcurrentModificationException durante l'utilizzo di istanze ViewModel associate a più istanze ViewModelStore con ambito grafico di navigazione diverse. (aosp/1112257)

Versione 2.2.0-alpha02

5 settembre 2019

androidx.navigation:navigation-*:2.2.0-alpha02 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

  • I deep link con parametri di query ora supportano i parametri di query riordinati; gli argomenti che hanno un valore predefinito o che possono essere nulli sono ora facoltativi quando corrispondono ai deep link. (b/133273839)
  • Ora puoi chiamare NavController.getBackStackEntry(), passando l'ID di una destinazione o di un grafico di navigazione nel back stack. L'oggetto NavBackStackEntry restituito fornisce un LifecycleOwner basato sulla navigazione, ViewModelStoreOwner (lo stesso restituito da NavController.getViewModelStoreOwner()) e SavedStateRegistryOwner, oltre a fornire gli argomenti utilizzati per avviare la destinazione. (aosp/1101691, aosp/1101710)

Correzioni di bug

  • Risolto un problema per cui l'aggiunta di un NavHostFragment a ViewPager2 non riusciva con un IllegalArgumentException. (b/133640271)
  • NavInflater ora evita di chiamare getResourceName() inutilmente, velocizzando il tempo di espansione fino al 40%. (b/139213740)

Versione 2.2.0-alpha01

7 agosto 2019

androidx.navigation:navigation-*:2.2.0-alpha01 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

  • SavedStateViewModelFactory è ora la factory predefinita utilizzata quando si usa by navGraphViewModels() o il costruttore ViewModelProvider con un ViewModelStoreOwner restituito da NavController.getViewModelStoreOwner(). (b/135716331)

Modifiche alle API

Correzioni di bug

  • NavHostFragment ora utilizza FragmentContainerView, risolvendo i problemi di ordinamento z dell'animazione e l'invio degli inset della finestra ai frammenti. (b/137310379)

Versione 2.1.0

Versione 2.1.0

5 settembre 2019

androidx.navigation:navigation-*:2.1.0 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Modifiche importanti dalla versione 2.0.0

  • Definizione dell'ambito dei ViewModel in un grafico di navigazione: ora puoi creare ViewModel con ambito a livello di grafico di navigazione utilizzando il delegato della proprietà by navGraphViewModels() per gli utenti Kotlin che utilizzano le librerie -ktx o l'API getViewModelStoreOwner() aggiunta a NavController. Per saperne di più, consulta Condividi i dati relativi alla UI tra le destinazioni.
  • Destinazioni di finestre di dialogo: ora puoi creare destinazioni <dialog> che mostreranno un DialogFragment quando navigate. NavHostFragment supporta le destinazioni di dialogo per impostazione predefinita. Per saperne di più, consulta Crea una destinazione da un DialogFragment.
  • Navigazione tramite URI: ora puoi navigate utilizzando un Uri, che utilizza l'<deepLink> che hai aggiunto a una destinazione per raggiungerla. Per saperne di più, consulta Naviga utilizzando Uri.
  • NavHostController: le API utilizzate specificamente per la creazione di un NavHost personalizzato sono state spostate in NavHostController, consentendo alle implementazioni di connettere il proprio NavController all'hosting LifecycleOwner, OnBackPressedDispatcher e ViewModelStore.

Versione 2.1.0-rc01

7 agosto 2019

androidx.navigation:navigation-*:2.1.0-rc01 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Modifiche alle API

  • L'API getViewModelStore() deprecata su NavController introdotta in 2.1.0-alpha02 è stata rimossa. (aosp/1091021)

Versione 2.1.0-beta02

19 luglio 2019

androidx.navigation:*:2.1.0-beta02 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Correzioni di bug

  • Rimossa la dipendenza jacoco involontaria introdotta in 2.1.0-beta01. (b/137782950)

Versione 2.1.0-beta01

17 luglio 2019

androidx.navigation:*:2.1.0-beta01 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

  • NavigationUI ora anima la rimozione del pulsante Su quando utilizzi setupWithNavController() con un Toolbar o un CollapsingToolbarLayout. (b/131403621)

Correzioni di bug

  • Risolto un problema di tempistica durante l'utilizzo di più NavHostFragment con lo stesso container con findNavController(). (b/136021571)

Versione 2.1.0-alpha06

2 luglio 2019

androidx.navigation:*:2.1.0-alpha06 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

  • L'attributo app:navGraph utilizzato da NavHostFragment è stato spostato nell'artefatto navigation-runtime. I navigatori personalizzati che possono essere aggiunti tramite XML devono utilizzare questo attributo per ottenere l'integrazione con il riquadro Host dell'editor di navigazione. (b/133880955)

Modifiche alle API

  • L'API getViewModelStore() su NavController è stata ritirata a favore del nuovo metodo getViewModelStoreOwner() che restituisce un ViewModelStoreOwner. (aosp/987010)
  • L'implementazione delle destinazioni delle finestre mobili, come le destinazioni <dialog>, è stata generalizzata in un'interfaccia di indicatore, FloatingWindow, che ora viene implementata da tutte le destinazioni <dialog>. I metodi NavigationUI per l'interazione con la barra delle app in alto ora ignorano le destinazioni FloatingWindow. (b/133600763)

Modifiche del comportamento

  • La navigazione ora mantiene correttamente lo stato sincronizzato con ciò che viene visualizzato sullo schermo quando si utilizza una destinazione <dialog>. Di conseguenza, Navigation ora mostra automaticamente le destinazioni <dialog> quando accedi a una destinazione non di dialogo e non di attività, ad esempio una destinazione <fragment>. (b/134089818)

Correzioni di bug

  • La navigazione ora sopprime l'animazione che si verifica quando si ricrea l'attività durante la gestione di un deep link, correggendo un flash visivo. (b/130362979)
  • È stato corretto un bug per cui il back stack di navigazione non era sincronizzato quando veniva rimosso un frammento durante l'aggiunta del frammento iniziale. (b/133832218)

Versione 2.1.0-alpha05

5 giugno 2019

androidx.navigation:*:2.1.0-alpha05 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Modifiche alle API

  • Le API relative all'host su NavController sono state rinominate e spostate in una nuova sottoclasse di NavController, NavHostController. (aosp/966091)
  • Il metodo setHostOnBackPressedDispatcherOwner() di NavController è stato sostituito con il metodo setOnBackPressedDispatcher() di NavHostController e ora richiede di chiamare setLifecycleOwner() prima di chiamarlo. (aosp/965409)
  • NavHostController ora contiene un metodo enableOnBackPressed(boolean) che sostituisce la classe NavHostOnBackPressedManager restituita in precedenza da setHostOnBackPressedDispatcherOwner(). (aosp/966091)

Correzioni di bug

  • Risolto un problema per cui il back stack non era corretto dopo la navigazione tramite URI. (b/132509387)
  • I deep link gestiti automaticamente da NavController ora vengono attivati una sola volta. (b/132754763)

Versione 2.1.0-alpha04

16 maggio 2019

androidx.navigation:*:2.1.0-alpha04 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Correzioni di bug

  • NavHostFragment rispetta correttamente app:defaultNavHost quando intercetta gli eventi del pulsante Indietro del sistema, correggendo una regressione in Navigation 2.1.0-alpha03. b/132077777
  • DialogFragmentNavigator ora gestisce correttamente le operazioni popBackStack() e navigateUp(). b/132576764
  • Risolto un problema di IllegalStateException: unknown destination during restore durante la navigazione ripetuta tra grafi nidificati. b/131733658

Versione 2.1.0-alpha03

7 maggio 2019

androidx.navigation:*:2.1.0-alpha03 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Problemi noti

  • NavHostFragment continua a intercettare il pulsante Indietro del sistema nonostante l'utilizzo di app:defaultNavHost="false" b/132077777

Nuove funzionalità

  • Ora puoi creare destinazioni <dialog> che mostreranno un DialogFragment quando navigate. NavHostFragment supporta le destinazioni delle finestre di dialogo per impostazione predefinita. b/80267254
  • Oltre a chiamare navigate con un ID risorsa o un'istanza NavDirections, ora puoi navigare tramite un Uri, che utilizza l'<deepLink> che hai aggiunto a una destinazione per navigare verso la destinazione corretta. b/110412864

Modifiche del comportamento

  • Le animazioni predefinite fornite da NavigationUI sono state velocizzate da 400 ms a 220 ms per corrispondere alla velocità di animazione predefinita di attività e frammenti. b/130055522

Modifiche alle API

  • Il metodo createFragmentNavigator() di NavHostFragment è stato ritirato e la sua funzionalità è stata spostata nel nuovo metodo onCreateNavController() per chiarire che questo è l'entry point corretto per l'aggiunta di navigatori personalizzati durante la sottoclasse di NavHostFragment. b/122802849
  • È stato aggiunto un metodo hasDeepLink() a NavDestination per consentirti di verificare se un determinato Uri può essere gestito da quella destinazione o, nel caso di un NavGraph, da qualsiasi destinazione nel grafico di navigazione. b/117437718

Correzioni di bug

  • Gli argomenti predefiniti ora vengono passati correttamente alle istanze OnDestinationChangedListener. b/130630686
  • NavHostFragment ora intercetta gli eventi Indietro di sistema utilizzando OnBackPressedDispatcher, risolvendo un problema durante la navigazione condizionale nei metodi del ciclo di vita dei frammenti al ritorno a un frammento. b/111598096
  • Per Safe Args, un android:defaultValue=”@null” con un app:argType non specificato viene ora dedotto correttamente come argomento string. b/129629192

Versione 2.1.0-alpha02

3 aprile 2019

androidx.navigation:*:2.1.0-alpha02 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

  • Ora puoi creare ViewModel con ambito a livello di grafico di navigazione tramite il delegato della proprietà by navGraphViewModels() per gli utenti Kotlin o utilizzando l'API getViewModelStore() aggiunta a NavController. b/111614463

Modifiche alle API

  • Ora puoi aggiungere un app:targetPackage a una destinazione <activity> per limitare il nome del pacchetto corrispondente. Supporta app:targetPackage="${applicationId}" per limitare il pacchetto al tuo ID applicazione. b/110975456

Correzioni di bug

  • L'attributo android:name per le destinazioni <activity> non viene più analizzato in una classe al momento dell'inflation, impedendo ClassNotFoundExceptions quando si utilizzano le funzionalità dinamiche. b/124538597

Versione 2.1.0-alpha01

19 marzo 2019

Questa è la prima release alpha di Navigation 2.1.0.

Modifiche alle dipendenze

  • La navigazione ora dipende da androidx.core:core:1.0.1 e androidx.fragment:fragment:1.1.0-alpha05. Questa release rimuove anche la dipendenza da androidx.legacy:legacy-support-core-utils:1.0.0. b/128632612

Modifiche alle API

  • È stato aggiunto un nuovo metodo Navigation.createNavigateOnClickListener(NavDirections) come alternativa alla creazione di un click listener con un ID risorsa e un bundle. b/127631752
  • FragmentNavigator.instantiateFragment è ora deprecato. L'implementazione predefinita ora utilizza FragmentFactory per creare un'istanza di Fragment. b/119054429

Correzioni di bug

  • La navigazione non invia più un Bundle null quando sono presenti argomenti associati a una destinazione, risolvendo un problema durante l'utilizzo di android:defaultValue="@null". b/128531879
  • Safe Args ora dipende da KotlinPoet 1.1.0, risolvendo un problema con nomi di pacchetti estremamente lunghi. b/123654948

Versione 2.0.0

Versione 2.0.0

14 marzo 2019

La navigazione 2.0.0 viene rilasciata senza modifiche rispetto alla versione 2.0.0-rc02.

Versione 2.0.0-rc02

6 marzo 2019

Navigation 2.0.0-rc02 fornisce nuovi artefatti con l'ID gruppo androidx.navigation e modifica le relative dipendenze con gli equivalenti AndroidX.

Il comportamento di 2.0.0-rc02 è identico a quello di Navigation 1.0.0-rc02 e non dovrebbero essere necessarie modifiche al codice per eseguire l'aggiornamento da 1.0.0-rc02, oltre all'aggiornamento delle dipendenze in modo che corrispondano alle nuove dipendenze.

Per utilizzare le release 2.X di Navigation, è necessario eseguire la migrazione del progetto ad AndroidX. La versione stabile di Navigation 1.0 sarà l'ultima release che utilizza le dipendenze della libreria di supporto; tutto lo sviluppo futuro oltre la versione 1.0 si baserà su AndroidX e sulla release stabile 2.0.

Dipendenze pre-AndroidX

Per le versioni di Navigation precedenti ad AndroidX, includi queste dipendenze:

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
}

Per Safe Args, aggiungi il seguente classpath nel file build.gradle di primo livello

buildscript {
    repositories {
        google()
    }
    dependencies {
        classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
    }
}

Versione 1.0.0

Versione 1.0.0

14 marzo 2019

La navigazione 1.0.0 viene rilasciata senza modifiche rispetto alla versione 1.0.0-rc02.

Versione 1.0.0-rc02

26 febbraio 2019

Questo è il secondo candidato per la release stabile 1.0.0 di Navigation. Questa release contiene una serie di correzioni di bug.

Correzioni di bug

  • Risolto un problema per cui popBackStack() veniva ignorato se il grafico principale non aveva un ID b/126251695
  • navigateUp() ora gestisce correttamente la navigazione per tornare all'attività della tua app quando viene chiamata dopo aver gestito un deep link senza FLAG_ACTIVITY_NEW_TASK b/126082008
  • Risolto un problema per cui ActivityNavigator.applyPopAnimationsToPendingTransition non applicava l'animazione di uscita corretta b/126237567
  • Il codice Kotlin generato da Safe Args ora esegue correttamente l'escape delle parole chiave Kotlin come in e fun nel nome del pacchetto associato alla classe R. b/126020455

Versione 1.0.0-rc01

21 febbraio 2019

Questo è un candidato per la release stabile 1.0.0 di Navigation. Questa release contiene una correzione di bug.

Correzioni di bug

  • È stato risolto un problema relativo all'utilizzo di frammenti e operazioni di navigazione singleTop b/124294805

Versione 1.0.0-beta02

12 febbraio 2019

Questa release include una serie di miglioramenti minori e importanti correzioni di bug.

Nuove funzionalità

  • Ora puoi utilizzare 0 come android:defaultValue per gli argomenti reference. b/124248602

Modifiche del comportamento

  • Le corrispondenze esatte dei deep link ora hanno la priorità rispetto ai deep link con corrispondenze di argomenti o .*. b/123969518

Correzioni di bug

  • popBackStack() e navigateUp ora restituiscono correttamente false quando viene estratta l'ultima destinazione nel back stack, correggendo una regressione introdotta in 1.0.0-beta01. b/123933201
  • La navigazione ora imposta correttamente ClassLoader durante il ripristino dello stato dell'istanza salvata, evitando problemi quando si utilizzano classi personalizzate nello stato salvato di Navigator o negli argomenti inviati a un NavDestination. b/123893858
  • Le classi NavArgs generate da Safe Args non si arrestano più in modo anomalo durante il ripristino di un argomento Parcelable[] dallo stato dell'istanza salvato. b/123963545
  • Safe Args ora pulisce correttamente le classi Kotlin generate non necessarie. b/124120883

Versione 1.0.0-beta01

4 febbraio 2019

Questa è la prima versione beta di Navigation. In futuro, l'API Navigation dovrebbe rimanere stabile fino alla versione successiva, a meno che non si verifichi un problema critico. Questa release contiene alcune correzioni di bug e modifiche del comportamento.

Modifiche del comportamento

  • Navigation ora garantisce che i valori predefiniti degli argomenti vengano trattati in modo identico durante il runtime e tramite Safe Args. Di conseguenza, solo gli argomenti con un app:argType="reference" possono avere un valore predefinito che rimanda a un'altra risorsa (ad esempio, @color/colorPrimary). Il tentativo di utilizzare un valore predefinito di riferimento con un app:argType diverso comporterà un'eccezione durante l'analisi dell'XML di navigazione. b/123551990
  • Safe Args ora dipende dal plug-in Android per Gradle 3.3.0 aosp/888413
  • Safe Args ora dipende da Kotlin 1.3.20 aosp/888414

Correzioni di bug

  • Safe Args ora può essere utilizzato nei moduli della libreria e delle funzionalità su tutte le versioni del plug-in Android per Gradle. b/121304903
  • Risolto un problema di regressione che causava la rimozione di tutte le copie di una destinazione dalla parte superiore del back stack con una singola operazione popBackStack(), anziché una sola destinazione alla volta. b/123552990
  • È stato risolto un problema per cui lo stato di FragmentNavigator si desincronizzava con lo stato di NavController, causando un IllegalStateException durante il tentativo di ripristinare il back stack. b/123803044
  • È stato risolto un problema per cui la freccia Indietro gestita da NavigationUI non veniva visualizzata quando si utilizzava ProGuard con l'offuscamento. b/123449431
  • Il codice generato da Safe Args ora gestisce correttamente l'utilizzo di un app:argType che punta a una classe interna statica nel formato .OuterClass$InnerClass. b/123736741
  • Il codice Java generato da Safe Args ora gestisce correttamente le azioni globali e le destinazioni con nidificazione profonda. b/123347762

Versione 1.0.0-alpha11

23 gennaio 2019

Questa è una versione hotfix di 1.0.0-alpha10 che risolve un problema con Safe Args.

Correzioni di bug

  • Risolve un problema per cui Safe Args non riusciva a importare la classe Directions associata alle azioni globali. b/123307342

Versione 1.0.0-alpha10

23 gennaio 2019

Problemi noti

  • Safe Args non riesce a importare la classe Directions associata alle azioni globali. b/123307342

Questa release contiene modifiche che provocano errori nell'API. Consulta la sezione Modifiche che provocano errori di seguito.

Nuove funzionalità

  • Gli utenti di Kotlin ora possono utilizzare il delegato della proprietà by navArgs() per ottenere in modo lazy un riferimento a una classe NavArgs generata da Safe Args in un Activity o Fragment. b/122603367
  • Safe Args ora ti consente di generare codice Kotlin applicando il plug-in androidx.navigation.safeargs.kotlin. Il codice Kotlin è creato appositamente per i moduli solo Kotlin, utilizzando argomenti predefiniti e classi immutabili rispetto al pattern del builder, che è ancora disponibile tramite il plug-in androidx.navigation.safeargs precedente. b/110263087

Modifiche del comportamento

  • I deep link corrispondenti ora sono orientati verso il deep link con il maggior numero di argomenti corrispondenti. b/118393029
  • La chiamata di setGraph() su un NavController ora reimposta il back stack. b/111450672
  • I deep link sconosciuti non generano più un IllegalStateException, ma vengono ignorati, risolvendo i problemi relativi a NavHostFragment nidificati o multipli. b/121340440

Modifiche che provocano un errore

  • Il metodo NavOptions.applyPopAnimationsToPendingTransition() per applicare animazioni pop a un'attività è stato spostato in ActivityNavigator. b/122413117
  • Safe Args ora evita di duplicare classi identiche per le azioni senza argomenti. Il tipo restituito per i metodi senza argomenti nelle classi NavDirections generate è ora NavDirections. b/123233147
  • Le classi Directions generate da Safe Args non hanno più un costruttore pubblico: devi interagire solo con i metodi statici generati. b/123031660
  • Le classi NavDirections generate da Safe Args non hanno più un costruttore pubblico: devono essere generate solo tramite i metodi statici nelle classi Directions generate. b/122963206
  • Il valore Bundle restituito da getArguments() di NavDirections è ora contrassegnato come @NonNull anziché @Nullable. b/123243957

Correzioni di bug

  • NavDeepLinkBuilder ora gestisce correttamente più PendingIntent simultanei alla stessa destinazione utilizzando gli argomenti che passi per determinare l'unicità. b/120042732
  • NavController ora gestisce correttamente le operazioni popBackStack() quando utilizza un NavHostFragment nidificato o altri frammenti secondari con un back stack. b/122770335
  • NavigationUI ora imposta correttamente la descrizione dei contenuti del pulsante Su. b/120395362
  • Le classi Directions generate da Safe Args ora gestiscono correttamente le azioni globali che hanno lo stesso ID di un'azione su una destinazione. b/122962504
  • Le classi NavDirections generate da Safe Args ora hanno correttamente valori hashCode() uguali quando equals() restituisce true. b/123043662
  • FragmentNavigator ora genera un messaggio di errore migliore se tenti di eseguire FragmentTransactions personalizzato su FragmentManager di NavHostFragment. Devi sempre utilizzare getChildFragmentManager(). b/112927148

Versione 1.0.0-alpha09

18 dicembre 2018

Questa release contiene modifiche che provocano errori nell'API. Consulta la sezione Modifiche che provocano errori di seguito.

Abbiamo scelto di non continuare lo sviluppo dell'artefatto android.arch.navigation:navigation-testing. Sebbene si sia dimostrato utile per i test interni di NavController, consigliamo vivamente strategie di test alternative, come il mocking dell'istanza NavController per verificare che vengano eseguite le chiamate navigate() corrette. Questo approccio è discusso in dettaglio nel talk Single Activity all'AndroidDevSummit 2018 e lavoreremo su ulteriore documentazione specifica sui test con Navigation.

Nuove funzionalità

  • I MenuItem con menuCategory="secondary" non mostreranno più il back stack quando vengono utilizzati con i metodi NavigationUI. b/120104424
  • AppBarConfiguration ora ti consente di impostare un'istanza OnNavigateUpListener di riserva che verrà chiamata quando navController.navigateUp() restituisce false. b/79993862 b/120690961

Modifiche che provocano un errore

  • Quando utilizzi un <argument> con un argType="reference", Navigation non analizza più il riferimento, ma fornisce l'ID risorsa non elaborata stesso. b/111736515
  • onNavDestinationSelected() ora torna alla destinazione iniziale del grafico di navigazione per impostazione predefinita, rendendola coerente con i metodi setup. Aggiungi menuCategory="secondary" al tuo MenuItem per evitare di eseguire il pop del back stack. aosp/852869
  • I metodi fromBundle() delle classi Args generate ora accettano un Bundle non null anziché un Bundle nullable aosp/845616

Correzioni di bug

  • Gli argomenti vengono ora analizzati correttamente dai deep link come argType corretti anziché sempre come stringhe b/110273284
  • La navigazione ora esporta correttamente le risorse pubbliche b/121059552
  • Safe Args è ora compatibile con il plug-in Android per Gradle 3.4 Canary 4 e versioni successive b/119662045

Versione 1.0.0-alpha08

6 dicembre 2018

Questa release contiene modifiche che provocano errori nell'API. Consulta la sezione Modifiche che provocano errori di seguito.

Nuove funzionalità

  • Le etichette di destinazione, se utilizzate con i metodi NavigationUI, ora sostituiranno automaticamente le istanze {argName} nel tuo android:label con l'argomento corretto b/80267266
  • La navigazione ora dipende dalla Support Library 28.0.0 b/120293333

Modifiche che provocano un errore

  • OnNavigatedListener è stato rinominato in OnDestinationChangedListener b/118670572
  • OnDestinationChangedListener ora passa anche il Bundle di argomenti aosp/837142
  • Gli attributi app:clearTask e app:launchDocument e i relativi metodi associati sono stati rimossi. Utilizza app:popUpTo con la radice del grafico per rimuovere tutte le destinazioni dal back stack. b/119628354
  • ActivityNavigator.Extras ora utilizza un pattern Builder e aggiunge la possibilità di impostare qualsiasi flag Intent.FLAG_ACTIVITY_ aosp/828140
  • NavController.onHandleDeepLink è stato rinominato in handleDeepLink aosp/836063
  • Molte classi e metodi non destinati alla sottoclasse, come NavOptions, NavInflater, NavDeepLinkBuilder e AppBarConfiguration, sono stati resi final aosp/835681
  • Il metodo NavHostFragment.setGraph() deprecato è stato rimosso aosp/835684
  • Il metodo NavigationUI.navigateUp(DrawerLayout, NavController) deprecato è stato rimosso. aosp/835684
  • La creazione dei frammenti è stata spostata in FragmentNavigator, semplificando la delega della creazione dei frammenti a un FragmentFactory. b/119054429
  • Il costruttore per NavGraphNavigator non accetta più un Context aosp/835340
  • NavigatorProvider ora è una classe, non un'interfaccia. La funzionalità di NavigatorProvider restituita da getNavigatorProvider() non è cambiata. aosp/830660
  • La risorsa NavDestination.navigate() è stata rimossa. Chiama invece navigate() su Navigator. aosp/830663
  • Rifattorizzazione significativa di Navigator, che elimina la necessità di OnNavigatorNavigatedListener e fa sì che navigate restituisca l'elemento NavDestination a cui è stata eseguita la navigazione.
  • Le istanze Navigator non possono più inviare eventi pop a NavController. Valuta la possibilità di utilizzare un OnBackPressedCallback per intercettare le pressioni del pulsante Indietro e chiamare navController.popBackStack(). aosp/833716

Correzioni di bug

  • popUpTo ora funziona in modo coerente quando la destinazione è un elemento <navigation> b/116831650
  • È stato corretto un numero di bug che generavano un IllegalArgumentException quando si utilizzavano grafici nidificati b/118713731 b/113611083 b/113346925 b/113305559
  • L'attributo dataPattern delle destinazioni <activity> ora compila gli argomenti da argomenti non di tipo String chiamando toString() b/120161365

Safe Args

  • Safe Args supporta gli oggetti Serializable, inclusi i valori Enum. I tipi di enum possono impostare un valore predefinito utilizzando il valore letterale enum senza il nome della classe (ad es. app:defaultValue="READ") b/111316353
  • Safe Args supporta array di tutti i tipi supportati b/111487504
  • Safe Args ora ignora le sottocartelle delle directory delle risorse b/117893516
  • Safe Args aggiunge annotazioni @Override dove appropriato b/117145301

Versione 1.0.0-alpha07

29 ottobre 2018

Nuove funzionalità

Modifiche che provocano un errore

  • Il modulo navigation-testing-ktx è stato integrato in navigation-testing artifact e non verrà più pubblicato.
  • L'artefatto navigation-testing ora ha una dipendenza dalla libreria standard di Kotlin. L'API è stata modificata per essere più coerente con le convenzioni di Kotlin, ma puoi continuare a utilizzarla per i test scritti in Java.
  • I grafici di navigazione registrati nel manifest dei metadati non sono più supportati. b/118355937
  • Le azioni non possono più essere collegate alle destinazioni <activity>. aosp/785539

Correzioni di bug

  • I deep link ora analizzano correttamente i parametri di query. b/110057514
  • Le destinazioni delle attività ora applicano correttamente tutte le animazioni di entrata e uscita. b/117145284
  • È stato corretto l'arresto anomalo che si verifica dopo le modifiche alla configurazione quando si utilizzano navigatori personalizzati. b/110763345

Safe Args

  • Safe Args ora ha una dipendenza fissa dal plug-in Android per Gradle 3.2.1. b/113167627
  • Ora è possibile generare indicazioni per le classi interne. b/117407555
  • Risolto un problema relativo alla generazione di indicazioni stradali per un grafico <include>. b/116542123

Versione 1.0.0-alpha06

20 settembre 2018

Nuove funzionalità

Modifiche alle API

  • Modifica che provoca un errore: il metodo Navigator navigate() ora accetta un parametro Navigator.Extras.
  • Il metodo getGraph() di NavController ora è NonNull b/112243286

Correzioni di bug

  • NavigationUI.setupWithNavController() non perde più visualizzazioni se utilizzato con visualizzazioni di singole destinazioni b/111961977
  • Navigator onSaveState() is now only called once b/112627079

Safe Args

  • Le classi Directions della destinazione di navigazione ora estendono la classe Directions principale, se esistente b/79871405
  • Le classi Directions e Args ora hanno un'implementazione toString() utile b/111843389

Versione 1.0.0-alpha05

10 agosto 2018

Correzioni di bug

  • Risolto un bug che causava un comportamento errato del backstack. b/111907708
  • Correzione di un bug in equals() delle classi Args generate. b/111450897
  • È stato corretto un errore di build in Safe Args. b/109409713
  • Correzione di una conversione da identificatori di risorse a nomi Java b/111602491
  • Risolti i messaggi di errore relativi alla nullabilità nel plug-in Safe Args.
  • Aggiungi le annotazioni di nullabilità mancanti.

Versione 1.0.0-alpha04

19 luglio 2018

Navigation 1.0.0-alpha04 e il plug-in Gradle Safe Args associato contengono una serie di modifiche alle API, modifiche al comportamento e correzioni di bug.

Modifiche alle API/al comportamento

  • NavHostFragment imposterà sempre il Fragment corrente come frammento di navigazione principale, assicurando che i gestori dei frammenti secondari vengano estratti prima del NavController esterno b/111345778

Safe Args

  • Modifica che provoca un errore: app:type è stato modificato in app:argType per evitare conflitti con altre librerie come ConstraintLayout 2.0.0-alpha1 b/111110548
  • I messaggi di errore di Safe Args sono ora cliccabili b/111534438
  • Le classi Args ora confermano che gli attributi NonNull non sono effettivamente nulli b/111451769
  • Sono state aggiunte ulteriori annotazioni NonNull alle classi generate NavDirections e Args b/111455455 b/111455456

Correzioni di bug

  • Risolto un problema relativo al pulsante Indietro del sistema dopo il deep linking a una destinazione di frammento b/111515685

Versione 1.0.0-alpha03

12 luglio 2018

Navigation 1.0.0-alpha03 e il plug-in Gradle Safe Args associato contengono una serie di modifiche alle API, modifiche al comportamento e correzioni di bug.

Modifiche alle API/al comportamento

  • È stato aggiunto un metodo NavigationUI.setupWithNavController per la barra degli strumenti b/109868820
  • È stato aggiunto un metodo NavigationUI.setupWithNavController per CollapsingToolbarLayout b/110887183
  • popBackStack() ora restituisce false quando il back stack è vuoto o quando l'ID della destinazione specificato non è presente nel back stack b/110893637
  • FragmentNavigator ora ignora le operazioni di navigazione dopo che FragmentManager ha salvato lo stato, evitando le eccezioni "Impossibile eseguire questa azione dopo onSaveInstanceState" b/110987825

Safe Args

  • Modifica che provoca un errore: i caratteri non alfanumerici nei nomi di azioni e argomenti verranno sostituiti dalla notazione a cammello nei rispettivi nomi dei metodi NavDirections
    • Ad esempio, DemoController.index diventerà setDemoControllerIndex b/79995048
    • Ad esempio, action_show_settings diventerà actionShowSettings b/79642240
  • Modifica che provoca un errore: gli argomenti sono ora considerati non nulli per impostazione predefinita. Per consentire valori null per gli argomenti stringa e parcelable, aggiungi app:nullable="true" b/79642307
  • Ora puoi utilizzare app:type="long" con defaultValues nel formato "123L" b/79563966
  • Gli argomenti Parcelable sono ora supportati utilizzando un nome di classe completo per app:type. L'unico valore predefinito supportato è "@null" b/79563966
  • Le classi Args ora implementano equals() e hashCode() b/79642246
  • Il plug-in Safe Args ora può essere applicato ai progetti di libreria b/80036553
  • Il plug-in Safe Args ora può essere applicato ai progetti di funzionalità b/110011752

Correzioni di bug

  • Risolti i problemi di navigazione durante i metodi del ciclo di vita di Fragment b/109916080
  • Risolti i problemi durante la navigazione ripetuta nei grafi nidificati b/110178671
  • Risolti i problemi relativi all'utilizzo di setPopUpTo con la prima destinazione nel grafico b/109909461
  • Risolto il problema per cui tutti i valori app:defaultValue venivano passati come stringhe b/110710788
  • aapt2 in bundle con il plug-in Android per Gradle 3.2 Beta 01 ora aggiunge regole di conservazione per ogni attributo android:name nei file XML di navigazione b/79874119
  • Risolto un problema di perdita di memoria durante la sostituzione del FragmentNavigator predefinito b/110900142

Versione 1.0.0-alpha02

7 giugno 2018

Modifiche del comportamento

  • FragmentNavigator ora utilizza setReorderingAllowed(true). b/109826220

  • La navigazione ora esegue la decodifica URL degli argomenti analizzati dagli URL dei deep link. b/79982454

Correzioni di bug

  • È stata corretta un'IllegalStateException durante la chiamata di navigazione dai metodi del ciclo di vita di Fragment. b/79632233

  • La navigazione ora dipende dalla Support Library 27.1.1 per correggere lo sfarfallio durante l'utilizzo delle animazioni. b/80160903

  • Risolto un problema di IllegalArgumentException quando si utilizza defaultNavHost="true" come frammento secondario. b/79656847

  • È stato corretto un StackOverflowError quando si utilizza NavDeepLinkBuilder. b/109653065

  • È stato corretto un IllegalArgumentException durante la navigazione verso un grafico nidificato. b/80453447

  • È stato risolto un problema relativo alla sovrapposizione dei frammenti quando si utilizza launchSingleTop. b/79407969

  • Navigation ora crea il back stack sintetico corretto per i grafici nidificati. b/79734195

  • NavigationUI ora evidenzia l'elemento corretto quando utilizza un grafico nidificato come MenuItem. b/109675998

Modifiche alle API

  • L'attributo clearTask per le azioni e l'API associata in NavOptions sono stati ritirati. b/80338878

  • L'attributo launchDocument per le azioni e l'API associata in NavOptions sono stati ritirati. b/109806636

Versione 1.0.0-alpha01

8 maggio 2018

Navigation fornisce un framework per la creazione della navigazione in-app. Questa release iniziale è 1.0.0-alpha01.