Navigation
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
| Letzte Aktualisierung | Stabile Release | Releasekandidat | Beta-Release | Alpha-Release |
|---|---|---|---|---|
| 23. September 2026 | 2.10.2 | - | - | - |
Abhängigkeiten deklarieren
Für eine Abhängigkeit von Navigation musst du deinem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Google-Repository bei Maven.
Fügen Sie die Abhängigkeiten für die benötigten Artefakte in der Datei build.gradle für Ihre App oder Ihr Modul hinzu:
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
Wenn Sie Safe Args in Ihr Projekt einfügen möchten, fügen Sie die folgende classpath in Ihre build.gradle-Datei auf oberster Ebene ein:
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") } }
Außerdem müssen Sie eines von zwei verfügbaren Plug-ins anwenden.
Wenn Sie Java-Sprachcode generieren möchten, der für Java- oder gemischte Java- und Kotlin-Module geeignet ist, fügen Sie diese Zeile in die build.gradle-Datei Ihrer App oder Ihres Moduls ein:
Groovy
plugins { id 'androidx.navigation.safeargs' }
Kotlin
plugins { id("androidx.navigation.safeargs") }
Wenn Sie stattdessen Kotlin-Code generieren möchten, der für reine Kotlin-Module geeignet ist, fügen Sie Folgendes hinzu:
Groovy
plugins { id 'androidx.navigation.safeargs.kotlin' }
Kotlin
plugins { id("androidx.navigation.safeargs.kotlin") }
Gemäß Zu AndroidX migrieren muss android.useAndroidX=true in Ihrer gradle.properties-Datei vorhanden sein.
Informationen zur Verwendung von Kotlin-Erweiterungen finden Sie in der KTX-Dokumentation.
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Navigation Version 2.10
Version 2.10.2
23. September 2026
androidx.navigation:navigation-*:2.10.2 ist veröffentlicht. Version 2.10.2 enthält diese Commits.
Abhängigkeitsupdates
androidx.lifecycle-Abhängigkeiten wurden auf Version 2.10.0 aktualisiert. I4505a9f9a
Version 2.10.1
9. September 2026
androidx.navigation:navigation-*:2.10.1 ist veröffentlicht. Version 2.10.1 enthält diese Commits.
Fehlerkorrekturen
- Wenn
NavHostAnimationen überspringt, wird jetzt auchsizeTransformals Teil der übersprungenen Animation berücksichtigt, um unerwartetes Clipping zu verhindern. (I4f995, b/550924680)
Version 2.10.0
26. August 2026
androidx.navigation:navigation-*:2.10.0 ist veröffentlicht. Version 2.10.0 enthält diese Commits.
Wichtige Änderungen seit 2.9.0:
NavHostbietet jetzt eine Überladung, die die ParameterpredictivePopEnterTransitionundpredictivePopExitTransitionakzeptiert, um einen benutzerdefinierten Übergang während der intelligenten „Zurück“-Touchgeste zu ermöglichen.handleDeepLinkwurde so geändert, dass nur erkannte Deeplinks verarbeitet und alle anderen ignoriert werden. Wenn dies zu einem Fehler in Ihrer App führt, sollten Sie die Navigation über Deeplinks in Betracht ziehen, die in Ihrem Navigationsdiagramm definiert sind. Für Robolectric-Tests müssen Sie möglicherweise die MethodesetPackagefür ein vertrauenswürdiges Paket verwenden.NavBackStackEntryInfowurde hinzugefügt, um Back-Stack-Snapshots während Navigationsereignissen verfügbar zu machen. So können umfangreichere benutzerdefinierte Animationen für die intelligente „Zurück“-Geste erstellt werden.
Unterstützung weiterer Plattformen
- Die Module
navigation-common,navigation-runtimeundnavigation-testingunterstützen jetztdesktop,linux,macOS,iOS,javascript,WASM,watchosundtvos.
Version 2.10.0-rc01
12. August 2026
androidx.navigation:navigation-*:2.10.0-rc01 ist veröffentlicht. Version 2.10.0-rc01 enthält diese Commits.
Verhaltensänderungen
- Das für die Navigation erforderliche Mindest-SDK wurde zusammen mit den anderen AndroidX-Bibliotheken auf API 24 verschoben. (I972da, b/474169350)
Version 2.10.0-beta01
29. Juli 2026
androidx.navigation:navigation-*:2.10.0-beta01 ist veröffentlicht. Version 2.10.0-beta01 enthält diese Commits.
API-Änderungen
NavBackStackEntryInfowurde eingeführt, um Back-Stack-Snapshots während Navigationsereignissen verfügbar zu machen. Dadurch werden umfangreichere benutzerdefinierte Animationen für die intelligente „Zurück“-Geste ermöglicht. (Icb3b8)
Version 2.10.0-alpha06
1. Juli 2026
androidx.navigation:navigation-*:2.10.0-alpha06 ist veröffentlicht. Version 2.10.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
handleDeepLinkwurde so geändert, dass nur erkannte Deeplinks verarbeitet werden (Id4fe3, b/509640056)ComposableFragmentwurde geändert, um den vollständig qualifizierten Namen des Ziels anstelle eines Fragmentarguments zum Aufblähen von zusammensetzbaren Funktionen zu verwenden. (I65ded, b/509640586)- Ein Absturz in
FragmentNavigatorwurde behoben, der dazu führte, dass legitime Fragmente eineIllegalArgumentExceptionauslösten, wenn Vorgänge optimiert wurden. (I093b0, b/340202276) - Ein Fehler in der Navigation mit Fragmenten wurde behoben, bei dem das programmatische Festlegen des Graphen nicht ordnungsgemäß wiederhergestellt wurde. (I41251, b/321147435)
Version 2.10.0-alpha05
19. Mai 2026
androidx.navigation:navigation-*:2.10.0-alpha05 ist veröffentlicht. Version 2.10.0-alpha05 enthält diese Commits.
Version 2.10.0-alpha04
6. Mai 2026
androidx.navigation:navigation-*:2.10.0-alpha04 ist veröffentlicht. Version 2.10.0-alpha04 enthält diese Commits.
Fehlerkorrekturen
- Verbesserte
NavHost, um möglicheNullPointerExceptions zu verhindern, die durch eine Race-Bedingung mit der intelligenten „Zurück“-Geste verursacht werden. (Ie36c6, b/500945998)
Version 2.10.0-alpha03
22. April 2026
androidx.navigation:navigation-*:2.10.0-alpha03 ist veröffentlicht. Version 2.10.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Compose
compileSdkwurde auf API 37 aktualisiert. Das bedeutet, dass bei der Verwendung von Compose mindestens die AGP-Version 9.2.0 erforderlich ist. (Id45cd, b/413674743)
Externer Beitrag
watchos- undtvos-Ziele zu den Modulennavigation-common,navigation-runtimeundnavigation-testinghinzugefügt (I60e46)DefaultNavTransitionsöffentlich machen (Ide293)
Version 2.10.0-alpha02
25. März 2026
androidx.navigation:navigation-*:2.10.0-alpha02 ist veröffentlicht. Version 2.10.0-alpha02 enthält diese Commits.
Version 2.10.0-alpha01
11. März 2026
androidx.navigation:navigation-*:2.10.0-alpha01 ist veröffentlicht. Version 2.10.0-alpha01 enthält diese Commits.
Neue Funktionen
NavHostbietet jetzt eine Überladung, die die ParameterpredictivePopEnterTransitionundpredictivePopExitTransitionakzeptiert, um einen benutzerdefinierten Übergang während der intelligenten „Zurück“-Touchgeste zu ermöglichen. (Iac9b0, b/478294569)
Aktualisierung der Mindest-SDK-Version
- Die Standard-minSdk wurde zusammen mit den anderen AndroidX-Bibliotheken von API 21 auf API 23 geändert. (Ibdfca, b/380448311, b/435705964, b/435705223)
Externer Beitrag
navigation:navigation-common,navigation:navigation-runtimeundnavigation:navigation-testingunterstützen jetzt neben Android auch Desktop, Linux, macOS, iOS, JavaScript und WASM. Vielen Dank an Konstantin Tskhovrebov! (I035d9, Iec624, I1615d)
Version 2.9
Version 2.9.8
22. April 2026
androidx.navigation:navigation-*:2.9.8 ist veröffentlicht. Version 2.9.8 enthält diese Commits.
Fehlerkorrekturen
- Verbesserte
NavHost, um möglicheNullPointerExceptions zu verhindern, die durch eine Race-Bedingung mit der intelligenten „Zurück“-Geste verursacht werden. (Ie36c6, b/500945998)
Version 2.9.7
28. Januar 2026
androidx.navigation:navigation-*:2.9.7 ist veröffentlicht. Version 2.9.7 enthält diese Commits.
Fehlerkorrekturen
- Bei der Navigation
SafeArgstreten keine Probleme mehr mit dem Konfigurations-Caching auf, wenn sie mit Google-Diensten verwendet wird. (I57cda, b/458071608) - Der Konstruktor
SavedStateHandlein „navigation-testing“ decodiertList<String>jetzt. (I26aac,b/454180135)
Version 2.9.6
5. November 2025
androidx.navigation:navigation-*:2.9.6 ist veröffentlicht. Version 2.9.6 enthält diese Commits.
Fehlerkorrekturen
- Das Navigations-Plug-in
SafeArgswurde zu den modernen Android-Gradle-Plug-in-APIs migriert, um die Kompatibilität mit allen AGP-Releases ab Version 8.4.2 zu gewährleisten. Aufgrund dieser Änderungen wurde das Ausgabeverzeichnis für vom Plug-in generierte Dateien in den von AGP bereitgestellten Standardspeicherort geändert. (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197) - Für das Navigations-Plug-in
SafeArgsmuss die PropertyuseAndroidXnicht mehr festgelegt werden, wenn es mit AGP 9.0.0-alpha04 oder höher verwendet wird. (I6c3a4, b/444746731, b/443106400)
Version 2.9.5
24. September 2025
androidx.navigation:navigation-*:2.9.5 ist veröffentlicht. Version 2.9.5 enthält diese Commits.
Fehlerkorrekturen
- Navigation Safe Args kann jetzt die Unterstützung von AGP 9.0 für integriertes Kotlin verarbeiten. (I1d9d76)
Abhängigkeitsupdate
- Das Navigation Safe Args-Plug-in hängt jetzt vom Android-Gradle-Plug-in in Version 8.4.2 ab. (b/431847270, I5932a)
Version 2.9.4
10. September 2025
androidx.navigation:navigation-*:2.9.4 ist veröffentlicht. Version 2.9.4 enthält diese Commits.
Fehlerkorrekturen
- Absturz verhindern, wenn ein Ereignis für die intelligente „Zurück“-Geste während des Renderns eines Frames übermittelt wird, nachdem der Handler in einem
NavHost-Übergang deaktiviert wurde. (I5667c, b/384186542)
Version 2.9.3
30. Juli 2025
androidx.navigation:navigation-*:2.9.3 ist veröffentlicht. Version 2.9.3 enthält diese Commits.
Fehlerkorrekturen
- In
NavControllerwurde ein Fehler behoben, der bei Verwendung vonOnDestinationChangedListenerszu einemConcurrentModificationExceptionführte. (If7406, b/417784831) - Ein Fehler bei der Verwendung von
navigate(uri, navOptions,navigationExtras), bei dem die Extras ignoriert wurden, wurde behoben. (I67fb7, b/430336813)
Version 2.9.2
16. Juli 2025
androidx.navigation:navigation-*:2.9.2 ist veröffentlicht. Version 2.9.2 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der Eintrag nicht fortgesetzt wurde, wenn das Dialogfeld über dem Eintrag geschlossen wurde (Idb20e, b/418746335).
- Der Fehler
MissingFieldExceptionbeim Testen vonSavedStateHandlemit typsicheren Routen bei Verwendung von benutzerdefiniertenNavTypeswurde behoben. (I2f843, b/421002511)
Version 2.9.1
2. Juli 2025
androidx.navigation:navigation-*:2.9.1 ist veröffentlicht. Version 2.9.1 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, durch das
NavEntries, die mit „singleTop“ instanziiert wurden, in ihremLifecycle.Statenie über CREATED hinausgingen. (I043ba, b/421095236)
Version 2.9.0
7. Mai 2025
androidx.navigation:navigation-*:2.9.0 ist veröffentlicht. Version 2.9.0 enthält diese Commits.
Wichtige Änderungen seit Version 2.8.0
- Navigation Safe Args-Aktionen werden jetzt mit der Annotation
@CheckResultgeneriert, um sicherzustellen, dass sie verwendet werden.
SupportingPane-Schnittstelle
- Benutzerdefinierte Navigatoren können ihre Ziele jetzt so kennzeichnen, dass sie die
SupportingPane-Schnittstelle implementieren. Dadurch wird demNavControllersignalisiert, dass diese Ziele zusammen mit anderen Zielen angezeigt werden. Über diese Schnittstelle können beispielsweise mehrere Ziele gleichzeitigRESUMEDwerden.
Compose Kotlin Multiplatform
- Die Navigation bietet jetzt eine neue allgemeine
NavController.handleDeepLink()-Funktion, die einNavDeepLinkRequestanstelle einesIntentverwendet. So können auch andere Plattformen als Android Deeplinks richtig verarbeiten. Vielen Dank, Konstantin Tskhovrebov! - Die Navigation bietet jetzt
NavUri, eine neue allgemeine Parser-Funktion, die eine kompatible API für den URI von Android auf anderen Plattformen ist. So kann ein URI plattformunabhängig erstellt werden. Vielen Dank, Konstantin Tskhovrebov!
Typsichere Funktionen
- Die typsicheren APIs, die zuvor nur über
reified-Methoden zugänglich waren, d.h.composable<YourScreen>hat jetzt nicht reifizierte Versionen, die direkt eineKClass-Instanz verwenden. - Die Typsicherheit für die Navigation unterstützt jetzt Wertklassen als Route oder als Argumenttyp einer Route.
Version 2.9.0-rc01
23. April 2025
androidx.navigation:navigation-*:2.9.0-rc01 ist veröffentlicht. Version 2.9.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Alle Nicht-Android-Plattformziele wurden aus Jetpack Navigation entfernt, da diese Ziele nicht funktionieren. Stattdessen werden jetzt Stubs für verschiedene Plattformen bereitgestellt.(I2877d)
Version 2.9.0-beta01
09. April 2025
androidx.navigation:navigation-*:2.9.0-beta01 ist veröffentlicht. Version 2.9.0-beta01 enthält diese Commits.
API-Änderungen
- Die allgemeine API von
parseStringAsNavUriwurde in eineNavUri-Factory-Funktion geändert, die einen String akzeptiert. (I4db6e, b/403616316)
Abhängigkeitsupdates
- Diese Bibliothek ist jetzt auf die Kotlin 2.0-Sprachebene ausgerichtet und erfordert KGP 2.0.0 oder höher. (Idb6b5)
Version 2.9.0-alpha09
26. März 2025
androidx.navigation:navigation-*:2.9.0-alpha09 ist veröffentlicht. Version 2.9.0-alpha09 enthält diese Commits.
Neue Funktionen
- Das
navigation-testing-Modul unterstützt jetzt neben Android auch Desktop, Linux, macOS und iOS. (I2b770, b/398265336) NavTypewird jetzt neben Android auch auf Computern, Linux, macOS und iOS unterstützt. (I297d8)
Version 2.9.0-alpha08
12. März 2025
androidx.navigation:navigation-*:2.9.0-alpha08 ist veröffentlicht. Version 2.9.0-alpha08 enthält diese Commits.
Fehlerkorrekturen
- Aus Navigation
2.8.9: Es wurde eine Regression in Navigation 2.8.8 behoben, bei der ein Deeplink genau mit allen Feldern einer Deeplink-Anfrage oder eines Deeplink-Intents übereinstimmen musste, um als Übereinstimmung zu gelten. Dies führte dazu, dass Deeplinks, die teilweise Feldübereinstimmungen enthielten und keine anderen hatten, nicht mehr funktionierten. (Ie5e36, b/399826566)
Externer Beitrag
- Neue allgemeine Parserfunktion zum Erstellen eines
NavUri. Vielen Dank, Konstantin Tskhovrebov! (If0a6a)
Version 2.9.0-alpha07
26. Februar 2025
androidx.navigation:navigation-*:2.9.0-alpha07 ist veröffentlicht. Version 2.9.0-alpha07 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der Versuch,
saveStatemit nicht inklusivem Pop auszuführen, zu einem Null-savedState führte, was beim Wiederherstellen zu einem Absturz führen konnte. (I9f3e8, b/395091644) - Ab Navigation 2.8.8: Der
NavDeepLink-Abgleich wurde korrigiert, sodass ein Deeplink und eine Deeplink-Anfrage genau in URI, Aktion und MIME übereinstimmen müssen. Ein Abgleich ist nicht mehr zulässig, wenn nur ein oder zwei Felder übereinstimmen. (I3b029, b/395712033) - Ab Navigation 2.8.8: Ein Fehler wurde behoben, bei dem Routen mit Platzhalterpfaden nicht mit einem hinzugefügten Deeplink übereinstimmten (I7ea92, b/389970341).
Externer Beitrag
- Extrahieren Sie die APIs „navigation-common“, „navigation-runtime“ und „navigation-compose“ auf die gemeinsame Plattform. Vielen Dank, Konstantin Tskhovrebov! (I1e626, Ica76f, Idf479)
Bekannte Probleme
- Aufgrund der Arbeiten zur Behebung von b/395712033 müssen Deeplinks fälschlicherweise dieselben Felder wie die Deeplink-Anfrage und/oder die
Intententhalten. Deeplinks müssen nur mit den Feldern übereinstimmen, die sie enthalten. Nicht enthaltene Felder sollten ignoriert werden. Dieses Problem wurde für eine spätere Version im Rahmen von b/399826566 behoben.
Version 2.9.0-alpha06
12. Februar 2025
androidx.navigation:navigation-*:2.9.0-alpha06 ist veröffentlicht. Version 2.9.0-alpha06 enthält diese Commits.
Neue Funktionen
- Navigation Safe Args-Aktionen werden jetzt mit der Annotation
@CheckResultgeneriert, um sicherzustellen, dass sie verwendet werden. (I14d4c, b/356323084)
Fehlerkorrekturen
- In
NavControllerwurde ein Fehler behoben, bei dem fälschlicherweise versucht wurde, die backStack-Zustände in einem Array wiederherzustellen, obwohl sie in einer Liste gespeichert waren. (Idfb9b) - Aus Navigation
2.8.7: Navigation Safe Args unterstützt jetzt zusammensetzbare Ziele. (I35320, b/362791955)
Version 2.9.0-alpha05
29. Januar 2025
androidx.navigation:navigation-*:2.9.0-alpha05 ist veröffentlicht. Version 2.9.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem wurde behoben, das bei Verwendung von Navigation Compose zu einer unerwarteten Skalierungsanimation führte. (I480f4, b/353294030)
- Ab Navigation
2.8.6: Über XML bereitgestellteNavDestination-Labels werden überNavType.getgeparst, damit die benutzerdefinierteNavType-Logik berücksichtigt wird. (I7ec2f, b/388100796) - Über Navigation
2.8.6: Wenn Sie mitdataPatternzu einer Aktivität navigieren, versuchtActivityNavigatorjetzt, den Argumentwert mit demNavTypedes Arguments zu codieren. (I16376, b/383616432) - Aus Navigation
2.8.5: Es wurde ein Problem behoben, das bei Verwendung von Navigation Compose und dem Aufruf von „navigate“ im selben Frame, in dem die aktuelle Animation endet, zu einer unerwarteten Skalierungsanimation führte. (I26cb1, b/353294030)
Version 2.9.0-alpha04
11. Dezember 2024
androidx.navigation:navigation-*:2.9.0-alpha04 ist veröffentlicht. Version 2.9.0-alpha04 enthält diese Commits.
Neue Funktionen
- Die typsicheren APIs, die zuvor nur über
reified-Methoden zugänglich waren, d.h.composable<YourScreen>haben jetzt nicht reifizierte Versionen, die direkt eineKClass-Instanz annehmen.(Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808)
In der folgenden Tabelle sind die reifizierten und KClass-APIs aufgeführt.
| 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) |
API-Änderungen
- Die Kotlin-spezifische
NavGraph.setStartDestination-Überladung für Typsicherheit wird vor Java-Quellen verborgen. (Ic640c, b/364634035)
Fehlerkorrekturen
- Aus Navigation
2.8.5: Es wurde ein Problem behoben, bei demNavHosteine Ausnahme innerhalb vonPredictiveBackHandlerauslösen konnte, wenn der Back Stack auf einen Eintrag reduziert und im selben Frame ein System-Back ausgelöst wurde. (I1a429, b/375343407) - Aus Navigation
2.8.5:NavDestinationNullPointerExceptionbeim Aktualisieren desstartDestinationeines Diagramms behoben. (I99421, b/361560785)
Externer Beitrag
- Aus Navigation
2.8.5: Die Typsicherheit der Navigation unterstützt jetztList<Enum>als Argumenttyp einer Route, ohne dass ein benutzerdefiniertesNavTypeerforderlich ist. Vielen Dank, Csaba Kozák! (GH-725, b/375559962)
Version 2.9.0-alpha03
13. November 2024
androidx.navigation:navigation-*:2.9.0-alpha03 ist veröffentlicht. Version 2.9.0-alpha03 enthält diese Commits.
Neue Funktionen
- Die Typsicherheit für die Navigation unterstützt jetzt Wertklassen als Route oder als Argumenttyp einer Route. (I9344a, b/374347483)
Fehlerkorrekturen
- Ein
ConcurrentModificationExceptionwurde behoben, der auftreten konnte, wenn ein an einNavBackStackEntryangehängtesLifecycleObservereine Änderung am Back Stack auslöste, wenn der Host-LifecycleOwner, z. B. die enthaltende Aktivität oder das enthaltende Fragment, seinen Lebenszyklusstatus änderte. (Ia9494)
Version 2.9.0-alpha02
30. Oktober 2024
androidx.navigation:navigation-*:2.9.0-alpha02 ist veröffentlicht. Version 2.9.0-alpha02 enthält diese Commits.
Externer Beitrag
- Neue allgemeine
NavController.handleDeepLink(request: NavDeepLinkRequest)-Methode. Vielen Dank, Konstantin Tskhovrebov! (I3e228)
Version 2.9.0-alpha01
16. Oktober 2024
androidx.navigation:navigation-*:2.9.0-alpha01 ist veröffentlicht. Version 2.9.0-alpha01 enthält diese Commits.
Neue Funktionen
- Benutzerdefinierte Navigatoren können ihre Ziele jetzt so kennzeichnen, dass sie die
SupportingPane-Schnittstelle implementieren. Dadurch wird demNavControllersignalisiert, dass diese Ziele zusammen mit anderen Zielen angezeigt werden. Über diese Schnittstelle können beispielsweise mehrere Ziele gleichzeitigRESUMEDwerden. (Id5559) - Aus Navigation
2.8.3: Es wurden neue Lint-Prüfungen für die Modulenavigation-common,navigation-runtimeundnavigation-composehinzugefügt, um typsichere Routen zu identifizieren, die nicht korrekt mit@Serializableannotiert sind. Diese Prüfung wird auf alleNavGraphBuilder- undNavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Aus Navigation
2.8.3: Es wurden neue Lint-Prüfungen für die Modulenavigation-common,navigation-runtimeundnavigation-composehinzugefügt, um typsichere Routen mit Enum-Argumenten zu identifizieren, die nicht korrekt mit@Keepannotiert sind. Diese Prüfung wird auf alleNavGraphBuilder- undNavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
Geändertes Verhalten
- Wenn Sie versuchen, einen
NavControllerzu verwenden, der zuvorDESTROYEDwurde, wird jetzt einIllegalStateExceptionausgelöst. (I520da, b/369616172)
Fehlerkorrekturen
- Die Ausnahme „Enum-Klasse nicht gefunden“ wurde aktualisiert, um die Verwendung der Annotation
@Keepvorzuschlagen, falls die Enum-Klasse in minimierten Builds gelöscht wird. (I90e79, b/358137294)
Bekannte Probleme
- Es gibt ein Problem mit den neuen Lint-Regeln, die in
Navigation 2.8.*hinzugefügt wurden. Dadurch wird einObsolete custom lint check-Fehler verursacht, wenn versucht wird, Lint mit dem Android-Gradle-Plug-in 8.4 oder höher auszuführen. (b/368070326, b/371463741)
Version 2.8
Version 2.8.9
12. März 2025
androidx.navigation:navigation-*:2.8.9 ist veröffentlicht. Version 2.8.9 enthält diese Commits.
Fehlerkorrekturen
- Es wurde eine Regression in Navigation 2.8.8 behoben, bei der ein Deeplink genau mit allen Feldern einer Deeplink-Anfrage oder eines Deeplink-Intents übereinstimmen musste, um als Übereinstimmung zu gelten. Dies führte dazu, dass Deeplinks, die teilweise Feldübereinstimmungen enthielten und keine anderen hatten, nicht mehr funktionierten. (Ie5e36, b/399826566)
Version 2.8.8
26. Februar 2025
androidx.navigation:navigation-*:2.8.8 ist veröffentlicht. Version 2.8.8 enthält diese Commits.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem Routen mit Platzhalterpfaden nicht mit einem hinzugefügten Deeplink übereinstimmten. (I7ea92, b/389970341)
- Der Abgleich von
NavDeepLinkwurde korrigiert. Deeplinks und Deeplink-Anfragen müssen jetzt genau in URI, Aktion und MIME übereinstimmen. Ein Abgleich ist nicht mehr zulässig, wenn nur ein oder zwei Felder übereinstimmen. (I3227f, b/395712033)
Bekannte Probleme
- Aufgrund der Arbeiten zur Behebung von b/395712033 müssen Deeplinks fälschlicherweise dieselben Felder wie die Deeplink-Anfrage und/oder die
Intententhalten. Deeplinks müssen nur mit den Feldern übereinstimmen, die sie enthalten. Nicht enthaltene Felder sollten ignoriert werden. Dieses Problem wurde für eine spätere Version im Rahmen von b/399826566 behoben.
Version 2.8.7
12. Februar 2025
androidx.navigation:navigation-*:2.8.7 ist veröffentlicht. Version 2.8.7 enthält diese Commits.
Fehlerkorrekturen
- Navigation Safe Args unterstützt jetzt zusammensetzbare Ziele. (I35320, b/362791955)
Version 2.8.6
29. Januar 2025
androidx.navigation:navigation-*:2.8.6 ist veröffentlicht. Version 2.8.6 enthält diese Commits.
Fehlerkorrekturen
NavDestination-Labels, die über XML bereitgestellt werden, werden überNavType.getgeparst, damit die benutzerdefinierteNavType-Logik berücksichtigt wird. (Id366d, b/388100796)- Wenn du mit
dataPatternzu einer Aktivität navigierst, versuchtActivityNavigatorjetzt, den Argumentwert mit demNavTypedes Arguments zu codieren. (I1a71d, b/383616432)
Version 2.8.5
11. Dezember 2024
androidx.navigation:navigation-*:2.8.5 ist veröffentlicht. Version 2.8.5 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem
NavHosteine Ausnahme innerhalb vonPredictiveBackHandlerauslösen konnte, wenn der Back Stack auf einen Eintrag reduziert und im selben Frame ein System-Back ausgelöst wurde. (I1a429, b/375343407) NavDestinationNullPointerExceptionbeim Aktualisieren desstartDestinationeines Diagramms wurde behoben. (I99421, b/361560785)- Es wurde ein Problem behoben, das bei Verwendung von Navigation Compose und dem Aufruf von „navigate“ im selben Frame, in dem die aktuelle Animation endet, zu einer unerwarteten Skalierungsanimation führte. (I26cb1, b/353294030)
- Ein
ConcurrentModificationExceptionwurde behoben, der auftreten konnte, wenn ein an einNavBackStackEntryangehängtesLifecycleObservereine Änderung am Back Stack auslöste, wenn der Host-LifecycleOwner, z. B. die enthaltende Aktivität oder das enthaltende Fragment, seinen Lebenszyklusstatus änderte. (Ia9494)
Externer Beitrag
- Die Typsicherheit für die Navigation unterstützt jetzt
List<Enum>als Argumenttyp einer Route, ohne dass ein benutzerdefinierterNavTypeerforderlich ist. Vielen Dank, Csaba Kozák! (GH-725, b/375559962)
Version 2.8.4
13. November 2024
androidx.navigation:navigation-*:2.8.4 ist veröffentlicht. Version 2.8.4 enthält diese Commits.
Neue Funktionen
- Aus Navigation
2.9.0-alpha03: Die Typsicherheit der Navigation unterstützt jetzt Wertklassen als Route oder als Argumenttyp einer Route (I9344a, b/374347483).
Fehlerkorrekturen
- Aus Navigation
2.9.0-alpha01: Der Versuch, einNavControllerzu verwenden, das zuvorDESTROYEDwurde, führt jetzt zu einemIllegalStateException. (I520da, b/369616172)
Version 2.8.3
16. Oktober 2024
androidx.navigation:navigation-*:2.8.3 ist veröffentlicht. Version 2.8.3 enthält diese Commits.
Neue Funktionen
- Es wurden neue Lint-Prüfungen für die Module
navigation-common,navigation-runtimeundnavigation-composehinzugefügt, um typsichere Routen zu identifizieren, die nicht korrekt mit@Serializableannotiert sind. Diese Prüfung wird auf alleNavGraphBuilder- undNavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Es wurden neue Lint-Prüfungen für die Module
navigation-common,navigation-runtimeundnavigation-composehinzugefügt, um typsichere Routen mit Enum-Argumenten zu identifizieren, die nicht korrekt mit@Keepannotiert sind. Diese Prüfung wird auf alleNavGraphBuilder- undNavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem die neuen Lint-Regeln, die in
Navigation 2.8.*hinzugefügt wurden, einenObsolete custom lint check-Fehler verursachten, wenn versucht wurde, Lint mit dem Android-Gradle-Plug-in 8.4 oder höher auszuführen. (I1be3d, b/368070326, b/371463741)
Bekannte Probleme
- Bei der Navigation-Lint-Prüfung wird ein Fehler vom Typ „Veraltete benutzerdefinierte Lint-Prüfung“ ausgegeben, wenn versucht wird, Lint mit Lint 16 (AGP 8.7) oder höher auszuführen. (b/371926651)
Version 2.8.2
2. Oktober 2024
androidx.navigation:navigation-*:2.8.2 ist veröffentlicht. Version 2.8.2 enthält diese Commits.
Neue Funktionen
- Die Typsicherheit für die Navigation unterstützt jetzt serialisierbare Klassen, die
Double,Double?,DoubleArray,DoubleArray?,List<Double>undList<Double>?enthalten, ohne dass ein benutzerdefinierterNavTypeerforderlich ist. (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)
Fehlerkorrekturen
- Die Fehlermeldung, die angezeigt wird, wenn die Navigation das Argument einer Route nicht einem
NavTypezuordnen kann, wurde verbessert. Die neue Fehlermeldung enthält den Argumentnamen, den vollständig qualifizierten Namen des Arguments und den vollständig qualifizierten Namen der Route. (Id8416, b/346264232)
Version 2.8.1
18. September 2024
androidx.navigation:navigation-*:2.8.1 ist veröffentlicht. Version 2.8.1 enthält diese Commits.
Neue Funktionen
- Es wurde eine neue Lint-Regel hinzugefügt, um die Verwendung der Funktion
popBackStackzu erzwingen, die einen reifizierten Klassentyp verwendet, wenn versucht wird, mit typsicheren APIs zupopBackStack. (Ief161, b/358095343)
Fehlerkorrekturen
- Für die Navigation muss die Route, die an die
startDestinationeinesNavGraphübergeben wird, jetzt die Werte für alle erforderlichen Argumente enthalten. Dazu gehören auch Argumente, die nicht nullfähig sind und keinen Standardwert haben. (I18e74, b/362594265) - Navigation Safe Args unterstützt jetzt nicht-nullable Strings, sodass „null“-Werte unverändert geparst und im Bundle gespeichert werden. Dies weicht vom bisherigen Verhalten ab, bei dem „null“-Werte in ein Null-Objekt geparst wurden. Diese Änderung gilt nur für nicht-nullable String-Typen. Nullable-Strings bleiben unverändert. (I08b4a, b/348936238)
- Ein Deeplink zu einer
NavDestinationist nur noch über einen Deeplink möglich, der explizit zum Ziel hinzugefügt wurde. Das bedeutet auch, dass Sie nur mit der Überladung der Funktion „navigate“ zu einer Route eines Ziels navigieren können, die eine Stringroute verwendet. Dadurch wird eine Sicherheitslücke behoben, die es ermöglichte, einen Deeplink zu einem potenziell geschützten Ziel zu erstellen. (Ie30e6)
Abhängigkeitsupdate
- Navigation Safe Args hängt jetzt von Kotlin 1.9.24 und nicht mehr von Kotlin 2.X ab. Entwickler müssen also kein Update durchführen. (a4129a)
- Navigation Compose hängt jetzt von Compose
1.7.2ab.
Version 2.8.0
4. September 2024
androidx.navigation:navigation-*:2.8.0 ist veröffentlicht. Version 2.8.0 enthält diese Commits.
Wichtige Änderungen seit 2.7.0
Typsicherheit in der Navigation Kotlin DSL
- Die Navigation bietet jetzt Typsicherheit für die Kotlin-DSL (von Navigation Compose verwendet) mithilfe der Kotlin-Serialisierung. So können Sie Ziele in Ihrem Navigationsgraphen über typsichere Objekte und Datenklassen definieren:
// 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)
}
}
Weitere Informationen finden Sie im Blogpost Navigation Compose meet Typsicherheit.
Intelligente „Zurück“-Geste in Navigation Compose
- Navigation Compose unterstützt jetzt die intelligente „Zurück“-Geste in der App über die neuen
SeekableTransitionStateAPIs von compose-animation. So können Sie mit der „Zurück“-Geste das vorherige Ziel mit Ihrem benutzerdefinierten Übergang sehen, bevor Sie sich entscheiden, die Transaktion über die abgeschlossene Geste zu bestätigen oder abzubrechen.
Navigation Fragment Composable
- Es wurde ein neues
navigation-fragment-compose-Artefakt hinzugefügt, das eineComposableNavHostFragment-Alternative zuNavHostFragmententhält. Damit können Sie Ihren Navigations-XML-Dateien zusammensetzbare Ziele hinzufügen. Jedescomposable-Ziel muss als@Composable-Methode auf oberster Ebene ohne Argumente ausgedrückt werden, deren voll qualifizierter Name alsandroid:name-Attribut für jedes Ziel verwendet wird. Wenn Sie zu einem dieser Ziele navigieren, wird ein Containerfragment erstellt, um den zusammensetzbaren Inhalt anzuzeigen.
// 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" />
Weitere Änderungen
- Navigation Compose hängt jetzt von Compose 1.7.0 ab.
- Die Navigation bietet jetzt eine neue
CollectionNavType<T>-Klasse, eine Unterklasse vonNavType<T>für sammlungsbasierte Argumente wie Listen, Arrays und Maps. Alle standardmäßigenNavType-Arrays (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeundStringArrayType) übernehmen jetzt diese neue Klasse. NavTypebietet jetzt integrierte Unterstützung für Listen mit Ganzzahlen, Strings, booleschen Werten, Gleitkommazahlen und Long-Werten.
Version 2.8.0-rc01
21. August 2024
androidx.navigation:navigation-*:2.8.0-rc01 ist veröffentlicht. Version 2.8.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Ein Absturz der Navigation wurde behoben, der auftrat, wenn Enum-Klassen der obersten Ebene als typsichere Argumente übergeben wurden. (I0ba76, b/358137294)
- Navigation 2.8 funktioniert jetzt korrekt mit SDK 34 und wird erst mit der Version 2.9 zusammen mit den anderen AndroidX-Bibliotheken auf SDK 35 umgestellt. (b/358798728)
Version 2.8.0-beta07
7. August 2024
androidx.navigation:navigation-*:2.8.0-beta07 ist veröffentlicht. Version 2.8.0-beta07 enthält diese Commits.
Bekannte Probleme
- Aufgrund von b/358137294 werden nur Enums unterstützt, die in einer anderen Klasse verschachtelt sind. Enums auf oberster Ebene werden in der nächsten Version unterstützt.
Fehlerkorrekturen
- Wenn Sie zu doppelten oder gemeinsamen Zielen navigieren, wird das nächstgelegene übereinstimmende Ziel vom aktuellen Standort im Diagramm priorisiert. (Ic89a4, b/352006850)
- Die Navigation in Safe Args wurde um ein neues
NavType.EnumTypeerweitert. Das bedeutet, dass fürEnum-Typen keine benutzerdefiniertenNavTypes mehr erforderlich sind. Beachten Sie, dass derSerialNamedesEnumder standardmäßige vollständig qualifizierte Name sein muss. (I66d22, b/346475493) - Die Navigation in Safe Args bietet jetzt integrierte Unterstützung für Argumenttypen, die Nullwerte zulassen, einschließlich
Int?,Long?,Float?,Boolean?undEnum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237) - Die
startDestinationderNavGraphverwenden jetzt die Standardargumentwerte, wenn die an dieNavGraphübergebenestartDestination-Route genau mit derstartDestination.routeübereinstimmt. (I13762, b/354046047)
Version 2.8.0-beta06
24. Juli 2024
androidx.navigation:navigation-*:2.8.0-beta06 ist veröffentlicht. Version 2.8.0-beta06 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem die Lint-Prüfungen von
WrongStartDestinationTypenicht nach Companion-Objekten im übergebenen Klassentyp gesucht haben, sodass Lint den Fehler nicht erkannt hat. (I92b09)
Version 2.8.0-beta05
10. Juli 2024
androidx.navigation:navigation-*:2.8.0-beta05 ist veröffentlicht. Version 2.8.0-beta05 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem die
singleTop-Navigation abstürzte, wenn verschachtelteNavGraphsdieselbestartDestination-Route hatten. (I17b94, b/294408596)
Version 2.8.0-beta04
26. Juni 2024
androidx.navigation:navigation-*:2.8.0-beta04 ist veröffentlicht. Version 2.8.0-beta04 enthält diese Commits.
Fehlerkorrekturen
- Die Navigation unterstützt jetzt die Navigation mit leeren Strings in Pfadargumenten. (Ic5dbd, b/339481310)
- Die Fehlermeldung für benutzerdefinierte Serializer, die direkt in Klassenfeldern über
@Serializable(with =...)deklariert werden, wurde verbessert, um klarzustellen, dass diese Funktion derzeit nicht unterstützt wird. (I052b0, b/341319151) - Die
SavedStateHandleFactory-Test-API kann jetzt in Nicht-Android-Tests verwendet werden. Dazu muss Robolectric jedoch das Parsen von Argumenten mit Bundles unterstützen. (I76cdc, b/340966212) - Ein Absturz wurde behoben, der beim Wiederherstellen des Zustands auftrat, wenn die App nach einer Prozessbeendigung mit typsicherer Navigation in Compose fortgesetzt wurde. (Ia8f38, b/341801005)
- In Navigation Compose wurde ein Problem behoben, bei dem nach dem Abbrechen der intelligenten „Zurück“-Touchgeste das
NavBackStackEntry, zu dem der Nutzer zurückkehrt, nie wieder in den LebenszyklusstatusRESUMEDzurückkehrt. Außerdem wird so dafür gesorgt, dass das zurückkehrende Ziel korrekt zurückanimiert wird, anstatt nach einem Wischen an die richtige Stelle zu springen. (I97a0c, b/346608857) - Wenn Sie die intelligente „Zurück“-Geste mit Navigation Compose verwenden, hat das Ziel, das entfernt wird, jetzt die richtige Z-Reihenfolge und wird korrekt über dem eingehenden Ziel animiert. (I2077b, b/345993681)
Version 2.8.0-beta03
12. Juni 2024
androidx.navigation:navigation-*:2.8.0-beta03 ist veröffentlicht. Version 2.8.0-beta03 enthält diese Commits.
API-Änderungen
CollectionNavTypehat eine neue abstrakteemptyCollection()-Methode. Überschreiben Sie dies, um eine leere Sammlung zu verarbeiten, die als Argument übergeben wird. (Ie4d84, b/341723133)
Fehlerkorrekturen
- Dokumentation zu
NavType.serializeAsValueundserializeAsValueshinzugefügt, um hervorzuheben, dass die endgültigen Ausgaben URI-codiert sein sollten. (Ida6bd, b/344943214) - Es wurde ein Absturz behoben, der beim Aufrufen von
toRoute<T>mit einem Null-CollectionNavType-Argument auftrat. Wenn Sie mit einem Null-CollectionNavTypenavigieren, ist das Ausgabeargument der Standardwert, der in Ihrer serialisierbaren Klasse deklariert ist, oder der Rückgabewert vonemptyCollection(), wenn kein Standardwert vorhanden ist. (I84158, Id630f, b/342672856)
Version 2.8.0-beta02
29. Mai 2024
androidx.navigation:navigation-*:2.8.0-beta02 ist veröffentlicht. Version 2.8.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Ein Absturz von
ClassCastExceptionbei Verwendung vonNavBackStackEntry.toRoutemit einem benutzerdefiniertenNavType, das null sein kann, wurde behoben. (I1c29b, b/342239473) - Es wurden Probleme bei der Wiederherstellung des Back-Stack-Status der Navigation behoben, die beim Versuch auftraten, einen Back-Stack-Eintrag wiederherzustellen, der nicht über die ID vom aktuellen Ziel aus erreichbar ist. Da Routen auf IDs basieren, waren auch Ziele betroffen, die mit Routen erstellt wurden. Außerdem wird ein Absturz behoben, der durch den Aufruf von
clearBackStack()verursacht wurde und auf dasselbe Problem zurückzuführen war. (I423c3, b/339908057)
Version 2.8.0-beta01
14. Mai 2024
androidx.navigation:navigation-*:2.8.0-beta01 ist veröffentlicht. Version 2.8.0-beta01 enthält diese Commits.
API-Änderungen
SavedStateHandle.toRoute()akzeptiert jetzt den ParametertypeMapfür benutzerdefinierte Argumenttypen. (Ie39fb, b/339026523)navigation-testingwurde eine Test-API hinzugefügt, um einSavedStateHandleaus einem serialisierbaren Kotlin-Objekt zu erstellen. (Id4867, b/339080702)
Fehlerkorrekturen
- Fehlende Parameterdokumente für Kotlin DSL-Funktionen für die Navigation wurden hinzugefügt. (I26a36)
Version 2.8.0-alpha08
1. Mai 2024
androidx.navigation:navigation-*:2.8.0-alpha08 ist veröffentlicht. Version 2.8.0-alpha08 enthält diese Commits.
Safe Args in Navigation Compose
- Die Arbeit zur Unterstützung der Typsicherheit zur Kompilierzeit für Navigation Compose und Nutzer der Navigation Kotlin DSL auf Basis der Kotlin-Serialisierung ist abgeschlossen und die zuvor experimentellen APIs sind jetzt stabil. (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
Diese Funktion verwendet die Kotlin-Serialisierung, damit Sie Ziele in Ihrem Navigationsgraphen über typsichere Objekte und Datenklassen definieren können:
// 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)
}
}
Weitere Informationen finden Sie im Blogpost Navigation Compose meet Typsicherheit.
Neue Funktionen
- Das Artefakt
navigation-fragment-composebietet jetzt einLocalFragment-CompositionLocal für zusammensetzbare Methoden innerhalb einesComposableFragment. (If35e5) NavTypebietet jetzt integrierte Unterstützung für Listen mit Ganzzahlen, Strings, booleschen Werten, Gleitkommazahlen und Long-Werten. (I4b6dd, Ia914c, b/188693139)
Version 2.8.0-alpha07
17. April 2024
androidx.navigation:navigation-*:2.8.0-alpha07 ist veröffentlicht. Version 2.8.0-alpha07 enthält diese Commits.
Neue Funktionen
Fügt ein neues
navigation-fragment-compose-Artefakt hinzu, das eineComposableNavHostFragment-Alternative zuNavHostFragmententhält, mit der Sie Ihren Navigations-XML-Dateiencomposable-Ziele hinzufügen können. Jedescomposable-Ziel muss als@Composable-Methode auf oberster Ebene ohne Argumente ausgedrückt werden, deren voll qualifizierter Name alsandroid:name-Attribut für jedes Ziel verwendet wird. Wenn Sie zu einem dieser Ziele navigieren, wird ein Containerfragment erstellt, um den zusammensetzbaren Inhalt anzuzeigen. (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" />
API-Änderungen
- Die Unterstützung für Safe Args in Navigation Compose wurde mit einem Ansatz auf Basis der Kotlin-Serialisierung fortgesetzt. Diese APIs sind nicht fertig und mit der Annotation
ExperimentalSafeArgsApigekennzeichnet. Diese Annotation wird entfernt, wenn die gesamte API-Oberfläche in einer zukünftigen Version vollständig ist. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)
Version 2.8.0-alpha06
3. April 2024
androidx.navigation:navigation-*:2.8.0-alpha06 ist veröffentlicht. Version 2.8.0-alpha06 enthält diese Commits.
API-Änderungen
- Die Unterstützung für Safe Args in Navigation Compose mit einem Ansatz, der auf der Kotlin-Serialisierung basiert, hat begonnen. Diese APIs sind nicht fertig und mit der Annotation
ExperimentalSafeArgsApigekennzeichnet. Diese Annotation wird entfernt, wenn die gesamte API-Oberfläche in einer zukünftigen Version vollständig ist. (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
Fehlerkorrekturen
NavHostverwendet jetztAlignment.TopStartals Standardargument für „contentAlignment“. Dies entspricht der Standardeinstellung fürAnimatedContentund behebt einige Fälle von unerwarteten Übergängen bei der Skalierung von der Mitte aus. (I09e72, b/330111602)- Wenn die intelligente „Zurück“-Touchgeste bei Verwendung von Navigation Compose ausgeführt wird, schließt
NavHostden benutzerdefinierten Übergang jetzt korrekt ab, anstatt ihn sofort zu beenden. (I99017, b/327292110)
Version 2.8.0-alpha05
20. März 2024
androidx.navigation:navigation-*:2.8.0-alpha05 ist veröffentlicht. Version 2.8.0-alpha05 enthält diese Commits.
Neue Funktionen
- Sie können jetzt Argumente direkt in der
startDestination-Route an diestartDestinationvonNavGraphübergeben, ohnedefaultValuezu verwenden. Dies gilt auch für verschachtelteNavGraph-startDestinations. (I0e0b5, b/109505019, b/188693139)
API-Änderungen
- Neue abstrakte Klasse
CollectionNavType<T>hinzugefügt, eine Unterklasse vonNavType<T>für sammlungsbasierte Argumente wie Listen, Arrays und Maps. (Ic6d63, b/188693139) - Alle standardmäßigen
NavType-Arrays (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeundStringArrayType) sind jetzt vom TypCollectionNavType(Idcf79, b/188693139) NavTypebietet jetzt eine neue offenevalueEquals-API, mit der ermittelt werden kann, ob zwei Werte desselben Typs gleich sind. (I6cb97, b/327229511)
Fehlerkorrekturen
- Suchparameter in Deeplinks können jetzt Werte in Form von geschweiften Klammern um den Argumentnamen (z.B.
{argName}) als gültige Werte für stringbasierteNavTypesenthalten. Dadurch wird ein Problem behoben, bei dem ein solcher Wert für alle Typen als ungültig (oder als fehlender Wert) betrachtet wurde. (I18302, b/327274038) NavController-Funktionen, die Routen wienavigateoderpopBackStackunterstützen, können jetzt Routen mit Argumenten des ArraysNavTypeskorrekt abgleichen. (Iea805, b/327229511)
Version 2.8.0-alpha04
6. März 2024
androidx.navigation:navigation-*:2.8.0-alpha04 ist veröffentlicht. Version 2.8.0-alpha04 enthält diese Commits.
Neue Funktionen
- Sie können jetzt die
SizeTranformfür Ihre Übergänge in Navigation Compose angeben, indem Sie sie als Teil der Initialisierung für die Funktionencomposableund/odernavigationdefinieren. (I91062, b/296912651)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem
NavHostin Compose Navigation den Übergang nicht richtig anzeigte, wenn „Zurück“ ohne Geste verwendet wurde. (Iceeae, b/325998468)
Version 2.8.0-alpha03
21. Februar 2024
androidx.navigation:navigation-*:2.8.0-alpha03 ist veröffentlicht. Version 2.8.0-alpha03 enthält diese Commits.
API-Änderungen
NavBackStackEntry.savedStateHandleist jetzt als@MainThreadgekennzeichnet, da Code verwendet wird, der ohnehin im Hauptthread ausgeführt werden muss. (Ibb988, b/299523245)
Fehlerkorrekturen
- In der Navigation wurde ein Problem behoben, das dazu führte, dass
NavGraph-ViewModels zu frühDESTROYEDwurden, weil dieViewModeldes zugehörigen Eintrags nicht Teil des gespeicherten Status war. (Ib6bb7, b/317581849)
Abhängigkeitsupdate
- Navigation Compose hängt jetzt von Compose 1.7.0-alpha03 ab.
Version 2.8.0-alpha02
7. Februar 2024
androidx.navigation:navigation-*:2.8.0-alpha02 ist veröffentlicht. Version 2.8.0-alpha02 enthält diese Commits.
Neue Funktionen
- Navigation Compose unterstützt jetzt die intelligente „Zurück“-Geste in der App über die neuen
SeekableTransitionStateAPIs von compose-animation. So können Sie mit der „Zurück“-Geste das vorherige Ziel mit Ihrem benutzerdefinierten Übergang sehen, bevor Sie sich entscheiden, die Transaktion über die abgeschlossene Geste zu bestätigen oder abzubrechen. (I8b8e9)
Version 2.8.0-alpha01
24. Januar 2024
androidx.navigation:navigation-*:2.8.0-alpha01 ist veröffentlicht. Version 2.8.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Ein
BackStackState-Leck wurde behoben, bei dem mehreresaveState-Aufrufe für ein Ziel dazu führten, dass mehrere Zustände gespeichert wurden, aber nur der erste wiederhergestellt werden konnte. (I598b0, b/309559751) - Es wurde ein Problem behoben, bei dem Argumente, die keine Strings sind, nicht richtig angezeigt wurden, wenn die
NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet wurden. (#636, b/316676794)
Abhängigkeitsupdate
- Navigation Compose hängt jetzt von Compose
1.7.0-alpha01ab. Dadurch wurde ein Problem behoben, das zu einer unerwarteten Skalierungsanimation führen konnte. (b/297258205)
Externer Beitrag
- Vielen Dank an SimonMarquis für die Behebung des Anzeigeproblems bei Nicht-String-Argumenten, wenn die
NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet werden.
Version 2.7.7
Version 2.7.7
7. Februar 2024
androidx.navigation:navigation-*:2.7.7 ist veröffentlicht. Version 2.7.7 enthält diese Commits.
Fehlerkorrekturen
- Backport aus Navigation
2.8.0-alpha01: Es wurde einBackStackState-Leck behoben, bei dem mehreresaveState()-Aufrufe für eine einzelneNavBackStackEntrydazu führten, dass mehrere Zustände gespeichert wurden, aber nur der erste gespeicherte Zustand wiederhergestellt werden konnte. (I598b0, b/309559751) - Backport aus Navigation
2.8.0-alpha01: Es wurde ein Problem behoben, bei dem Argumente, die keine Strings sind, nicht richtig angezeigt wurden, wenn dieNavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet wurden. (#636, b/316676794)
Externer Beitrag
- Vielen Dank an SimonMarquis für die Behebung des Anzeigeproblems bei Nicht-String-Argumenten, wenn die
NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet werden.
Version 2.7.6
Version 2.7.6
13. Dezember 2023
androidx.navigation:navigation-*:2.7.6 ist veröffentlicht. Version 2.7.6 enthält diese Commits.
Fehlerkorrekturen
- Die Funktion
NavGraphequals()berücksichtigt jetzt die Knoten des anderen Diagramms und nicht nur die des aufrufenden Diagramms. Dadurch wird sichergestellt, dass Graphen mit Knoten, die unterschiedliche IDs haben, nicht mehr als gleich betrachtet werden (I401cb, b/311414915).
Version 2.7.5
Version 2.7.5
1. November 2023
androidx.navigation:navigation-*:2.7.5 ist veröffentlicht. Version 2.7.5 enthält diese Commits.
Leistungsverbesserungen
- Die Leistung (sowohl in Bezug auf die Zeit als auch auf die Anzahl der Zuweisungen) beim Vergleichen von zwei Diagrammen wurde erheblich verbessert. Das bedeutet, dass Aufrufe wie
setGraph, die den neuen Graphen intern mit dem vorhandenen vergleichen, viel schneller sind und zu weniger übersprungenen Frames führen. Vielen Dank an Michał Z für die gründliche Analyse, die zu dieser Verbesserung geführt hat. (I6ad62) NavHostrendert jetzt das Startziel im ersten Durchlauf der Zusammensetzung, anstatt auf den zweiten Durchlauf warten zu müssen, um den aktualisierten Status zu lesen. (I439a7, b/304852206)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem der Back Stack entfernt wurde, wenn Sie
setGraphmehrmals mit genau demselben Graphen aufgerufen haben, aber nur, wenn es im Graphen ein Ziel gab, das einen Aktionslink enthielt, der zwei Ziele verknüpfte. (Ieaed7) - Dialogfelder, die schnell nacheinander aufgerufen und geschlossen wurden, werden nicht mehr in die Liste der
NavController.visibleEntriesaufgenommen. (I67586, b/287969970) - Wenn ein Eintrag entfernt wird und danach eine Konfigurationsänderung erfolgt, wird der
ViewModeldes Eintrags jetzt ordnungsgemäß gelöscht, wennsaveState„false“ ist. (Idf242, b/298164648) - Es wurde ein Problem behoben, bei dem
NavControllerdenselben Deeplink mehrmals verarbeiten konnte, wenn der Back Stack vor einer Konfigurationsänderung oder einem Aufruf vonsetGraphvollständig leer war, aber nur, wenn für den eingehenden Intent das FlagFLAG_ACTIVITY_NEW_TASKgesetzt war. (I73c7f)
Abhängigkeitsupdates
- Die Navigation mit Fragmenten hängt jetzt von Fragment 1.6.2 ab. Dadurch wurde ein Problem behoben, bei dem die
ViewModel-Instanzen verschachtelter Fragmente beim Aufrufen vonclearBackStacknicht gelöscht wurden.
Version 2.7.4
Version 2.7.4
4. Oktober 2023
androidx.navigation:navigation-*:2.7.4 ist veröffentlicht. Version 2.7.4 enthält diese Commits.
Neue Funktionen
- Unterstützung für
popUpTohinzugefügt, um Routen mit Argumenten zu verwenden, damit zu einem bestimmten Eintrag zurückgekehrt werden kann, der genau diese Argumente verwendet. Dies entspricht der Unterstützung inpopBackStack. (I731f4, b/299255572)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem das Unterbrechen einer Navigation mit einer anderen Navigation mit
popUpTozum Absturz vonFragmentNavigatorführte. (I3c848, b/301887045) - Es wurde ein Problem behoben, bei dem durch Drücken der Zurück-Taste des Systems die
currentDestinationnicht korrekt aktualisiert wurde, um dem angezeigten Fragment zu entsprechen. (Id0d6c, b/289877514) - Der Lebenszyklus von
DialogFragmentwechselt jetzt ordnungsgemäß in den StatusRESUMED, wenn das Dialogfeld darüber geschlossen wird. (I88f0d, b/301811387)
Version 2.7.3
Version 2.7.3
20. September 2023
androidx.navigation:navigation-*:2.7.3 ist veröffentlicht. Version 2.7.3 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem in der Navigation mit Fragmenten wurde behoben, durch das die Liste
visibleEntriesfalsche Einträge enthielt. (I5caa9, b/288520638) - Es wurde ein Problem behoben, durch das das Ziel des schwebenden Fensters (z. B.
Dialogs,Bottomsheetsusw.) nie einenRESUMED-Lebenszyklus-Callback erhalten hat. (I3b866, b/287505132)
Version 2.7.2
Version 2.7.2
6. September 2023
androidx.navigation:navigation-*:2.7.2 ist veröffentlicht. Version 2.7.2 enthält diese Commits.
Fehlerkorrekturen
- Die Navigation hängt jetzt von Lifecycle
2.6.2ab. Dadurch wird ein Problem bei der Interaktion zwischenrememberSaveableundNavHostvon Navigation Compose behoben, das dazu führte, dass derrememberSaveable-Status von Zielen und alle zuViewModelgehörendenSavedStateHandle-Instanzen nach einer Prozessbeendigung und Neuerstellung nicht ordnungsgemäß wiederhergestellt wurden. (b/298059596, b/289436035) - Es wurde ein Problem behoben, bei dem beim gleichzeitigen Anzeigen mehrerer Dialogfelder in Navigation Compose die teilweise verdeckten Dialogfelder (z.B. nicht das oberste Dialogfeld) im Lebenszyklusstatus
CREATEDstatt im StatusSTARTEDwaren. (aosp/2728520, b/289257213) - Es wurde ein Problem behoben, das auftrat, wenn mehrere Dialogfelder gleichzeitig in Navigation Compose angezeigt wurden. Wenn das oberste Dialogfeld geschlossen wurde, blieb das neue oberste Dialogfeld im Lebenszyklusstatus
STARTEDhängen, anstatt korrekt zuRESUMEDzu wechseln. (aosp/2629401, b/286371387) - Navigation Safe Args instanziiert seine Aufgabe nicht mehr sofort, wenn sie nicht tatsächlich ausgeführt wird. (I0e385, b/260322841)
Abhängigkeitsupdate
- Navigation Compose hängt jetzt von Compose 1.5.1 ab.
Version 2.7.1
Version 2.7.1
23. August 2023
androidx.navigation:navigation-*:2.7.1 ist veröffentlicht. Version 2.7.1 enthält diese Commits.
Fehlerkorrekturen
- In der Navigation mit Compose wurde ein Problem behoben, bei dem bei Verwendung eines
Scaffoldein Fehler beim Zugriff auf einLifecycle.State.DESTROYEDViewModelauftreten konnte. (I1dc11, b/268422136)
Version 2.7.0
Version 2.7.0
9. August 2023
androidx.navigation:navigation-*:2.7.0 ist veröffentlicht. Version 2.7.0 enthält diese Commits.
Wichtige Änderungen seit Version 2.6.0
Animationen von Accompanist
Da AnimatedContent jetzt stabil ist, konnten wir den Code aus Accompanist Navigation Animation wieder in Navigation Compose verschieben.
Das bedeutet, dass die gesamte Unterstützung für das Festlegen benutzerdefinierter Übergänge, die in AnimatedNavHost vorhanden war, direkt in NavHost unterstützt wird.
An Accompanist Navigation Animation werden keine weiteren Änderungen vorgenommen und die Funktion wird bald offiziell eingestellt. Es wird dann auch eine Anleitung zur Migration zurück zu Navigation Compose geben. Diese wird der Migrationsanleitung entsprechen, nur in umgekehrter Reihenfolge. Wenn Sie bereits die neueste Accompanist-Alphaversion (0.31.2-alpha) verwenden, sind keine weiteren API-Änderungen erforderlich. (b/197140101)
Fehlerkorrekturen
- NavHost in Navigation Compose fängt jetzt Systemaufrufe zum Zurückgehen korrekt ab, auch nachdem die Aktivität GESTOPPT und FORTGESETZT wurde. (Icb6de, b/279118447)
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Compose
1.5.0ab, vorher von1.1.0.
Version 2.7.0-rc01
26. Juli 2023
androidx.navigation:navigation-*:2.7.0-rc01 ist veröffentlicht. Version 2.7.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem die Lambdas
EnterTransitionundExitTransition, die als Teil vonNavHosterstellt wurden, möglicherweise auch nach dem Entfernen vonNavHostaus der Komposition im Speicher verbleiben konnten. (I893d0)
Bekannte Probleme
- In Navigation 2.6.x gibt es ein Problem, bei dem die Navigation mit „popUpTo“ zu einer
IllegalArgumentExceptionführen kann. Möglicherweise lässt sich diese Ausnahme vermeiden, wenn Sie Ihren Graphen umstrukturieren, ähnlich wie hier vorgeschlagen. (b/287133013)
Version 2.7.0-beta02
28. Juni 2023
androidx.navigation:navigation-*:2.7.0-beta02 ist veröffentlicht. Version 2.7.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Navigation Compose hat jetzt die richtige Z-Reihenfolge für benutzerdefinierte Übergänge, die die Navigation mit der Option
popUpToverwenden.(/Ib1c3a, b/285153947)
Version 2.7.0-beta01
7. Juni 2023
androidx.navigation:navigation-*:2.7.0-beta01 ist veröffentlicht. Version 2.7.0-beta01 enthält diese Commits.
Fehlerkorrekturen
NavHostin Navigation Compose fängt jetzt Systemaufrufe zum Zurückgehen korrekt ab, auch nachdemActivitySTOPPEDundRESUMEDwurde. (Icb6de, b/279118447)
Version 2.7.0-alpha01
24. Mai 2023
androidx.navigation:navigation-*:2.7.0-alpha01 ist veröffentlicht. Version 2.7.0-alpha01 enthält diese Commits.
Animationen von Accompanist
Da AnimatedContent jetzt stabil ist, konnten wir den Code aus Accompanist Navigation Animation wieder in Navigation Compose verschieben.
Das bedeutet, dass die gesamte Unterstützung für das Festlegen benutzerdefinierter Übergänge, die in AnimatedNavHost vorhanden war, direkt in NavHost unterstützt wird.
An Accompanist Navigation Animation werden keine weiteren Änderungen vorgenommen und die Funktion wird bald offiziell eingestellt. Es wird dann auch eine Anleitung zur Migration zurück zu Navigation Compose geben. Diese wird der Migrationsanleitung entsprechen, nur in umgekehrter Reihenfolge. Wenn Sie bereits die neueste Accompanist-Alphaversion (0.31.2-alpha) verwenden, sind keine weiteren API-Änderungen erforderlich. (b/197140101)
Fehlerkorrekturen
- Aus Navigation
2.6.0-rc02: Es wurde ein Problem mit der Navigation in Fragmenten behoben, bei dem die Navigation mitpopUpTound das Entfernen eines Fragments aus dem Back Stack ohne Neuerstellung der Ansicht dazu führten, dass die Zurück-Funktion des Systems nicht mehr funktionierte. (Ieb8d4, b/281726455)
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Compose
1.5.0-beta01ab.
Version 2.6.0
Version 2.6.0
7. Juni 2023
androidx.navigation:navigation-*:2.6.0 ist veröffentlicht. Version 2.6.0 enthält diese Commits.
Wichtige Änderungen an der Navigation seit Version 2.5.0
- Die
argumentsvonNavBackStackEntryund die an einOnDestinationChangedListenerübergebenenargumentssind jetzt nur noch eine Kopie der unveränderlichen Argumente, die beim Aufrufen des Ziels erstellt wurden. Das bedeutet, dass Änderungen an diesen Bundles bei nachfolgenden Zugriffen auf diearguments- oder andereOnDestinationChangedListener-Instanzen nicht berücksichtigt werden. NavDeepLinkunterstützt jetzt Standardwerte für Arrays, sodass wiederholte Abfrageparameter unterstützt werden, die dem Array-Typ des Arguments zugeordnet werden.NavTypeenthält jetzt auch eine Standardmethode, die überschrieben werden kann, um zwei geparste Werte zu kombinieren.- Benutzerdefinierte Unterklassen von
NavTypekönnen jetztserializeAsValueüberschreiben, um einen Wert in einen String zu serialisieren. Dadurch können sowohl die Serialisierung als auch die Deserialisierung (überparseValue) vollständig in der KlasseNavTypegekapselt werden.StringTypeüberschreibt diese Methode jetzt, umUri.encodefür den angegebenenStringaufzurufen.
Wichtige Änderungen an Navigation Compose seit Version 2.5.0
- Wenn Sie sich eine Vorschau einer zusammensetzbaren Funktion mit
NavHostansehen, wird jetzt standardmäßig derstartDestinationdes NavGraph angezeigt. NavController.popBackStack(route),NavController.getBackStackEntry(route)undNavController.clearBackStack(route)unterstützen jetzt Routen mit teilweise oder vollständig ausgefüllten Argumenten. Die Argumente müssen genau mit den Argumenten des Eintrags übereinstimmen.- Wenn Sie versuchen, einen leeren
NavDeepLinkmit der Kotlin-DSLnavDeepLinkzu erstellen, wird jetzt eine Lint-Warnung angezeigt, die darauf hinweist, dass ein Deeplink einen URI, eine Aktion und/oder einen MIME-Typ benötigt, um gültig zu sein.
Wichtige Änderungen an der Navigation mit Fragmenten seit Version 2.5.0
NavHostFragmentfängt den Button „Zurück“ des Systems nicht mehr selbst ab. Dadurch kann die zugrunde liegendeFragmentManagerdie Systemrückgabe verarbeiten. Dadurch können Fragment1.7.0-alpha01und höher eine In-App-Animation für die intelligente „Zurück“-Geste auf Android U-Geräten bereitstellen.- Wenn Sie die Navigation mit Fragmenten verwenden und versuchen, manuell eine
FragmentTransactionauszuführen, die dem Back Stack vonFragmentManagerein Fragment hinzufügt, wird jetzt eineIllegalArgumentExceptionausgelöst. Fragmente sollten immer über dienavigate()API hinzugefügt werden. - Wenn Sie den genauen String
${applicationId}als Platzhalter in den Attributenapp:dataundapp:dataPatternim Aktivitätselement einer Navigations-XML-Datei verwenden, wird der Platzhalter beim Aufblähen automatisch mit dempackageNamedes Kontexts ausgefüllt. - Der
FragmentNavigatorverwendet jetzt die Übergangs-APIs, wennNavBackStackEntriesaufgerufen und angezeigt wird. Das bedeutet, dass derNavBackStackEntryLifecyclejetzt wartet, bis die Spezialeffekte für das Ein- und Ausblenden des Fragments abgeschlossen sind, bevor er die endgültigeLifecycle.Stateverschiebt. - Der
DialogFragmentNavigatorverwendet jetzt die Übergangs-APIs, wennNavBackStackEntriesaufgerufen und angezeigt wird. Das bedeutet, dass derNavBackStackEntryLifecyclejetzt wartet, bis derDialogFragmentLifecyclezuDESTROYEDwechselt, bevor er selbst zuDESTROYEDwechselt. - Mit
NavHostFragmentkönnen Sie jetzt dieNavControllerabrufen, sobald dieNavHostFragmentan dieFragmentManagerangehängt ist, und nicht erst nachonCreate(). - Die Unterstützung von dynamischen Funktionsmodulen durch die Navigation hängt jetzt von der detaillierten Play Feature Delivery-Bibliothek ab.
- Navigation Safe Args hängt jetzt von Android-Gradle-Plug-in-Version 7.3.0 ab. Das bedeutet, dass sie jetzt nur noch mit Versionen ab 7.3.0 kompatibel ist.
Wichtige Änderungen an NavigationUI seit Version 2.5.0
- Wenn die ID eines Navigationsgraphen an
AppBarConfigurationübergeben wird (z. B. über einMenu), betrachtetNavigationUIjetzt nur das Startziel dieses Navigationsgraphen als Ziel auf oberster Ebene, anstatt fälschlicherweise jedes Ziel im Graphen als Ziel auf oberster Ebene zu markieren. Das Verhalten beim Übergeben der ID eines einzelnen Ziels bleibt unverändert. Diese Funktion ist auch für Ihren eigenen Code über die neueisTopLevelDestination-Funktion inAppBarConfigurationverfügbar. - Die
setupWithNavController-Integrationen inNavigationUIfür die Arbeit mit der oberen App-Leiste parsen jetztR.string-Werte fürReferenceType-Argumente, die in Ihrerandroid:labelgefunden werden, in ihre String-Werte, anstatt die automatisch generierte Ressourcen-Ganzzahl auszugeben. NavigationUIstellt jetzt Logs bereit, wenn die Navigation über eine ausgewählteMenuItemfehlschlägt.
Version 2.6.0-rc02
24. Mai 2023
androidx.navigation:navigation-*:2.6.0-rc02 ist veröffentlicht. Version 2.6.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem mit der Navigation in Fragmenten behoben, bei dem die Navigation mit
popUpTound das Entfernen eines Fragments aus dem Back Stack ohne Neuerstellung der Ansicht dazu führten, dass die Zurück-Taste des Systems nicht mehr funktionierte. (Ieb8d4, b/281726455)
Version 2.6.0-rc01
10. Mai 2023
androidx.navigation:navigation-*:2.6.0-rc01 ist veröffentlicht. Version 2.6.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem in der Navigation mit Fragmenten behoben, bei dem das Entfernen eines Fragments über die Navigation mit
popUpToim Lebenszyklus-CallbackonResume()zu einemIllegalStateExceptionführte. (I21884, b/279644470)
Version 2.6.0-beta01
19. April 2023
androidx.navigation:navigation-*:2.6.0-beta01 ist veröffentlicht. Version 2.6.0-beta01 enthält diese Commits.
Neue Funktionen
NavBackStackEntrybietet jetzt eine benutzerdefiniertetoString-Implementierung. (Iff00b)
Fehlerkorrekturen
- Wenn Sie die Navigation mit Fragmenten verwenden und versuchen, manuell eine
FragmentTransactionauszuführen, die dem Back Stack vonFragmentManagerein Fragment hinzufügt, wird jetzt eineIllegalArgumentExceptionausgelöst. Fragmente sollten immer über dienavigate()API hinzugefügt werden. (I6d38e) - Wenn es im selben Frame einen
navigategibt, der einen Eintrag hinzufügt, und einenpopBackStack, der ihn entfernt, wird der resultierende oberste Eintrag im Back Stack jetzt konsistent an dieRESUMEDLifecycle.Statezurückgegeben. (Id8067, b/276495952)
Version 2.6.0-alpha09
5. April 2023
androidx.navigation:navigation-*:2.6.0-alpha09 ist veröffentlicht. Version 2.6.0-alpha09 enthält diese Commits.
Fehlerkorrekturen
- Die Prüfungen auf ungültige Routen wurden korrigiert. Wenn ein
NavDestinationein nicht-nullbaresNavArgumententhält, muss die Route dieses Ziels Platzhalter für Argumente enthalten, die denselben Namen wie das nicht-nullbareNavArgumenthaben. (Ic62bf, b/274697949) - Deeplink-Navigationen basierend auf
Action/MimeTypeschlagen jetzt fehl, wenn im Navigationsvorgang ein nicht nullfähigesNavArgumentfehlt, das für dasNavDestinationerforderlich ist, mit dem dasAction/MimeTypeübereinstimmt. (Ibfa17, b/271777424) - Wenn
NavControllerein Diagramm mit derselben Route und denselben Zielen wie das vorherige Diagramm festlegt, werden die aktuellen Diagrammknoten und die Back-Stack-Ziele jetzt ordnungsgemäß durch neue Instanzen ersetzt. Dadurch wird ein Absturz behoben, der bei der Verwendung vononLaunchSingleTopohne Speichern des Status in Navigation Compose auftritt. Außerdem wurde ein Fehler behoben, bei dem beim Aufrufen von Zielen, die mit dem Stammgraphen verknüpft sind, ein falscher Back Stack erstellt wurde. (I5bc58, b/275258161, b/275407804)
Version 2.6.0-alpha08
22. März 2023
androidx.navigation:navigation-*:2.6.0-alpha08 ist veröffentlicht. Version 2.6.0-alpha08 enthält diese Commits.
Neue Funktionen
- Mit
NavHostFragmentkönnen Sie jetzt dieNavControllerabrufen, sobald dieNavHostFragmentan dieFragmentManagerangehängt ist, und nicht erst nachonCreate(). (Ic6382, b/220186282)
Fehlerkorrekturen
- Ein
NullPointerExceptionwurde behoben, der beim Aufrufen eines verschachtelten Graphen mit einem nicht nullfähigen Argument auftrat. (6b3581, b/249988437) - Wenn du nach der Navigation mit
popUpTodie Systemfunktion „Zurück“ verwendest, wird der Status vonNavControllerauf den richtigen Eintrag gesetzt. (I3a8ec, b/270447657) FragmentNavigatorentfernt jetzt Einträge ordnungsgemäß, wenn der Back Stack über die Zurück-Taste des Systems oderpopBackStack()entfernt wird, und zwar unabhängig davon, ob die Transaktion Effekte für das Fragment verwendet oder nicht. (I81bdf)- Wenn Sie der
FragmentManagervonFragmentNavigatorFragmente hinzufügen, ohne die Navigation zu verwenden, führt dies nicht mehr zu einem Absturz. (b17204, b/274167493)
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Lifecycle
2.6.1ab. (586fe7) - Die Navigation hängt jetzt von SavedState
1.2.1ab. (078e4e) - Die Navigation hängt jetzt von ProfileInstaller
1.3.0ab. (512f0c)
Version 2.6.0-alpha07
8. März 2023
androidx.navigation:navigation-*:2.6.0-alpha07 ist veröffentlicht. Version 2.6.0-alpha07 enthält diese Commits.
Fehlerkorrekturen
- Die API-Varianten
getBackStackEntry,popBackStackundclearBackStack, die Routen akzeptieren, akzeptieren jetzt Routenmuster mit Argumenten und Abfrageparametern, die null sein können (I22294, b/269302500). - Ein Problem wurde behoben, bei dem durch den Aufruf von
clearBackStack()überNavControllerder gespeicherte Status im Fragment-Manager, der mit dem gelöschten Back Stack verknüpft ist, nicht gelöscht wurde. (Ic1cce, b/271190202) - Es wurde eine Regression in 2.6.0-alpha06 behoben, die dazu führte, dass bei Verwendung der System-Zurück-Funktion zwischen Tabs das falsche
MenuItemin derBottomNavigationViewhervorgehoben wurde. (I634f6, b/270447657) - Es wurde eine Regression in 2.6.0-alpha06 behoben, die dazu führte, dass
NavBackStackEntrys bei Verwendung vonAnimations nicht in den Status RESUMED verschoben wurden. (Ib3589, b/269646882)
Version 2.6.0-alpha06
22. Februar 2023
androidx.navigation:navigation-*:2.6.0-alpha06 ist veröffentlicht. Version 2.6.0-alpha06 enthält diese Commits.
Neue Funktionen
- Wenn Sie sich eine Vorschau einer zusammensetzbaren Funktion mit
NavHostansehen, wird jetzt standardmäßig derstartDestinationdes NavGraph angezeigt. (I2b89f)
API-Änderungen
- Alle
NavController-navigate-Überladungen sind jetzt mit@MainThreadannotiert, damit sie im Hauptthread aufgerufen werden. (I2c0b0, b/263427111)
Fehlerkorrekturen
- Ein Absturz beim Versuch, mit der dynamischen Fragmentnavigation zu navigieren, wurde behoben. (I3ee29, b/268360479)
- Fehler behoben, bei dem die untere Leiste nicht auf das richtige ausgewählte Element aktualisiert wurde, wenn über den Button „Zurück“ des Systems zu einem anderen Fragment navigiert wurde (If559f, b/269044426)
Bekannte Probleme
- Wenn Sie die Navigation mit Fragmenten verwenden, erreicht der Lebenszyklus von
NavBackStackEntrybei Verwendung vonAnimation-APIs nichtRESUMED. (b/269646882) - Wenn Sie die Navigation mit Fragmenten verwenden und mit
BottomNavigationnavigieren, wird derBottomMenuItemnicht korrekt aktualisiert, wenn Sie versuchen, einen Back Stack mit mehreren Einträgen wiederherzustellen. (b/270447657) - Wenn Sie die Navigation mit Fragmenten verwenden, wird nach dem Wiederherstellen des Status die
NavBackStackEntryLifecyclenichtDESTROYED, wenn das FragmentDESTROYEDist. (b/270610768)
Version 2.6.0-alpha05
8. Februar 2023
androidx.navigation:navigation-*:2.6.0-alpha05 ist veröffentlicht. Version 2.6.0-alpha05 enthält diese Commits.
Neue Funktionen
NavController.popBackStack(route),NavController.getBackStackEntry(route)undNavController.clearBackStack(route)unterstützen jetzt Routen mit teilweise oder vollständig ausgefüllten Argumenten. Die Argumente müssen genau mit den Argumenten des Eintrags übereinstimmen. (Iebd28, Ic678c, I3b37b, b/257514373)- Der
FragmentNavigatorverwendet jetzt die Übergangs-APIs, wennNavBackStackEntriesaufgerufen und angezeigt wird. Das bedeutet, dass derNavBackStackEntryLifecyclejetzt wartet, bis die Spezialeffekte für das Ein- und Ausblenden des Fragments abgeschlossen sind, bevor er die endgültigeLifecycle.Stateverschiebt. (I3cb19, b/238686802) - Der
DialogFragmentNavigatorverwendet jetzt die Übergangs-APIs, wennNavBackStackEntriesaufgerufen und angezeigt wird. Das bedeutet, dass derNavBackStackEntryLifecyclejetzt wartet, bis derDialogFragmentLifecyclezuDESTROYEDwechselt, bevor er selbst zuDESTROYEDwechselt. (I53ee5, b/261213893)
API-Änderungen
NavigatorStatebietet jetzt dieprepareForTransitionAPI, mit derNavigatorsNavBackStackEntriesin Zwischen-Lifecycle.States verschieben können. (I42c21, b/238686802)- Sie können jetzt über die Property
backstackauf den Back Stack zugreifen, der mit einemNavGraphNavigatoroder einemComposeNavigatorverknüpft ist.ComposeNavigatorstellt jetzt auch den CallbackonTransitionComplete()bereit, um einenNavBackStackEntry, der einen Navigations- oderpopBackStack-Vorgang ausgeführt hat, als abgeschlossen zu markieren. (I02062, I718db, b/257519195)
Fehlerkorrekturen
- Der Navigator-Status wird jetzt nicht mehr ausgeführt, wenn die
push/popWithTransitionAPIs verwendet werden und der Eintrag bereits verarbeitet wird. (Iadbfa, b/261213893) - Wenn Sie
launchSingleTopmit einem verschachteltenNavGraphverwenden, werden alle Ziele vom ursprünglichen Ziel bis zu seinemstartDestinationnur ordnungsgemäß oben im Backstack hinzugefügt. (Id4bea, b/253256629) - Die Navigation ersetzt jetzt die
DialogFragment-Instanz ordnungsgemäß, wenn zum selben Ziel navigiert wird und das FlaglaunchSingleTopauf „true“ gesetzt ist. (I45b5a, b/149572817) - Navigation SafeArgs verursacht keinen Kompilierungsfehler mehr, wenn Argumente verwendet werden, die genau 19 Zeichen lang sind. (Id60bc, b/257110095)
Version 2.6.0-alpha04
9. November 2022
androidx.navigation:navigation-*:2.6.0-alpha04 ist veröffentlicht. Version 2.6.0-alpha04 enthält diese Commits.
Neue Funktionen
- Benutzerdefinierte Unterklassen von
NavTypekönnen jetztserializeAsValueüberschreiben, um einen Wert in einen String zu serialisieren. Dadurch können sowohl die Serialisierung als auch die Deserialisierung (überparseValue) vollständig in der KlasseNavTypegekapselt werden.StringTypeüberschreibt diese Methode jetzt, umUri.encodefür den angegebenenStringaufzurufen. (Ie5213, b/247637434) NavigationUIstellt jetzt Logs bereit, wenn die Navigation über eine ausgewählteMenuItemfehlschlägt. (I2af5a, b/247730357)
Fehlerkorrekturen
- Navigations-Deeplinks werden jetzt verzögert geparst, anstatt bei der Initialisierung des Graphen. Das kann die App-Leistung beim Start verbessern. (Iab0ab)
- Ein Absturz wurde behoben, der durch das Navigieren nach oben nach dem Deeplinking zu einem Ziel mit Null-Standardargumenten verursacht wurde. (I51c24, b/243183636)
Abhängigkeitsupdate
- Die Unterstützung von dynamischen Funktionsmodulen durch die Navigation hängt jetzt von der detaillierten Play Feature Delivery-Bibliothek ab. (Ib4ddc)
- Navigation Safe Args hängt jetzt von Android-Gradle-Plug-in-Version 7.3.0 ab. Das bedeutet, dass sie jetzt nur noch mit Versionen ab 7.3.0 kompatibel ist. (I47e49)
Version 2.6.0-alpha03
24. Oktober 2022
androidx.navigation:navigation-*:2.6.0-alpha03 ist veröffentlicht. Version 2.6.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Navigation
2.5.3:NavHostverursacht keinenNoSuchElementExceptionmehr, wenn kein Ziel für die Erstellung desCrossfadeverfügbar ist. Die Komposition wird jetzt einfach übersprungen. (Ieb46e, b/253299416) - Aus Navigation
2.5.3: Es wurde ein Problem behoben, bei dem gespeicherte Compose-Zustände (z.B. Verwendungen vonrememberSaveable) nicht vergessen und entfernt wurden, wenn ein Ziel aus dem Back Stack entfernt wurde. (I64949)
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Fragment
1.5.4ab. (Icd424)
Version 2.6.0-alpha02
5. Oktober 2022
androidx.navigation:navigation-*:2.6.0-alpha02 ist veröffentlicht. Version 2.6.0-alpha02 enthält diese Commits.
Geändertes Verhalten
- Wenn die ID eines Navigationsgraphen an
AppBarConfigurationübergeben wird (z. B. über einMenu), betrachtetNavigationUIjetzt nur das Startziel dieses Navigationsgraphen als Ziel auf oberster Ebene, anstatt fälschlicherweise jedes Ziel im Graphen als Ziel auf oberster Ebene zu markieren. Das Verhalten beim Übergeben der ID eines einzelnen Ziels bleibt unverändert. Diese Funktion ist auch für Ihren eigenen Code über die neueisTopLevelDestination-Funktion inAppBarConfigurationverfügbar. (Ie936e, b/238496771)
Fehlerkorrekturen
- Die Komponente
navigation:navigation-fragmenthängt jetzt von der Fragment-Version1.5.2ab. (I00ba4) - Der ausgewählte Menüpunkt wird nicht mehr aktualisiert, wenn zu einem
FloatingWindow-Ziel wie einem Dialogfeld navigiert wird. (I4cde8, b/240308330)
Version 2.6.0-alpha01
7. September 2022
androidx.navigation:navigation-*:2.6.0-alpha01 ist veröffentlicht. Version 2.6.0-alpha01 enthält diese Commits.
Neue Funktionen
- Die
setupWithNavController-Integrationen inNavigationUIfür die Arbeit mit der oberen App-Leiste parsen jetztR.string-Werte fürReferenceType-Argumente, die in Ihrerandroid:labelgefunden werden, in ihre String-Werte, anstatt die automatisch generierte Ressourcen-Ganzzahl auszugeben. (I5f803, b/167959935) NavDeepLinkunterstützt jetzt Standardwerte für Arrays, sodass wiederholte Abfrageparameter unterstützt werden, die dem Array-Typ des Arguments zugeordnet werden.NavTypeenthält jetzt auch eine Standardmethode, die überschrieben werden kann, um zwei geparste Werte zu kombinieren. (Id68c3, b/209977108)- Wenn Sie den genauen String
${applicationId}als Platzhalter in den Attributenapp:dataundapp:dataPatternim Aktivitätselement einer Navigations-XML-Datei verwenden, wird der Platzhalter beim Aufblähen automatisch mit dempackageNamedes Kontexts ausgefüllt. (Iaabde, b/234223561) - Wenn Sie versuchen, einen leeren
NavDeepLinkmit der Kotlin-DSLnavDeepLinkzu erstellen, wird jetzt eine Lint-Warnung angezeigt, die darauf hinweist, dass ein Deeplink einen URI, eine Aktion und/oder einen MIME-Typ benötigt, um gültig zu sein. (I08d2f, b/154038883)
API-Änderungen
- Neue Erweiterungsfunktion
NavDestinationhinzugefügt, um dynamische Labels mit Argumenten im Formatandroid:label="{arg}"in String zu parsen. UnterstütztReferenceType-Argumente, indemR.string-Werte in ihre Stringwerte geparst werden. (I07d89, b/236269380)
Geändertes Verhalten
- Die
argumentsvon NavBackStackEntry und die an einOnDestinationChangedListenerübergebenenargumentssind jetzt nur noch eine Kopie der unveränderlichen Argumente, die beim Aufrufen des Ziels erstellt wurden. Das bedeutet, dass Änderungen an diesen Bundles bei nachfolgenden Zugriffen auf diearguments- oder andereOnDestinationChangedListener-Instanzen nicht berücksichtigt werden. (I676f5)
Fehlerkorrekturen
- Unter Navigation
2.5.2: Bei der dynamischen Navigation wird jetzt versucht, Aktivitätsziele aus anderen Modulen zu installieren, bevor dorthin navigiert wird. (Ia2c16, b/240292838) - Aus Navigation
2.5.2: Die Navigation ersetzt jetzt die Fragmentinstanz ordnungsgemäß, wenn zum selben Ziel navigiert und das FlaglaunchSingleTopauf „true“ gesetzt wird. (I5a2f1, b/237374580) - Aus Navigation
2.5.2: Es wurde einIllegalStateExceptionbehoben, der durch die Navigation zu einem doppelt verschachtelten Diagramm verursacht wurde, das ein übergeordnetes Element mit einem neuen Startziel hat, das aus dem Backstack entfernt wurde. (I9f7cb, b/243778589)
Version 2.5
Version 2.5.3
24. Oktober 2022
androidx.navigation:navigation-*:2.5.3 ist veröffentlicht. Version 2.5.3 enthält diese Commits.
Fehlerkorrekturen
NavHostverursacht keinenNoSuchElementExceptionmehr, wenn kein Ziel für die Erstellung desCrossfadeverfügbar ist. Die Komposition wird jetzt einfach übersprungen. (Ieb46e, b/253299416)- Es wurde ein Problem behoben, bei dem der gespeicherte Compose-Status (z.B. Verwendungen von
rememberSaveable) nicht vergessen und entfernt wurde, wenn ein Ziel aus dem Back Stack entfernt wurde. (I64949)
Version 2.5.2
7. September 2022
androidx.navigation:navigation-*:2.5.2 ist veröffentlicht. Version 2.5.2 enthält diese Commits.
Fehlerkorrekturen
- Die dynamische Navigation versucht jetzt, Aktivitätsziele aus anderen Modulen zu installieren, bevor sie dorthin navigiert. (Ia2c16, b/240292838)
- Die Navigation ersetzt jetzt die Fragment-Instanz ordnungsgemäß, wenn zum selben Ziel navigiert und das Flag
launchSingleTopauf „true“ gesetzt wird. (I5a2f1, b/237374580) IllegalStateExceptionbehoben, der durch die Navigation zu einem doppelt verschachtelten Diagramm verursacht wurde, das ein übergeordnetes Element mit einem neuen entfernten Startziel teilt. (I9f7cb, b/243778589)
Abhängigkeitsupdate
- Navigation
2.5.2hängt jetzt von Fragment1.5.2ab. (aosp/2178734)
Version 2.5.1
27. Juli 2022
androidx.navigation:navigation-*:2.5.1 ist veröffentlicht. Version 2.5.1 enthält diese Commits.
Fehlerkorrekturen
Navigation Safe Argsverursacht keine Warnungen mehr zu verworfenen Funktionen in generierten Klassen, wenn benutzerdefinierte Argumenttypen verwendet werden, die in einemBundlegespeichert sind. (Id86ed, b/237725966)
Abhängigkeitsupdates
- Die Navigationsbibliothek hängt jetzt von Lifecycle
2.5.1ab. (Ib4451) - Die Navigationsbibliothek hängt jetzt von Activity
1.5.1ab. (I3efe8) - Die Navigationsbibliothek hängt jetzt von Fragment
1.5.1ab. (I56177)
Version 2.5.0
29. Juni 2022
androidx.navigation:navigation-*:2.5.0 ist veröffentlicht. Version 2.5.0 enthält diese Commits.
Wichtige Änderungen seit 2.4.0
- CreationExtras-Integration:
Navigationkann jetzt überCreationExtrasvon Lifecycle2.5.0einen zustandslosenViewModelProvider.Factorybereitstellen.
Navigation SafeArgs
Navigation Safe Argshat dieAndroid Gradle Plugin-Abhängigkeit auf7.0.4aktualisiert. Die Kompatibilität mit AGP-Versionen vor7.0wurde entfernt.- Das build.gradle-Attribut „namespace“ wird jetzt unterstützt und kann anstelle von „applicationId“ verwendet werden.
Weitere Änderungen
- Die
visibleEntriesAPI ist nicht mehr experimentell und bietet eine Funktion zum Abrufen aller Einträge, deren Ziel gemäßNavControllerderzeit sichtbar ist.
Version 2.5.0-rc02
15. Juni 2022
androidx.navigation:navigation-*:2.5.0-rc02 ist veröffentlicht. Version 2.5.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Ein Absturz, der durch schnelles Wechseln zwischen den unteren Zielen bei Verwendung von Navigation Compose
NavHostverursacht wurde, wurde behoben. (I3979a, b/234054916) Navigation SafeArgsstürzt nicht mehr ab, wenn einapplicationIdSuffixund ein Namespace verwendet werden, ohne dass einapplicationIdvorhanden ist, oder wenn sichapplicationIdund Namespace unterscheiden. (I754b1, b/233119646)NavArgumenthat jetzt eine benutzerdefiniertetoString()-Funktion, um die internen Werte des Arguments anzuzeigen. (I900a8)
Version 2.5.0-rc01
11. Mai 2022
androidx.navigation:navigation-*:2.5.0-rc01 ist veröffentlicht. Version 2.5.0-rc01 enthält diese Commits.
Neue Funktionen
- Es wurde eine neue Lint-Regel hinzugefügt, die davor warnt,
<deeplink>-Elemente in<activity>-Elementen in dernavigation.xml-Datei zu platzieren.(Ic15a5, b/178403185)
Fehlerkorrekturen
- Komponierbare Bereiche in
NavHostundDialogHostwerden jetzt in der erwarteten Reihenfolge verworfen, d.h. innere komponierbare Elemente werden vor äußeren komponierbaren Elementen verworfen. (I157e6) - Navigation SafeArgs verwendet jetzt
PathSensitivity.RELATIVEin derArgumentsGenerationTask, um die Cache-Verschiebbarkeit zu ermöglichen. Das bedeutet, dass der Cache-Eintrag jetzt von einem CI-Build zu einem lokalen Build wiederverwendet werden kann. (I5f67c, b/173420454) - Die Lint-Regel
UnrememberedGetBackStackEntryDetectorwurde aktualisiert, um sicherzustellen, dass der Aufruf vonremember, der den Aufruf vongetBackStackEntry()umgibt, auch einNavBackStackEntry-Objekt als Schlüssel übergibt.(Ib7081, b/227382831)
Version 2.5.0-beta01
20. April 2022
androidx.navigation:navigation-*:2.5.0-beta01 ist veröffentlicht. Version 2.5.0-beta01 enthält diese Commits.
Fehlerkorrekturen
DialogNavigatorverwendet jetztpopWithTransition, wenn eindismiss()-Aufruf ausgeführt wird. Dadurch wird eine Race-Bedingung behoben, die bei Verwendung einesViewModel-Ziels innerhalb einesdialog-Ziels auftritt und zu einemIllegalStateExceptionführt, wenn das Dialogfeld entweder über die Zurück-Taste des Systems oder durch Tippen außerhalb des Dialogfelds geschlossen wird. (Id7376, b/226552301)
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Lifecycle
2.5.0-beta01ab. Dadurch wird einIllegalStateExceptionbehoben, der auftrat, wenn einNavHostin einem anderenNavHostin einem nicht primären Tab der unteren Navigationsleiste verschachtelt wurde, wenn mehrere Back Stacks verwendet wurden.
Version 2.5.0-alpha04
6. April 2022
androidx.navigation:navigation-*:2.5.0-alpha04 ist veröffentlicht. Version 2.5.0-alpha04 enthält diese Commits.
API-Änderungen
visibleEntriesist nicht mehr experimentell. (I4829f, b/225394514)
Fehlerkorrekturen
- NavHost hängt jetzt von
visibleEntriesaus demNavControllerab, um zu bestimmen, welche Einträge zusammengestellt werden sollen. Das bedeutet, dass bei Verwendung eines verschachtelten NavHost der innereNavHostjetzt ordnungsgemäß ausgeblendet werden sollte. (I4ba2b, b/225394514) - Der von
NavControllerbereitgestelltevisibleEntriesStateFlowbasiert jetzt auf dem maximalen Lebenszyklusstatus des Eintrags und nicht mehr auf dem aktuellen Lebenszyklusstatus. Das bedeutet, dass die Liste der sichtbaren Einträge auch dann gleich bleibt, wenn der Hostlebenszyklus desnavControllerunter STARTED fällt. (I9e2a8, b/225394514) SavedStateViewFactoryunterstützt jetzt die Verwendung vonCreationExtras, auch wenn es mit einemSavedStateRegistryOwnerinitialisiert wurde. Wenn Extras angegeben sind, werden die initialisierten Argumente ignoriert. (I6c43b, b/224844583)NavDeepLinkkann jetzt URIs mit einem einzelnen Suchparameter ohne Wert parsen. (I0efe8, b/148905489)- Leere Strings werden jetzt als gültige Argumente in Deeplinks betrachtet. (I70a0d, b/217399862)
Navigation Safe Argsstürzt nicht mehr ab, wenn Namespaces verwendet werden und keinAndroidManifest.xmlvorhanden ist. (I17ccf, b/227229815)
Version 2.5.0-alpha03
23. Februar 2022
androidx.navigation:navigation-*:2.5.0-alpha03 ist veröffentlicht. Version 2.5.0-alpha03 enthält diese Commits.
API-Änderungen
- Sie können jetzt
CreationExtrasanby navGraphViewModelsübergeben, um einViewModelzu erstellen. (I29217, b/217618359)
Fehlerkorrekturen
NavDeepLinksunterstützt jetzt codierte Zeilenumbruchzeichen, die in Routen/Deeplink-URIs eingebettet sind. (I513d1, b/217815060)CreationExtrasfunktioniert jetzt korrekt, wenn es mitNavBackStackEntriesverwendet wird, um ViewModels zu erstellen. (I69161, b/217617710)- Navigation Safe Args unterstützt jetzt die Verwendung des in der
build.gradledefinierten Namespace anstelle des Pakets im AndroidManifest. (I659ef, b/217414933)
Version 2.5.0-alpha02
9. Februar 2022
androidx.navigation:navigation-*:2.5.0-alpha02 ist veröffentlicht. Version 2.5.0-alpha02 enthält diese Commits.
Fehlerkorrekturen
- Aus Navigation
2.4.1: DieNavHostFragmentlegt jetzt dieOnBackPressedDispatcherordnungsgemäß fest, wenn die Ansichtsbindung mit verschachtelten Diagrammen verwendet wird. (Ifbb51, b/214577959) - Über Navigation
2.4.1: Beim Deeplinking über mehrere verschachtelteNavGraphs enthält der Back Stack jetzt auch Zwischenstartziele. (I504c0, b/214383060)
Version 2.5.0-alpha01
26. Januar 2022
androidx.navigation:navigation-*:2.5.0-alpha01 ist veröffentlicht. Version 2.5.0-alpha01 enthält diese Commits.
Neue Funktionen
NavBackStackEntryist jetzt in ViewModel CreationExtras eingebunden, die als Teil von Lifecycle2.5.0-alpha01eingeführt wurden. (Ib9fe2, b/207012490)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der Zugriff auf ein
ViewModel, das überby navGraphViewModels()aus demonCreate()eines Fragments erstellt wurde, mit einemIllegalStateExceptionfehlschlug. (I8a14d) NavDeepLinks decodieren Argumente nicht mehr unnötigerweise zweimal, d. h., die richtigen Argumente werden jetzt an das endgültige Ziel übergeben. (I31b0a, b/210711399)
Safe Args
- Safe Args hängt jetzt von der Android-Gradle-Plug-in-Version 7.0.4 ab. Das bedeutet, dass Navigation Safe Args nicht mehr mit Android Studio-Versionen vor 7.0 kompatibel ist, aber jetzt mit dem Android-Gradle-Plug-in 7.1.0 und höher kompatibel ist. (I41c88, b/213086135, b/207670704)
Version 2.4.2
Version 2.4.2
6. April 2022
androidx.navigation:navigation-*:2.4.2 ist veröffentlicht. Version 2.4.2 enthält diese Commits.
Fehlerkorrekturen
- Backport aus Navigation
2.5.0-alpha03:NavDeepLinksunterstützt jetzt ordnungsgemäß codierte Zeilenumbruchzeichen, die in Routen/Deeplink-URIs eingebettet sind. (I513d1, b/217815060) - Backport aus Navigation
2.5.0-alpha03: Navigation SafeArgs unterstützt jetzt die Verwendung des in derbuild.gradledefinierten Namespace anstelle des Pakets im AndroidManifest. (I659ef, b/217414933) - Backport aus Navigation
2.5.0-alpha04:Navigation Safe Argsstürzt nicht mehr ab, wenn Namespaces verwendet werden und keinAndroidManifest.xmlvorhanden ist. (I17ccf, b/227229815) - Backport aus Navigation
2.5.0-alpha04: Leere Strings werden jetzt als gültige Argumente in Deeplinks betrachtet. (I70a0d, b/217399862)
Version 2.4.1
Version 2.4.1
9. Februar 2022
androidx.navigation:navigation-*:2.4.1 ist veröffentlicht. Version 2.4.1 enthält diese Commits.
Fehlerkorrekturen
- In
NavHostFragmentwird jetztOnBackPressedDispatcherrichtig festgelegt, wenn die Ansichtsbindung mit verschachtelten Graphen verwendet wird. (Ifbb51, b/214577959) - Beim Deeplink über mehrere verschachtelte
NavGraphs enthält der Back Stack jetzt die Zwischenstartziele. (I504c0, b/214383060) - Backport aus Navigation
2.5.0-alpha01: Es wurde ein Problem behoben, bei dem der Zugriff auf ein überby navGraphViewModels()erstelltes ViewModel aus demonCreate()eines Fragments mit einemIllegalStateExceptionfehlschlug. (I8a14d) - Backport aus Navigation
2.5.0-alpha01:NavDeepLinks decodieren Argumente nicht mehr unnötigerweise zweimal. Das bedeutet, dass die korrekt decodierten Argumente jetzt an das endgültige Ziel übergeben werden. (I31b0a, b/210711399) - Backport aus Navigation
2.5.0-alpha01: Safe Args hängt jetzt von der Android-Gradle-Plug-in-Version 7.0.4 ab. Das bedeutet, dass Navigation Safe Args nicht mehr mit Android Studio-Versionen vor 7.0 kompatibel ist, aber jetzt mit dem Android-Gradle-Plug-in 7.1.0 und höher kompatibel ist. (I41c88, b/213086135, b/207670704)
Version 2.4.0
Version 2.4.0
26. Januar 2022
androidx.navigation:navigation-*:2.4.0 ist veröffentlicht. Version 2.4.0 enthält diese Commits.
Wichtige Änderungen seit Version 2.3.0
- Alle Navigationsartefakte wurden in Kotlin neu geschrieben. Dadurch wurde die Null-Zulässigkeit von Klassen verbessert, die Generics verwenden (z. B.
NavType-Unterklassen). Alle Kotlin-Erweiterungsfunktionen, die früher Teil der-ktx-Artefakte waren, wurden in die entsprechenden Hauptartefakte verschoben. Die-ktx-Artefakte werden weiterhin veröffentlicht, sind aber vollständig leer. - Das Artefakt
navigation-fragmententhält jetzt eine vordefinierte Implementierung eines Layouts mit zwei Bereichen über die neueAbstractListDetailFragment. Dieses Fragment verwendet einSlidingPaneLayout, um einen Listenbereich (der von Ihrer Unterklasse bereitgestellt wird) und einen Detailbereich zu verwalten, der einNavHostFragmentals Implementierung verwendet, wie in unserer Beispielimplementierung zu sehen ist. - Die Methode
currentBackStackEntryAsFlow()fürNavControllerstellt einFlowbereit, das immer dann ausgegeben wird, wenn sich die aktuelleNavBackStackEntryändert. Dieser Ablauf kann als Alternative zur manuellen Verwaltung einesOnDestinationChangedListenerverwendet werden. - NavController bietet jetzt die Möglichkeit, über das experimentelle Attribut
visibleEntrieseine Liste aller sichtbarenNavBackStackEntry-Instanzen alsStateFlowabzurufen. - Es ist jetzt möglich, die Klasse
NavTypezu erweitern, um benutzerdefinierte NavTypes zu erstellen. Benutzerdefinierte Typen werden nur unterstützt, wenn Sie Ihren Navigationsgraphen programmatisch erstellen, z. B. über die Kotlin-DSL für Navigationsgraphen. Die Navigation bietet jetzt die APIs
findStartDestination()undgetHierarchy(), mit denen sich eine benutzerdefinierte NavigationUI implementieren lässt.findStartDestination()ist eine Erweiterungsfunktion fürNavGraph, mit der das tatsächliche Startziel ermittelt wird, das angezeigt wird, wenn Sie zum Graphen navigieren, auch wennstartDestinationselbst ein verschachteltesNavGraphist.getHierarchy()ist eine Funktion inNavDestination, mit der Sie prüfen können, ob sich ein bestimmtes Ziel in der Hierarchie eines anderen Ziels befindet.val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }NavigationUI-Methoden, die einBottomNavigationView-Objekt akzeptiert haben, wurden so aktualisiert, dass sie stattdessen die in Material1.4.0eingeführte BasisklasseNavigationBarViewakzeptieren. Dadurch können diese Methoden mit demNavigationRailViewverwendet werden.Wenn ein
<action>-Element über XML aufgebläht wird, können für Animationsattribute Attribute verwendet werden, die mit der Syntaxapp:enterAnim="?attr/transitionEnter"aus dem Design abgerufen werden.Safe Args generiert jetzt für jede
NavArgs-Klasse einefromSavedStateHandle()-Methode. (#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) }
Navigationsrouten und die Kotlin-DSL
In früheren Versionen der Navigation musste jedes Ziel eine konstante Ganzzahl-ID haben, die es eindeutig von seinen gleichgeordneten Zielen unterscheidet und es Ihnen ermöglicht, entweder direkt oder über eine Aktion zu diesem Ziel zu navigate(). Das ist zwar weiterhin gültig und nützlich, insbesondere wenn Sie Ihren Navigationsgraphen in XML definieren und automatisch generierte R.id-Konstanten oder Safe Args verwenden können (die diese Konstanten verwenden, um Code zur Build-Zeit zu generieren). Dieses System eindeutiger Ganzzahlen erfasste jedoch nicht die semantische Bedeutung und Ausdruckskraft, die erforderlich sind, um vollständig dynamische Graphen zu unterstützen, die zur Laufzeit programmatisch über die Navigation Kotlin DSL erstellt werden.
Mit diesem Release wird eine neue Option eingeführt, mit der ein Ziel in einem Navigationsgraphen anhand seiner Route eindeutig identifiziert werden kann. Eine Route ist ein String, der den eindeutigen Pfad zu einem Ziel definiert. Alle Kotlin DSL-Methoden, die eine Ziel-ID akzeptiert haben, wurden eingestellt und durch eine entsprechende API ersetzt, die eine Route akzeptiert.
Jede Route sollte als „Pfad“-Teil eines Uri behandelt werden, der dieses Ziel definiert, z.B. home, profile/{userId}, profile/{userId}/friends usw. Wenn die Identität eines Ziels mit einem bestimmten Inhalt verknüpft ist, sollten diese dynamischen Argumente Teil der Route sein und denselben Regeln wie implizite Deeplinks folgen.
Alle NavController-APIs, die bisher nur eine ID akzeptiert haben, haben jetzt eine Überladung, die eine Route String akzeptiert. Dazu gehören navigate(), popBackStack(), popUpTo() und getBackStackEntry().
Dies hatte einige Auswirkungen auf die API:
- Das Kotlin-Attribut
popUpToin der Kotlin-DSL wurde zugunsten vonpopUpToIdeingestellt. - Die
getStartDestination()API wurde zugunsten vongetStartDestinationId()eingestellt.
Im Gegensatz zur Navigation nach ID gelten für die Navigation nach Route dieselben Regeln wie für implizite Deeplinks. Sie können direkt zu jedem Ziel in jedem verschachtelten Graphen navigieren. So können diese Routen in Projekten mit mehreren Modulen verwendet werden, ohne dass jedem Ziel explizit ein extern sichtbarer Deeplink hinzugefügt werden muss.
Navigation Compose
Das Artefakt navigation-compose ermöglicht die Integration der Navigationskomponente in Jetpack Compose. Dabei werden @Composable-Funktionen als Ziele in Ihrer Anwendung verwendet.
Diese Version bietet:
- Eine
NavHostkomponierbare Funktion, mit der Sie Ihren Navigationsgraphen über eine Kotlin-DSL mitcomposable- unddialog-Zielen erstellen können. Außerdem werden optionale Navigatoren wie die von Accompanist Navigation Material unterstützt. - Obligatorische Unterstützung für Überblendungen zwischen Zielen. Mit Accompanist Navigation Animation können Sie die Ein- und Ausstiegsübergänge mithilfe experimenteller Compose APIs steuern.
- Festlegung des Bereichs eines
Lifecyclefür jedes zusammensetzbare Ziel. Jedes Ziel erreicht den StatusRESUMEDnur, wenn alle eingehenden Übergänge abgeschlossen sind, und wechselt sofort zuSTARTED, wenn ausgehende Übergänge beginnen. So können Sie alleIllegalStateException- und Multi-Touch-Probleme vermeiden, indem Sie einennavigate-Aufruf nur dann auslösen, wenn derLifecycleRESUMEDist. - Bereichseingrenzung von
ViewModel(über dieviewModel()API von Lifecycle ViewModel Compose2.4.0oderhiltViewModel()von Hilt Navigation Compose1.0.0auf Zielebene, um einen Bereich bereitzustellen, der Konfigurationsänderungen übersteht und im Back Stack bleibt (wenn der Composable-Inhalt ansonsten verworfen wird), und ein Signal in deronCleared()des ViewModels, das das dauerhafte Verwerfen und Bereinigen des mit diesemNavBackStackEntryverknüpften Zustands anzeigt. - Festlegung des Bereichs des
rememberSaveable-Zustands auf Zielebene, sodass der gesamte zusammensetzbare Zustand automatisch gespeichert und wiederhergestellt wird, wenn Sie zu einem Ziel zurückkehren. - Vollständige Unterstützung für das Speichern und Wiederherstellen des Status von
NavControllerund des Status des Ziels nach Prozessbeendigung und Neuerstellung. - Automatische Integration mit dem Button „Zurück“ des Systems.
Unterstützung für die Übergabe von Argumenten, das Anhängen von Deeplinks an Ziele und die Rückgabe eines Ergebnisses an vorherige Ziele.
Spezifische Hilfsprogramme in
rememberNavController()undcurrentBackStackEntryAsState()erstellen, um das Hochstufen des Status und das Verbinden desNavControllermit Composables außerhalb desNavHost(z. B. einer unteren Navigationsleiste) zu ermöglichen.
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()
}
}
}
Weitere Informationen finden Sie im Leitfaden zur Navigation mit Compose.
Mehrere Back Stacks
Der NavController ist für die Verwaltung des Back Stacks von Zielen verantwortlich. Er fügt dem Back Stack Ziele hinzu, wenn du zu ihnen navigate(), und entfernt sie, wenn du popBackStack() aufrufst oder den Zurück-Button des Systems auslöst. Die vorhandene Klasse NavOptions und die Einbindung in <action>-Elemente in der XML-Datei des Navigationsgraphen wurden erweitert, um das Speichern und Wiederherstellen des Backstacks zu unterstützen.
Im Rahmen dieser Änderung speichern und stellen die NavigationUI-Methoden von onNavDestinationSelected(), BottomNavigationView.setupWithNavController() und NavigationView.setupWithNavController() jetzt automatisch den Status von entfernten Zielen wieder her. Dadurch werden mehrere Back Stacks ohne Codeänderungen unterstützt. Wenn Sie die Navigation mit Fragmenten verwenden, ist dies die empfohlene Methode für die Einbindung mehrerer Back Stacks.
Die zugrunde liegenden APIs zum Speichern und Wiederherstellen des Status werden über eine Reihe von Oberflächen bereitgestellt:
In der Navigations-XML kann das Element
<action>jetzt die booleschen Attributeapp:popUpToSaveStateundapp:restoreStateverwenden, um den Status aller überapp:popUpToentfernten Ziele zu speichern und den Status des alsapp:destinationübergebenen Ziels wiederherzustellen:<action android:id=”@+id/swap_stack” app:destination=”@id/second_stack” app:restoreState=”true” app:popUpTo=”@id/first_stack_start_destination” app:popUpToSaveState=”true” />In der
navOptionsKotlin DSL können Sie die boolesche PropertyrestoreStateund die boolesche PropertysaveStateimpopUpTo-Builder hinzufügen:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.findStartDestination().id) { saveState = true } }Wenn Sie ein
NavOptions-Objekt manuell über dieNavOptions.Buildererstellen, können Sie diesetRestoreState()und die neue Überladung fürsetPopUpTo()verwenden, die einen zusätzlichensaveState-Parameter akzeptiert.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);Programmatische Aufrufe von
popBackStack()können jetzt einen zusätzlichensaveState-Parameter enthalten.Mit der Methode
clearBackStack()können Sie alle Status löschen, die mitpopBackStack()oderpopUpToSaveStategespeichert wurden.
In allen Fällen speichert und stellt der NavController den Status jedes NavBackStackEntry wieder her, einschließlich aller ViewModel-Instanzen, die auf das Navigationsziel beschränkt sind. Die Navigator-APIs wurden aktualisiert, damit jede Navigator das Speichern und Wiederherstellen des eigenen Status unterstützt.
Verhaltensänderungen
NavDeepLinkBuilderfügt jetztPendingIntent.FLAG_IMMUTABLEzuPendingIntenthinzu, das voncreatePendingIntent()zurückgegeben wird. Dadurch wird sichergestellt, dass diese API wie erwartet funktioniert, wenn sie auf Android 12 ausgerichtet ist.- Die Navigation hängt jetzt von Lifecycle
2.3.1ab und markiert jetztsetGraph(),popBackStack(),navigateUp()undnavigate(), die Methoden, die denNavBackStackEntryLifecycleaktualisieren, als@MainThread. Dadurch wird die Navigation an die in Lifecycle2.3.0eingeführte Erzwingung des Hauptthreads angepasst. - Bei Deeplinks wird jetzt geprüft, ob alle erforderlichen Argumente (die ohne Standardwerte) im
Urivorhanden sind. - Bei geparsten
NavDeepLink-Argumenten werden Rautenzeichen jetzt wie Fragezeichen als Trennzeichen zwischen Pfadsegmenten behandelt. Dadurch wird verhindert, dass sich ein Argument über das Rautenzeichen erstreckt. - Beim Generieren von Aktionen werden Argumente ohne Standardwerte im von Safe Args generierten Kotlin-Code jetzt vor Argumenten mit Standardwerten als Parameter platziert.
- Beim Generieren von Argumenten platziert Safe Args jetzt Parameter ohne Standardwerte vor Parametern mit Standardwerten.
- Safe-Args hängt jetzt vom Android-Gradle-Plug-in 4.2.0 ab. Die Warnung, dass
applicationIdTextResourceverwendet wird, sollte jetzt nicht mehr angezeigt werden.
Bekannte Probleme
- In Navigation
2.5.0-alpha01behoben: Der Zugriff auf einViewModel, das überby navGraphViewModels()aus demonCreate()eines Fragments erstellt wurde, schlägt mit einemIllegalStateExceptionfehl. (b/213504272) - In Navigation
2.5.0-alpha01behoben: Safe Args 2.4.0 ist nicht mit dem Android-Gradle-Plug-in 7.1.0 und höher kompatibel. (b/213086135) - Beim Deeplinking mit mehreren verschachtelten Navigationsgraphen wird der vollständige Backstack nicht korrekt erstellt. (b/214383060)
Version 2.4.0-rc01
15. Dezember 2021
androidx.navigation:navigation-*:2.4.0-rc01 ist veröffentlicht. Version 2.4.0-rc01 enthält diese Commits.
Verhaltensänderungen
- Bei geparsten
NavDeepLink-Argumenten werden Rautenzeichen jetzt wie Fragezeichen als Trennzeichen zwischen Argumenten behandelt. (I21309, b/180042703)
Fehlerkorrekturen
- Deeplinks ignorieren keine Argumente mehr, deren Werte mit dem Namen des Platzhalters übereinstimmen. (If8017, b/207389470)
NavControllerstürzt nicht mehr ab, wenn ein verschachteltes Ziel mit Übergängen nach der Wiederherstellung vonNavControllerentfernt wird. (I0f7c9, b/205021623)- Die Fehlermeldung bei Verwendung eines ungültigen
startDestinationwird jetzt standardmäßig auf die Route des Startziels gesetzt, sofern eine verfügbar ist. (I86b9d, b/208041894)
Fehlerkorrekturen für Navigation Compose
- Ein potenzieller Absturz wurde behoben, der durch schnelles Wechseln zwischen dem Startziel und einem anderen Ziel über die Elemente im unteren Navigationsmenü verursacht wurde. (Ic8976, b/208887901)
- Dialogziele werden jetzt nach Konfigurationsänderungen oder Prozessbeendigung ordnungsgemäß oben auf dem Bildschirm wiederhergestellt. (I4c0dc, b/207386169)
- Es wurde ein Problem behoben, bei dem der Versuch, einen
ViewModelaus demNavBackStackEntryeines Dialogfelds abzurufen, fehlschlug, wenn das Dialogfeld geschlossen wurde. (I6b96d, b/206465487) - Es wurde ein Problem behoben, bei dem die Verwendung von
activity-Zielen mitNavHostvon Navigation Compose zu unendlichen Neuzusammensetzungen führte. (I8f64c) - Es wurde ein Leck in Navigation Compose behoben, bei dem nach einer Konfigurationsänderung oder Prozessbeendigung ein Verweis auf die alte Aktivität beibehalten wurde. (I4efcb, b/204905432)
Safe Args-Fehlerkorrekturen
SafeArgsstürzt nicht mehr ab, wenn versucht wird, benutzerdefinierte Parcelable-Arrays nach einer Prozessbeendigung wiederherzustellen. (I618e8, b/207315994)- Ein Fehler in Safe Args wurde behoben, der verhinderte, dass boolesche Arrays den Wert
nullhaben. (I8c396, b/174787525)
Version 2.4.0-beta02
3. November 2021
androidx.navigation:navigation-*:2.4.0-beta02 ist veröffentlicht. Version 2.4.0-beta02 enthält diese Commits.
API-Änderungen
- Bei der Verarbeitung von expliziten und impliziten Deeplinks wird jetzt automatisch das Flag
saveStatehinzugefügt, wenn zu einem anderen Graphen navigiert wird. Dadurch wird sichergestellt, dass Code wieNavigationUI.setupWithNavControllerund Code, der mehrere Back Stacks verwendet, wie erwartet funktioniert. (Ic8807)
Geändertes Verhalten
- Deeplink-Muster werden jetzt in NavDeepLink verzögert kompiliert, anstatt während der Inflation. Dadurch sollte sich die Inflationszeit von Navigationsgraphen mit Deeplinks verbessern. (b8d257, b/184149935)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem NavBackStackEntries nach dem Wechsel zu
Lifecycle.State.STARTEDaufLifecycle.State.CREATEDverschoben wurden, wenn dieNavHostdirekt dersetContent()der Aktivität hinzugefügt wurde. (Ia5ac1, b/203536683) - Es wurde eine Race-Bedingung behoben, bei der das Entfernen eines
DialogFragment-Ziels aus dem Back Stack vor dem eigentlichen Anzeigen des Dialogfelds das Dialogfeld nicht wirklich schloss. Dies führte zu einem Absturz, wenn das fehlerhafte Dialogfeld vom Nutzer manuell geschlossen wurde. (I687e5) - Es wurde ein Problem behoben, bei dem die
onNavDestinationSelectedAPI aufNavigationUIden Werttruezurückgegeben hat, auch wenn Sie nicht tatsächlichnavigate()zu diesem Navigationsgraphen ausgeführt haben. Es wird jetzt dieselbe Logik verwendet, die intern vonsetupWithNavControllerverwendet wird, um nur dieMenuItemauszuwählen, die dem aktuellen Ziel mit derhierarchydes Ziels zugeordnet sind. (I2b053)
Version 2.4.0-beta01
27. Oktober 2021
androidx.navigation:navigation-*:2.4.0-beta01 ist veröffentlicht. Version 2.4.0-beta01 enthält diese Commits.
Neue Funktionen
- Sie können jetzt
by navGraphViewModelmit einer Route anstelle einer ID verwenden, um die Navigation Kotlin DSL mit Fragmenten besser zu unterstützen. (I901e3, b/201446416)
API-Änderungen
- Die
visibleEntriesAPI ist jetzt experimentell. (I93f6f)
Fehlerkorrekturen
- ViewModels werden nicht mehr gelöscht, wenn Übergänge durch Hin- und Herwechseln zwischen denselben Bildschirmen unterbrochen werden (Id52d8, b/200817333).
- Für Nullable-
NavDeepLink-Argumente ist kein Standardwert mehr erforderlich, wenn Deeplinks zuNavDestinations hinzugefügt werden. (I5aad4, b/201320030) - NavBackStackEntries mit unterschiedlichen Lebenszyklen werden nicht mehr als gleich betrachtet. Das bedeutet, dass NavHost alle Ziele ordnungsgemäß neu zusammensetzt, wenn die Navigation mit „singleTop“ erfolgt und wenn Elemente im unteren Menü neu ausgewählt werden. (I1b351, b/196997433)
- Es wurde ein Problem mit
AbstractListDetailFragmentbehoben, das dazu führte, dass die Attributelayout_widthundlayout_weightim vononCreateListPaneView()zurückgegebenen Listenbereich falsch verarbeitet oder ignoriert wurden. (f5fbf3) - Der visuelle Status von Dialogzielen bleibt jetzt korrekt mit dem Status des
DialogFragmentNavigatorsynchronisiert. Das bedeutet, dass durch den manuellen Aufruf der asynchronendismiss()API fürDialogFragmentjetzt alle Dialogziele über dem geschlossenen Dialogfeld ordnungsgemäß gelöscht werden. Dies hat keine Auswirkungen auf Fälle, in denen SiepopUpTooderpopBackStack()verwenden, um das Dialogfeld zu schließen. (I77ba2) AbstractAppBarOnDestinationChangedListenerhat jetzt klarere Fehlermeldungen füronDestinationChanged(). (Ie742d)
Version 2.4.0-alpha10
29. September 2021
androidx.navigation:navigation-*:2.4.0-alpha10 ist veröffentlicht. Version 2.4.0-alpha10 enthält diese Commits.
Neue Funktionen
- NavController bietet jetzt die Möglichkeit, eine Liste aller sichtbaren
NavBackStackEntry-Instanzen über denvisibleEntries-StateFlow abzurufen (Ia964e). rememberNavController()akzeptiert jetzt eine optionale Gruppe vonNavigator-Instanzen, die dem zurückgegebenenNavControllerhinzugefügt werden, um optionale Navigatoren wie die von Accompanist Navigation Material besser zu unterstützen. (I4619e)
Fehlerkorrekturen
- Die dynamische Navigation stürzt nicht mehr ab, wenn die Aktivität neu erstellt wird. (Ifa6a3, b/197942869)
- Es wurde ein Problem mit dem Button „Zurück“ des Systems behoben, das nur auftritt, wenn zu einem zusammensetzbaren Ziel zurückgekehrt wird, das ein
NavHostenthält. (3ed148, b/195668143) - SafeArgs generiert jetzt die Argumente für
fromBundle()undfromSavedStateHandle()in der richtigen Parameterreihenfolge. (I824a8, b/200059831)
Version 2.4.0-alpha09
15. September 2021
androidx.navigation:navigation-*:2.4.0-alpha09 ist veröffentlicht. Version 2.4.0-alpha09 enthält diese Commits.
Neue Funktionen
- Sie können jetzt die Methode
clearBackStack()verwenden, um alle mitpopBackStack()oderpopUpToSaveStategespeicherten Status zu löschen. (I80a0f) - Sie können jetzt eine Liste von Argumenten und/oder Deeplinks an den Builder des verschachtelten Navigationsgraphen übergeben. Diese werden dann automatisch dem resultierenden Graphen hinzugefügt. (I8a470, b/182545357)
API-Änderungen
- Die Kotlin DSL-Funktion
navArgumentist jetzt Teil vonnavigation-commonstattnavigation-compose. Dazu müssen Importe aktualisiert werden, um diese Funktion weiterhin verwenden zu können. (I1d095)
Geändertes Verhalten
- Beim Generieren von Argumenten platziert Safe Args jetzt Parameter ohne Standardwerte vor Parametern mit Standardwerten. (I89709, b/198493585)
Fehlerkorrekturen
- Bei Verwendung von Navigation Compose werden NavGraphs erst dann
DESTROYED, wenn alle ihre untergeordneten ElementeDESTROYEDsind. (I86552, b/198741720) - Für Nullable-
NavDeepLink-Argumente ist kein Standardwert mehr erforderlich. (Ia14ef, b/198689811) - Wenn Sie
setGraph()mit einem neuen Graphen aufrufen, werden jetzt zusätzlich zum bisherigen Verhalten, bei dem der Back Stack entfernt wurde, auch alle gespeicherten Back Stacks gelöscht. (I97f96) - Ein Problem wurde behoben, bei dem
OnDestinationChangedListener-Instanzen und dercurrentBackStackEntryFlowbei Verwendung vonlaunchSingleTopnicht benachrichtigt wurden. (Iaaebc)
Abhängigkeitsupdates
- Navigation Compose hängt jetzt von Activity Compose 1.3.1 ab. (I05829)
- Navigation Compose hängt jetzt von Lifecycle ViewModel Compose
2.4.0-beta01ab. (Ib86a3)
Version 2.4.0-alpha08
1. September 2021
androidx.navigation:navigation-*:2.4.0-alpha08 ist veröffentlicht. Version 2.4.0-alpha08 enthält diese Commits.
Neue Funktionen
- Es ist jetzt möglich, die Klasse
NavTypezu erweitern, um benutzerdefinierte NavTypes zu erstellen. Benutzerdefinierte Typen werden nur unterstützt, wenn Sie Ihren Navigationsgraphen programmatisch erstellen, z. B. über die Kotlin-DSL für Navigationsgraphen. (I78440, b/196871885)
Geändertes Verhalten
- Beim Generieren von Aktionen werden Argumente ohne Standardwerte im von Safe Args generierten Kotlin-Code jetzt vor Argumenten mit Standardwerten als Parameter platziert. (Idb697, b/188855904)
- Bei Deeplinks wird jetzt geprüft, ob alle erforderlichen Argumente (die ohne Standardwerte) im
Urivorhanden sind. (#204, b/185527157)
Fehlerkorrekturen
- Wenn Sie
getBackStackEntryundpreviousBackStackEntryin composable() in Verbindung mitremember()verwenden, wird keine Ausnahme mehr ausgelöst, weil kein Ziel im Back Stack vorhanden ist. (I75138, b/194313238) - Navigation Compose wird jetzt ordnungsgemäß neu zusammengesetzt, wenn Back-Stack-Argumente geändert und
launchSingleTop=trueverwendet wird. (Iebd69, b/186392337) - Beim Aufruf von
setGraphmit einem Graphen mit 13 oder 29 Zielen wird keinArrayIndexOutOfBoundsExceptionmehr zurückgegeben. (I1a9f1, b/195171984) - Der SafeArgs-Java-Generator sollte beim Generieren von Args-Klassen keine Lint-Warnungen mehr verursachen. (I1a666, b/185843837)
Externer Beitrag
- Vielen Dank an ospixd, der dafür gesorgt hat, dass bei Deeplinks geprüft wird, ob alle erforderlichen Argumente (die ohne Standardwerte) im
Urivorhanden sind. (#204, b/185527157)
Version 2.4.0-alpha07
18. August 2021
androidx.navigation:navigation-*:2.4.0-alpha07 ist veröffentlicht. Version 2.4.0-alpha07 enthält diese Commits.
Fehlerkorrekturen
- Navigation Compose speichert den Status jetzt nach Konfigurationsänderungen und beim Ändern von Graphen, wenn die Funktion für mehrere Back Stacks verwendet wird. (If5a3d, b/195141957)
- Wenn Sie denselben Tab noch einmal auswählen, während Sie Navigation Compose mit mehreren Back Stacks verwenden, wird kein leerer Bildschirm mehr angezeigt. (I860dc, b/194925622)
NavHostbeobachtet jetzt Änderungen imLifecycle.StatevonNavBackStackEntrys. Das bedeutet, dass die Verwendung einesNavHostin einem Fragment jetzt bei Änderungen des Lebenszyklus ordnungsgemäß neu zusammengesetzt wird, anstatt einen leeren Bildschirm anzuzeigen. (I4eb85, b/195864489)- Es wurde ein Problem behoben, bei dem das Schließen eines
DialogFragmentden Status desNavControllernach dem Neuerstellen der Aktivität (z.B. nach einer Konfigurationsänderung) nicht korrekt aktualisiert hat. (Icd72b) - Ein Problem wurde behoben, bei dem das Schließen eines Dialogfeldziels die Verarbeitung des System-Buttons „Zurück“ durch den NavController nicht aktualisierte. Dies konnte dazu führen, dass der NavController den Button „Zurück“ abfing, obwohl er keinen Back Stack zum Schließen hatte. (If3b34)
- Safe-args generiert jetzt automatisch eine
toSavedStateHandle-Methode für Argumente, mit der Sie IhrenViewModel-Code testen können. (If1e2d, b/193353880)
Version 2.4.0-alpha06
4. August 2021
androidx.navigation:navigation-*:2.4.0-alpha06 ist veröffentlicht. Version 2.4.0-alpha06 enthält diese Commits.
API-Änderungen
- Die Methoden
requireSlidingPaneLayout()undrequireDetailPaneNavHostFragment()fürAbstractListDetailFragmentwurden ingetSlidingPaneLayout()bzw.getDetailPaneNavHostFragment()umbenannt. (I34a08)
Geändertes Verhalten
- Bei der Navigation mit Animationen (z. B.
Crossfade) erreicht dieLifecycledes neuen Ziels jetzt erst dann denRESUMED, wenn die Animation abgeschlossen ist. (If0543, b/172112072, b/194301889) - In Navigation Compose wird der Graph jetzt von
NavHostals Teil der ersten Komposition festgelegt. (Ieb7be)
Fehlerkorrekturen
- Wenn das letzte Ziel eines Navigationsgraphen entfernt wird, wird kein
ClassCastExceptionmehr ausgelöst. (If0543, b/172112072, b/194301889) - Es wurde ein
NullPointerExceptionbehoben, der auftrat, wenn ein Deeplink ohneUrihinzugefügt und über eine Route oder einen Deeplink navigiert wurde. (938a0c, b/193805425) - Ein Problem in Navigation Compose wurde behoben, bei dem ein Deeplink-
NavBackStackEntryden StatusRESUMEDnicht erreichte. (I192c5) - Es wurde ein Problem behoben, bei dem das Schließen eines Dialogziels die Verarbeitung des System-Buttons „Zurück“ durch den NavController nicht aktualisierte. Dies konnte dazu führen, dass der NavController den Button „Zurück“ abfing, obwohl kein Back Stack zum Schließen vorhanden war. (aosp/1782668)
Version 2.4.0-alpha05
21. Juli 2021
androidx.navigation:navigation-*:2.4.0-alpha05 ist veröffentlicht. Version 2.4.0-alpha05 enthält diese Commits.
Geändertes Verhalten
NavHostvon Navigation Compose verwendet jetzt immer Überblendungen, wenn zwischen Zielen navigiert wird. (I07049, b/172112072)- Sie können jetzt Änderungen am Graphen eines NavHost vornehmen. Graphen mit demselben „startDestination“ und denselben Zielen im Graphen werden als gleich betrachtet und der Back Stack
NavControllerwird nicht gelöscht. (I0b8db, b/175392262)
Fehlerkorrekturen
- Ein
NoSuchElementExceptionbeim Aufrufen vonpopBackStack()innerhalb einesLifecycleObserver, das an einNavBackStackEntryangehängt ist, wurde behoben. Dieser Fehler wurde durch wiedereintretende Aktualisierungen des Status des NavControllers verursacht. (I64621) AbstractListDetailFragmentermöglicht jetzt, dassSlidingPaneLayoutvollständig aus deinem APK entfernt wird, wennAbstractListDetailFragmentnicht verwendet wird. (I611ad)NavGraphundNavDestinationüberschreiben jetzt die equals-Methode, sodass zwei Objekte mit denselben Werten als gleich betrachtet werden. (I166eb, b/175392262)
Version 2.4.0-alpha04
1. Juli 2021
androidx.navigation:navigation-*:2.4.0-alpha04 ist veröffentlicht. Version 2.4.0-alpha04 enthält diese Commits.
Neue Funktionen
- Das Artefakt
navigation-fragmententhält jetzt eine vordefinierte Implementierung eines Layouts mit zwei Bereichen über die neueAbstractListDetailFragment. Dieses Fragment verwendet einSlidingPaneLayout, um einen Listenbereich (der von Ihrer Unterklasse bereitgestellt wird) und einen Detailbereich zu verwalten, der einNavHostFragmentals Implementierung verwendet, wie in unserer Beispielimplementierung zu sehen ist. (Iac4be, b/191276636) - Der
NavHostdes Artefaktsnavigation-composeunterstützt jetzt nebencomposable-Zielen auchdialog-Ziele. Diese Dialogziele werden jeweils in einem ComposableDialogangezeigt, das über dem aktuellencomposable-Ziel schwebt. (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()
}
}
}
API-Änderungen
- Die Funktion
addinNavigatorStatewurde inpushumbenannt. Alle aktuellen Aufrufe vonadd()müssen in push() geändert werden. (Ie89fc, b/172112072) - Benutzerdefinierte
Navigator-Instanzen können jetzt die APIspushWithTransactionundpopWithTransitionaufNavigatorStateverwenden, um ein Ziel asynchron zu pushen oder zu poppen. Diese APIs werden noch von keinem der enthaltenen Navigatoren verwendet. (Ic4d7c, b/172112072)
Geändertes Verhalten
NavDeepLinkBuilderfügt jetztPendingIntent.FLAG_IMMUTABLEzuPendingIntenthinzu, das voncreatePendingIntent()zurückgegeben wird. Dadurch wird sichergestellt, dass diese API wie erwartet funktioniert, wenn sie auf Android 12 ausgerichtet ist. (If8c52)
Fehlerkorrekturen
- Es wurde ein Problem mit
<include-dynamic>behoben, bei dem an den Graphen übergebene Argumente nicht korrekt an den dynamisch eingebundenen Graphen übergeben wurden. (I3e115) - Ein
NullPointerExceptionwurde behoben, der auftrat, wenn zu einem Ziel mit einemstring[]-Argument mit dem Standardwert@nullnavigiert wurde. (I1fbe8) - ProGuard-Regeln für
@Navigator.Namehinzugefügt, um Probleme bei der Verwendung des R8 3.1-Vollmodus zu beheben. (I2add9, b/191654433) - SafeArgs schlägt nicht mehr fehl, wenn Sie Ihre App mit
Kotlin-Versionen vor1.5.0erstellen. (Icd1ff, b/190739257)
Version 2.4.0-alpha03
16. Juni 2021
androidx.navigation:navigation-*:2.4.0-alpha03 ist veröffentlicht. Version 2.4.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem zwei
navigate()-Aufrufe erforderlich waren, um zu einem enthaltenen dynamischen Graphen zu navigieren. (I7785c, b/188859835) - Eine Regression, die in Navigation
2.4.0-alpha01eingeführt wurde, wurde behoben. Dabei wurde das Aufwärtssymbol vonsetupActionBarWithNavController()nicht ordnungsgemäß entfernt, wenn Sie sich auf einem Ziel der obersten Ebene befanden. (I5d443, b/189868637) - Ein
IllegalStateExceptionbeim Aufrufen vonpopBackStack()nach dem vorherigen Entfernen des Root-Diagramms des NavController wurde behoben. (I2a330, b/190265699) - ProGuard-Regeln für
by navArgs()werden jetzt ordnungsgemäß angewendet, wennnavigation-commonoder davon abhängige Artefakte verwendet werden. (I68800, b/190082521) - Eine
OnDestinationChangedListener, die beim ersten Empfang eines Callbacksnavigate()aufruft, erhält jetzt ordnungsgemäß einen zweiten Callback mit dem Ziel, zu dem sie navigiert ist. (Ie5f9e, b/190228815) - Safe Args stürzt nicht mehr ab, wenn es mit dynamischen Funktionsmodulen und AGP 7.0 oder höher verwendet wird. (I69518, b/189966576)
Bekanntes Problem
- Safe Args schlägt bei Verwendung von Gradle
6.7.0aufgrund einer Abhängigkeit von einer älteren Kotlin-Version mit dem FehlerUnable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’fehl. Dies kann durch ein Update auf Gradle 7.0 umgangen werden. (b/190739257)
Version 2.4.0-alpha02
2. Juni 2021
androidx.navigation:navigation-*:2.4.0-alpha02 ist veröffentlicht. Version 2.4.0-alpha02 enthält diese Commits.
Neue Funktionen
- Routen werden jetzt für Aktivitäts-, Fragment- und Dialogziele sowie in der gesamten DynamicNavigation Kotlin DSL unterstützt. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
NavigationUIhat vorübergehend experimentelle APIs hinzugefügt, mit denen Sie das Speichern Ihres Status deaktivieren können. Das Speichern des Status ist zwar das richtige Verhalten, es gibt jedoch immer noch veraltete Bibliotheken (z. B. beibehaltene Fragmente), die beim Speichern des Status nicht unterstützt werden können. So haben Apps die Möglichkeit, langsam von nicht unterstützten APIs wegzukommen. (Idf93c)Die Navigation bietet jetzt die APIs
findDestination()undgetHierarchy(), mit denen sich eine benutzerdefinierte NavigationUI implementieren lässt.findDestination()ist eine Erweiterungsfunktion fürNavGraph, mit der ein Ziel im Graphen gefunden wird.getHierarchy()ist eine Funktion inNavDestination, mit der geprüft werden kann, ob sich ein bestimmtes Ziel in der Hierarchie eines anderen Ziels befindet.(I2932f, b/188183365)val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }NavigationUI-Methoden, die ein
BottomNavigationViewakzeptiert haben, wurden aktualisiert und akzeptieren jetzt die in Material1.4.0eingeführte BasisklasseNavigationBarView. Dadurch können diese Methoden mit demNavigationRailViewverwendet werden. (Ib0b36, b/182938895)Wenn ein
<action>-Element über XML aufgebläht wird, können Animationsattribute Attribute verwenden, die mit der Syntaxapp:enterAnim="?attr/transitionEnter"aus Ihrem Design abgerufen werden. (I07bc1, b/178291654)
API-Änderungen
- Kotlin-DSL-Builder, die eine ID verwenden, wurden eingestellt und sollten durch Builder ersetzt werden, die Routen verwenden (I85b42, b/188816479) (I9f58f, b/188816479).
Fehlerkorrekturen
DialogFragmentNavigatorverwendet jetzt dieNavigatorState.pop()API, um denNavControllerzu informieren, wenn ein Dialogfeld durch Drücken der Zurück-Taste des Systems oder durch Klicken außerhalb des Dialogfelds geschlossen wird. So wird sichergestellt, dass der Status desNavControllerimmer mit dem Status des Navigators synchron ist. (I2ead9)Die Navigation gibt keinen
ConcurrentModificationExceptionmehr zurück, wenn die Liste derOnDestinationChangedListenersüber einenonDestinationChanged-Callback manipuliert wird. (Ib1707, b/188860458)Safe Args stürzt nicht mehr ab, wenn versucht wird, Richtungseigenschaften in Kotlin zu generieren. (Id2416, b/188564435)
Die Methode „setId“ für „NavDestination“ ist jetzt korrekt mit
@IdResannotiert, sodass sie nur Ressourcen-IDs akzeptiert. (I69b80)Der int-Parameter von
findNodeist jetztresIdstattresid. (I7711d)
Abhängigkeitsupdate
- Safe-Args hängt jetzt vom Android-Gradle-Plug-in 4.2.0 ab. Die Warnung, dass
applicationIdTextResourceverwendet wird, sollte jetzt nicht mehr angezeigt werden. (I6d67b, b/172824579)
Version 2.4.0-alpha01
18. Mai 2021
androidx.navigation:navigation-*:2.4.0-alpha01 ist veröffentlicht. Version 2.4.0-alpha01 enthält diese Commits.
Neue Funktionen
- Die Methode
currentBackStackEntryAsFlow()fürNavControllerstellt einFlowbereit, das immer dann ausgegeben wird, wenn sich die aktuelleNavBackStackEntryändert. Dieser Ablauf kann als Alternative zur manuellen Verwaltung einesOnDestinationChangedListenerverwendet werden. (I19c4a, #89, b/163947280)
Mehrere Back Stacks
Der NavController ist für die Verwaltung des Back Stacks von Zielen verantwortlich. Er fügt dem Back Stack Ziele hinzu, wenn du zu ihnen navigate(), und entfernt sie, wenn du popBackStack() aufrufst oder den Zurück-Button des Systems auslöst. Die vorhandene Klasse NavOptions und die Einbindung in <action>-Einträge in der XML-Datei des Navigationsgraphen wurden erweitert, um das Speichern und Wiederherstellen des Backstacks zu unterstützen. (b/80029773)
Im Rahmen dieser Änderung speichern und stellen die NavigationUI-Methoden von onNavDestinationSelected(), BottomNavigationView.setupWithNavController() und NavigationView.setupWithNavController() jetzt automatisch den Status von entfernten Zielen wieder her. Dadurch werden mehrere Back Stacks ohne Codeänderungen unterstützt. Wenn Sie die Navigation mit Fragmenten verwenden, ist dies die empfohlene Methode für die Einbindung mehrerer Back Stacks. (Ie07ca)
Die zugrunde liegenden APIs zum Speichern und Wiederherstellen des Status werden über eine Reihe von Oberflächen bereitgestellt:
In der Navigations-XML kann das Element
<action>jetzt die booleschen Attributeapp:popUpToSaveStateundapp:restoreStateverwenden, um den Status aller überapp:popUpToentfernten Ziele zu speichern und den Status des alsapp:destinationübergebenen Ziels wiederherzustellen:<action android:id=”@+id/swap_stack” app:destination=”@id/second_stack” app:restoreState=”true” app:popUpTo=”@id/first_stack_start_destination” app:popUpToSaveState=”true” />In der
navOptionsKotlin DSL können Sie die boolesche PropertyrestoreStateund die boolesche PropertysaveStateimpopUpTo-Builder hinzufügen:// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.startDestinationId) { saveState = true } }Wenn Sie ein
NavOptions-Objekt manuell über dieNavOptions.Buildererstellen, können Sie diesetRestoreState()und die neue Überladung fürsetPopUpTo()verwenden, die einen zusätzlichensaveState-Parameter akzeptiert.NavOptions navOptions = new NavOptions.Builder() .setLaunchSingleTop(true) .setRestoreState(true) .setPopUpTo(navController.getGraph().getStartDestinationId(), false, // inclusive true) // saveState .build(); navController.navigate(selectedBottomNavId, null, navOptions);Programmatische Aufrufe von
popBackStack()können jetzt einen zusätzlichensaveState-Parameter enthalten.
In allen Fällen speichert und stellt der NavController den Status jedes NavBackStackEntry wieder her, einschließlich aller ViewModel-Instanzen, die auf das Navigationsziel beschränkt sind. Die Navigator-APIs wurden aktualisiert, damit jede Navigator das Speichern und Wiederherstellen des eigenen Status unterstützt.
Die ComposeNavigator, die für composable-Ziele in Navigation Compose verwendet wird, sowie die FragmentNavigator und DynamicFragmentNavigator, die für <fragment>-Ziele in Navigation mit Fragmenten verwendet werden, wurden aktualisiert, um die neuen Navigator APIs zu verwenden und das Speichern und Wiederherstellen des Status zu unterstützen.
Navigationsrouten
Eine Route ist ein String, das ein Ziel eindeutig identifiziert. Bisher wurde dieses Konzept nur in Navigation Compose verwendet, ist jetzt aber Teil der zentralen Navigation APIs. Dies ist eine Alternative zur Verwendung von Ganzzahl-IDs beim Erstellen des Graphen über die Navigation Kotlin DSL. (b/172823546)
Alle APIs, die bisher nur eine ID akzeptiert haben, haben jetzt eine Überladung, die eine Route String akzeptiert. Dazu gehören navigate(), popBackStack(), popUpTo() und getBackStackEntry().
Dies hatte einige Auswirkungen auf die API:
- Das Kotlin-Attribut
popUpToin der Kotlin-DSL wurde zugunsten vonpopUpToIdeingestellt. (I59c73, b/172823546) - Die
getStartDestination()API wurde zugunsten vongetStartDestinationId()eingestellt. (I0887f, b/172823546)
Für Entwickler, die ein Upgrade von früheren Versionen von Navigation Compose auf Navigation Compose 2.4.0-alpha01 durchführen, bedeutet dies, dass die folgenden Importe von Erweiterungsmethoden nicht mehr erforderlich sind und entfernt werden sollten:
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
Das Argument KEY_ROUTE wurde durch das Attribut route in NavDestination ersetzt, sodass Sie navBackStackEntry.destination.route direkt aufrufen können.
API-Änderungen
- Alle Navigationsartefakte wurden in Kotlin neu geschrieben. Dadurch wurde die Null-Zulässigkeit von Klassen verbessert, die Generics verwenden (z. B.
NavType-Unterklassen). Alle Kotlin-Erweiterungsfunktionen, die früher Teil der-ktx-Artefakte waren, wurden in die entsprechenden Hauptartefakte verschoben. Die-ktx-Artefakte werden weiterhin veröffentlicht, sind aber vollständig leer. (b/184292145) NavDeepLinkBuilderunterstützt jetzt das Hinzufügen mehrerer unterschiedlicher Ziele zum generierten Back Stack. (I3ee0d, b/147913689)- Factory-Funktionen für
DynamicNavHostFragmenthinzugefügt (Icd515, b/175222619) - Die eindeutige ID eines
NavBackStackEntrywird jetzt als Teil der öffentlichen API angezeigt. (Ie033a) - Die Felder
nameundargumentsowie die Destrukturierungsfunktionen vonNamedNavArgumentsind jetzt öffentlich. (#174, b/181320559) - Es wurde eine neue
NavBackStackEntry#provideToCompositionLocals-Erweiterung eingeführt, die denNavBackStackEntryfür die relevanten CompositionLocals bereitstellt. (#175, b/187229439)
Safe Args
Safe Args generiert jetzt für jede
NavArgs-Klasse einefromSavedStateHandle()-Methode. (#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) }Safe Args wurde aktualisiert, um von KotlinPoet
1.8.0abhängig zu sein. (#172, b/183990444)
Geändertes Verhalten
- Die Navigation hängt jetzt von Lifecycle
2.3.1ab und markiert jetztsetGraph(),popBackStack(),navigateUp()undnavigate(), die Methoden, die denNavBackStackEntryLifecycleaktualisieren, als@MainThread. Dadurch wird die Navigation an die in Lifecycle2.3.0eingeführte Erzwingung des Hauptthreads angepasst. (b/171125856) - Beim Parsen von Enum-Argumenten aus Deeplinks wird die Groß-/Kleinschreibung jetzt nicht mehr berücksichtigt. So kann ein Deeplink wie
http://www.example.com/redmit einem Deeplinkwww.example.com/{color}übereinstimmen, auch wenn das Enum den WertREDhat. (#152, b/135857840)
Compose-Kompatibilität
androidx.navigation:navigation-compose:2.4.0-alpha01ist nur mit Compose-Version1.0.0-beta07und höher kompatibel.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem nachgestellte Argumentplatzhalter Vorrang vor Deeplinks mit einem übereinstimmenden genauen Suffix hatten. (#153, b/184072811)
NavHostFragmentunterstützt jetzt benutzerdefinierte Navigatoren, die dieselbe@Navigator.Name("dialog")wie die Standard-DialogFragmentNavigatorverwenden. (Ib1c2c, b/175979140)- Das Verhalten von
NavigatorProvider#addNavigatorwurde verbessert, sodass wiederholte Aufrufe mit derselben Instanz keine Probleme mehr verursachen. (#176, b/187443146)
Externe Beiträge
- Vielen Dank an simonschiller für die Unterstützung von Safe Args, die eine
fromSavedStateHandle()-Methode für jedeNavArgs-Klasse generiert. (#122, b/136967621) - Vielen Dank an Bradleycorn, der dafür gesorgt hat, dass beim Parsen von Enum-Argumenten aus Deeplinks die Groß-/Kleinschreibung nicht berücksichtigt wird. (#152, b/135857840)
- Vielen Dank an osipxd für die Behebung eines Problems, bei dem nachgestellte Argumentplatzhalter Vorrang vor Deeplinks mit einem übereinstimmenden genauen Suffix hatten. (#153, b/184072811)
- Vielen Dank an tatocaster für die Aktualisierung von Safe Args, sodass es von KotlinPoet
1.8.0abhängt. (#172, b/183990444) - Vielen Dank an jossiwolf für die Veröffentlichung der Felder
nameundargumentsowie der Destrukturierungsfunktionen vonNamedNavArgument. (#174, b/181320559) - Vielen Dank an jossiwolf für die Einführung einer neuen
NavBackStackEntry#provideToCompositionLocals-Erweiterung, die denNavBackStackEntryfür die relevanten CompositionLocals bereitstellt. (#175, b/187229439) - Vielen Dank an jossiwolf für die Verbesserung des Verhaltens von
NavigatorProvider#addNavigator, damit es bei wiederholtem Aufruf mit derselben Instanz nicht zu Problemen kommt. (#176, b/187443146)
Navigation Compose Version 1.0.0
Version 1.0.0-alpha10
7. April 2021
androidx.navigation:navigation-compose:1.0.0-alpha10 ist veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
API-Änderungen
NavHostakzeptiert jetzt einModifier, das an den zusammensetzbaren Container übergeben wird, der die zusammensetzbaren Ziele umschließt. (I85aca, b/175125483)
Fehlerkorrekturen
NavHostfunktioniert jetzt auch, wenn keinOnBackPressedDispatcherOwnergefunden wird, z. B. bei der Vorschau vonNavHost. (I7d8b4)- Navigation Compose hängt jetzt von Navigation
2.3.5ab. Dadurch wurde ein Problem behoben, das bei der Verwendung vonBackHandlerinnerhalb einesNavHost-Ziels aufgetreten ist. (I7e63b, b/182284739)
Version 1.0.0-alpha09
10. März 2021
androidx.navigation:navigation-compose:1.0.0-alpha09 ist veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
API-Änderungen
LocalViewModelStoreOwner.currentgibt jetzt einen nullableViewModelStoreOwnerzurück, um besser feststellen zu können, ob einViewModelStoreOwnerin der aktuellen Komposition verfügbar ist. APIs, die einenViewModelStoreOwnererfordern, z. B.viewModel()undNavHost, lösen weiterhin eine Ausnahme aus, wenn keinViewModelStoreOwnerfestgelegt ist. (Idf39a)
Fehlerkorrekturen
- Navigation Compose hängt jetzt von Navigation 2.3.4 ab. Diese Version enthält die Korrektur für den Versuch, dasselbe ViewModelStore-Objekt festzulegen, nachdem der Graph festgelegt wurde. (I65c24, b/177825470)
Version 1.0.0-alpha08
24. Februar 2021
androidx.navigation:navigation-compose:1.0.0-alpha08 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
NavHostfüllt jetzt die CompositionLocalLocalSavedStateRegistryOwnermit derNavBackStackEntrydes Ziels. So wird sichergestellt, dass alle direkt in derSavedStateRegistrygespeicherten Zustände zusammen mit dem Ziel gespeichert und wiederhergestellt werden. (I435d7, b/179469431)
Version 1.0.0-alpha07
10. Februar 2021
androidx.navigation:navigation-compose:1.0.0-alpha07 ist veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
Abhängigkeitsupdates
- Navigation Compose hängt jetzt von Lifecycle ViewModel Compose 1.0.0-alpha01 ab, um
viewModel()-Unterstützung fürcomposable-Ziele zu bieten. (I7a374) NavHostverwendet jetzt die neueLocalOnBackPressedDispatcherOwneraus Activity-Compose 1.3.0-alpha01, um dieOnBackPressedDispatcherabzurufen, die für dieNavControllerfestgelegt ist. (I65b12)
Version 1.0.0-alpha06
28. Januar 2021
androidx.navigation:navigation-compose:1.0.0-alpha06 ist veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Es wurde eine
getBackStackEntry(route: String)-Erweiterungsmethode fürNavControllerhinzugefügt, die die zugehörigeNavBackStackEntryzurückgibt. (If8931)
Version 1.0.0-alpha05
13. Januar 2021
androidx.navigation:navigation-compose:1.0.0-alpha05 ist veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Aktualisiert, um von Compose 1.0.0-alpha10 abhängig zu sein.
Version 1.0.0-alpha04
16. Dezember 2020
androidx.navigation:navigation-compose:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
- Aktualisiert für die Kompatibilität mit Compose
1.0.0-alpha09.
Version 1.0.0-alpha03
2. Dezember 2020
androidx.navigation:navigation-compose:1.0.0-alpha03 ist veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, durch das
popBackStack()undnavigateUp()nach einer Konfigurationsänderung oder einer Prozessbeendigung und ‑neuerstellung nicht funktionierten. (Icea47, b/173281473) - Die Navigation zu einem verschachtelten Graphen in Ihrem NavHost funktioniert jetzt ordnungsgemäß. (I0948d, b/173647694)
Version 1.0.0-alpha02
11. November 2020
androidx.navigation:navigation-compose:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Navigation Compose unterstützt jetzt NavOptions für die Verwendung von popUpTo- und launchSingleTop-Vorgängen (If96c3, b/171468994)
- Es wurde eine Navigationsfunktion hinzugefügt, die eine Route anstelle einer ID verwendet. Damit können Sie verschachtelte Graphen in der Navigation Compose DSL erstellen. (I1661d)
- „startDestination“ steht jetzt in der Liste der Parameter für einen NavHost vor der Route (Ie620e).
- Sie können jetzt ein Diagramm mit der Route als Startziel außerhalb einer NavHost-Komposition erstellen. (Iceb75)
Version 1.0.0-alpha01
28. Oktober 2020
android.navigation:navigation-compose:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Das Artefakt navigation-compose ermöglicht die Integration der Navigationskomponente in Jetpack Compose. Dabei werden @Composable-Funktionen als Ziele in Ihrer Anwendung verwendet.
Diese erste Version bietet:
- Eine
NavHostkomponierbare Funktion, mit der Sie Ihren Navigationsgraphen über eine Kotlin-DSL erstellen können. - Festlegung des Bereichs für Lebenszyklus,
ViewModelund gespeicherten Zustand auf Zielebene. - Automatische Integration mit dem Button „Zurück“ des Systems.
- Unterstützung für die Übergabe von Argumenten, das Anhängen von Deeplinks an Ziele und die Rückgabe eines Ergebnisses an vorherige Ziele.
- Spezifische Hilfsprogramme in
rememberNavController()undcurrentBackStackEntryAsState()erstellen, um das Hochstufen des Status und das Verbinden desNavControllermit Composables außerhalb desNavHost(z. B. einer unteren Navigationsleiste) zu ermöglichen.
Weitere Informationen finden Sie im Leitfaden zur Navigation mit Compose.
Version 2.3.5
Version 2.3.5
7. April 2021
androidx.navigation:navigation-*:2.3.5 ist veröffentlicht. Version 2.3.5 enthält diese Commits.
Neue Funktionen
- Wenn Sie mit einem
NavDeepLinkRequestoderUrinavigieren, können Sie jetzt auf denUri, die Aktion und den MIME-Typ im resultierenden Ziel zugreifen, indem Sie den Intent aus Argumenten überKEY_DEEP_LINK_INTENTabrufen. Dies spiegelt die Funktionalität wider, die bereits für externe Deeplinks verfügbar ist. (I975c3, b/181521877)
Fehlerkorrekturen
OnBackPressedCallbacks, die einem Dispatcher mitNavBackStackEntryals LifecycleOwner hinzugefügt wurden, fangen jetzt „Zurück“ ordnungsgemäß ab, nachdem der AktivitätslebenszyklusSTOPPEDund dannSTARTEDist (Iff94f, b/182284739).- Beim Parsen von Deeplink-Domains wird die Groß-/Kleinschreibung nicht mehr berücksichtigt.
www.example.comstimmt also sowohl mitwww.example.comals auch mitwww.Example.comüberein. Bei den Namen der Suchparameter wird weiterhin zwischen Groß- und Kleinschreibung unterschieden. (#144, b/153829033) - Es wurde ein
NullPointerExceptionbehoben, der auftreten konnte, wenn ein Ziel mehrere nicht nullable Standardargumente hatte und Sie zu diesem Ziel navigierten, während Sie nur einen Teil dieser Argumente überschrieben. (aosp/1644827)
Abhängigkeitsupdates
- Das Gradle-Plug-in „Navigation Safe Args“ hängt jetzt vom Kotlin-Gradle-Plug-in 1.4.31 ab. (aosp/1661058, b/181156413)
Externer Beitrag
- Vielen Dank an
bentrengrovefür die Pull-Anfrage, mit der das Parsen von Deeplink-Domains unabhängig von der Groß- und Kleinschreibung gemacht wurde. (#144, b/153829033)
Version 2.3.4
Version 2.3.4
10. März 2021
androidx.navigation:navigation-*:2.3.4 ist veröffentlicht. Version 2.3.4 enthält diese Commits.
Neue Funktionen
ReferenceType-Argumente können jetzt richtig geparst werden, wenn sie als Teil eines Deeplink-URI gesendet werden. Es werden sowohl der ganzzahlige Rohwert als auch Hexadezimalwerte mit dem Präfix0xunterstützt. (#127, b/179166693)- Der
android:defaultValuefür ein Argument mitapp:argType="float"unterstützt jetzt ganzzahlige Standardwerte, sodass Sieandroid:defaultValue="0"verwenden können, anstatt0.0verwenden zu müssen. (#117, b/173766247)
Fehlerkorrekturen
- Problem behoben, bei dem der Installationsfortschritt hängen blieb, wenn die Unterstützung für dynamische Funktionen in der Navigation verwendet wurde. (Ib27a7, b/169636207)
- Der Aufruf von
setViewModelStoreodersetLifecycleOwnermit demselben Objekt, das bereits festgelegt wurde, ist jetzt ein No-Op (Idf491, b/177825470). - Safe-Args fügt jetzt bei Verwendung von Java Unterdrückungsannotationen zu den richtigen Methoden hinzu. (I8fbc5, b/179463137)
Externe Beiträge
- Vielen Dank an
JvmNamefür die Pull-Anfrage, mit der sichergestellt wird, dassReferenceType-Argumente jetzt ordnungsgemäß geparst werden können, wenn sie als Teil eines Deeplink-URI gesendet werden. (#127, b/179166693) - Vielen Dank an
tatocasterfür die Pull-Anfrage, mit derdefaultValuefür ein Argument mitapp:argType=”float”jetzt ganzzahlige Standardwerte unterstützt. (#117, b/173766247)
Version 2.3.3
Version 2.3.3
27. Januar 2021
androidx.navigation:navigation-*:2.3.3 ist veröffentlicht. Version 2.3.3 enthält diese Commits.
Fehlerkorrekturen
- Es kommt nicht mehr zu einem Absturz, wenn ein
NavBackStackEntryentfernt wird, bevor seinLifecyclezuCREATEDverschoben wird. (Ie3ba3) - Es wurde eine Regression behoben, die durch b/171364502 verursacht wurde, bei der die Navigation zu einer Aktivität mit dem Animationsressourcenwert
0einenResourceNotFoundExceptionverursachte. (I7aedb, b/176819931)
Version 2.3.2
Version 2.3.2
2. Dezember 2020
androidx.navigation:navigation-*:2.3.2 ist veröffentlicht. Version 2.3.2 enthält diese Commits.
Fehlerkorrekturen
- Es wurde eine Regression in
NavigationUIbehoben, bei der die Verwendung eines<activity>-Ziels mitonNavDestinationSelecteddazu führte, dass die Navigation zur Aktivität fehlschlug. (I22e34, b/171364502) - Ein Problem wurde behoben, bei dem
navigation-dynamic-features-fragmentdazu führte, dass mehrmals zum neu installierten Ziel navigiert wurde. (aosp/1486056, b/169636207) - Es wurde ein Problem behoben, bei dem Standardargumente bei Verwendung von
launchSingleTopnicht anOnDestinationChangedListener-Instanzen gesendet wurden. (I2c5cb) - Es wurde ein Problem behoben, bei dem beim Navigieren zu einem verschachtelten Navigationsgraphen keine neue Graphinstanz im Back Stack erstellt wurde. (Ifc831)
- Es wurde ein Problem behoben, bei dem die Verwendung von
navigate()mit einempopUpTo, der das letzte Ziel in einem Navigationsgraphen entfernt hat, den Navigationsgraphen nicht sofort zerstört und aus dem Back Stack entfernt hat. (I910a3) - Navigation SafeArgs verwendet jetzt KotlinPoet Version 1.7.2, die Unterstützung für den expliziten API-Modus von Kotlin bietet. (I918b5)
NavHostFragment.findNavController(Fragment)prüft jetzt zusätzlich zu den vorhandenen Prüfungen der Fragmenthierarchie und der Ansichtshierarchie des Fragments auch die Stammdekoransicht eines DialogFragments. So können Sie Dialogfragmente testen, die die Navigation mitFragmentScenarioundNavigation.setViewNavController()verwenden. (I69e0d)
Version 2.3.1
Version 2.3.1
14. Oktober 2020
androidx.navigation:navigation-*:2.3.1 ist veröffentlicht. Version 2.3.1 enthält diese Commits.
Neue Funktionen
- Der Navigations-UI wurden Standard-Animator-Ressourcen hinzugefügt. Sie werden gegenüber den Standard-Animationsressourcen empfohlen. (b/167430145)
- „NavOptions“ überschreibt jetzt die Methoden „hashcode“ und „equals“ (b/161586466)
- Die Navigation enthält jetzt das aktuelle Ziel in der IllegalArgumentException „Kein Ziel mit ID“, was das Debugging für Entwickler verbessern sollte. (b/168311416)
Fehlerkorrekturen
- Safe Args bricht die Rückgabezeile nicht mehr um, auch wenn der generierte Argumentklassenname länger als 100 Zeichen ist. (b/168584987)
Änderungen an Abhängigkeiten
navigation-uihängt jetzt von DrawerLayout 1.1.1 ab, sodassNavigationUIdie Leiste auch dann öffnen kann, wennLOCK_MODE_LOCKED_CLOSEDoderLOCK_MODE_LOCKED_OPENverwendet wird. (b/162253907)- Safe Args hängt jetzt von KotlinPoet 1.6.0 ab (aosp/1435911).
- Safe Args hängt jetzt von AGP 4.0.1 ab (aosp/1442337).
Version 2.3.0
Version 2.3.0
24. Juni 2020
androidx.navigation:navigation-*:2.3.0 ist veröffentlicht. Version 2.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 2.2.0
- Integration von Funktionsmodulen: Mit den Artefakten
navigation-dynamic-features-runtimeundnavigation-dynamic-features-fragmentkönnen Sie zu Zielen navigieren, die in Funktionsmodulen definiert sind. Die Installation der Funktionsmodule wird dabei automatisch nach Bedarf durchgeführt. Weitere Informationen finden Sie unter Mit Funktionsmodulen navigieren. - Navigationstests: Das Artefakt
navigation-testingbietet einenTestNavHostController, mit dem Sie das aktuelle Ziel festlegen und den Back Stack nach Navigationsvorgängen prüfen können. Weitere Informationen finden Sie unter Navigation testen. - Ergebnis zurückgeben: Über den
NavBackStackEntry, der mit jedem Ziel im Back Stack der Navigation verknüpft ist, können Sie jetzt auf einSavedStateHandlezugreifen, das sich zum Speichern kleiner Mengen gespeicherter Zustände eignet, die mit einem bestimmten Back-Stack-Eintrag verknüpft werden sollen. Weitere Informationen finden Sie unter Ergebnis an das vorherige Ziel zurückgeben. NavigationUI-Unterstützung fürOpenable: Alle Verwendungen vonDrawerLayoutinNavigationUIwurden durch die allgemeinereOpenable-Schnittstelle ersetzt, die in CustomView1.1.0hinzugefügt und vonDrawerLayoutin DrawerLayout1.1.0implementiert wurde.- Unterstützung von Aktionen und MIME-Typen in Deeplinks: Deeplinks wurden erweitert, um neben dem zuvor verfügbaren
app:uriauchapp:actionundapp:mimeTypezu unterstützen.NavControllerunterstützt jetzt die Navigation nach einer beliebigen Kombination dieser Felder über die neueNavDeepLinkRequest-Klasse. Weitere Informationen findest du unter Mit NavDeepLinkRequest navigieren.
Bekannte Probleme
- Die Unterstützung für Deeplink-Aktionen und MIME-Typen ist in Manifest Merger noch nicht verfügbar. Bis diese Arbeit abgeschlossen ist, enthalten alle generierten
<intent-filter>-Elemente aus dem<nav-graph>-Element in Ihrem Manifest weder Ihren MIME-Typ im<data>-Element noch Ihre benutzerdefinierte<action>. Sie müssen Ihrem Manifest manuell einen geeigneten<intent-filter>hinzufügen.
Version 2.3.0-rc01
10. Juni 2020
androidx.navigation:navigation-*:2.3.0-rc01 ist veröffentlicht. Version 2.3.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein
NullPointerExceptionbehoben, der auftrat, wenn eine Instanz eines Ziels ohne Argumente durch eine andere Instanz mit Argumenten mitsingleTopersetzt wurde. (b/158006669) - Alle von
NavControllerausgelöstendestination is unknown-Ausnahmen enthalten jetzt zusätzliche Debugging-Informationen, um den Status vonNavControllerzu ermitteln. (b/157764916)
Version 2.3.0-beta01
20. Mai 2020
androidx.navigation:navigation-*:2.3.0-beta01 sind veröffentlicht. Version 2.3.0-beta01 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
LifecyclevonNavBackStackEntrynach der Prozessbeendigung nicht richtig aktualisiert wurde. (b/155218371) OnDestinationChangedListener-Instanzen, die vor dem Aufruf vonsetGraph()registriert wurden, wird nach einer Prozessbeendigung jetzt das wiederhergestellte Ziel gesendet. (b/155218371)- Wenn Sie
singleTopverwenden, werden die Argumente vonNavBackStackEntryjetzt korrekt aktualisiert und die aktualisierten Argumente werden an alleOnDestinationChangeListener-Instanzen gesendet. (b/156545508)
Abhängigkeitsupdates
- Das Artefakt
NavigationUIhängt jetzt von CustomView1.1.0-rc01und DrawerLayout1.1.0-rc01ab. (aosp/1309696)
Version 2.3.0-alpha06
29. April 2020
androidx.navigation:navigation-*:2.3.0-alpha06 ist veröffentlicht. (Version 2.3.0-alpha06 enthält diese Commits.)
Neue Funktionen
- Deeplinks wurden erweitert, um neben dem zuvor verfügbaren
app:uriauchapp:actionundapp:mimeTypezu unterstützen. NavController unterstützt jetzt die Navigation über eine beliebige Kombination dieser Felder über die neueNavDeepLinkRequest-Klasse. (b/136573074, b/135334841)
API-Änderungen
- Die Kotlin-DSL-Unterstützung für dynamische Navigationsziele wurde erheblich erweitert. (b/148969800)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem Deeplink-Intents ignoriert wurden, wenn ein verschachteltes Startziel verwendet wurde. (b/154532067)
Version 2.3.0-alpha05
15. April 2020
androidx.navigation:navigation-*:2.3.0-alpha05 ist veröffentlicht. Version 2.3.0-alpha05 enthält diese Commits.
Neue Funktionen
- Für dynamische Diagrammeinschlüsse mit
<include-dynamic>müssen Sieapp:graphPackagenicht mehr angeben. Es wird ein Standardwert verwendet, indem das SuffixmoduleNamenach einem Punkt anapplicationIdangehängt wird. Wenn Sie IhregraphPackageanpassen müssen, wird jetzt ein${applicationId}-Platzhalter unterstützt. (b/152696768) - Die Kotlin-DSL für Navigationsgraphen stellt jetzt ein
defaultArguments-Mapfür Aktionen bereit. Damit können Standardwerte für<action>-Elemente in Navigations-XML-Dateien festgelegt werden. (b/150345605)
Fehlerkorrekturen
- Ab Navigation 2.2.2: Es wurde ein
IllegalStateExceptionbehoben, der beim Deeplinking zum Startziel des Graphen auftrat, wenn mehrereNavHostFragment-Instanzen in der Aktivität vorhanden waren. (b/147378752)
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Fragment
1.2.4ab. (aosp/1277325) - Die dynamische Navigation hängt jetzt von Play Core
1.7.2ab. (aosp/1282257)
Version 2.3.0-alpha04
18. März 2020
androidx.navigation:navigation-*:2.3.0-alpha04 ist veröffentlicht. Version 2.3.0-alpha04 enthält diese Commits.
Neue Funktionen
- In der Navigation Kotlin DSL wurde Unterstützung für Funktionsmodul-Aktivitäten und Fragmentziele hinzugefügt. (b/148969800)
API-Änderungen
- Die Klasse
DynamicExtrasverwendet kein Builder-Muster mehr und kann jetzt direkt erstellt werden. (aosp/1253671) DynamicActivityNavigatorverwendet jetzt im Konstruktor einContextanstelle einesActivity. (aosp/1250252)
Fehlerkorrekturen
NavigationUIignoriert leere Labels (d.h. ein Ziel mitandroid:label=””) nicht mehr und legt den Titel jetzt korrekt als leeren String fest. (b/148679860)
Abhängigkeitsupdates
- Die Artefakte für dynamische Navigationsfunktionen hängen jetzt von Play Core
1.6.5ab. (b/149556401)
Version 2.3.0-alpha03
4. März 2020
androidx.navigation:navigation-*:2.3.0-alpha03 ist veröffentlicht. Version 2.3.0-alpha03 enthält diese Commits.
API-Änderungen
- Anstatt sich auf die konkrete
DrawerLayout-Klasse zu verlassen, verwendetAppBarConfigurationjetzt die in CustomView1.1.0-alpha02eingeführteOpenable-Schnittstelle (dieDrawerLayoutab DrawerLayout1.1.0-alpha04implementiert), sodass Sie benutzerdefinierte Implementierungen vonOpenablemitNavigationUIverwenden können. (b/129030452)
Fehlerkorrekturen
- Die ProGuard-Regeln für
navigation-common-ktxbehalten jetzt nur die verwendetenNavArgs-Klassen bei, anstatt alleNavArgs-Instanzen. (b/150213558)
Änderungen an Abhängigkeiten
- Die Abhängigkeit von Navigation von Core
1.2.0wurde rückgängig gemacht. Navigation hängt jetzt von Core1.1.0ab, damit Entwickler nicht gezwungen sind, zu einer neueren Abhängigkeit zu wechseln, wenn Navigation nicht von neuen APIs in Core1.2.0abhängt.
Version 2.3.0-alpha02
19. Februar 2020
androidx.navigation:navigation-*:2.3.0-alpha02 ist veröffentlicht. Version 2.3.0-alpha02 enthält diese Commits.
Neue Funktionen
- Mit
NavBackStackEntrykannst du jetzt auf einenSavedStateHandlezugreifen, der sich zum Speichern kleiner Mengen gespeicherter Zustände eignet, die mit einem bestimmten Back-Stack-Eintrag verknüpft werden sollen. Ein Beispiel für einen Anwendungsfall finden Sie unter Ergebnis zurückgeben. (b/79672220)
API-Änderungen
- Die Komfortmethoden
getCurrentBackStackEntry()undgetPreviousBackStackEntry()wurden hinzugefügt, um das Abrufen einesNavBackStackEntryfür das aktuelle und das vorherige Ziel zu vereinfachen. (b/79672220)
Fehlerkorrekturen
navigateUp()übergibt jetzt die Argumente des aktuellen Ziels und dasKEY_DEEP_LINK_INTENTan das vorherige Ziel, wenn die App im eigenen Aufgabenstapel gestartet wird. (b/147456890)
Änderungen an Abhängigkeiten
- Die Navigation hängt jetzt von Core
1.2.0ab.
Version 2.3.0-alpha01
5. Februar 2020
androidx.navigation:navigation-*:2.3.0-alpha01 ist veröffentlicht. Version 2.3.0-alpha01 enthält diese Commits.
Neue Funktionen
- Das neue
navigation-testing-Artefakt stellt eineTestNavHostController-Klasse bereit. Diese Klasse bietet eine Alternative zur Verwendung eines simuliertenNavControllerbeim Testen der Navigation. Sie können damit das aktuelle Ziel festlegen und den Back Stack nach Navigationsvorgängen prüfen. (b/140884273) - Mit dem neuen
navigation-dynamic-features-fragment(und seiner transitiven Abhängigkeitnavigation-dynamic-features-runtime) können Sie Ziele oder ganze Navigationsgraphen (über<include-dynamic>) aus Funktionsmodulen einbeziehen. So können On-Demand-Funktionsmodule nahtlos installiert werden, wenn Sie zu diesen Zielen navigieren. Weitere Informationen finden Sie unter Mit Funktionsmodulen navigieren. (b/132170186)
Diverse Fehlerkorrekturen
- Aus Navigation
2.2.1: Deeplinks ohne Suchparameter ignorieren jetzt Suchparameter korrekt, anstatt sie an nachfolgende{argument}-Elemente anzuhängen oder den Deeplink nicht abzugleichen. (b/147447512) - Aus Navigation
2.2.1: Dienavigation-ui-ProGuard-Regeln fürDrawerArrowDrawablewurden aktualisiert, damitandroid.enableJetifier=truenicht erforderlich ist. (b/147610424) - Aus Navigation
2.2.1: Dasnavigation-common-ktx-Modul hat jetzt einen eindeutigen Manifestpaketnamen, anstatt denselben Manifestpaketnamen wienavigation-runtime-ktxzu verwenden. (aosp/1141947)
Abhängigkeitsupdates
- Ab Navigation
2.2.1: Navigation2.2.1hängt jetzt von Lifecycle ViewModel SavedState2.2.0und Fragment1.2.1ab.
Version 2.2.2
Version 2.2.2
15. April 2020
androidx.navigation:navigation-*:2.2.2 sind veröffentlicht. Version 2.2.2 enthält diese Commits.
Fehlerkorrekturen
- Ein
IllegalStateException-Fehler beim Deeplinking zum Startziel des Graphen, wenn mehrereNavHostFragment-Instanzen in der Aktivität vorhanden sind, wurde behoben. (b/147378752) NavigationUIignoriert leere Labels (d.h. ein Ziel mitandroid:label=””) nicht mehr und legt den Titel jetzt korrekt als leeren String fest. Diese Funktion wurde bereits in Navigation 2.3.0-alpha04 veröffentlicht. (b/148679860)- Die ProGuard-Regeln für
navigation-common-ktxbehalten jetzt nur die verwendetenNavArgs-Klassen bei, anstatt alleNavArgs-Instanzen. Diese Funktion wurde bereits in Navigation 2.3.0-alpha03 veröffentlicht. (b/150213558
Abhängigkeitsupdates
- Die Navigation hängt jetzt von Fragment
1.2.4ab. (aosp/1277325)
Version 2.2.1
Version 2.2.1
5. Februar 2020
androidx.navigation:navigation-*:2.2.1 ist veröffentlicht. Version 2.2.1 enthält diese Commits.
Diverse Fehlerkorrekturen
- Bei Deeplinks ohne Suchparameter werden jetzt alle Suchparameter ignoriert, anstatt sie an nachfolgende
{argument}-Elemente anzuhängen oder den Deeplink nicht abzugleichen. (b/147447512) - Die
navigation-ui-ProGuard-Regeln fürDrawerArrowDrawablewurden aktualisiert, damitandroid.enableJetifier=truenicht erforderlich ist. (b/147610424) - Das Modul
navigation-common-ktxhat jetzt einen eindeutigen Manifest-Paketnamen, anstatt denselben Manifest-Paketnamen wienavigation-runtime-ktxzu verwenden. (aosp/1141947)
Abhängigkeitsupdates
- Navigation
2.2.1hängt jetzt von Lifecycle ViewModel SavedState2.2.0und Fragment1.2.1ab.
Version 2.2.0
Version 2.2.0
22. Januar 2020
androidx.navigation:navigation-*:2.2.0 ist veröffentlicht. Version 2.2.0 enthält diese Commits.
Wichtige Änderungen seit Version 2.1.0
- NavBackStackEntry: Sie können jetzt
NavController.getBackStackEntry()aufrufen und die ID eines Ziels oder Navigationsgraphen im Back Stack übergeben. Der zurückgegebeneNavBackStackEntryenthält neben den Argumenten, die zum Starten dieses Ziels verwendet wurden, auch ein navigationsgesteuertesLifecycleOwner,ViewModelStoreOwner(das gleiche, das vonNavController.getViewModelStoreOwner()zurückgegeben wird) undSavedStateRegistryOwner. - Lifecycle ViewModel SavedState-Integration:
SavedStateViewModelFactoryist jetzt die Standard-Factory, wennby navGraphViewModels()oder derViewModelProvider-Konstruktor mit einemViewModelStoreOwnerverwendet wird, das vonNavController.getBackStackEntry()oderNavController.getViewModelStoreOwner()zurückgegeben wird. - Unterstützung von Suchparametern für Deeplinks: Deeplinks mit Suchparametern unterstützen jetzt neu angeordnete Suchparameter. Argumente mit einem Standardwert oder Argumente, die null sein können, sind jetzt beim Abgleich von Deeplinks optional.
- Verbesserte Unterstützung für Animationen:
NavHostFragmentverwendet jetztFragmentContainerViewaus Fragment 1.2.0. Dadurch werden Probleme mit der Z-Reihenfolge von Animationen und der Weiterleitung von Fenstereinzügen an Fragmente behoben.
Version 2.2.0-rc04
18. Dezember 2019
androidx.navigation:navigation-*:2.2.0-rc04 ist veröffentlicht. Version 2.2.0-rc04 enthält diese Commits.
Diverse Fehlerkorrekturen
- Die von
navigation-uiverwendeten Standard-Einblendungsanimationen wurden an die angepassten Einblendungsanimationen in Fragment1.2.0-rc04angepasst. (b/145769814)
Version 2.2.0-rc03
4. Dezember 2019
androidx.navigation:navigation-*:2.2.0-rc03 ist veröffentlicht. Version 2.2.0-rc03 enthält diese Commits.
Diverse Fehlerkorrekturen
- Es wurde ein Problem beim Parsen von Deeplinks behoben, das auftrat, wenn Suchparameter und ein Argument als letzter Teil des Pfads verwendet wurden. Dadurch wurde verhindert, dass mehr als ein Zeichen des letzten Pfadarguments geparst wurde. (b/144554689)
- Ein Problem beim Parsen von Deeplinks wurde behoben, bei dem optionale Parameter
"@null"anstelle vonnullerhielten. (b/141613546) NavHostFragmentstellt das Diagramm jetzt nach einer Konfigurationsänderung korrekt wieder her, wenn es mitFragmentContainerViewverwendet wird. (b/143752103)
Änderungen an Abhängigkeiten
- Die Navigation hängt jetzt von Lifecycle
2.2.0-rc03, Lifecycle ViewModel SavedState1.0.0-rc03, Activity1.1.0-rc03und Fragment1.2.0-rc03ab, sofern zutreffend.
Version 2.2.0-rc02
7. November 2019
androidx.navigation:navigation-*:2.2.0-rc02 ist veröffentlicht. Version 2.2.0-rc02 enthält diese Commits.
Änderungen an Abhängigkeiten
- Die Navigation hängt jetzt von androidx.lifecycle
2.2.0-rc02ab.
Version 2.2.0-rc01
23. Oktober 2019
androidx.navigation:navigation-*:2.2.0-rc01 wird ohne Änderungen seit 2.2.0-beta01 veröffentlicht. Version 2.2.0-rc01 enthält diese Commits.
Version 2.2.0-beta01
9. Oktober 2019
androidx.navigation:navigation-*:2.2.0-beta01 ist veröffentlicht. Version 2.2.0-beta01 enthält diese Commits.
Neue Funktionen
NavDestinationund die zugehörigen Unterklassen überschreiben jetzttoString(), um beim Debugging hilfreichere Informationen bereitzustellen. (b/141264986)
Verhaltensänderungen
- Zusätzliche Suchparameter werden jetzt beim Abgleich von Deeplinks ignoriert, anstatt dass der Abgleich fehlschlägt. (b/141482822)
Diverse Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem Argumente im Pfad eines Deeplinks ignoriert wurden, wenn auch Suchparameter angegeben waren. (b/141505755)
- Die Kotlin-Erweiterung
navArgs()fürActivitygibt jetzt eine bessere Fehlermeldung aus, wenn keine Extras vorhanden sind. (b/141408999) - Von Safe Args generierte
Directions-Java-Klassen enthalten jetzt Standardwerte. (b/141099045) - Von Safe Args generierte
Args-Java-Klassen enthalten jetzt Standardwerte. (b/140123727) - Wenn ein
Toolbarverwendet wird, animiertNavigationUIdie Textänderung nicht mehr, wenn zwischen zwei Zielen der obersten Ebene gewechselt wird. (b/140848160)
Version 2.2.0-alpha03
18. September 2019
androidx.navigation:navigation-*:2.2.0-alpha03 ist veröffentlicht. Version 2.2.0-alpha03 enthält diese Commits.
Verhaltensänderungen
- Wenn Sie
setViewModelStore()nachsetGraphaufrufen, wird jetzt einIllegalStateExceptionzurückgegeben. Dies sollte immer von derNavHostim Rahmen der Ersteinrichtung festgelegt werden, damit alleNavBackStackEntry-Instanzen einen einheitlichen Speicher fürViewModel-Instanzen haben. (aosp/1111821)
Diverse Fehlerkorrekturen
- Ein
ConcurrentModificationExceptionbei der Verwendung vonViewModel-Instanzen, die an mehrere verschiedeneViewModelStore-Instanzen mit Navigationsdiagramm-Bereich angehängt sind, wurde behoben. (aosp/1112257)
Version 2.2.0-alpha02
5. September 2019
androidx.navigation:navigation-*:2.2.0-alpha02 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Neue Funktionen
- Deeplinks mit Suchparametern unterstützen jetzt neu angeordnete Suchparameter. Argumente mit einem Standardwert oder Argumente, die null sein können, sind jetzt beim Abgleich von Deeplinks optional. (b/133273839)
- Sie können jetzt
NavController.getBackStackEntry()aufrufen und die ID eines Ziels oder Navigationsgraphen im Back Stack übergeben. Der zurückgegebeneNavBackStackEntryenthält neben den Argumenten, die zum Starten dieses Ziels verwendet wurden, auch ein navigationsgesteuertesLifecycleOwner,ViewModelStoreOwner(das gleiche, das vonNavController.getViewModelStoreOwner()zurückgegeben wird) undSavedStateRegistryOwner. (aosp/1101691, aosp/1101710)
Diverse Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem das Hinzufügen eines
NavHostFragmentzuViewPager2mit einemIllegalArgumentExceptionfehlschlug. (b/133640271) NavInflaterruftgetResourceName()jetzt nicht mehr unnötig auf, wodurch die Inflationszeit um bis zu 40 % verkürzt wird. (b/139213740)
Version 2.2.0-alpha01
7. August 2019
androidx.navigation:navigation-*:2.2.0-alpha01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Neue Funktionen
SavedStateViewModelFactoryist jetzt die Standard-Factory, wennby navGraphViewModels()oder derViewModelProvider-Konstruktor mit einem vonNavController.getViewModelStoreOwner()zurückgegebenenViewModelStoreOwnerverwendet wird. (b/135716331)
API-Änderungen
- Aus Navigation
2.1.0-rc01: Die verworfenegetViewModelStore()API fürNavController, die in2.1.0-alpha02eingeführt wurde, wurde entfernt. (aosp/1091021)
Diverse Fehlerkorrekturen
NavHostFragmentverwendet jetztFragmentContainerView, wodurch Probleme mit der Z-Reihenfolge von Animationen und der Weiterleitung von Fenster-Insets an Fragmente behoben werden. (b/137310379)
Version 2.1.0
Version 2.1.0
5. September 2019
androidx.navigation:navigation-*:2.1.0 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Wichtige Änderungen seit Version 2.0.0
- ViewModels auf einen Navigationsgraphen beschränken: Sie können jetzt ViewModels erstellen, die auf der Ebene des Navigationsgraphen beschränkt sind. Verwenden Sie dazu den Property-Delegaten
by navGraphViewModels()für Kotlin-Nutzer, die die-ktx-Bibliotheken verwenden, oder diegetViewModelStoreOwner()API, die zuNavControllerhinzugefügt wurde. Weitere Informationen finden Sie unter UI-bezogene Daten zwischen Zielen freigeben. - Dialogziele: Sie können jetzt
<dialog>-Ziele erstellen, die einDialogFragmentanzeigen, wenn Sie sienavigate.NavHostFragmentunterstützt standardmäßig Dialogziele. Weitere Informationen finden Sie unter Ziel aus einem DialogFragment erstellen. - Navigation per URI: Sie können jetzt mit einem
Urieinnavigateausführen. Dabei wird der<deepLink>verwendet, den Sie einem Ziel hinzugefügt haben, um dorthin zu navigieren. Weitere Informationen finden Sie unter Mit URI navigieren. - NavHostController: APIs, die speziell für die Erstellung eines benutzerdefinierten
NavHostverwendet werden, wurden nachNavHostControllerverschoben. Dadurch können Implementierungen ihreNavControllermit dem Hosting-LifecycleOwner,OnBackPressedDispatcherundViewModelStoreverbinden.
Version 2.1.0-rc01
7. August 2019
androidx.navigation:navigation-*:2.1.0-rc01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
API-Änderungen
- Die verworfene
getViewModelStore()API aufNavController, die in2.1.0-alpha02eingeführt wurde, wurde entfernt. (aosp/1091021)
Version 2.1.0-beta02
19. Juli 2019
androidx.navigation:*:2.1.0-beta02 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Diverse Fehlerkorrekturen
- Unbeabsichtigte jacoco-Abhängigkeit entfernt, die in
2.1.0-beta01eingeführt wurde. (b/137782950)
Version 2.1.0-beta01
17. Juli 2019
androidx.navigation:*:2.1.0-beta01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Neue Funktionen
NavigationUIanimiert jetzt das Entfernen der Aufwärtsschaltfläche, wennsetupWithNavController()mit einemToolbaroderCollapsingToolbarLayoutverwendet wird. (b/131403621)
Diverse Fehlerkorrekturen
- Ein Timing-Problem bei der Verwendung mehrerer NavHostFragments mit demselben Container mit
findNavController()wurde behoben. (b/136021571)
Version 2.1.0-alpha06
2. Juli 2019
androidx.navigation:*:2.1.0-alpha06 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Neue Funktionen
- Das von NavHostFragment verwendete Attribut
app:navGraphwurde jetzt in das Artefaktnavigation-runtimeverschoben. Benutzerdefinierte Navigatoren, die über XML hinzugefügt werden können, sollten dieses Attribut verwenden, um die Integration in den Hostbereich des Navigationseditors zu ermöglichen. (b/133880955)
API-Änderungen
- Die
getViewModelStore()API aufNavControllerwurde zugunsten der neuengetViewModelStoreOwner()-Methode eingestellt, die eineViewModelStoreOwnerzurückgibt. (aosp/987010) - Die Implementierung von Zielen mit unverankerten Fenstern, z. B.
<dialog>-Zielen, wurde in eine Markierungsschnittstelle (FloatingWindow) verallgemeinert, die jetzt von allen<dialog>-Zielen implementiert wird. NavigationUI-Methoden für die Interaktion mit der oberen App-Leiste ignorieren jetztFloatingWindow-Ziele. (b/133600763)
Verhaltensänderungen
- Die Navigation wird jetzt korrekt mit dem synchronisiert, was auf dem Bildschirm angezeigt wird, wenn ein
<dialog>-Ziel verwendet wird. Daher werden in der Navigation jetzt automatisch<dialog>-Ziele entfernt, wenn Sie zu einem Ziel navigieren, das kein Dialogfeld und keine Aktivität ist, z. B. ein<fragment>-Ziel. (b/134089818)
Diverse Fehlerkorrekturen
- In der Navigation wird jetzt die Animation unterdrückt, die beim Neuerstellen der Aktivität beim Verarbeiten eines Deeplinks auftritt. Dadurch wird ein visuelles Flackern behoben. (b/130362979)
- Es wurde ein Fehler behoben, durch den der Back Stack der Navigation nicht mehr synchron war, wenn ein Fragment entfernt wurde, während das ursprüngliche Fragment hinzugefügt wurde. (b/133832218)
Version 2.1.0-alpha05
5. Juni 2019
androidx.navigation:*:2.1.0-alpha05 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
API-Änderungen
- Hostbezogene APIs in
NavControllerwurden umbenannt und in eine neue Unterklasse vonNavController,NavHostController, verschoben. (aosp/966091) - Die Methode
setHostOnBackPressedDispatcherOwner()vonNavControllerwurde durch die MethodesetOnBackPressedDispatcher()vonNavHostControllerersetzt. Jetzt musssetLifecycleOwner()vor dem Aufruf aufgerufen werden. (aosp/965409) NavHostControllerenthält jetzt eineenableOnBackPressed(boolean)-Methode, die dieNavHostOnBackPressedManager-Klasse ersetzt, die zuvor vonsetHostOnBackPressedDispatcherOwner()zurückgegeben wurde. (aosp/966091)
Diverse Fehlerkorrekturen
- Ein Problem wurde behoben, durch das der Back Stack nach der Navigation per URI nicht korrekt war. (b/132509387)
- Deeplinks, die automatisch von NavController verarbeitet werden, werden jetzt nur einmal ausgelöst. (b/132754763)
Version 2.1.0-alpha04
16. Mai 2019
androidx.navigation:*:2.1.0-alpha04 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Diverse Fehlerkorrekturen
NavHostFragmentberücksichtigtapp:defaultNavHostkorrekt, wenn Ereignisse des System-Buttons „Zurück“ abgefangen werden. Dadurch wird eine Regression in Navigation2.1.0-alpha03behoben. b/132077777DialogFragmentNavigatorverarbeitet jetztpopBackStack()- undnavigateUp()-Vorgänge korrekt. b/132576764- Ein
IllegalStateException: unknown destination during restore-Problem wurde behoben, das beim wiederholten Navigieren zwischen verschachtelten Graphen auftrat. b/131733658
Version 2.1.0-alpha03
7. Mai 2019
androidx.navigation:*:2.1.0-alpha03 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Bekannte Probleme
- NavHostFragment fängt trotz Verwendung von
app:defaultNavHost="false"weiterhin den System-Button „Zurück“ ab. b/132077777
Neue Funktionen
- Du kannst jetzt
<dialog>Ziele erstellen, für die einDialogFragmentangezeigt wird, wenn du sienavigate.NavHostFragmentunterstützt standardmäßig Dialogziele. b/80267254 - Zusätzlich zum Aufruf von
navigatemit einer Ressourcen-ID oder einerNavDirections-Instanz kannst du jetzt über eineUrinavigieren, die die<deepLink>verwendet, die du einem Ziel hinzugefügt hast, um zum richtigen Ziel zu navigieren. b/110412864
Verhaltensänderungen
- Die von NavigationUI bereitgestellten Standardanimationen wurden von 400 ms auf 220 ms beschleunigt, um der Standardanimationsgeschwindigkeit von Aktivitäten und Fragmenten zu entsprechen. b/130055522
API-Änderungen
- Die Methode
createFragmentNavigator()vonNavHostFragmentwurde eingestellt und ihre Funktionalität wurde in die neue MethodeonCreateNavController()verschoben. So ist klarer, dass dies der richtige Einstiegspunkt ist, um benutzerdefinierte Navigatoren hinzuzufügen, wenn Sie eine Unterklasse vonNavHostFragmenterstellen. b/122802849 NavDestinationwurde die MethodehasDeepLink()hinzugefügt, mit der Sie prüfen können, ob ein bestimmterUrivon diesem Ziel oder, im Fall vonNavGraph, von einem beliebigen Ziel im Navigationsdiagramm verarbeitet werden kann. b/117437718
Diverse Fehlerkorrekturen
- Standardargumente werden jetzt korrekt an
OnDestinationChangedListener-Instanzen übergeben. b/130630686 NavHostFragmentfängt jetzt System-Zurück-Ereignisse mitOnBackPressedDispatcherab. Dadurch wird ein Problem behoben, das bei der bedingten Navigation in Fragment-Lebenszyklusmethoden bei der Rückkehr zu einem Fragment auftrat. b/111598096- Bei Safe Args wird ein
android:defaultValue=”@null”mit einem nicht angegebenenapp:argTypejetzt korrekt alsstring-Argument abgeleitet. b/129629192
Version 2.1.0-alpha02
3. April 2019
androidx.navigation:*:2.1.0-alpha02 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.
Neue Funktionen
- Sie können jetzt ViewModels erstellen, die auf der Ebene des Navigationsgraphen über den Attributdelegierten
by navGraphViewModels()für Kotlin-Nutzer oder über diegetViewModelStore()API, die zuNavControllerhinzugefügt wurde, zugänglich sind. b/111614463
API-Änderungen
- Sie können jetzt einem
<activity>-Ziel einapp:targetPackagehinzufügen, um den übereinstimmenden Paketnamen einzuschränken.app:targetPackage="${applicationId}"wird unterstützt, um das Paket auf Ihre eigene Anwendungs-ID zu beschränken. b/110975456
Diverse Fehlerkorrekturen
- Das
android:namefür<activity>-Ziele wird beim Aufblähen nicht mehr in eine Klasse geparst, um ClassNotFoundExceptions bei der Verwendung dynamischer Funktionen zu verhindern. b/124538597
Version 2.1.0-alpha01
19. März 2019
Dies ist die erste Alpha-Version von Navigation 2.1.0.
Änderungen an Abhängigkeiten
- Die Navigation hängt jetzt von
androidx.core:core:1.0.1undandroidx.fragment:fragment:1.1.0-alpha05ab. In dieser Version wird auch die Abhängigkeit vonandroidx.legacy:legacy-support-core-utils:1.0.0entfernt. b/128632612
API-Änderungen
- Eine neue
Navigation.createNavigateOnClickListener(NavDirections)-Methode wurde als Alternative zum Erstellen eines Klick-Listeners mit einer Ressourcen-ID und einem Bundle hinzugefügt. b/127631752 FragmentNavigator.instantiateFragmentwurde eingestellt. Die Standardimplementierung verwendet jetztFragmentFactory, um Fragmente zu instanziieren. b/119054429
Fehlerkorrekturen
- Die Navigation sendet keinen Null-
Bundlemehr, wenn Argumente an ein Ziel angehängt sind. Dadurch wird ein Problem bei der Verwendung vonandroid:defaultValue="@null"behoben. b/128531879 - Safe Args hängt jetzt von KotlinPoet 1.1.0 ab, wodurch ein Problem mit extrem langen Paketnamen behoben wird. b/123654948
Version 2.0.0
Version 2.0.0
14. März 2019
Die Navigation 2.0.0 wird ohne Änderungen gegenüber 2.0.0-rc02 veröffentlicht.
Version 2.0.0-rc02
6. März 2019
Navigation 2.0.0-rc02 bietet neue Artefakte mit der Gruppen-ID androidx.navigation und ändert die Abhängigkeiten in die AndroidX-Entsprechungen.
Das Verhalten von 2.0.0-rc02 ist mit dem Verhalten von Navigation 1.0.0-rc02 identisch. Für die Aktualisierung von 1.0.0-rc02 sind keine Änderungen an Ihrem Code erforderlich, außer dass Sie Ihre Abhängigkeiten an die neuen Abhängigkeiten anpassen müssen.
Ihr Projekt muss zu AndroidX migriert worden sein, damit Sie die 2.X-Releases der Navigation SDK verwenden können. Navigation 1.0 Stable ist die letzte Version, die die Support Library-Abhängigkeiten verwendet. Alle zukünftigen Entwicklungen nach Version 1.0 basieren auf AndroidX und auf der stabilen Version 2.0.
Abhängigkeiten vor AndroidX
Fügen Sie für die Navigation-Versionen vor AndroidX die folgenden Abhängigkeiten hinzu:
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
}
Fügen Sie für Safe Args den folgenden classpath in die build.gradle-Datei auf der obersten Ebene ein:
buildscript {
repositories {
google()
}
dependencies {
classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
}
}
Version 1.0.0
Version 1.0.0
14. März 2019
Die Navigation 1.0.0 wird ohne Änderungen gegenüber 1.0.0-rc02 veröffentlicht.
Version 1.0.0-rc02
26. Februar 2019
Dies ist der zweite Releasekandidat für die stabile Version 1.0.0 von Navigation. Diese Version enthält eine Reihe von Fehlerkorrekturen.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
popBackStack()ignoriert wurde, wenn das Root-Diagramm keine ID hatte. b/126251695 navigateUp()verarbeitet jetzt die Rückkehr zur Aufgabe deiner App korrekt, wenn sie nach der Verarbeitung eines Deeplinks ohneFLAG_ACTIVITY_NEW_TASKaufgerufen wird. b/126082008- Ein Problem wurde behoben, bei dem
ActivityNavigator.applyPopAnimationsToPendingTransitionnicht die richtige Pop-Exit-Animation angewendet hat b/126237567 - Kotlin-Code, der von Safe Args generiert wird, maskiert jetzt Kotlin-Schlüsselwörter wie
inundfunim Paketnamen, der mit der KlasseRverknüpft ist. b/126020455
Version 1.0.0-rc01
21. Februar 2019
Dies ist ein Releasekandidat für die stabile Version 1.0.0 von Navigation. Diese Version enthält eine Fehlerkorrektur.
Fehlerkorrekturen
- Problem bei der Verwendung von Fragmenten und
singleTop-Navigationsvorgängen behoben b/124294805
Version 1.0.0-beta02
12. Februar 2019
Diese Version umfasst eine Reihe kleinerer Verbesserungen und wichtiger Fehlerkorrekturen.
Neue Funktionen
- Sie können jetzt
0alsandroid:defaultValuefürreference-Argumente verwenden. b/124248602
Verhaltensänderungen
- Genaue Deeplink-Übereinstimmungen werden jetzt gegenüber Deeplinks mit
.*- oder Argumentübereinstimmungen priorisiert. b/123969518
Fehlerkorrekturen
popBackStack()undnavigateUpgeben jetzt korrektfalsezurück, wenn das letzte Ziel im Back Stack entfernt wird. Dadurch wird eine Regression behoben, die in1.0.0-beta01eingeführt wurde. b/123933201- Die Navigation legt jetzt beim Wiederherstellen des gespeicherten Instanzstatus die
ClassLoaderkorrekt fest. Dadurch werden Probleme vermieden, wenn benutzerdefinierte Klassen im gespeicherten Status vonNavigatoroder in Argumenten verwendet werden, die an einNavDestinationgesendet werden. b/123893858 - Von Safe Args generierte NavArgs-Klassen stürzen nicht mehr ab, wenn ein
Parcelable[]-Argument aus dem gespeicherten Instanzstatus wiederhergestellt wird. b/123963545 - Safe Args bereinigt jetzt unnötige generierte Kotlin-Klassen ordnungsgemäß. b/124120883
Version 1.0.0-beta01
4. Februar 2019
Dies ist die erste Betaversion der Navigation API. Es wird erwartet, dass die Navigation API bis zur nächsten Version stabil bleibt, sofern kein kritisches Problem auftritt. Diese Version enthält einige Fehlerkorrekturen und Verhaltensänderungen.
Verhaltensänderungen
- Die Navigation sorgt jetzt dafür, dass Standardwerte für Argumente zur Laufzeit und über Safe Args identisch behandelt werden. Daher können nur Argumente mit einem
app:argType="reference"einen Standardwert haben, der auf eine andere Ressource verweist (z. B.@color/colorPrimary). Wenn Sie versuchen, einen Referenzstandardwert mit einem anderenapp:argTypezu verwenden, wird beim Parsen der Navigations-XML eine Ausnahme ausgelöst. b/123551990 - Safe Args hängt jetzt vom Android-Gradle-Plug-in 3.3.0 ab aosp/888413
- Safe Args hängt jetzt von Kotlin 1.3.20 ab aosp/888414
Fehlerkorrekturen
- Safe Args können jetzt in Bibliotheks- und Funktionsmodulen in allen Versionen des Android-Gradle-Plug-ins verwendet werden. b/121304903
- Es wurde eine Regression behoben, die dazu führte, dass ein einzelner
popBackStack()-Vorgang alle Kopien eines Ziels vom Back Stack entfernte, anstatt nur ein einzelnes Ziel auf einmal. b/123552990 - Ein Problem wurde behoben, bei dem der Status von
FragmentNavigatornicht mehr mit dem Status vonNavControllersynchronisiert war, was beim Versuch, den Back Stack wiederherzustellen, zu einemIllegalStateExceptionführte. b/123803044 - Ein Problem wurde behoben, bei dem der von
NavigationUIverarbeitete Zurückpfeil nicht angezeigt wurde, wenn ProGuard mit Obfuskation verwendet wurde. b/123449431 - Der von Safe Args generierte Code verarbeitet jetzt ordnungsgemäß die Verwendung eines
app:argType, das auf eine statische innere Klasse im Format.OuterClass$InnerClassverweist. b/123736741 - Der von Safe Args generierte Java-Code verarbeitet jetzt globale Aktionen und tief verschachtelte Ziele ordnungsgemäß. b/123347762
Version 1.0.0-alpha11
23. Januar 2019
Dies ist ein Hotfix-Release von 1.0.0-alpha10, mit dem ein Problem mit Safe Args behoben wird.
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem Safe Args die Directions-Klasse, die mit globalen Aktionen verknüpft ist, nicht importieren konnte. b/123307342
Version 1.0.0-alpha10
23. Januar 2019
Bekannte Probleme
- Safe Args kann die mit globalen Aktionen verknüpfte Directions-Klasse nicht importieren. b/123307342
Diese Version enthält funktionsgefährdende API-Änderungen. Weitere Informationen finden Sie unten im Abschnitt Funktionsgefährdende Änderungen.
Neue Funktionen
- Kotlin-Nutzer können jetzt den Property-Delegaten
by navArgs()verwenden, um eine Referenz auf eine von Safe Args generierteNavArgs-Klasse in einerActivityoder einemFragmentabzurufen. b/122603367 - Mit Safe Args können Sie jetzt Kotlin-Code generieren, indem Sie das Plug-in
androidx.navigation.safeargs.kotlinanwenden. Der Kotlin-Code wurde speziell für reine Kotlin-Module entwickelt. Dabei werden Standardargumente und unveränderliche Klassen anstelle des Builder-Musters verwendet, das weiterhin über das vorherigeandroidx.navigation.safeargs-Plug-in verfügbar ist. b/110263087
Geändertes Verhalten
- Übereinstimmende Deeplinks werden jetzt bevorzugt, wenn sie die meisten übereinstimmenden Argumente haben. b/118393029
- Wenn
setGraph()auf einemNavControlleraufgerufen wird, wird jetzt der Back Stack zurückgesetzt. b/111450672 - Unbekannte Deeplinks lösen keine
IllegalStateExceptionmehr aus, sondern werden ignoriert. Dadurch werden Probleme mit verschachtelten oder mehrerenNavHostFragments behoben. b/121340440
Funktionsgefährdende Änderungen
- Die Methode
NavOptions.applyPopAnimationsToPendingTransition()zum Anwenden von Pop-Animationen auf eine Aktivität wurde nachActivityNavigatorverschoben. b/122413117 - Safe Args vermeidet jetzt das Duplizieren identischer Klassen für Aktionen ohne Argumente. Der Rückgabetyp für Methoden ohne Argumente in generierten NavDirections-Klassen ist jetzt
NavDirections. b/123233147 - Von Safe Args generierte Directions-Klassen haben keinen öffentlichen Konstruktor mehr. Sie sollten nur mit den generierten statischen Methoden interagieren. b/123031660
- Von Safe Args generierte
NavDirections-Klassen haben keinen öffentlichen Konstruktor mehr. Sie sollten nur über die statischen Methoden in den generierten Directions-Klassen generiert werden. b/122963206 - Der zurückgegebene
Bundleaus demgetArguments()vonNavDirectionswird jetzt als@NonNullund nicht mehr als@Nullablegekennzeichnet. b/123243957
Fehlerkorrekturen
NavDeepLinkBuilderverarbeitet jetzt mehrere gleichzeitigePendingIntents an dasselbe Ziel korrekt. Dazu werden die von Ihnen übergebenen Argumente verwendet, um die Eindeutigkeit zu bestimmen. b/120042732NavControllerverarbeitet jetztpopBackStack()-Vorgänge korrekt, wenn ein verschachteltesNavHostFragmentoder andere untergeordnete Fragmente mit einem Back Stack verwendet werden. b/122770335NavigationUIlegt jetzt die Inhaltsbeschreibung der Schaltfläche „Nach oben“ korrekt fest. b/120395362- Von Safe Args generierte Directions-Klassen verarbeiten jetzt globale Aktionen, die dieselbe ID wie eine Aktion für ein Ziel haben, korrekt. b/122962504
- Von Safe Args generierte
NavDirections-Klassen haben jetzt korrektehashCode()-Werte, wennequals()„true“ zurückgibt. b/123043662 FragmentNavigatorgibt jetzt eine bessere Fehlermeldung aus, wenn Sie versuchen, benutzerdefinierteFragmentTransactionsfür dieFragmentManagervonNavHostFragmentauszuführen. Sie sollten immergetChildFragmentManager()verwenden. b/112927148
Version 1.0.0-alpha09
18. Dezember 2018
Diese Version enthält funktionsgefährdende API-Änderungen. Weitere Informationen finden Sie unten im Abschnitt Funktionsgefährdende Änderungen.
Wir haben uns entschieden, das android.arch.navigation:navigation-testing-Artefakt nicht weiterzuentwickeln. Es hat sich zwar für interne Tests von NavController als hilfreich erwiesen, wir empfehlen jedoch dringend alternative Teststrategien, z. B. das Mocking der NavController-Instanz, um zu prüfen, ob die richtigen navigate()-Aufrufe ausgeführt werden. Dieser Ansatz wird im Vortrag zu Single Activity auf dem AndroidDevSummit 2018 ausführlich erläutert. Wir arbeiten an einer zusätzlichen Dokumentation, die sich speziell mit dem Testen mit Navigation befasst.
Neue Funktionen
- Bei
MenuItems mitmenuCategory="secondary"wird der Back Stack nicht mehr entfernt, wenn sie mitNavigationUI-Methoden verwendet werden. b/120104424 - Mit
AppBarConfigurationkönnen Sie jetzt eine Fallback-OnNavigateUpListener-Instanz festlegen, die aufgerufen wird, wennnavController.navigateUp()den Wertfalsezurückgibt. b/79993862 b/120690961
Funktionsgefährdende Änderungen
- Wenn Sie einen
<argument>mit einemargType="reference"verwenden, parst Navigation die Referenz nicht mehr, sondern stellt die Rohressourcen-ID selbst bereit. b/111736515 onNavDestinationSelected()kehrt jetzt standardmäßig zum Startziel des Navigationsdiagramms zurück, sodass sie mit densetup-Methoden konsistent sind. Fügen SiemenuCategory="secondary"zuMenuItemhinzu, um zu vermeiden, dass der Back Stack entfernt wird. aosp/852869- Die
fromBundle()-Methoden der generiertenArgs-Klassen verwenden jetzt einen Nicht-Null-Bundleanstelle eines Null-Bundle. aosp/845616
Fehlerkorrekturen
- Argumente werden jetzt korrekt aus Deeplinks als der richtige
argTypegeparst, anstatt immer als Strings b/110273284 - Navigation exportiert jetzt die öffentlichen Ressourcen korrekt b/121059552
- Safe Args ist jetzt mit dem Android-Gradle-Plug-in 3.4 Canary 4 und höher kompatibel (b/119662045).
Version 1.0.0-alpha08
6. Dezember 2018
Diese Version enthält funktionsgefährdende API-Änderungen. Weitere Informationen finden Sie unten im Abschnitt Funktionsgefährdende Änderungen.
Neue Funktionen
- Wenn Ziellabels mit
NavigationUI-Methoden verwendet werden, werden{argName}-Instanzen in Ihremandroid:labeljetzt automatisch durch das richtige Argument ersetzt. b/80267266 - Die Navigation hängt jetzt von der Support-Bibliothek 28.0.0 ab (b/120293333).
Funktionsgefährdende Änderungen
OnNavigatedListenerwurde inOnDestinationChangedListenerumbenannt b/118670572OnDestinationChangedListenerübergibt jetzt auch dieBundlevon Argumenten. aosp/837142- Die Attribute
app:clearTaskundapp:launchDocumentsowie die zugehörigen Methoden wurden entfernt. Verwenden Sieapp:popUpTomit dem Stamm Ihres Graphen, um alle Ziele aus dem Back Stack zu entfernen. b/119628354 ActivityNavigator.Extrasverwendet jetzt einBuilder-Muster und bietet die Möglichkeit, beliebigeIntent.FLAG_ACTIVITY_-Flags festzulegen. aosp/828140NavController.onHandleDeepLinkwurde inhandleDeepLinkumbenannt. aosp/836063- Viele Klassen und Methoden, die nicht für die Erstellung von abgeleiteten Klassen vorgesehen sind, z. B.
NavOptions,NavInflater,NavDeepLinkBuilderundAppBarConfiguration, wurden alsfinaldeklariert. aosp/835681 - Die verworfene Methode
NavHostFragment.setGraph()wurde entfernt aosp/835684 - Die verworfene Methode
NavigationUI.navigateUp(DrawerLayout, NavController)wurde entfernt. aosp/835684 - Die Fragmenterstellung wurde nach
FragmentNavigatorverschoben, sodass die Fragmenterstellung einfacher an einenFragmentFactorydelegiert werden kann. b/119054429 - Der Konstruktor für
NavGraphNavigatorverwendet keinenContextmehr. aosp/835340 - NavigatorProvider ist jetzt eine Klasse und keine Schnittstelle mehr. Die von
getNavigatorProvider()zurückgegebeneNavigatorProviderhat ihre Funktionalität nicht geändert. aosp/830660 NavDestination.navigate()wurde entfernt. Stattdessennavigate()aufNavigatoraufrufen. aosp/830663- Umfangreiches Refactoring von
Navigator, sodassOnNavigatorNavigatedListenernicht mehr erforderlich ist und stattdessennavigatedieNavDestinationzurückgibt, zu der navigiert wurde. Navigator-Instanzen können keine Pop-Ereignisse mehr anNavControllersenden. Du kannst einenOnBackPressedCallbackverwenden, um das Drücken des Buttons „Zurück“ abzufangen undnavController.popBackStack()aufzurufen. aosp/833716
Fehlerkorrekturen
popUpTofunktioniert jetzt einheitlich, wenn das Ziel ein<navigation>-Element ist. b/116831650- Es wurden mehrere Fehler behoben, die bei der Verwendung verschachtelter Diagramme zu einem
IllegalArgumentExceptionführten. b/118713731 b/113611083 b/113346925 b/113305559 - Das Attribut
dataPatternvon<activity>-Zielen füllt jetzt Argumente aus Nicht-String-Argumenten, indemtoString()aufgerufen wird. b/120161365
Safe Args
- Safe Args unterstützt serialisierbare Objekte, einschließlich Enum-Werte. Für Enum-Typen kann ein Standardwert festgelegt werden, indem das Enum-Literal ohne den Klassennamen verwendet wird (z. B.
app:defaultValue="READ"). b/111316353 - Safe Args unterstützt Arrays aller unterstützten Typen b/111487504
- Safe Args ignoriert jetzt Unterordner von Ressourcenverzeichnissen b/117893516
- Safe Args fügt gegebenenfalls
@Override-Anmerkungen hinzu b/117145301
Version 1.0.0-alpha07
29. Oktober 2018
Neue Funktionen
- Mit der neuen Klasse AppBarConfiguration kannst du anpassen, welche Ziele als Top-Level-Ziele gelten. Weitere Informationen finden Sie in der aktualisierten Dokumentation. b/117333663
- Sie können jetzt Argumente an das Startziel Ihres Graphen übergeben. b/110300470
- Deeplinks unterstützen jetzt benutzerdefinierte Schemas mit Punkten, Bindestrichen und Pluszeichen. b/112806402
Funktionsgefährdende Änderungen
- Das Modul
navigation-testing-ktxwurde innavigation-testing artifactintegriert und wird nicht mehr veröffentlicht. - Das Artefakt
navigation-testingist jetzt von der Kotlin-Standardbibliothek abhängig. Die API wurde geändert, um besser mit Kotlin-Konventionen übereinzustimmen. Sie können sie aber weiterhin für in Java geschriebene Tests verwenden. - Im Metadatenmanifest registrierte Navigationsgraphen werden nicht mehr unterstützt. b/118355937
- Aktionen können nicht mehr an <activity>-Ziele angehängt werden. aosp/785539
Fehlerkorrekturen
- Deeplinks parsen jetzt Suchparameter korrekt. b/110057514
- Bei Aktivitätszielen werden jetzt alle Ein- und Ausblendanimationen korrekt angewendet. b/117145284
- Ein Absturz, der nach Konfigurationsänderungen bei Verwendung benutzerdefinierter Navigatoren auftritt, wurde behoben. b/110763345
Safe Args
- Safe Args haben jetzt eine feste Abhängigkeit vom Android-Gradle-Plug-in 3.2.1. b/113167627
- Wegbeschreibungen können jetzt für innere Klassen generiert werden. b/117407555
- Ein Problem beim Generieren von Wegbeschreibungen zu einem <include>-Graphen wurde behoben. b/116542123
Version 1.0.0-alpha06
20. September 2018
Neue Funktionen
- Übergänge für freigegebene Elemente für Fragment- und Aktivitätsziele werden jetzt unterstützt b/79665225. Weitere Informationen findest du unter Navigation mit der Navigationsarchitekturkomponente implementieren.
- Wenn Sie ein Element in
NavigationViewauswählen, werden jetzt alle enthaltenen Ansichten am unteren Rand geschlossen. b/112158843
API-Änderungen
- Funktionsgefährdende Änderung: Die Navigator-Methode
navigate()verwendet jetzt den ParameterNavigator.Extras. - Die Methode
getGraph()von NavController ist jetztNonNullb/112243286
Fehlerkorrekturen
NavigationUI.setupWithNavController()gibt keine Ansichten mehr preis, wenn es mit Ansichten aus einzelnen Zielen verwendet wird b/111961977- Navigator
onSaveState()wird jetzt nur noch einmal aufgerufen b/112627079
Safe Args
- Die Directions-Klassen für Navigationsziele erweitern jetzt die Directions-Klasse des übergeordneten Elements, falls vorhanden b/79871405
- Die Klassen „Directions“ und „Args“ haben jetzt eine nützliche
toString()-Implementierung b/111843389
Version 1.0.0-alpha05
10. August 2018
Fehlerkorrekturen
- Ein Fehler wurde behoben, der zu einem fehlerhaften Backstack-Verhalten führte. b/111907708
- Fehler in
equals()der generierten Args-Klassen behoben. b/111450897 - Ein Build-Fehler in Safe Args wurde behoben. b/109409713
- Fehler bei der Konvertierung von Ressourcenkennungen in Java-Namen behoben b/111602491
- Fehlermeldungen zur Null-Zulässigkeit im Safe Args-Plug-in wurden behoben.
- Fehlende Null-Zulässigkeits-Annotationen hinzufügen.
Version 1.0.0-alpha04
19. Juli 2018
Navigation 1.0.0-alpha04 und das zugehörige Gradle-Plug-in „Safe Args“ enthalten eine Reihe von API-Änderungen, Verhaltensänderungen und Fehlerkorrekturen.
API-/Verhaltensänderungen
- NavHostFragment legt das aktuelle Fragment immer als primäres Navigationsfragment fest. Dadurch wird sichergestellt, dass untergeordnete Fragmentmanager vor dem äußeren NavController entfernt werden b/111345778
Safe Args
- Funktionsgefährdende Änderung:
app:typewurde inapp:argTypegeändert, um Konflikte mit anderen Bibliotheken wie ConstraintLayout 2.0.0-alpha1 zu vermeiden. b/111110548 - Fehlermeldungen von Safe Args sind jetzt anklickbar b/111534438
- Args-Klassen bestätigen jetzt, dass
NonNull-Attribute tatsächlich nicht null sind b/111451769 - Den generierten Klassen „NavDirections“ und „Args“ wurden zusätzliche
NonNull-Annotationen hinzugefügt b/111455455 b/111455456
Fehlerkorrekturen
- Ein Problem mit dem Button „Zurück“ des Systems nach dem Deeplinking zu einem Fragmentziel wurde behoben b/111515685
Version 1.0.0-alpha03
12. Juli 2018
Navigation 1.0.0-alpha03 und das zugehörige Gradle-Plug-in „Safe Args“ enthalten eine Reihe von API-Änderungen, Verhaltensänderungen und Fehlerkorrekturen.
API-/Verhaltensänderungen
- Eine NavigationUI.setupWithNavController-Methode für die Symbolleiste wurde hinzugefügt b/109868820
- Eine NavigationUI.setupWithNavController-Methode für CollapsingToolbarLayout wurde hinzugefügt b/110887183
- „popBackStack()“ gibt jetzt „false“ zurück, wenn der Back Stack leer ist oder die angegebene Ziel-ID nicht im Back Stack enthalten ist b/110893637
- FragmentNavigator ignoriert jetzt Navigationsvorgänge, nachdem FragmentManager den Status gespeichert hat. Dadurch werden „Can not perform this action after onSaveInstanceState“-Ausnahmen vermieden b/110987825
Safe Args
- Funktionsgefährdende Änderung: Nicht alphanumerische Zeichen in Aktions- und Argumentnamen werden in den entsprechenden NavDirections-Methodennamen durch Camel-Case-Schreibweise ersetzt.
- Beispiel:
DemoController.indexwird zusetDemoControllerIndexb/79995048 - Beispiel:
action_show_settingswird zuactionShowSettingsb/79642240
- Beispiel:
- Funktionsgefährdende Änderung: Argumente werden jetzt standardmäßig als nicht null betrachtet. Um Nullwerte für String- und Parcelable-Argumente zuzulassen, fügen Sie
app:nullable="true"hinzu. b/79642307 - Sie können jetzt
app:type="long"mit defaultValues im Format „123L“ verwenden. b/79563966 - Parcelable-Argumente werden jetzt unterstützt, wobei ein vollständig qualifizierter Klassenname für
app:typeverwendet wird. Der einzige unterstützte Standardwert ist"@null"b/79563966 - Args-Klassen implementieren jetzt
equals()undhashCode()b/79642246 - Das Safe Args-Plug-in kann jetzt auf Bibliotheksprojekte angewendet werden b/80036553
- Das Safe Args-Plug-in kann jetzt auf Feature-Projekte angewendet werden b/110011752
Fehlerkorrekturen
- Probleme bei der Navigation während Fragment-Lebenszyklusmethoden behoben b/109916080
- Probleme beim mehrmaligen Navigieren durch verschachtelte Diagramme wurden behoben b/110178671
- Probleme bei der Verwendung von
setPopUpTomit dem ersten Ziel im Diagramm wurden behoben b/109909461 - Ein Problem wurde behoben, bei dem alle
app:defaultValue-Werte als Strings übergeben wurden b/110710788 - Das mit dem Android-Gradle-Plug-in 3.2 Beta 01 gebündelte aapt2 fügt jetzt Beibehaltungsregeln für jedes
android:name-Attribut in Navigations-XML-Dateien hinzu b/79874119 - Speicherleck beim Ersetzen des Standard-FragmentNavigators behoben b/110900142
Version 1.0.0-alpha02
7. Juni 2018
Geändertes Verhalten
FragmentNavigatorverwendet jetztsetReorderingAllowed(true). b/109826220Die Navigation decodiert jetzt Argumente, die aus Deeplink-URLs geparst wurden, mit URLDecode. b/79982454
Fehlerkorrekturen
Ein
IllegalStateExceptionbeim Aufrufen von „navigate“ aus Fragment-Lebenszyklusmethoden wurde behoben. b/79632233Die Navigation hängt jetzt von der Support-Bibliothek 27.1.1 ab, um das Flackern bei der Verwendung von Animationen zu beheben. b/80160903
Ein
IllegalArgumentExceptionbei Verwendung von defaultNavHost="true" als untergeordnetes Fragment wurde behoben. b/79656847Ein
StackOverflowErrorbei Verwendung von NavDeepLinkBuilder wurde behoben. b/109653065Ein
IllegalArgumentException-Fehler beim Zurücknavigieren zu einem verschachtelten Diagramm wurde behoben. b/80453447Ein Problem mit überlappenden Fragmenten bei Verwendung von
launchSingleTopwurde behoben. b/79407969Die Navigation erstellt jetzt den richtigen synthetischen Backstack für verschachtelte Graphen. b/79734195
NavigationUI hebt jetzt das richtige Element hervor, wenn ein verschachtelter Graph als
MenuItemverwendet wird. b/109675998
API-Änderungen
Das Attribut
clearTaskfür Aktionen und die zugehörige API inNavOptionswurden verworfen. b/80338878Das Attribut
launchDocumentfür Aktionen und die zugehörige API inNavOptionswurden verworfen. b/109806636
Version 1.0.0-alpha01
8. Mai 2018
Navigation bietet ein Framework zum Erstellen der In-App-Navigation. Diese erste Version ist 1.0.0-alpha01.