Navigazione
androidx.navigation
androidx.navigation.compose
androidx.navigation.dynamicfeatures
androidx.navigation.dynamicfeatures.fragment
androidx.navigation.dynamicfeatures.fragment.ui
androidx.navigation.fragment
androidx.navigation.fragment.compose
androidx.navigation.testing
androidx.navigation.ui
| 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.
Per saperne di più, consulta la documentazione di Issue Tracker.
Versione di navigazione 2.10
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.lifecyclealla 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
NavHostsalta le animazioni, ora considererà anchesizeTransformcome 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:
NavHostora fornisce un overload che accetta i parametripredictivePopEnterTransitionepredictivePopExitTransitionper 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 metodosetPackageper un pacchetto attendibile.- È stato aggiunto
NavBackStackEntryInfoper 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-runtimeenavigation-testinghanno aggiunto il supporto perdesktop,linux,macOS,iOS,javascript,WASM,watchosetvos.
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
NavBackStackEntryInfoper 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
handleDeepLinkper 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
FragmentNavigatorche causava la generazione di un'eccezioneIllegalArgumentExceptionda 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
NavHostmigliorato per rafforzare la protezione contro possibiliNullPointerExceptioncausati 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
compileSdkall'API 37. Ciò significa che, se utilizzi Compose, è richiesta una versione minima di AGP 9.2.0. (Id45cd, b/413674743)
Contributo esterno
watchosetvostarget aggiunti ai modulinavigation-common,navigation-runtimeenavigation-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à
NavHostora fornisce un overload che accetta i parametripredictivePopEnterTransitionepredictivePopExitTransitionper consentire la transizione personalizzata durante il gesto Indietro predittivo. (Iac9b0, b/478294569)
Aggiornamento dell'SDK minimo
- Il valore predefinito di minSdk è stato modificato dall'API 21 all'API 23, insieme al resto delle librerie AndroidX. (Ibdfca, b/380448311, b/435705964, b/435705223)
Contributo esterno
navigation:navigation-common,navigation:navigation-runtimeenavigation:navigation-testingora 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
NavHostmigliorato per rafforzare la protezione contro possibiliNullPointerExceptioncausati 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
SafeArgsnon 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
SavedStateHandlein navigation-testing non decodificavaList<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
SafeArgsalle 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
SafeArgsnon richiederà più l'impostazione della proprietàuseAndroidXse 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
NavControllerche causava unConcurrentModificationExceptionquando si utilizzavaOnDestinationChangedListeners. (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
MissingFieldExceptiondurante il test diSavedStateHandlecon route con sicurezza dei tipi durante l'utilizzo diNavTypespersonalizzati. (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
NavEntriesdi cui era stata creata un'istanza utilizzando single top non andavano mai oltre CREATED nel loroLifecycle.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
@CheckResultper garantire che vengano utilizzate.
Interfaccia SupportingPane
- I navigatori personalizzati ora possono contrassegnare le loro destinazioni come implementazioni dell'interfaccia
SupportingPane, il che indica aNavControllerche queste destinazioni verranno mostrate insieme ad altre. Ad esempio, utilizzando questa interfaccia, è possibileRESUMEDpiù destinazioni contemporaneamente.
Compose Kotlin Multiplatform
- La navigazione ora offre una nuova funzione
NavController.handleDeepLink()comune che accetta unNavDeepLinkRequestanziché unIntent. 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, ovverocomposable<YourScreen>ora ha versioni non reificate che accettano direttamente un'istanzaKClass. - 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 factoryNavUriche 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-testingora 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
saveStatecon 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
@CheckResultper garantire che vengano utilizzate. (I14d4c, b/356323084)
Correzioni di bug
- È stato corretto un errore in
NavControllerper 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 etichetteNavDestinationfornite tramite XML verranno analizzate tramiteNavType.getper garantire il rispetto della logicaNavTypepersonalizzata. (I7ec2f, b/388100796) - Da Navigation
2.8.6: quando si passa all'attività condataPattern,ActivityNavigatorora tenta di codificare il valore dell'argomento con il relativoNavType. (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à
- Le API type-safe, che in precedenza erano accessibili solo tramite i metodi
reified, ovverocomposable<YourScreen>ora hanno versioni non reificate che accettano direttamente un'istanzaKClass.(Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808)
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.setStartDestinationspecifico 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 cuiNavHostpoteva generare un'eccezione all'interno diPredictiveBackHandlerse 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 correttoNavDestinationNullPointerExceptiondurante l'aggiornamento distartDestinationdi un grafico. (I99421, b/361560785)
Contributo esterno
- Da Navigation
2.8.5: la sicurezza dei tipi di navigazione ora supportaList<Enum>come tipo di argomento di un percorso senza richiedereNavTypepersonalizzati. Grazie Csaba Kozák. (GH-725, b/375559962)
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
ConcurrentModificationExceptionche poteva verificarsi quando unLifecycleObservercollegato a unNavBackStackEntryattivava una modifica al back stack quando l'LifecycleOwnerhost, 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 aNavControllerche queste destinazioni verranno mostrate insieme ad altre. Ad esempio, utilizzando questa interfaccia, è possibileRESUMEDpiù destinazioni contemporaneamente. (Id5559) - Da Navigation
2.8.3: sono stati aggiunti nuovi controlli lint per i modulinavigation-common,navigation-runtimeenavigation-composeper identificare i percorsi con sicurezza dei tipi che non sono annotati correttamente con@Serializable. Questo controllo viene applicato a tutte le funzioni di estensioneNavGraphBuildereNavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Da Navigation
2.8.3: sono stati aggiunti nuovi controlli lint per i modulinavigation-common,navigation-runtimeenavigation-composeper identificare eventuali route con sicurezza dei tipi con argomenti Enum non annotati correttamente con@Keep. Questo controllo viene applicato a tutte le funzioni di estensioneNavGraphBuildereNavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
Modifiche del comportamento
- Il tentativo di utilizzare un
NavControllerche è stato precedentementeDESTROYEDora causerà unIllegalStateException. (I520da, b/369616172)
Correzioni di bug
- Aggiorna l'eccezione di classe Enum non trovata per suggerire l'utilizzo dell'annotazione
@Keepnel 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 erroreObsolete custom lint checkquando 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
NavDestinationfornite tramite XML verranno analizzate tramiteNavType.getper garantire il rispetto della logicaNavTypepersonalizzata. (Id366d, b/388100796) - Quando si passa all'attività con
dataPattern,ActivityNavigatorora tenterà di codificare il valore dell'argomento con ilNavTypedell'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
NavHostpoteva generare un'eccezione all'interno diPredictiveBackHandlerse 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
NavDestinationNullPointerExceptiondurante l'aggiornamento distartDestinationdi 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
ConcurrentModificationExceptionche poteva verificarsi quando unLifecycleObservercollegato a unNavBackStackEntryattivava una modifica al back stack quando l'LifecycleOwnerhost, 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 richiedereNavTypepersonalizzati. 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à
- Da Navigation
2.9.0-alpha03: la sicurezza dei tipi di navigazione ora supporta la classe di valore come route o come tipo di argomento di una route (I9344a, b/374347483)
Correzioni di bug
- Da Navigazione
2.9.0-alpha01: il tentativo di utilizzare unNavControllerche è stato precedentementeDESTROYEDora causerà unIllegalStateException. (I520da, b/369616172)
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-runtimeenavigation-composeper identificare i percorsi con sicurezza dei tipi che non sono annotati correttamente con@Serializable. Questo controllo viene applicato a tutte le funzioni di estensioneNavGraphBuildereNavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Sono stati aggiunti nuovi controlli lint per i moduli
navigation-common,navigation-runtimeenavigation-composeper identificare eventuali route con sicurezza dei tipi con argomenti Enum non annotati correttamente con@Keep. Questo controllo viene applicato a tutte le funzioni di estensioneNavGraphBuildereNavDeepLinkBuilder. (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 erroreObsolete custom lint checkquando 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>eList<Double>?senza richiedereNavTypepersonalizzati. (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
popBackStackche accetta un tipo di classe reificata quando si tenta di eseguirepopBackStackutilizzando API con sicurezza dei tipi. (Ief161, b/358095343)
Correzioni di bug
- La navigazione ora richiede che il percorso passato a un
startDestinationdi unNavGraphcontenga 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
NavDestinationnon 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
SeekableTransitionStatedi 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-composeche include un'alternativaComposableNavHostFragmentaNavHostFragmentche ti consente di aggiungere destinazioni componibili ai tuoi file XML di navigazione. Ogni destinazionecomposabledeve essere espressa come metodo@Composabledi primo livello senza argomenti, il cui nome completo viene utilizzato come attributoandroid:namein 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 diNavType<T>per gli argomenti basati su raccolte, come elenchi, array e mappe. Tutti gli arrayNavTypepredefiniti (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeeStringArrayType) ora ereditano da questa nuova classe. NavTypeora 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 tipiEnumnon richiedono piùNavTypepersonalizzati. Tieni presente che ilSerialNamediEnumdeve 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?eEnum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237) startDestinationdiNavGraphora utilizzerà i valori degli argomenti predefiniti se il percorsostartDestinationpassato aNavGraphè esattamente uguale astartDestination.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
WrongStartDestinationTypenon 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
singleTopquandoNavGraphsnidificati condividono lo stesso percorsostartDestination. (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
SavedStateHandleFactoryora 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
NavBackStackEntrya cui l'utente torna non torna mai allo stato del ciclo di vitaRESUMED. 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
CollectionNavTypeha un nuovo metodo astrattoemptyCollection(). 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.serializeAsValueeserializeAsValuesper 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 argomentoCollectionNavTypenullo. Quando navighi con unCollectionNavTypenull, l'argomento di output sarà il valore predefinito dichiarato nella classe Serializable o il valore restituito diemptyCollection()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
ClassCastExceptionquando si utilizzaNavBackStackEntry.toRoutecon unNavTypepersonalizzato 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 parametrotypeMapper i tipi di argomenti personalizzati. (Ie39fb, b/339026523)- È stata aggiunta un'API di test a
navigation-testingper creare unSavedStateHandleda 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
- Il lavoro per supportare la sicurezza dei tipi in fase di compilazione per Navigation Compose e per gli utenti di Navigation Kotlin DSL basato su Kotlin Serialization è stato completato e le API precedentemente sperimentali sono ora stabili. (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
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-composeora fornisce unLocalFragmentCompositionLocal ai metodi componibili all'interno di unComposableFragment. (If35e5) NavTypeora 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-composeche include un'alternativaComposableNavHostFragmentaNavHostFragmentche ti consente di aggiungere destinazionicomposableai file XML di navigazione. Ogni destinazionecomposabledeve essere espressa come metodo@Composabledi primo livello senza argomenti, il cui nome completo viene utilizzato come attributoandroid:namein 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
- È iniziato il supporto per Safe Args in Navigation Compose utilizzando un approccio basato sulla serializzazione 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. (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
Correzioni di bug
NavHostora utilizzaAlignment.TopStartcome argomento contentAlignment predefinito. In questo modo, l'impostazione è in linea con l'impostazione predefinita perAnimatedContente vengono risolti alcuni casi di transizione di ridimensionamento dal centro imprevista. (I09e72, b/330111602)- Quando si utilizza il gesto Indietro predittivo con Navigation Compose,
NavHostora 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
startDestinationdiNavGraphdirettamente nella routestartDestinationsenza fare affidamento sudefaultValue. Questo vale anche per istartDestinationsNavGraphnidificati. (I0e0b5, b/109505019, b/188693139)
Modifiche alle API
- È stata aggiunta una nuova classe astratta
CollectionNavType<T>, una sottoclasse diNavType<T>per gli argomenti basati su raccolte, come elenchi, array e mappe. (Ic6d63, b/188693139) - Tutti gli array
NavTypepredefiniti (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeeStringArrayType) ora sono di tipoCollectionNavType(Idcf79, b/188693139) NavTypeora fornisce una nuova APIvalueEqualsaperta 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 perNavTypesbasati 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
NavControllerche supportano route comenavigateopopBackStackora possono trovare correttamente le route compilate con argomenti di tipo ArrayNavTypes. (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
SizeTranformper le transizioni in Navigation Compose definendole nell'ambito dell'inizializzazione delle funzionicomposablee/onavigation. (I91062, b/296912651)
Correzioni di bug
- È stato risolto un problema per cui
NavHostin 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@MainThreadperché 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
DESTROYEDdei ViewModelNavGraphtroppo presto perché ilViewModeldella voce associata non faceva parte dello stato salvato. (Ib6bb7, b/317581849)
Aggiornamento delle dipendenze
- Navigation Compose ora dipende da Compose 1.7.0-alpha03.
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
SeekableTransitionStatedi 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
BackStackStateper cui più chiamatesaveStatesu 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
NavigationUIper compilare il titolo delle barre delle app. (#636, b/316676794)
Aggiornamento delle dipendenze
- Navigation Compose ora dipende da Compose
1.7.0-alpha01, risolvendo un problema che poteva causare un'animazione di scalabilità imprevista. (b/297258205)
Contributo esterno
- Grazie a SimonMarquis per aver risolto il problema di visualizzazione degli argomenti non di tipo String quando si utilizzano gli helper
NavigationUIper 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 diBackStackStatein cui più chiamatesaveState()su un singoloNavBackStackEntrycomportavano 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 helperNavigationUIper 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
NavigationUIper 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
NavGraphequals()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) NavHostora 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
setGraphpiù 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
ViewModeldella voce verrà ora cancellato correttamente sesaveStateè false. (Idf242, b/298164648) - Risolto un problema per cui
NavControllerpoteva 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 asetGraphsolo quando l'intent in entrata aveva il flagFLAG_ACTIVITY_NEW_TASKimpostato. (I73c7f)
Aggiornamenti delle dipendenze
- La navigazione con i frammenti ora dipende da Fragment 1.6.2, risolvendo un problema per cui le istanze
ViewModeldei frammenti nidificati non venivano cancellate quando veniva chiamatoclearBackStack.
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
popUpToper utilizzare i percorsi con argomenti per consentire il ritorno a una voce specifica che utilizza quegli argomenti esatti, in linea con il supporto trovato inpopBackStack. (I731f4, b/299255572)
Correzioni di bug
- Risolto il problema per cui l'interruzione di una navigazione con un'altra navigazione con
popUpTocausava l'arresto anomalo diFragmentNavigator. (I3c848, b/301887045) - Risolto il problema per cui la pressione del tasto Indietro del sistema causava l'aggiornamento non corretto di
currentDestinationin modo che corrispondesse al frammento visualizzato. (Id0d6c, b/289877514) - Il ciclo di vita di
DialogFragmentora passerà correttamente allo statoRESUMEDquando 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,Bottomsheetse così via) di ricevere un callback del ciclo di vitaRESUMED. (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 trarememberSaveableeNavHostdi Navigation Compose che impediva il corretto ripristino dello statorememberSaveabledelle destinazioni e di eventuali istanzeSavedStateHandledi proprietà diViewModeldopo 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
CREATEDanziché nello statoSTARTED. (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
STARTEDanziché passare correttamente aRESUMED. (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 unLifecycle.State.DESTROYEDViewModel. (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.0anziché da1.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
EnterTransitioneExitTransitioncreate nell'ambito diNavHostpotevano potenzialmente rimanere in memoria anche dopo la rimozione diNavHostdalla 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
NavHostin Navigation Compose ora intercetta correttamente le chiamate di ritorno del sistema anche dopo cheActivityè statoSTOPPEDeRESUMED. (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 conpopUpToe 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
argumentsdiNavBackStackEntryeargumentspassati a unOnDestinationChangedListenerora 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 aargumentso ad altre istanze diOnDestinationChangedListener.NavDeepLinkora 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.NavTypeora include anche un metodo predefinito di cui è possibile eseguire l'override per combinare due valori analizzati.- Le sottoclassi personalizzate di
NavTypeora possono eseguire l'override diserializeAsValueper serializzare un valore in una stringa, consentendo di incapsulare completamente sia la serializzazione che la deserializzazione (tramiteparseValue) nella classeNavType.StringTypeora esegue l'override di questo metodo per chiamareUri.encodesull'oggettoStringspecificato.
Modifiche importanti a Navigation Compose dalla versione 2.5.0
- Quando visualizzi l'anteprima di un composable con
NavHost, ora viene mostrato ilstartDestinationdi 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
NavDeepLinkvuoto utilizzando il DSL KotlinnavDeepLinkora 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
NavHostFragmentnon intercetta più il pulsante Indietro del sistema. In questo modo, l'elementoFragmentManagersottostante può gestire il pulsante Indietro del sistema. In questo modo, Fragment1.7.0-alpha01e 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
FragmentTransactionche aggiunge un frammento al back stack diFragmentManagerora genera unIllegalArgumentException. Devi sempre aggiungere i frammenti tramite l'APInavigate(). - Quando utilizzi la stringa esatta
${applicationId}come segnaposto negli attributiapp:dataeapp:dataPatternnell'elemento di attività di un file XML di navigazione, il segnaposto verrà compilato automaticamente con ilpackageNamedel contesto al momento dell'inflazione. FragmentNavigatorora utilizza le API di transizione durante la navigazione e il popping diNavBackStackEntries. Ciò significa cheNavBackStackEntryLifecycleora attenderà il completamento degli effetti speciali dei frammenti in entrata e in uscita prima di spostare il relativoLifecycle.Statefinale.DialogFragmentNavigatorora utilizza le API di transizione durante la navigazione e il popping diNavBackStackEntries. Ciò significa cheNavBackStackEntryLifecycleora attenderà cheDialogFragmentLifecyclepassi aDESTROYEDprima di passare aDESTROYED.NavHostFragmentora ti consente di recuperareNavControllernon appenaNavHostFragmentviene collegato aFragmentManager, anziché solo dopoonCreate().- 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 unMenu),NavigationUIora 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 funzioneisTopLevelDestinationsuAppBarConfiguration. - Le integrazioni di
setupWithNavControllerinNavigationUIper l'utilizzo della barra delle app in alto ora analizzeranno i valoriR.stringper gli argomentiReferenceTypetrovati inandroid:labelnei relativi valori String anziché restituire l'intero della risorsa generato automaticamente. NavigationUIora fornisce i log quando non riesce a navigare tramite unMenuItemselezionato.
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
popUpToe 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
popUpTonel relativo callback del ciclo di vitaonResume()causava unIllegalStateException. (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à
NavBackStackEntryora fornisce un'implementazionetoStringpersonalizzata. (Iff00b)
Correzioni di bug
- Quando utilizzi la navigazione con i frammenti, il tentativo di eseguire manualmente un
FragmentTransactionche aggiunge un frammento al back stack diFragmentManagerora genera unIllegalArgumentException. Devi sempre aggiungere i frammenti tramite l'APInavigate(). (I6d38e) - Quando nello stesso frame è presente un
navigateche aggiunge una voce e unpopBackStackche la rimuove, la voce in alto risultante nel back stack ora tornerà in modo coerente aRESUMEDLifecycle.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
NavDestinationcontieneNavArgumentnon null, il percorso di questa destinazione deve contenere segnaposto per gli argomenti con lo stesso nome diNavArgumentnon null. (Ic62bf, b/274697949) - Le navigazioni tramite deep link basate su
Action/MimeTypeora non andranno a buon fine se nell'operazione di navigazione manca unNavArgumentnon nullable richiesto dalNavDestinationcon cui corrispondeAction/MimeType. (Ibfa17, b/271777424) - Quando
NavControllerimposta 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 utilizzaonLaunchSingleTopsenza 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à
NavHostFragmentora ti consente di recuperareNavControllernon appenaNavHostFragmentviene collegato aFragmentManager, anziché solo dopoonCreate(). (Ic6382, b/220186282)
Correzioni di bug
- Risolto un problema di
NullPointerExceptiondurante 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 diNavControllerpassa alla voce corretta. (I3a8ec, b/270447657) FragmentNavigatorora rimuoverà correttamente le voci quando il back stack viene rimosso tramite il pulsante Indietro del sistema opopBackStack()e indipendentemente dal fatto che la transazione utilizzi o meno gli effetti per il frammento. (I81bdf)- L'aggiunta di frammenti a
FragmentManagerdiFragmentNavigatorsenza utilizzare la navigazione non causerà più un arresto anomalo. (b17204, b/274167493)
Aggiornamenti delle dipendenze
- La navigazione ora dipende dal Ciclo di vita
2.6.1. (586fe7) - La navigazione ora dipende da SavedState
1.2.1. (078e4e) - La navigazione ora dipende da ProfileInstaller
1.3.0. (512f0c)
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,clearBackStackche 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()daNavControllernon 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
MenuItemerrato inBottomNavigationViewquando 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
NavBackStackEntryallo stato RESUMED quando si utilizzavanoAnimation. (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 ilstartDestinationdi NavGraph per impostazione predefinita. (I2b89f)
Modifiche alle API
- Tutti gli overload
NavControllernavigatesono ora annotati con@MainThreadper 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
NavBackStackEntrynon riesce a raggiungereRESUMEDquando si utilizzano le APIAnimation. (b/269646882) - Quando utilizzi la navigazione con i frammenti e navighi con
BottomNavigation, se provi a ripristinare un back stack con più voci,BottomMenuItemnon viene aggiornato correttamente. (b/270447657) - Quando utilizzi la navigazione con i frammenti, dopo aver ripristinato lo stato,
NavBackStackEntryLifecyclenon riceveDESTROYEDquando 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)FragmentNavigatorora utilizza le API di transizione durante la navigazione e il popping diNavBackStackEntries. Ciò significa cheNavBackStackEntryLifecycleora attenderà il completamento degli effetti speciali dei frammenti in entrata e in uscita prima di spostare il relativoLifecycle.Statefinale. (I3cb19, b/238686802)DialogFragmentNavigatorora utilizza le API di transizione durante la navigazione e il popping diNavBackStackEntries. Ciò significa cheNavBackStackEntryLifecycleora attenderà cheDialogFragmentLifecyclepassi aDESTROYEDprima di passare aDESTROYED. (I53ee5, b/261213893)
Modifiche alle API
NavigatorStateora fornisce l'APIprepareForTransitionper consentire aiNavigatordi spostareNavBackStackEntriesinLifecycle.Stateintermedi. (I42c21, b/238686802)- Ora puoi accedere al back stack associato a un
NavGraphNavigatoro a unComposeNavigatortramite una proprietàbackstack.ComposeNavigatorora espone anche il callbackonTransitionComplete()per contrassegnare come completata unaNavBackStackEntryche ha eseguito un'operazione di navigazione opopBackStack. (I02062, I718db, b/257519195)
Correzioni di bug
- Lo stato del navigatore ora non eseguirà alcuna operazione quando utilizzi le API
push/popWithTransitione la voce è già in fase di gestione. (Iadbfa, b/261213893) - Quando utilizzi
launchSingleTopcon unNavGraphnidificato, tutte le destinazioni a partire dalla destinazione originale fino alla relativastartDestinationverranno aggiunte correttamente solo all'inizio del backstack. (Id4bea, b/253256629) - La navigazione ora sostituirà correttamente l'istanza
DialogFragmentquando si naviga verso la stessa destinazione con il flaglaunchSingleTopimpostato 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
NavTypeora possono eseguire l'override diserializeAsValueper serializzare un valore in una stringa, consentendo di incapsulare completamente sia la serializzazione che la deserializzazione (tramiteparseValue) nella classeNavType.StringTypeora esegue l'override di questo metodo per chiamareUri.encodesull'oggettoStringspecificato. (Ie5213, b/247637434) NavigationUIora fornisce i log quando non riesce a navigare tramite unMenuItemselezionato. (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:NavHostnon causerà più unNoSuchElementExceptionquando non è disponibile una destinazione per la composizione diCrossfade. 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 dirememberSaveable) non veniva dimenticato e rimosso quando una destinazione veniva rimossa dal back stack. (I64949)
Aggiornamenti delle dipendenze
- La navigazione ora dipende da Fragment
1.5.4. (Icd424)
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 unMenu),NavigationUIora 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 funzioneisTopLevelDestinationsuAppBarConfiguration. (Ie936e, b/238496771)
Correzioni di bug
- Il componente
navigation:navigation-fragmentora dipende dalla versione1.5.2di 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
setupWithNavControllerinNavigationUIper l'utilizzo della barra delle app in alto ora analizzeranno i valoriR.stringper gli argomentiReferenceTypetrovati inandroid:labelnei relativi valori String anziché restituire l'intero della risorsa generato automaticamente. (I5f803, b/167959935) NavDeepLinkora 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.NavTypeora 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 attributiapp:dataeapp:dataPatternnell'elemento di attività di un file XML di navigazione, il segnaposto verrà compilato automaticamente con ilpackageNamedel contesto al momento dell'inflazione. (Iaabde, b/234223561) - Il tentativo di creare un
NavDeepLinkvuoto utilizzando il DSL KotlinnavDeepLinkora 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
NavDestinationper analizzare le etichette dinamiche con argomenti nel formatoandroid:label="{arg}"in String. Supporta gli argomentiReferenceTypeanalizzando i valoriR.stringnei relativi valori String. (I07d89, b/236269380)
Modifiche del comportamento
argumentsdi NavBackStackEntry eargumentspassati a unOnDestinationChangedListenerora 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 aargumentso ad altre istanze diOnDestinationChangedListener. (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 flaglaunchSingleTopsu true. (I5a2f1, b/237374580) - Da Navigation
2.5.2: è stato corretto l'erroreIllegalStateExceptioncausato 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
NavHostnon causerà più unNoSuchElementExceptionquando non è disponibile una destinazione per la composizione diCrossfade. 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
launchSingleTopsu true. (I5a2f1, b/237374580) - Risolto il problema
IllegalStateExceptioncausato 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
- Navigation
2.5.2ora dipende da Fragment1.5.2. (aosp/2178734)
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 Argsnon causerà più avvisi di ritiro nelle classi generate quando si utilizzano tipi di argomenti personalizzati salvati in unBundle. (Id86ed, b/237725966)
Aggiornamenti delle dipendenze
- La libreria Navigation ora dipende da Lifecycle
2.5.1. (Ib4451) - La libreria Navigation ora dipende da Activity
1.5.1. (I3efe8) - La libreria Navigation ora dipende da Fragment
1.5.1. (I56177)
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 -
Navigationora ha la possibilità di fornire unViewModelProvider.Factorystateless tramiteCreationExtrasdi Lifecycle2.5.0.
Navigation SafeArgs
Navigation Safe Argsha eseguito l'upgrade della dipendenzaAndroid Gradle Pluginper fare affidamento su7.0.4, eliminando la compatibilità con le versioni di AGP precedenti alla7.0.- Aggiunto il supporto per l'attributo build.gradle dello spazio dei nomi da utilizzare al posto di applicationId.
Altre modifiche
- L'API
visibleEntriesnon è più sperimentale e fornisce una funzione per recuperare tutte le voci la cui destinazione è attualmente visibile in base aNavController.
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 SafeArgsnon si arresterà più in modo anomalo quando utilizzi unapplicationIdSuffixe uno spazio dei nomi senzaapplicationIdo quandoapplicationIde lo spazio dei nomi sono diversi. (I754b1, b/233119646)NavArgumentora ha una funzionetoString()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 filenavigation.xml.(Ic15a5, b/178403185)
Correzioni di bug
- Gli ambiti componibili in
NavHosteDialogHostora vengono eliminati nell'ordine previsto, ovvero i componibili interni vengono eliminati prima di quelli esterni. (I157e6) - Navigation SafeArgs ora utilizza
PathSensitivity.RELATIVEinArgumentsGenerationTaskper 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 chiamatarememberche circonda la chiamata agetBackStackEntry()passi anche un oggettoNavBackStackEntrycome 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
DialogNavigatorora utilizzapopWithTransitionquando esegue una chiamatadismiss(). In questo modo viene corretta una race condition quando si utilizza un elementoViewModelall'interno di una destinazionedialogche causerebbe un erroreIllegalStateExceptionquando 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 unIllegalStateExceptionquando si nidifica unNavHostall'interno di un altroNavHostin 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
visibleEntriesnon è più sperimentale. (I4829f, b/225394514)
Correzioni di bug
- NavHost ora dipende da
visibleEntriesdiNavControllerper determinare quali voci comporre. Ciò significa che, quando utilizzi NavHost nidificati, l'elementoNavHostinterno ora dovrebbe uscire correttamente dall'animazione. (I4ba2b, b/225394514) - La
visibleEntriesStateFlowfornita daNavControllerora 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 dinavControllerscende al di sotto di STARTED, l'elenco delle voci visibili rimarrà invariato. (I9e2a8, b/225394514) SavedStateViewFactoryora supporta l'utilizzo diCreationExtrasanche se è stato inizializzato con unSavedStateRegistryOwner. Se vengono forniti extra, gli argomenti inizializzati vengono ignorati. (I6c43b, b/224844583)NavDeepLinkora 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 Argsnon si arresterà più in modo anomalo quando utilizzi gli spazi dei nomi e non è presenteAndroidManifest.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
CreationExtrasaby navGraphViewModelsper creare unViewModel. (I29217, b/217618359)
Correzioni di bug
NavDeepLinksora supporta correttamente i caratteri di nuova riga codificati incorporati negli URI di route/deep link. (I513d1, b/217815060)CreationExtrasora funzionerà correttamente se utilizzato conNavBackStackEntriesper creare ViewModel. (I69161, b/217617710)- Navigation Safe Args ora supporta l'utilizzo dello spazio dei nomi definito in
build.gradleal 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:NavHostFragmentora imposterà correttamenteOnBackPressedDispatcherquando utilizzi l'associazione delle visualizzazioni con grafici nidificati. (Ifbb51, b/214577959) - Da Navigation
2.4.1: quando si esegue il deep linking tramite piùNavGraphnidificati, 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à
NavBackStackEntryora si integra con CreationExtras di ViewModel, introdotto come parte di Lifecycle2.5.0-alpha01. (Ib9fe2, b/207012490)
Correzioni di bug
- Risolto un problema per cui l'accesso a un
ViewModelcreato tramiteby navGraphViewModels()da unonCreate()di un frammento non andava a buon fine con unIllegalStateException. (I8a14d) NavDeepLinknon 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
- Backport da Navigation
2.5.0-alpha03:NavDeepLinksora supporta correttamente i caratteri di nuova riga codificati incorporati negli URI dei percorsi/deep link. (I513d1, b/217815060) - Backporting da Navigation
2.5.0-alpha03: Navigation SafeArgs ora supporta l'utilizzo dello spazio dei nomi definito inbuild.gradleal posto del pacchetto in AndroidManifest. (I659ef, b/217414933) - Backport da Navigation
2.5.0-alpha04:Navigation Safe Argsnon si arresterà più in modo anomalo quando si utilizzano gli spazi dei nomi e non è presenteAndroidManifest.xml. (I17ccf, b/227229815) - Backport da Navigation
2.5.0-alpha04: le stringhe vuote sono ora considerate argomenti validi nei deep link. (I70a0d, b/217399862)
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
NavHostFragmentora imposterà correttamenteOnBackPressedDispatcherquando utilizzi l'associazione delle visualizzazioni con grafici nidificati. (Ifbb51, b/214577959)- Quando esegui il deep linking tramite più
NavGraphnidificati, 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 tramiteby navGraphViewModels()da unonCreate()di un Fragment non andava a buon fine con unIllegalStateException. (I8a14d) - Backport da Navigation
2.5.0-alpha01:NavDeepLinknon 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-ktxsono state spostate nei rispettivi artefatti principali. Gli artefatti-ktxcontinueranno a essere pubblicati, ma saranno completamente vuoti. - L'artefatto
navigation-fragmentora contiene un'implementazione predefinita di un layout a due riquadri tramite il nuovoAbstractListDetailFragment. Questo frammento utilizza unSlidingPaneLayoutper gestire un riquadro elenco (fornito dalla tua sottoclasse) e un riquadro dei dettagli, che utilizza unNavHostFragmentcome implementazione, come mostrato nella nostra implementazione di esempio. - Il metodo
currentBackStackEntryAsFlow()suNavControllerfornisce unFlowche viene emesso ogni volta che cambia ilNavBackStackEntrycorrente. Questo flusso può essere utilizzato come alternativa alla gestione manuale di unOnDestinationChangedListener. - NavController ora offre la possibilità di recuperare un elenco di tutte le istanze
NavBackStackEntryvisibili comeStateFlowtramite la proprietà sperimentalevisibleEntries. - Ora è possibile estendere la classe
NavTypeper 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()egetHierarchy()che possono essere utilizzate per implementare la NavigationUI personalizzata.findStartDestination()è una funzione di estensione suNavGraphche individua la destinazione di partenza effettiva che verrà visualizzata quando accedi al grafico, anche sestartDestinationè unNavGraphnidificato.getHierarchy()è una funzione diNavDestinationche 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
NavigationUIche accettavano unBottomNavigationViewsono stati aggiornati per accettare la relativa superclasse introdotta in Material1.4.0,NavigationBarView. In questo modo, questi metodi possono essere utilizzati conNavigationRailView.Quando si esegue l'inflation di un elemento
<action>tramite XML, gli attributi di animazione possono utilizzare attributi estratti dal tema utilizzando la sintassiapp:enterAnim="?attr/transitionEnter".Safe Args ora genera un metodo
fromSavedStateHandle()per ogni classeNavArgs. (#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
popUpTonel DSL Kotlin è stata deprecata a favore dipopUpToId. - L'API
getStartDestination()è stata ritirata a favore digetStartDestinationId().
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
NavHostche ti consente di creare il grafico di navigazione tramite un DSL Kotlin, utilizzando le destinazionicomposableedialog, 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
Lifecycleper ogni destinazione componibile. Ogni destinazione raggiunge lo statoRESUMEDsolo quando terminano le transizioni in entrata e passa immediatamente aSTARTEDquando iniziano le transizioni in uscita, consentendoti così di evitare tutti i problemi diIllegalStateExceptione multi-touch attivando una chiamatanavigatesolo quandoLifecycleèRESUMED. - Definizione dell'ambito di
ViewModel(tramite l'APIviewModel()di Lifecycle ViewModel Compose2.4.0ohiltViewModel()di Hilt Navigation Compose1.0.0a 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 inonCleared()di ViewModel che indica l'eliminazione definitiva e la pulizia dello stato associato aNavBackStackEntry. - Definizione dell'ambito dello stato di
rememberSaveablea 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
NavControllere 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()ecurrentBackStackEntryAsState()per consentire l'elevazione dello stato e il collegamento diNavControllera elementi componibili esterni aNavHost(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 diapp:popUpToSaveStateeapp:restoreStateper salvare lo stato di tutte le destinazioni rimosse tramiteapp:popUpToe ripristinare lo stato associato alla destinazione passata comeapp: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
navOptionsKotlin DSL, puoi aggiungere la proprietà booleanarestoreStatee la proprietà booleanasaveStatenel builderpopUpTo:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.findStartDestination().id) { saveState = true } }Quando crei manualmente un oggetto
NavOptionstramiteNavOptions.Builder, puoi utilizzaresetRestoreState()e il nuovo overload persetPopUpTo()che accetta un parametrosaveStateaggiuntivo.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 parametrosaveStateaggiuntivo.Puoi utilizzare il metodo
clearBackStack()per cancellare qualsiasi stato salvato conpopBackStack()opopUpToSaveState.
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
NavDeepLinkBuilderora aggiungePendingIntent.FLAG_IMMUTABLEaPendingIntentrestituito dacreatePendingIntent(), garantendo che questa API funzioni come previsto quando il target è Android 12.- La navigazione ora dipende da
Lifecycle
2.3.1e ora contrassegnasetGraph(),popBackStack(),navigateUp()enavigate(), i metodi che aggiornanoNavBackStackEntryLifecycle, come@MainThread, allineando la navigazione con l'applicazione del thread principale introdotta in Lifecycle2.3.0. - I deep link ora verificano che tutti gli argomenti obbligatori (quelli senza valori predefiniti) siano presenti in
Uri. - Gli argomenti analizzati di
NavDeepLinkora 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 unViewModelcreato tramiteby navGraphViewModels()da unonCreate()di un frammento non andrà a buon fine con unIllegalStateException. (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
NavDeepLinkora 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)
NavControllernon si arresterà più in modo anomalo quando viene visualizzata una destinazione nidificata utilizzando le transizioni dopo il ripristino diNavController. (I0f7c9, b/205021623)- Il messaggio di errore quando si utilizza un
startDestinationnon 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
ViewModelda unNavBackStackEntrydi 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
activityconNavHostdi 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
SafeArgsnon 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
saveStatequando si passa a un altro grafico, garantendo che il codice comeNavigationUI.setupWithNavControllere 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.CREATEDdopo il passaggio aLifecycle.State.STARTEDquandoNavHostviene aggiunto direttamente asetContent()dell'attività. (Ia5ac1, b/203536683) - È stata corretta una race condition in cui
la rimozione di una destinazione
DialogFragmentdal 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
onNavDestinationSelectedsuNavigationUIrestituivatrueanche se non avevi eseguitonavigate()su quel grafico di navigazione. Ora utilizza la stessa logica utilizzata internamente dasetupWithNavControllerper selezionare solo ilMenuItemassociato alla destinazione corrente utilizzando ilhierarchydella 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 navGraphViewModelcon 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
NavDeepLinkche ammettono valori null non richiedono più un valore predefinito quando si aggiungono deep link aNavDestination. (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
AbstractListDetailFragmentche causava la gestione errata o l'ignoramento degli attributilayout_widthelayout_weightnel riquadro dell'elenco restituito daonCreateListPaneView(). (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 asincronadismiss()perDialogFragmentora cancella correttamente tutte le destinazioni della finestra di dialogo sopra quella ora chiusa. Ciò non influisce sui casi in cui utilizzipopUpToopopBackStack()per chiudere la finestra di dialogo. (I77ba2) AbstractAppBarOnDestinationChangedListenerora ha messaggi di errore più chiari peronDestinationChanged(). (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
NavBackStackEntryvisibili tramitevisibleEntriesStateFlow (Ia964e) rememberNavController()ora accetta un insieme facoltativo di istanzeNavigatorche verranno aggiunte all'oggettoNavControllerrestituito 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()efromSavedStateHandle()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 conpopBackStack()opopUpToSaveState. (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
navArgumentora fa parte dinavigation-commonanziché dinavigation-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
DESTROYEDsolo dopo che tutti i relativi elementi secondari saranno statiDESTROYED. (I86552, b/198741720) - Gli argomenti
NavDeepLinkche 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
OnDestinationChangedListenerecurrentBackStackEntryFlownon venivano informate quando utilizzavanolaunchSingleTop. (Iaaebc)
Aggiornamenti delle dipendenze
- Navigation Compose ora dipende da Activity Compose 1.3.1. (I05829)
- Navigation Compose ora dipende da
Lifecycle ViewModel Compose
2.4.0-beta01. (Ib86a3)
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à
- Ora è possibile estendere la classe
NavTypeper 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. (I78440, b/196871885)
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
getBackStackEntryepreviousBackStackEntryall'interno di composable(), insieme aremember(), 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
ArrayIndexOutOfBoundsExceptionquando chiamisetGraphcon 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)
NavHostora osserva le modifiche nelLifecycle.StatediNavBackStackEntry, il che significa che l'utilizzo di unNavHostin 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
DialogFragmentnon aggiornava correttamente lo stato diNavControllerdopo 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
toSavedStateHandleper gli argomenti che possono essere utilizzati per testare il codiceViewModel. (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()erequireDetailPaneNavHostFragment()suAbstractListDetailFragmentsono stati rinominati rispettivamente ingetSlidingPaneLayout()egetDetailPaneNavHostFragment(). (I34a08)
Modifiche del comportamento
- Quando navighi con le animazioni (come
Crossfade), l'elementoLifecycledella nuova destinazione raggiungerà l'elementoRESUMEDsolo al termine dell'animazione. (If0543, b/172112072, b/194301889) NavHostdi 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
NullPointerExceptionche si verificava quando si aggiungeva un deep link senza unUrie si navigava tramite un percorso o un deep link. (938a0c, b/193805425) - Risolto un problema in Navigation Compose per cui un
NavBackStackEntrycon deep link non raggiungeva lo statoRESUMED. (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
NavHostdi 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
NoSuchElementExceptionquando viene chiamatopopBackStack()da unLifecycleObservercollegato a unNavBackStackEntrycausato da aggiornamenti rientranti dello stato di NavController. (I64621) AbstractListDetailFragmentora consente di rimuovere completamenteSlidingPaneLayoutdal tuo APK quandoAbstractListDetailFragmentnon viene utilizzato. (I611ad)NavGrapheNavDestinationora 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-fragmentora contiene un'implementazione predefinita di un layout a due riquadri tramite il nuovoAbstractListDetailFragment. Questo frammento utilizza unSlidingPaneLayoutper gestire un riquadro elenco (fornito dalla tua sottoclasse) e un riquadro dei dettagli, che utilizza unNavHostFragmentcome implementazione, come mostrato nella nostra implementazione di esempio. (Iac4be, b/191276636) - La
NavHostdell'artefattonavigation-composeora supporta le destinazionidialogoltre alle destinazionicomposable. Queste destinazioni della finestra di dialogo verranno visualizzate ciascuna all'interno di un elemento componibileDialog, che fluttua sopra la destinazionecomposablecorrente. (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
addinNavigatorStateè stata rinominata inpush. Tutte le chiamate correnti aadd()dovranno essere modificate in push(). (Ie89fc, b/172112072) - Le istanze
Navigatorpersonalizzate ora possono utilizzare le APIpushWithTransactionepopWithTransitionsuNavigatorStateper 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
NavDeepLinkBuilderora aggiungePendingIntent.FLAG_IMMUTABLEaPendingIntentrestituito dacreatePendingIntent(), 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
NullPointerExceptiondurante la navigazione verso una destinazione utilizzando un argomentostring[]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
Kotlinprecedenti alla1.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-alpha01per cuisetupActionBarWithNavController()non rimuoveva correttamente l'icona Su quando ti trovi in una destinazione di primo livello. (I5d443, b/189868637) - Risolto un problema di
IllegalStateExceptionquando viene chiamatopopBackStack()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 utilizzinavigation-commono qualsiasi artefatto che dipende da questo. (I68800, b/190082521) - Un
OnDestinationChangedListenerche chiamanavigate()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 Gradle6.7.0a 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)
NavigationUIha 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()egetHierarchy()che possono essere utilizzate per implementare la NavigationUI personalizzata.findDestination()è una funzione di estensione suNavGraphche individua una destinazione all'interno del grafico.getHierarchy()è una funzione suNavDestinationche 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
BottomNavigationViewsono stati aggiornati per accettare la relativa superclasse introdotta in Material1.4.0,NavigationBarView. In questo modo, questi metodi possono essere utilizzati conNavigationRailView. (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 sintassiapp:enterAnim="?attr/transitionEnter". (I07bc1, b/178291654)
Modifiche alle API
- I builder Kotlin DSL che utilizzano un ID sono stati ritirati e devono essere sostituiti con builder che utilizzano route (I85b42, b/188816479) (I9f58f, b/188816479)
Correzioni di bug
DialogFragmentNavigatorora utilizza l'APINavigatorState.pop()per informareNavControllerquando una finestra di dialogo viene chiusa premendo il pulsante Indietro del sistema o facendo clic all'esterno, assicurando che lo stato diNavControllersia sempre sincronizzato con lo stato di Navigator. (I2ead9)La navigazione non restituisce più un
ConcurrentModificationExceptionquando si utilizza la manipolazione dell'elenco diOnDestinationChangedListenerscon un callbackonDestinationChanged. (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
findNodeora èresIdanziché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()suNavControllerfornisce unFlowche viene emesso ogni volta che cambia ilNavBackStackEntrycorrente. Questo flusso può essere utilizzato come alternativa alla gestione manuale di unOnDestinationChangedListener. (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 diapp:popUpToSaveStateeapp:restoreStateper salvare lo stato di tutte le destinazioni rimosse tramiteapp:popUpToe ripristinare lo stato associato alla destinazione passata comeapp: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
navOptionsKotlin DSL, puoi aggiungere la proprietà booleanarestoreStatee la proprietà booleanasaveStatenel builderpopUpTo:// 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
NavOptionstramiteNavOptions.Builder, puoi utilizzaresetRestoreState()e il nuovo overload persetPopUpTo()che accetta un parametrosaveStateaggiuntivo.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 parametrosaveStateaggiuntivo.
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
popUpTonel DSL Kotlin è stata ritirata a favore dipopUpToId. (I59c73, b/172823546) - L'API
getStartDestination()è stata ritirata a favore digetStartDestinationId(). (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-ktxsono state spostate nei rispettivi artefatti principali. Gli artefatti-ktxcontinueranno a essere pubblicati, ma saranno completamente vuoti. (b/184292145) NavDeepLinkBuilderora 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
nameeargumente le funzioni di destrutturazione diNamedNavArgumentsono ora pubblici. (#174, b/181320559) - È stata introdotta una nuova estensione
NavBackStackEntry#provideToCompositionLocalsche fornisceNavBackStackEntryai CompositionLocal pertinenti. (#175, b/187229439)
Safe Args
Safe Args ora genera un metodo
fromSavedStateHandle()per ogni classeNavArgs. (#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.1e ora contrassegnasetGraph(),popBackStack(),navigateUp()enavigate(), i metodi che aggiornanoNavBackStackEntryLifecycle, come@MainThread, allineando la navigazione con l'applicazione del thread principale introdotta in Lifecycle2.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/reddi corrispondere a un deep linkwww.example.com/{color}anche quando l'enum ha il valoreRED. (#152, b/135857840)
Compatibilità di Compose
androidx.navigation:navigation-compose:2.4.0-alpha01è compatibile solo con Compose versione1.0.0-beta07e 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)
NavHostFragmentora supporta i navigatori personalizzati che utilizzano lo stesso@Navigator.Name("dialog")delDialogFragmentNavigatorpredefinito. (Ib1c2c, b/175979140)- Migliorato il comportamento di
NavigatorProvider#addNavigatorper 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 classeNavArgs. (#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
nameeargumente le funzioni di destrutturazione diNamedNavArgument. (#174, b/181320559) - Grazie a jossiwolf per aver introdotto una nuova estensione
NavBackStackEntry#provideToCompositionLocalsche fornisceNavBackStackEntryai relativi elementi locali di composizione. (#175, b/187229439) - Grazie a jossiwolf per aver migliorato il comportamento di
NavigatorProvider#addNavigatorper garantire che la chiamata ripetuta con la stessa istanza non causi problemi. (#176, b/187443146)
Navigation Compose versione 1.0.0
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
NavHostora accetta unModifier, che viene passato al container componibile che aggrega i componibili di destinazione. (I85aca, b/175125483)
Correzioni di bug
NavHostora funziona anche quando non viene trovato unOnBackPressedDispatcherOwner, come nel caso dell'anteprima diNavHost. (I7d8b4)- Navigation Compose ora dipende da Navigation
2.3.5, risolvendo un problema relativo all'utilizzo diBackHandlerall'interno di una destinazioneNavHost. (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.currentora restituisce unViewModelStoreOwnernullable per determinare meglio se unViewModelStoreOwnerè disponibile nella composizione corrente. Le API che richiedono unViewModelStoreOwner, comeviewModel()eNavHost, generano comunque un'eccezione se non è impostato unViewModelStoreOwner. (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à
NavHostora compila il CompositionLocalLocalSavedStateRegistryOwnercon ilNavBackStackEntrydi quella destinazione, assicurando che qualsiasi stato salvato direttamente nelSavedStateRegistryvenga 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
- Navigation Compose ora dipende da Lifecycle ViewModel Compose 1.0.0-alpha01 per fornire il supporto di
viewModel()alle destinazionicomposable. (I7a374) NavHostora utilizza il nuovoLocalOnBackPressedDispatcherOwnerdi Activity-Compose 1.3.0-alpha01 per ottenere ilOnBackPressedDispatcherimpostato suNavController. (I65b12)
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)suNavControllerche restituisce l'oggettoNavBackStackEntryassociato. (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()enavigateUp()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
NavHostche ti consente di creare il grafico di navigazione tramite un DSL Kotlin. - Definizione dell'ambito del ciclo di vita, di
ViewModele 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()ecurrentBackStackEntryAsState()per consentire l'elevazione dello stato e il collegamento diNavControllera elementi componibili esterni aNavHost(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
NavDeepLinkRequesto unUri, ora puoi accedere aUri, azione e tipo MIME nella destinazione risultante recuperando l'intent dagli argomenti tramiteKEY_DEEP_LINK_INTENT, rispecchiando la funzionalità già disponibile per il deep linking esterno. (I975c3, b/181521877)
Correzioni di bug
OnBackPressedCallbacksaggiunto a un dispatcher conNavBackStackEntrycome LifecycleOwner ora intercetta correttamente il pulsante Indietro dopo che il ciclo di vita dell'attività èSTOPPED, quindiSTARTED(Iff94f, b/182284739)- L'analisi del dominio dei deep link ora non fa distinzione tra maiuscole e minuscole, garantendo che
www.example.comcorrisponda sia awww.example.comche awww.Example.com. Tieni presente che i nomi dei parametri di query sono ancora sensibili alle maiuscole. (#144, b/153829033) - Risolto un problema di
NullPointerExceptionche 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
- Il plug-in Gradle Navigation Safe Args ora dipende dal plug-in Gradle Kotlin 1.4.31. (aosp/1661058, b/181156413)
Contributo esterno
- Grazie a
bentrengroveper 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
ReferenceTypepossono 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 prefisso0x. (#127, b/179166693) android:defaultValueper un argomento conapp:argType="float"ora supporta i valori predefiniti interi, consentendoti di utilizzareandroid:defaultValue="0"anziché richiedere l'utilizzo di0.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
setViewModelStoreosetLifecycleOwnercon 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
JvmNameper la richiesta di pull per garantire che gli argomentiReferenceTypepossano ora essere analizzati correttamente quando vengono inviati come parte di un URI di deep link. (#127, b/179166693) - Grazie
tatocasterper la richiesta di pull per consentiredefaultValueper un argomento conapp: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
NavBackStackEntryprima che il relativoLifecyclevenga spostato inCREATED. (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
0causava unResourceNotFoundException. (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
NavigationUIper cui l'utilizzo di una destinazione<activity>cononNavDestinationSelectednon consentiva di passare all'attività. (I22e34, b/171364502) - Risolto un problema per cui
navigation-dynamic-features-fragmentportava 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
OnDestinationChangedListenerquando si utilizzavalaunchSingleTop. (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 unpopUpToche 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 conFragmentScenarioeNavigation.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-uiora dipende da DrawerLayout 1.1.1, per garantire cheNavigationUIsia in grado di aprire il riquadro a scomparsa anche quando utilizziLOCK_MODE_LOCKED_CLOSEDoLOCK_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-runtimeenavigation-dynamic-features-fragmentti 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-testingfornisce unTestNavHostControllerche 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:
NavBackStackEntryassociato a ogni destinazione nel back stack di navigazione ora consente di accedere a unSavedStateHandleadatto 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
NavigationUIperOpenable: tutti gli utilizzi diDrawerLayoutinNavigationUIsono stati sostituiti con l'interfaccia più genericaOpenableaggiunta in CustomView1.1.0e implementata daDrawerLayoutin DrawerLayout1.1.0. - Supporto di Action e Mime Type nei deep link: il deep linking è stato ampliato per supportare
app:actioneapp:mimeTypeoltre aapp:uriprecedentemente disponibile.NavControllerora supporta la navigazione in base a qualsiasi combinazione di questi campi tramite la nuova classeNavDeepLinkRequest. 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
NullPointerExceptiondurante la sostituzione di un'istanza di una destinazione senza argomenti con un'altra istanza con argomenti consingleTop. (b/158006669) - Tutte le eccezioni
destination is unknowngenerate daNavControllerora contengono informazioni di debug aggiuntive per aiutare a determinare lo stato diNavController. (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
LifecyclediNavBackStackEntrynon veniva aggiornato correttamente dopo l'interruzione del processo. (b/155218371) - Le istanze
OnDestinationChangedListenerregistrate prima di chiamaresetGraph()ora ricevono correttamente la destinazione ripristinata dopo un'interruzione del processo. (b/155218371) - Quando utilizzi
singleTop, gli argomenti diNavBackStackEntryora vengono aggiornati correttamente e gli argomenti aggiornati vengono inviati a tutte le istanzeOnDestinationChangeListener. (b/156545508)
Aggiornamenti delle dipendenze
- L'artefatto
NavigationUIora dipende da CustomView1.1.0-rc01e DrawerLayout1.1.0-rc01. (aosp/1309696)
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:actioneapp:mimeType, oltre aapp:uri, che era già disponibile. NavController ora supporta la navigazione in base a qualsiasi combinazione di questi campi tramite la nuova classeNavDeepLinkRequest. (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 specificareapp:graphPackagee ne verrà utilizzato uno predefinito aggiungendo il suffissomoduleNameaapplicationIddopo un punto. Se devi personalizzare il tuographPackage, ora è supportato un segnaposto${applicationId}. (b/152696768) - La DSL Kotlin del grafico di navigazione ora espone un
defaultArgumentsMapper 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
IllegalStateExceptiondurante il deep linking alla destinazione iniziale del grafico quando hai più istanzeNavHostFragmentnella tua attività. (b/147378752)
Aggiornamenti delle dipendenze
- La navigazione ora dipende da Fragment
1.2.4. (aosp/1277325) - La navigazione dinamica ora dipende dalla libreria di base Play
1.7.2. (aosp/1282257)
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
DynamicExtrasnon utilizza più un pattern builder e ora può essere creata direttamente. (aosp/1253671) DynamicActivityNavigatorora accetta unContextnel suo costruttore anziché unActivity. (aosp/1250252)
Correzioni di bug
NavigationUInon ignora più le etichette vuote (ovvero una destinazione conandroid: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
DrawerLayoutconcreta,AppBarConfigurationora utilizza l'interfacciaOpenableintrodotta in CustomView1.1.0-alpha02(cheDrawerLayoutimplementa a partire da DrawerLayout1.1.0-alpha04), consentendoti di utilizzare implementazioni personalizzate diOpenableconNavigationUI. (b/129030452)
Correzioni di bug
- Le regole ProGuard di
navigation-common-ktxora mantengono correttamente solo le classiNavArgsutilizzate anziché tutte le istanzeNavArgs. (b/150213558)
Modifiche alle dipendenze
- Navigation ha ripristinato la sua dipendenza da Core
1.2.0e ora dipende da Core1.1.0per evitare di costringere gli sviluppatori a passare a una dipendenza più recente quando Navigation non dipende da nuove API in Core1.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à
NavBackStackEntryora ti consente di accedere a unSavedStateHandleadatto 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()egetPreviousBackStackEntry()per semplificare il recupero di unNavBackStackEntryper le destinazioni corrente e precedente. (b/79672220)
Correzioni di bug
navigateUp()ora passa gli argomenti della destinazione corrente eKEY_DEEP_LINK_INTENTalla destinazione precedente quando avvii l'app nel tuo stack di attività. (b/147456890)
Modifiche alle dipendenze
- La navigazione ora dipende da Core
1.2.0.
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-testingfornisce una classeTestNavHostController. Questa classe fornisce un'alternativa all'utilizzo di unNavControllerfittizio 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 dinavigation-uiperDrawerArrowDrawablesono state aggiornate per garantire cheandroid.enableJetifier=truenon sia obbligatorio. (b/147610424) - Da Navigazione
2.2.1: il modulonavigation-common-ktxora ha un nome del pacchetto manifest univoco anziché condividere lo stesso nome del pacchetto manifest dinavigation-runtime-ktx. (aosp/1141947)
Aggiornamenti delle dipendenze
- Da Navigation
2.2.1: Navigation2.2.1ora dipende da Lifecycle ViewModel SavedState2.2.0e Fragment1.2.1.
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
IllegalStateExceptiondurante il deep linking alla destinazione iniziale del grafico quando sono presenti più istanze diNavHostFragmentnell'attività. (b/147378752) NavigationUInon ignora più le etichette vuote (ovvero una destinazione conandroid: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-ktxora mantengono correttamente solo le classiNavArgsutilizzate anziché tutte le istanzeNavArgs. Questa funzionalità è stata rilasciata in precedenza in Navigation 2.3.0-alpha03. (b/150213558
Aggiornamenti delle dipendenze
- La navigazione ora dipende da Fragment
1.2.4. (aosp/1277325)
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-uiperDrawerArrowDrawablesono state aggiornate per garantire cheandroid.enableJetifier=truenon sia obbligatorio. (b/147610424) - Il modulo
navigation-common-ktxora ha un nome del pacchetto manifest univoco anziché condividere lo stesso nome del pacchetto manifest dinavigation-runtime-ktx. (aosp/1141947)
Aggiornamenti delle dipendenze
- Navigation
2.2.1ora dipende da Lifecycle ViewModel SavedState2.2.0e Fragment1.2.1.
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'oggettoNavBackStackEntryrestituito fornisce unLifecycleOwnerbasato sulla navigazione,ViewModelStoreOwner(lo stesso restituito daNavController.getViewModelStoreOwner()) eSavedStateRegistryOwner, 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 utilizzaby navGraphViewModels()o il costruttoreViewModelProvidercon unViewModelStoreOwnerrestituito daNavController.getBackStackEntry()oNavController.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:
NavHostFragmentora utilizzaFragmentContainerViewdi 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-uiin modo che corrispondano alle animazioni di dissolvenza modificate in Fragment1.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) NavHostFragmentora ripristina correttamente il grafico dopo una modifica della configurazione se utilizzato conFragmentContainerView. (b/143752103)
Modifiche alle dipendenze
- La navigazione ora dipende da Lifecycle
2.2.0-rc03, Lifecycle ViewModel SavedState1.0.0-rc03, Activity1.1.0-rc03e Fragment1.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à
NavDestinatione le relative sottoclassi ora eseguono l'override ditoString()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()suActivityora ha un messaggio di errore migliore quando non sono presenti extra. (b/141408999) - Le classi Java
Directionsgenerate da Safe Args ora contengono valori predefiniti. (b/141099045) - Le classi Java
Argsgenerate da Safe Args ora contengono valori predefiniti. (b/140123727) - Quando utilizzi un
Toolbar,NavigationUInon 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 asetGraphora genera unIllegalStateException. Questo valore deve essere sempre impostato daNavHostnell'ambito della configurazione iniziale per garantire che tutte le istanzeNavBackStackEntryabbiano uno spazio di archiviazione coerente per le istanzeViewModel. (aosp/1111821)
Correzioni di bug
- Risolto un problema di
ConcurrentModificationExceptiondurante l'utilizzo di istanzeViewModelassociate a più istanzeViewModelStorecon 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'oggettoNavBackStackEntryrestituito fornisce unLifecycleOwnerbasato sulla navigazione,ViewModelStoreOwner(lo stesso restituito daNavController.getViewModelStoreOwner()) eSavedStateRegistryOwner, 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
NavHostFragmentaViewPager2non riusciva con unIllegalArgumentException. (b/133640271) NavInflaterora evita di chiamaregetResourceName()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 usaby navGraphViewModels()o il costruttoreViewModelProvidercon unViewModelStoreOwnerrestituito daNavController.getViewModelStoreOwner(). (b/135716331)
Modifiche alle API
- Da Navigazione
2.1.0-rc01: l'APIgetViewModelStore()deprecata suNavControllerintrodotta in2.1.0-alpha02è stata rimossa. (aosp/1091021)
Correzioni di bug
NavHostFragmentora utilizzaFragmentContainerView, 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-ktxo l'APIgetViewModelStoreOwner()aggiunta aNavController. 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 unDialogFragmentquandonavigate.NavHostFragmentsupporta le destinazioni di dialogo per impostazione predefinita. Per saperne di più, consulta Crea una destinazione da un DialogFragment. - Navigazione tramite URI: ora puoi
navigateutilizzando unUri, 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
NavHostpersonalizzato sono state spostate inNavHostController, consentendo alle implementazioni di connettere il proprioNavControllerall'hostingLifecycleOwner,OnBackPressedDispatchereViewModelStore.
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 suNavControllerintrodotta in2.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à
NavigationUIora anima la rimozione del pulsante Su quando utilizzisetupWithNavController()con unToolbaro unCollapsingToolbarLayout. (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:navGraphutilizzato da NavHostFragment è stato spostato nell'artefattonavigation-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()suNavControllerè stata ritirata a favore del nuovo metodogetViewModelStoreOwner()che restituisce unViewModelStoreOwner. (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 destinazioniFloatingWindow. (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
NavControllersono state rinominate e spostate in una nuova sottoclasse diNavController,NavHostController. (aosp/966091) - Il metodo
setHostOnBackPressedDispatcherOwner()diNavControllerè stato sostituito con il metodosetOnBackPressedDispatcher()diNavHostControllere ora richiede di chiamaresetLifecycleOwner()prima di chiamarlo. (aosp/965409) NavHostControllerora contiene un metodoenableOnBackPressed(boolean)che sostituisce la classeNavHostOnBackPressedManagerrestituita in precedenza dasetHostOnBackPressedDispatcherOwner(). (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
NavHostFragmentrispetta correttamenteapp:defaultNavHostquando intercetta gli eventi del pulsante Indietro del sistema, correggendo una regressione in Navigation2.1.0-alpha03. b/132077777DialogFragmentNavigatorora gestisce correttamente le operazionipopBackStack()enavigateUp(). b/132576764- Risolto un problema di
IllegalStateException: unknown destination during restoredurante 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 unDialogFragmentquandonavigate.NavHostFragmentsupporta le destinazioni delle finestre di dialogo per impostazione predefinita. b/80267254 - Oltre a chiamare
navigatecon un ID risorsa o un'istanzaNavDirections, ora puoi navigare tramite unUri, 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()diNavHostFragmentè stato ritirato e la sua funzionalità è stata spostata nel nuovo metodoonCreateNavController()per chiarire che questo è l'entry point corretto per l'aggiunta di navigatori personalizzati durante la sottoclasse diNavHostFragment. b/122802849 - È stato aggiunto un metodo
hasDeepLink()aNavDestinationper consentirti di verificare se un determinatoUripuò essere gestito da quella destinazione o, nel caso di unNavGraph, da qualsiasi destinazione nel grafico di navigazione. b/117437718
Correzioni di bug
- Gli argomenti predefiniti ora vengono passati correttamente alle istanze
OnDestinationChangedListener. b/130630686 NavHostFragmentora intercetta gli eventi Indietro di sistema utilizzandoOnBackPressedDispatcher, 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 unapp:argTypenon specificato viene ora dedotto correttamente come argomentostring. 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'APIgetViewModelStore()aggiunta aNavController. b/111614463
Modifiche alle API
- Ora puoi aggiungere un
app:targetPackagea una destinazione<activity>per limitare il nome del pacchetto corrispondente. Supportaapp:targetPackage="${applicationId}"per limitare il pacchetto al tuo ID applicazione. b/110975456
Correzioni di bug
- L'attributo
android:nameper 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.1eandroidx.fragment:fragment:1.1.0-alpha05. Questa release rimuove anche la dipendenza daandroidx.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 utilizzaFragmentFactoryper creare un'istanza di Fragment. b/119054429
Correzioni di bug
- La navigazione non invia più un
Bundlenull quando sono presenti argomenti associati a una destinazione, risolvendo un problema durante l'utilizzo diandroid: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 senzaFLAG_ACTIVITY_NEW_TASKb/126082008- Risolto un problema per cui
ActivityNavigator.applyPopAnimationsToPendingTransitionnon 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
inefunnel nome del pacchetto associato alla classeR. 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
singleTopb/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
0comeandroid:defaultValueper gli argomentireference. 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()enavigateUpora restituiscono correttamentefalsequando viene estratta l'ultima destinazione nel back stack, correggendo una regressione introdotta in1.0.0-beta01. b/123933201- La navigazione ora imposta correttamente
ClassLoaderdurante il ripristino dello stato dell'istanza salvata, evitando problemi quando si utilizzano classi personalizzate nello stato salvato diNavigatoro negli argomenti inviati a unNavDestination. 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 unapp:argTypediverso 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
FragmentNavigatorsi desincronizzava con lo stato diNavController, causando unIllegalStateExceptiondurante il tentativo di ripristinare il back stack. b/123803044 - È stato risolto un problema per cui la freccia Indietro gestita da
NavigationUInon 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:argTypeche 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 classeNavArgsgenerata da Safe Args in unActivityoFragment. 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-inandroidx.navigation.safeargsprecedente. 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 unNavControllerora reimposta il back stack. b/111450672 - I deep link sconosciuti non generano più un
IllegalStateException, ma vengono ignorati, risolvendo i problemi relativi aNavHostFragmentnidificati o multipli. b/121340440
Modifiche che provocano un errore
- Il metodo
NavOptions.applyPopAnimationsToPendingTransition()per applicare animazioni pop a un'attività è stato spostato inActivityNavigator. 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
NavDirectionsgenerate 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
Bundlerestituito dagetArguments()diNavDirectionsè ora contrassegnato come@NonNullanziché@Nullable. b/123243957
Correzioni di bug
NavDeepLinkBuilderora gestisce correttamente piùPendingIntentsimultanei alla stessa destinazione utilizzando gli argomenti che passi per determinare l'unicità. b/120042732NavControllerora gestisce correttamente le operazionipopBackStack()quando utilizza unNavHostFragmentnidificato o altri frammenti secondari con un back stack. b/122770335NavigationUIora 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
NavDirectionsgenerate da Safe Args ora hanno correttamente valorihashCode()uguali quandoequals()restituisce true. b/123043662 FragmentNavigatorora genera un messaggio di errore migliore se tenti di eseguireFragmentTransactionspersonalizzato suFragmentManagerdiNavHostFragment. Devi sempre utilizzaregetChildFragmentManager(). 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
MenuItemconmenuCategory="secondary"non mostreranno più il back stack quando vengono utilizzati con i metodiNavigationUI. b/120104424 AppBarConfigurationora ti consente di impostare un'istanzaOnNavigateUpListenerdi riserva che verrà chiamata quandonavController.navigateUp()restituiscefalse. b/79993862 b/120690961
Modifiche che provocano un errore
- Quando utilizzi un
<argument>con unargType="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 metodisetup. AggiungimenuCategory="secondary"al tuoMenuItemper evitare di eseguire il pop del back stack. aosp/852869- I metodi
fromBundle()delle classiArgsgenerate ora accettano unBundlenon null anziché unBundlenullable aosp/845616
Correzioni di bug
- Gli argomenti vengono ora analizzati correttamente dai deep link come
argTypecorretti 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 tuoandroid:labelcon 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 inOnDestinationChangedListenerb/118670572OnDestinationChangedListenerora passa anche ilBundledi argomenti aosp/837142- Gli attributi
app:clearTaskeapp:launchDocumente i relativi metodi associati sono stati rimossi. Utilizzaapp:popUpTocon la radice del grafico per rimuovere tutte le destinazioni dal back stack. b/119628354 ActivityNavigator.Extrasora utilizza un patternBuildere aggiunge la possibilità di impostare qualsiasi flagIntent.FLAG_ACTIVITY_aosp/828140NavController.onHandleDeepLinkè stato rinominato inhandleDeepLinkaosp/836063- Molte classi e metodi non destinati alla sottoclasse, come
NavOptions,NavInflater,NavDeepLinkBuildereAppBarConfiguration, sono stati resifinalaosp/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 unFragmentFactory. b/119054429 - Il costruttore per
NavGraphNavigatornon accetta più unContextaosp/835340 - NavigatorProvider ora è una classe, non un'interfaccia. La funzionalità di
NavigatorProviderrestituita dagetNavigatorProvider()non è cambiata. aosp/830660 - La risorsa
NavDestination.navigate()è stata rimossa. Chiama invecenavigate()suNavigator. aosp/830663 - Rifattorizzazione significativa di
Navigator, che elimina la necessità diOnNavigatorNavigatedListenere fa sì chenavigaterestituisca l'elementoNavDestinationa cui è stata eseguita la navigazione. - Le istanze
Navigatornon possono più inviare eventi pop aNavController. Valuta la possibilità di utilizzare unOnBackPressedCallbackper intercettare le pressioni del pulsante Indietro e chiamarenavController.popBackStack(). aosp/833716
Correzioni di bug
popUpToora funziona in modo coerente quando la destinazione è un elemento<navigation>b/116831650- È stato corretto un numero di bug che generavano un
IllegalArgumentExceptionquando si utilizzavano grafici nidificati b/118713731 b/113611083 b/113346925 b/113305559 - L'attributo
dataPatterndelle destinazioni<activity>ora compila gli argomenti da argomenti non di tipo String chiamandotoString()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
@Overridedove appropriato b/117145301
Versione 1.0.0-alpha07
29 ottobre 2018
Nuove funzionalità
- Una nuova classe AppBarConfiguration ti consente di personalizzare le destinazioni considerate di primo livello. Per maggiori dettagli, consulta la documentazione aggiornata. b/117333663
- Ora puoi passare argomenti alla destinazione iniziale del grafico b/110300470
- I deep link ora supportano schemi personalizzati con punti, trattini e segni più. b/112806402
Modifiche che provocano un errore
- Il modulo
navigation-testing-ktxè stato integrato innavigation-testing artifacte non verrà più pubblicato. - L'artefatto
navigation-testingora 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à
- Ora sono supportate le transizioni di elementi condivisi per le destinazioni Fragment e Activity b/79665225. Per saperne di più, consulta Implementa la navigazione con il componente di architettura di navigazione.
- La selezione di un elemento in
NavigationViewora chiuderà qualsiasi riquadro inferiore contenente b/112158843
Modifiche alle API
- Modifica che provoca un errore: il metodo Navigator
navigate()ora accetta un parametroNavigator.Extras. - Il metodo
getGraph()di NavController ora èNonNullb/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 inapp:argTypeper 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
NonNullnon sono effettivamente nulli b/111451769 - Sono state aggiunte ulteriori annotazioni
NonNullalle 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.indexdiventeràsetDemoControllerIndexb/79995048 - Ad esempio,
action_show_settingsdiventeràactionShowSettingsb/79642240
- Ad esempio,
- 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()ehashCode()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
setPopUpTocon la prima destinazione nel grafico b/109909461 - Risolto il problema per cui tutti i valori
app:defaultValuevenivano 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:namenei 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
FragmentNavigatorora utilizzasetReorderingAllowed(true). b/109826220La navigazione ora esegue la decodifica URL degli argomenti analizzati dagli URL dei deep link. b/79982454
Correzioni di bug
È stata corretta un'
IllegalStateExceptiondurante la chiamata di navigazione dai metodi del ciclo di vita di Fragment. b/79632233La navigazione ora dipende dalla Support Library 27.1.1 per correggere lo sfarfallio durante l'utilizzo delle animazioni. b/80160903
Risolto un problema di
IllegalArgumentExceptionquando si utilizza defaultNavHost="true" come frammento secondario. b/79656847È stato corretto un
StackOverflowErrorquando si utilizza NavDeepLinkBuilder. b/109653065È stato corretto un
IllegalArgumentExceptiondurante la navigazione verso un grafico nidificato. b/80453447È stato risolto un problema relativo alla sovrapposizione dei frammenti quando si utilizza
launchSingleTop. b/79407969Navigation 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
clearTaskper le azioni e l'API associata inNavOptionssono stati ritirati. b/80338878L'attributo
launchDocumentper le azioni e l'API associata inNavOptionssono 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.