navigation3
| Letzte Aktualisierung | Stabile Release | Releasekandidat | Beta-Release | Alpha-Release |
|---|---|---|---|---|
| 4. November 2026 | 1.2.1 | - | - | 1.3.0-alpha04 |
Abhängigkeiten deklarieren
Für eine Abhängigkeit von Navigation3 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
dependencies { implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha04" implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04" }
Kotlin
dependencies { implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha04") implementation("androidx.navigation3:navigation3-ui:1.3.0-alpha04") }
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.
Version 1.3
Version 1.3.0-alpha04
4. November 2026
androidx.navigation3:navigation3-*:1.3.0-alpha04 ist veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.
Fehlerkorrekturen
- Problem behoben, bei dem ein freigegebenes
NavEntry-Element nicht auf dem Bildschirm gerendert wurde, wenn es entfernt und dann wieder hinzugefügt wurde, bevor das Entfernen abgeschlossen war. (I6a482)
Version 1.3.0-alpha03
21. Oktober 2026
androidx.navigation3:navigation3-*:1.3.0-alpha03 ist veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Keine Änderungen gegenüber 1.3.0-alpha02
Version 1.3.0-alpha02
7. Oktober 2026
androidx.navigation3:navigation3-*:1.3.0-alpha02 ist veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Klasse
SceneInfohat die Attributetitleundurlhinzugefügt, die automatisch aus den letztenNavEntry's-Metadaten der Szene ausgefüllt werden. Verwenden SieTitleMetadataKeyundUrlMetadataKey, um in den Metadaten des Eintrags Titel und URLs für die Ziele zu definieren. (I78a20, b/542693522)
Version 1.3.0-alpha01
23. September 2026
androidx.navigation3:navigation3-*:1.3.0-alpha01 ist veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Die Übergabe der Animation für die intelligente „Zurück“-Geste in
NavDisplaywurde durch die Migration zuDeferredAnimatedContentund die Behebung von Problemen bei der Übergabe von Übergängen korrigiert. I145eaedd b/430807423DeferredAnimatedContentverwendetDeferredTransition, um Übergänge in eine verzögerte Phase (überdefer) und eine automatische Phase (überanimateTo) zu unterteilen. In der verzögerten Phase werden während einer Wischgeste manuelle Transformationen angewendet. In der automatischen Phase wird der Übergang ausgeführt, wenn die Wischgeste abgeschlossen ist.
Bekannte Probleme
- Gemeinsame Elemente werden während der Übergänge in der ausgehenden Szene statt in der eingehenden Szene gerendert. (b/582354988)
- Geteilte Elemente werden während der verzögerten Phase (Geste) nicht gesucht.
Navigation3 Version 1.2
Version 1.2.1
4. November 2026
androidx.navigation3:navigation3-*:1.2.1 ist veröffentlicht. Version 1.2.1 enthält diese Commits.
Änderungen
compileSdkwurde von 37 auf 36 herabgestuft. Version 1.2 hängt von Compose1.10ab, für dascompileSdk37 nicht erforderlich ist.
Version 1.2.0
23. September 2026
androidx.navigation3:navigation3-*:1.2.0 ist veröffentlicht. Version 1.2.0 enthält diese Commits.
1.2.0 ist jetzt stabil.
Wichtige Änderungen seit 1.1.0
Result API
- Mit dieser neuen API können Ergebnisse zwischen
NavEntriesübergeben werden. Dazu wird dieResultEventBusverwendet, die vonLocalResultEventBusundResultEventBusNavEntryDecoratorbereitgestellt wird. rememberResultEventBuswurde hinzugefügt, um das Hoisting vonResultEventBusaußerhalb vonResultEventBusNavEntryDecoratorund die Übergabe anrememberResultEventBusNavEntryDecoratorzu unterstützen.- Auf übergebene Ergebnisse kann als Status mit
ResultEventBus#conflateAsStatezugegriffen werden oder sie können als Ergebnis-Flow mitResultEffecterfasst werden.
Deep Link API
Navigation3 unterstützt jetzt Kotlin Multiplatform (KMP)-Deeplinks in androidx.navigation3.runtime.deeplink über DeepLinkRequest, DeepLinkUri und DeepLinkMatcher.
DeepLinkRequestundRequestExtras: Steht für eine Deeplink-Anfrage, die aus einemDeepLinkUri, einem URI-String oder einem Android-Intenterstellt wurde. Zusätzliche Anfragemetadaten können mit dem typsicheren ContainerRequestExtrasangehängt werden, der mit der DSLrequestExtrasundRequestExtrasKey<T>erstellt wurde.DeepLinkMatcher: Stellt einen Deeplink dar, der mit einemDeepLinkRequestabgeglichen werden kann. Jede Matcher-Instanz ist mit dem Navigationsschlüssel verknüpft, der diesen Deeplink unterstützt. Ein Navigationsschlüssel kann mit mehreren Matchern verknüpft sein. Wenn SieDeepLinkMatcher.matchaufrufen, wird einMatchResultmit dem zugehörigen Navigationsschlüssel zurückgegeben, wenn eine Übereinstimmung gefunden wird. Es gibt zwei Standardimplementierungen vonDeepLinkMatcher:UriDeepLinkMatcherfür den Abgleich von Deeplinks basierend aufUriundStaticKeyDeepLinkMatcherfür den Abgleich von Deeplinks mit nurDeepLinkMatcher.Filter, die mit einem booleschen Wert übereinstimmen.BackStackMatcher: EinDeepLinkMatcher, um bei einer erfolgreichen Deeplink-Übereinstimmung einen synthetischen Back Stack zu erstellen.BackStackMatcherkann über die ErweiterungsfunktionDeepLinkMatcher.withBackStackerstellt werden.
Umgang mit der intelligenten „Zurück“-Geste
NavigationBackHandlerundrememberNavigationEventStatewurden hinzugefügt, um die Verbindung vonSceneStatemit der intelligenten „Zurück“-Touchgeste (onBackCompletedundonBackCancelled) zu vereinfachen. Dadurch können benutzerdefinierte UI-Komponenten die standardmäßige Rückwärtsnavigation und die intelligente „Zurück“-Touchgeste unterstützen, ohne dass Back-Stack-Deltas manuell berechnet werden müssen.- Verbesserte Übergänge für die intelligente „Zurück“-Geste, einschließlich Unterstützung für intelligente „Zurück“-Gesten, die während Vorwärtsanimationen ausgelöst werden.
Weitere Änderungen
NavEntry.contentKeyist jetzt standardmäßig eine Kombination auskey.toString()undkey::class.toString(), um Schlüsselkonflikte zwischendata object-Schlüsseln zu vermeiden, die denselben einfachen Namen auf verschiedenen Schnittstellen haben.EntryProviderpriorisiert jetzt den Abgleich basierend auf Schlüsselinstanzen gegenüber Schlüsseltypen.- Es wurde eine Lint-Prüfung hinzugefügt, um sicherzustellen, dass
Scene-Implementierungen entwederdata classs sind oderequalsundhashCodeimplementieren.
Version 1.2.0-rc01
9. September 2026
androidx.navigation3:navigation3-*:1.2.0-rc01 ist veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Doppelte Platzhalternamen in Deeplink-URI-Mustern nicht zulassen. (I8985c, b/522343165)
Version 1.2.0-beta01
26. August 2026
androidx.navigation3:navigation3-*:1.2.0-beta01 ist veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
API-Änderungen
DeepLinkRequest.extraswurde vonMap<String, Any>in eine neue typsichere kartenähnliche KlasseRequestExtrasrefaktoriert, in der Paare vonRequestExtrasKey<T>zuTgespeichert werden.RequestExtraskann mit derrequestExtras-DSL instanziiert werden. (Ic929d, b/543883369)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem intelligente „Zurück“-Touchgesten, die während eines Übergangs nach vorn ausgelöst werden, nicht entsprechend dem Fortschritt der Wischgeste animiert werden. Die intelligente „Zurück“-Geste wird jetzt richtig animiert und ausgeführt. (Icdcb0, b/456218398)
- Es wurde eine Lint-Prüfung hinzugefügt, um sicherzustellen, dass
Scene-Implementierungen entweder Datenklassen sind oder „equals“ und „hashcode“ implementieren, damit bei Bedarf derselbeSceneverwendet wird. (Ibdf0d, b/542316099) NavEntry.contentKeyist jetzt standardmäßig eine Kombination auskey.toString()undkey::class.toString(). So wird sichergestellt, dass Datenobjekte, die denselben Namen haben, aber unterschiedliche Schnittstellen implementieren, nicht mehr dieselbecontentKeyhaben. Diekey::classder JS-Plattform gibt jedoch nur den einfachen Klassennamen anstelle des vollständig qualifizierten Namens zurück. Daher sollte die JS-Plattform weiterhin benutzerdefiniertecontentKeyfür Datenobjekte mit doppelten Namen implementieren. (I1fbbb, b/512534342)- Es wurde ein Problem behoben, bei dem
IllegalArgumentExceptionvonSaveableStateProviderfür doppelte Schlüssel ausgelöst wurde, die bei der schnellen Rückwärtsnavigation verwendet wurden, wenn mehrere Pop-Übergänge aktiv waren. (I4d728, b/516312097)
Version 1.2.0-alpha07
29. Juli 2026
androidx.navigation3:navigation3-*:1.2.0-alpha07 ist veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
API-Änderungen
- Eine abstrakte
WrappedMatchResult-Klasse wurde hinzugefügt, um eine weitereDeepLinkMatcher.MatchResult-Klasse zu umschließen. So können benutzerdefinierte Übereinstimmungsergebnisse übereinander gelegt werden. (I7d4dc, b/470282247) Neue
BackStackMatcher-Klasse hinzugefügt, die zwei Parameter akzeptiert: eine Matcher-Instanz und ein Builder-Lambda, das das Übereinstimmungsergebnis des Eingabe-Matchers liefert und einen Back Stack zurückgibt. Bei einer erfolgreichen Übereinstimmung gibtBackStackMatchereinBackStackMatchResultzurück, dasWrappedMatchResulterweitert und das ursprüngliche Übereinstimmungsergebnis sowie den mit dem Lambda erstellten Back Stack enthält. DieBackStackMatcherkann nur mit der neuen ErweiterungsfunktionDeepLinkMatcher.withBackStackerstellt werden. (Ibf987, b/470282247)Eine abstrakte
DeepLinkSerializer-Klasse wurde hinzugefügt, dieKSerializererweitert, umvalue : TalsStringzu codieren und zu decodieren.DeepLinkSerializerkann verwendet werden, um nicht primitive Deeplink-Argumente zu serialisieren. Kompatibel mitrememberSaveableundrememberNavBackStack. (Id3c9f, b/470282247)DeepLinkMatcherhat einen zweiten Typparameterout R : DeepLinkMatcher.MatchResult<T>hinzugefügt, damit Entwickler auf die Attribute der vonDeepLinkMatcher.match()zurückgegebenen abgeleiteten KlasseMatchResultzugreifen können, ohne eine Typumwandlung vornehmen zu müssen. (I693d3, b/470282247)Die Obergrenze für
DeepLinkMatcher.MatchResult'sT wurde vonAny?inAnygeändert. (I6bf1a)Das Konstruktorfeld
urivonDeepLinkRequestist jetzt standardmäßig auf „null“ gesetzt. DeruriStringdes sekundären Konstruktors wurde inuriumbenannt. (Ia0f14, b/522194187)
Fehlerkorrekturen
ResultEffectverwendet jetztrememberUpdatedState, um das neuesteonResult-Lambda zu erfassen. (I7d2a3, b/531709234)- Der Deeplink-Abgleich für leere Pfadsegmente wurde korrigiert. Wenn der Argumenttyp „String“ ist, wird der leere Pfad als leerer Stringwert behandelt. Andernfalls wird der leere Pfad so behandelt, als wäre kein Wert angegeben, und es wird auf den Standardwert zurückgegriffen. Wenn kein Standardwert vorhanden ist, schlägt der Abgleich fehl. (I56575, b/535298128)
- Unterstützung für leere Abfragewerte in
DeepLinkRequest.urihinzugefügt. Wenn das Argument vom Typ „String“ ist, wird der leere Wert als literaler leerer String behandelt. Andernfalls wird der leere Wert so behandelt, als wäre kein Wert angegeben, und es wird versucht, auf den Standardwert zurückzugreifen. Wenn kein Standardwert vorhanden ist, schlägt der Abgleich fehl. (I30343, b/535127459) EntryProviderpriorisiert jetzt den Abgleich basierend auf Schlüsselinstanzen gegenüber Schlüsseltypen. (Ib5ec9, b/533331924)SceneStateberechnet jetzt die vorherigen Szenen korrekt, beginnend mit der obersten Nicht-Overlay-Szene. (I91915, b/513630541)
Version 1.2.0-alpha06
15. Juli 2026
androidx.navigation3:navigation3-*:1.2.0-alpha06 ist veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Die
UriDeepLinkMatcher-Dokumentation zu URI-Fragmenten wurde korrigiert, um klarzustellen, dass Fragmente mit Platzhaltern mit jeder Eingabe übereinstimmen, die Eingabe jedoch nicht als Argumente extrahiert wird. (I5ad9b, b/524677091) - Es wurde ein Problem behoben, bei dem
UriDeepLinkMatchernicht mit einer Anfrage übereinstimmte, wenn das URI-Muster kein Schema enthielt oder nicht mit einem doppelten Schrägstrich begann. Beispielsweise führtwww.example.com/homejetzt zu Übereinstimmungen mithttp://www.example.com/home. (Ia6b65, b/522791926)
Version 1.2.0-alpha05
1. Juli 2026
androidx.navigation3:navigation3-*:1.2.0-alpha05 ist veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
Neue API
- Eine
rememberResultEventBusAPI wurde hinzugefügt, die einResultEventBuszurückgibt, das anrememberResultEventBusNavEntryDecoratorübergeben werden kann. Dadurch kann einResultEventBusaußerhalb desResultEventBusNavEntryDecoratorhochgezogen werden. (Ia655b, b/516995400)
DeepLinkRequest
- Zwei KMP-kompatible Konstruktoren hinzugefügt: einer, der eine DeepLinkUri akzeptiert, und einer, der eine Rohstring-URI akzeptiert. (I3c088, b/513200887, b/522194187)
- (Nur Android) Es wurde ein Konstruktor hinzugefügt, der ein
Intent-Objekt akzeptiert. (Ia0498, b/513200887, b/522194187) - Alle Konstruktoren haben ein zusätzliches
extras-Feld für einenMap<String, Any>, um zusätzliche Anfrageinformationen anzuhängen. (If81d5, b/513200887) - Eine neue
requestExtras-DSL wurde als typsichere Methode zum Erstellen einer Karte mit Extras hinzugefügt. Die DSL bietet eineput-Funktion zum Speichern von Paaren ausRequestExtrasKeyundAny. Mit der ErweiterungsfunktionMap<String, Any>.get(key)kann mit einemRequestExtrasKeyaus der Karte gelesen werden. (I5091c, b/513200887) - (Nur Android) Die Funktionen
ActionExtrasKeyundactionExtrawurden hinzugefügt, um eine Extras-Map mitActionExtrasKeyzu erstellen. (Id0c90, [b/513200887] - Die Funktionen
MimeTypeExtrasKeyundmimeTypeExtrawurden hinzugefügt, um eine Extras-Map mitMimeTypeExtrasKeyzu erstellen. (I85131, b/513200887)
DeepLinkMatcher
- Die Funktionen
DeepLinkMatcher.mimeTypeFilterundDeepLinkMatcher.actionFilterwurden hinzugefügt, umDeepLinkMatcher.Filterszu erstellen, dieDeepLinkRequestnachmimeTypeoderactionfiltern (nur Android). Bei beiden Filtern wird nach String-Gleichheit gesucht. Die Groß- und Kleinschreibung wird nicht berücksichtigt. (Ie7e67, b/513191950)
API-Änderungen
DeepLinkRequest
- Entfernen Sie die Factory-Funktion
fromAction. Wenn Sie eine Anfrage erstellen möchten, die mit einer Aktion verknüpft ist, verwenden Sie das neue FeldDeepLinkRequest.extras. (Id0c90, b/513200887) fromMimeTypeFactory-Funktion wurde entfernt. Wenn Sie eine Anfrage erstellen möchten, die mit einem mimeType verknüpft ist, verwenden Sie das neue FeldDeepLinkRequest.extras. (I85131, b/513200887)- (Nur Android) Die Factory-Funktion
fromIntentwurde entfernt. Ersetzt durch einen neuen Konstruktor, der einen Intent und eine Extras-Zuordnung verwendet. (Ia0498, b/513200887, b/522194187) - Die Factory-Funktionen
fromUriundfromUriStringwurden entfernt. Ersetzt durch neue Konstruktoren, die entweder einenDeepLinkUrioder einen Rohstring-URI verwenden. (Id5b6f, b/522194187) DeepLinkMatcher,DeepLinkMatcher.MatchResultund ihre Unterklassen verwenden jetzt ein kovariantes T (out T), sodass hierarchische Schlüssel bei der Verwendung mit Matchers keine Typumwandlung benötigen. (I1e453, b/525094876)- Der Konstruktorparameter
UriMatchResultfür die Argumentzuordnung ist jetzt standardmäßig eine leere Zuordnung. (I3acdd) - Die abstrakte Klasse
DeepLinkMatcher.Filterist jetzt eine funktionale Schnittstelle. Das Konstruktorfeldfilterwird entfernt und sollte stattdessen direkt in der Unterklasse übergeben werden. (I9eb7d, b/522194187)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem ein entfernter Eintrag sofort verschwand, wenn zu einem Eintrag mit verschachtelten Metadaten mit Lambda-Werten gewechselt wurde. (Idb872, b/520494430)
UriDeepLinkMatcherwurde korrigiert, sodass ein Null-UriMatchResultzurückgegeben wird, anstattMissingFieldExceptionauszulösen, wenn während des Abgleichs erforderliche Argumente fehlen. (I5322f, b/524663005)- Eine
UriDeeplinkMatchermit einer URI mit HTTPS-Schema kann nur mit Anfragen abgeglichen werden, die ebenfalls ein HTTPS-Schema haben. (Ibfe22, b/522304329) UriDeepLinkMatcherwurde korrigiert, um dashttp-Schema beim Abgleich vonDeepLinkRequestmitUriDeepLinkMatcherkorrekt als positive Übereinstimmung mithttpszu identifizieren. (I3a62b, b/518804264)- Der
DeepLinkMatcher.MatchResult-Komparator gibt jetzt standardmäßig 0 zurück, wenn zwei Ergebnisse gleich sind. (I48ddb, b/518841353) UriDeepLinkMatchergibt jetzt einen Null-UriMatchResultzurück, anstatt eine Ausnahme auszulösen, wenn die Anfrage mit Übereinstimmung aufgrund fehlender erforderlicher Argumente fehlschlägt. (I669a7, b/470282247, b/512923412)
Version 1.2.0-alpha04
3. Juni 2026
androidx.navigation3:navigation3-*:1.2.0-alpha04 ist veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
Fehlerkorrekturen
- Ein Problem mit der Overlay-Animation wurde behoben, bei dem verschachtelte Overlays wie
ModalBottomSheetunerwartet neu animiert wurden, wenn die Overlays darüber eingeblendet wurden. (Ia2b9e, b/502624496)
Version 1.2.0-alpha03
19. Mai 2026
androidx.navigation3:navigation3-*:1.2.0-alpha03 ist veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
Neue Funktionen
Navigation 3 unterstützt jetzt Deeplinks mit DeepLinkRequest und DeepLinkMatcher:
DeepLinkRequesteinen angeforderten Deeplink, der einenDeepLinkUriund optional einen mimeType oder eine Aktion (nur Android) enthält. Zusammen mit der neuen Klasse gibt es Companion-Funktionen, mit denen eine Instanz mit einemuri, einemmimeTypeoder einemactionerstellt werden kann. Die Android-Plattform bietet auch eine Hilfsfunktion, mit der eine Anfrage aus einem Intent erstellt werden kann. (Iaaac9, b/470282247)val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home") val uriAndMimeRequest = DeepLinkRequest.fromUriString( "https://sampledeeplink.com/user/profile?id=123", "image/png" )DeepLinkMatchersteht für einen Deeplink, der mit einemDeepLinkRequestabgeglichen werden kann. Jede Matcher-Instanz ist mit dem Navigationsschlüssel verknüpft, der diesen Deeplink unterstützt. Ein Navigationsschlüssel kann mit mehreren Matchern verknüpft sein. Wenn SieDeepLinkMatcher.matchaufrufen, wird einMatchResultmit dem zugehörigen Navigationsschlüssel zurückgegeben, wenn eine Übereinstimmung gefunden wird. Es gibt zwei Standardimplementierungen vonDeepLinkMatcher:UriDeepLinkMatcherfür den Abgleich von Deeplinks basierend auf dem URI undStaticKeyDeepLinkMatcherfür den Abgleich von Deeplinks nur mitDeepLinkMatcher.Filter, die mit einemBooleanübereinstimmen. (I3798e, b/470282247)UriDeepLinkMatcher: Eine vordefinierte Implementierung vonDeepLinkMatcher, die Deeplinks verarbeitet, indemDeepLinkUrimit einem serialisierbaren Navigationsschlüssel abgeglichen wird. Es werden Deeplink-Argumente von primitiven Typen oder Sammlungen von primitiven Typen wie Listen, Arrays und Sets unterstützt. (I1520b, b/470282247)@Serializable data class UserKey(val id: Int): NavKey // declare a deep link supported by UserKey val userMatcher = UriDeepLinkMatcher( uriPattern = "www.sampledeeplink.com/user?userId={id}", serializer = serializer<UserKey>() ) // handle a requested deep link with fallback key val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKeyDeepLinkUrihinzugefügt, eine Kotlin-Multiplatform-Version vonandroid.net.Uri(Id4725, b/470282247)
API-Änderungen
- Auf
compileSdk 37erhöht, um der compileSdk von Compose zu entsprechen
Fehlerkorrekturen
IllegalArgumentExceptionvonAnimatedBottomSheetSamplebei der Anzeige mehrerer Overlays korrigiert. Im BeispielSceneStrategywird jetzt der letzte Wert, der nichtOverlaySceneist, korrekt berechnet und unter allen Overlay-Szenen angezeigt. (If2281, b/506733412)- Die Abhängigkeit
NavigationEventwurde auf 1.1.1 erhöht. Dadurch wird der No-Op-NavigationEventHandler im Prüfmodus entfernt, um die intelligente „Zurück“-Geste in Android Studio-Vorabversionen zu aktivieren. (I487fd)
Version 1.2.0-alpha02
22. April 2026
androidx.navigation3:navigation3-*:1.2.0-alpha02 ist veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
onBackwurde inonBackCompletedumbenannt undonBackCancelledwurde zu NavigationBackHandler hinzugefügt, um die Verarbeitung abgebrochener Zurück-Gesten zu unterstützen. (I92741)- Fügen Sie
NavigationBackHandlerhinzu, um die Verarbeitung von „Zurück“-Gesten und intelligenten „Zurück“-Gesten bei Verwendung vonSceneStatezu vereinfachen. So können Entwickler einfacher benutzerdefinierte UI-Komponenten erstellen, die die standardmäßige Rückwärtsnavigation und vorausschauende Gesten unterstützen, ohne Back-Stack-Deltas manuell berechnen zu müssen. (I6a055) - Fügen Sie
rememberNavigationEventStatehinzu, um die Verbindung vonSceneStatemit der Verarbeitung der intelligenten „Zurück“-Geste zu vereinfachen. (Iae49c)
Neue Funktionen
- Es wurde eine
ResultEventBusAPI hinzugefügt, mit der Ergebnisse zwischen NavEntries mit demLocalResultEventBusübergeben werden können, das vom neuenResultEventBusNavEntryDecoratorbereitgestellt wird. Übergebene Ergebnisse können als Status mitResultEventBus#conflateAsStateoder als Ergebnisfluss mitResultEffectbewertet werden.
Version 1.2.0-alpha01
8. April 2026
androidx.navigation3:navigation3-*:1.2.0-alpha01 ist veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Der Zugriff auf
LocalNavAnimatedContentScopeüber einOverlaySceneführt nicht mehr zu einemIllegalStateException, daOverlayScenesjetzt mit einem No-Op-LocalAnimatedContentScopebereitgestellt werden. (I2f00c, b/486067688)
Navigation3 Version 1.1
Version 1.1.7
26. August 2026
androidx.navigation3:navigation3-*:1.1.7 ist veröffentlicht. Version 1.1.7 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem intelligente „Zurück“-Touchgesten, die während eines Übergangs nach vorn ausgelöst werden, nicht entsprechend dem Fortschritt der Wischgeste animiert werden. Die intelligente „Zurück“-Geste wird jetzt richtig animiert und ausgeführt. (Icdcb0, b/456218398)
Version 1.1.6
12. August 2026
androidx.navigation3:navigation3-*:1.1.6 ist veröffentlicht. Version 1.1.6 enthält diese Commits.
Fehlerkorrekturen
NavEntry.contentKeyist jetzt standardmäßig eine Kombination auskey.toString()undkey::class.toString(). So wird sichergestellt, dass Datenobjekte, die denselben Namen haben, aber unterschiedliche Schnittstellen implementieren, nicht mehr dieselbecontentKeyhaben. Diekey::classder JS-Plattform gibt jedoch nur den einfachen Klassennamen anstelle des vollständig qualifizierten Namens zurück. Daher sollte die JS-Plattform weiterhin benutzerdefiniertecontentKeyfür Datenobjekte mit doppelten Namen implementieren. (I1fbbb, b/512534342)- Es wurde ein Problem behoben, bei dem
IllegalArgumentExceptionvonSaveableStateHolderfür die Wiederverwendung von Schlüsseln ausgelöst wurde, wenn mehrere Pop-Übergänge gleichzeitig aufgrund eines schnellen Poppings aus dem Back Stack ausgeführt wurden. (I4d728, b/516312097)
Version 1.1.5
29. Juli 2026
androidx.navigation3:navigation3-*:1.1.5 ist veröffentlicht. Version 1.1.5 enthält diese Commits.
Fehlerkorrekturen
- Die
entryProvider-DSL priorisiert jetztNavEntry, die mit einer Schlüsselinstanz erstellt wurden, z. B.entry(key = userKey) { ... }, gegenüberNavEntry, die mit einer Schlüsselklasse wieentry<UserKey>{ ... }erstellt wurden. (Ib5ec9, b/533331924)
Version 1.1.4
1. Juli 2026
androidx.navigation3:navigation3-*:1.1.4 ist veröffentlicht. Version 1.1.4 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem ein entfernter Eintrag sofort verschwand, wenn zu einem Eintrag mit verschachtelten Metadaten mit Lambda-Werten gewechselt wurde. (Idb872, b/520494430)
Version 1.1.3
17. Juni 2026
androidx.navigation3:navigation3-*:1.1.3 ist veröffentlicht. Version 1.1.3 enthält diese Commits.
Fehlerkorrekturen
Ein Problem mit der Overlay-Animation wurde behoben, bei dem verschachtelte Overlays wie
ModalBottomSheetunerwartet neu animiert wurden, wenn die Overlays darüber eingeblendet wurden. (Ia2b9e, b/502624496)Die
NavigationEvent-Abhängigkeit wurde auf 1.1.2 aktualisiert. Dadurch wurde der No-Op-NavigationEventHandlerim Prüfmodus entfernt, um die intelligente „Zurück“-Geste in Android Studio-Vorabversionen zu aktivieren.
Version 1.1.2
19. Mai 2026
androidx.navigation3:navigation3-*:1.1.2 ist veröffentlicht. Version 1.1.2 enthält diese Commits.
Fehlerkorrekturen
- Die
NavigationEvent-Abhängigkeit wurde auf 1.1.1 erhöht. Dadurch wurde der No-Op-NavigationEventHandlerim Prüfmodus entfernt, um die intelligente „Zurück“-Geste in Android Studio-Vorabversionen zu aktivieren.
Version 1.1.1
22. April 2026
androidx.navigation3:navigation3-*:1.1.1 ist veröffentlicht. Version 1.1.1 enthält diese Commits.
Fehlerkorrekturen
- Der Zugriff auf
LocalNavAnimatedContentScopeüber einOverlaySceneführt nicht mehr zu einemIllegalStateException, daOverlayScenesjetzt mit einem No-Op-LocalAnimatedContentScopebereitgestellt werden. (I2f00c, b/486067688)
Version 1.1.0
8. April 2026
androidx.navigation3:navigation3-*:1.1.0 ist veröffentlicht. Version 1.1.0 enthält diese Commits.
1.1.0 ist jetzt stabil.
Wichtige Änderungen seit 1.0.0
Gemeinsame Elemente zwischen Szenen
– Navigation3 unterstützt jetzt die Behandlung von Szenen als gemeinsame Elementobjekte. So kann ein reibungsloser Übergang zwischen den Szenen gewährleistet werden. Sie können dies aktivieren, indem Sie entweder NavDisplay oder rememberSceneState einen SharedTransitionScope übergeben.
SceneDecoratorStrategy
– Einführung von SceneDecoratorStrategy, um Anwendungsfälle wie das Dekorieren von Szenen mit gängigen UI-Komponenten oder das Teilen des Status über Szenen hinweg zu unterstützen.
NavMetadata DSL: Navigation3 bietet jetzt eine neue typsichere Metadaten-DSL. Die DSL verwendet eine neue MetadataKey-Schnittstelle, mit der die Schlüssel- und Werttypen definiert werden können, die für die Metadatenzuordnung bereitgestellt werden sollen. Außerdem wurden neue NavMetadataKeys für NavDisplay-Übergänge hinzugefügt, damit sie mit der neuen Metadaten-DSL verwendet werden können, um Übergänge zu NavDisplay hinzuzufügen.
OverlayScene-Animationen:
- Die OverlayScene-Schnittstelle hat einen neuen aussetzenden onRemoved-Callback. Dieser Callback wird aufgerufen, nachdem ein mit der Szene verknüpfter Schlüssel aus dem Backstack entfernt wurde, aber bevor er die Komposition verlässt. So können in onRemoved aufgerufene Exit-Animationen abgeschlossen werden, bevor die Overlay-Szene aus der Komposition entfernt wird.
Weitere Änderungen
– NavDisplay und rememberSceneState verwenden jetzt List<SceneStrategy> anstelle des vorherigen einzelnen SceneStrategy-Parameters, der durch den Infix then verkettet wurde.
- Sie können jetzt Metadaten dynamisch hinzufügen und dabei den Eintragsschlüssel über die EntryProvider-DSL berücksichtigen.
Version 1.1.0-rc01
25. März 2026
androidx.navigation3:navigation3-*:1.1.0-rc01 ist veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
Fehlerkorrekturen
NavDisplaysorgt jetzt dafür, dass Einträge, die unter Overlays angezeigt werden, einenLifecyclevon maximalSTARTEDhaben. So wird sichergestellt, dass APIs wiedropUnlessResumedweiterhin funktionieren, wenn Dialogfelder verwendet werden. (If209f, b/483966071)- In
NavDisplaywurde ein Problem behoben, bei dem die Z-Reihenfolge der Bildschirme falsch sein konnte, wenn zwischen denselben Bildschirmen hin- und hergewechselt und die Animationen zwischen den beiden unterbrochen wurden. (I4d491, b/459419800)
Version 1.1.0-beta01
11. März 2026
androidx.navigation3:navigation3-*:1.1.0-beta01 ist veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.
Version 1.1.0-alpha05
25. Februar 2026
androidx.navigation3:navigation3-*:1.1.0-alpha05 ist veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.
API-Änderungen
NavDisplayundrememberSceneStateverwenden jetzt einenList<SceneStrategy>anstelle des vorherigen einzelnenSceneStrategy-Parameters, der durch den Infixthenverkettet wurde. Dies entspricht eher demList<SceneDecoratorStrategy<T>>, den beide APIs bereits verwenden. Die vorherigen APIs wurden eingestellt. (I78b2c, b/482108465)- Der Metadatenoperator #contains wurde hinzugefügt, um zu prüfen, ob die Metadatenzuordnung den angegebenen
NavMetadataKeyenthält. (Ic30db, b/485311895) NavMetadataKeyDialogKeyfürDialogSceneStrategyzur Verwendung mit der Metadaten-DSL hinzugefügt. (Ic7a26, b/483388817)
Version 1.1.0-alpha04
11. Februar 2026
androidx.navigation3:navigation3-*:1.1.0-alpha04 ist veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.
Neue Funktionen
- Navigation3 bietet jetzt eine neue typsichere Metadaten-DSL. Die DSL verwendet eine neue
MetadataKey-Schnittstelle, mit der die Schlüssel- und Werttypen definiert werden können, die für die Metadatenzuordnung bereitgestellt werden sollen. Außerdem wurden neueNavMetadataKeys fürNavDisplay-Übergänge hinzugefügt, damit sie mit der neuenmetadata-DSL verwendet werden können, um Übergänge zuNavDisplayhinzuzufügen. (Ic10ef, Ic049c,b/476213928)
API-Änderungen
- Die
OverlayScene-Schnittstelle hat einen neuenonRemoved-Callback zum Sperren. Dieser Callback wird aufgerufen, nachdem ein mit der Szene verknüpfter Schlüssel aus dem Backstack entfernt wurde, aber bevor er die Komposition verlässt. So können Exit-Animationen, die inonRemovedaufgerufen werden, abgeschlossen werden, bevor die Overlay-Szene aus der Komposition entfernt wird. (I29a72, b/440558061) SceneStrategyhat die Dekorationsfunktion in eine neueSceneDecoratorStrategyausgelagert. Diese neue Schnittstelle sollte zum Dekorieren von Szenen verwendet werden. Es gibt neue APIs fürNavDisplayundrememberSceneState, mit denenSceneDecoratorStrategieshinzugefügt werden können. (If9385, b/477669607, b/477670333)
Fehlerkorrekturen
- Es wurde ein Fehler behoben, bei dem die Übergabe eines
SharedTransitionLayoutanNavDisplayoderrememberSceneStateund die Verwendung eines beliebigenOverlayScenezu einem Absturz führte, da die Verwendung vonSharedTransitionLayoutnur mitNavEntriesfunktioniert, die als Teil desAnimatedContentgerendert werden, undOverlaySceneseparat in eigenen Fenstern gerendert werden. (I1bb76, b/478664101)
Abhängigkeitsupdate
- Ab
Navigation31.0.1:Navigation3hängt jetzt vonNavigationEvent1.0.2 ab. Dadurch wird einIllegalStateException-Fehler behoben, der durch die Verwendung vonNavDisplaywährend derAndroidStudio-Vorabversionen verursacht wurde. (Id7212, b/477149762)
Version 1.1.0-alpha03
28. Januar 2026
androidx.navigation3:navigation3-*:1.1.0-alpha03 ist veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
Neue Funktionen
- Sie können jetzt Metadaten dynamisch unter Berücksichtigung des Eintragsschlüssels über die
EntryProvider-DSL hinzufügen. (I942fb, b/474416976)
Version 1.1.0-alpha02
14. Januar 2026
androidx.navigation3:navigation3-*:1.1.0-alpha02 ist veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
Neue Funktionen
SceneStrategyunterstützt jetzt das Verschachteln von Szenen über eine neuecalculatedScene(Scene)-Funktion. Das bedeutet, dassSceneStrategys angepasst werden können, um zusätzliche Funktionen für andere Szenen bereitzustellen. (I5df7c,b/440333896)
Version 1.1.0-alpha01
3. Dezember 2025
androidx.navigation3:navigation3-*:1.1.0-alpha01 ist veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
Navigation3unterstützt jetzt die Behandlung von Szenen als freigegebenes Elementobjekt. So kann ein reibungsloser Übergang zwischen den Szenen gewährleistet werden. Sie können dies aktivieren, indem Sie entwederNavDisplayoderrememberSceneStateeinenSharedTransitionScopeübergeben. (I15868)
Version 1.0
Version 1.0.1
11. Februar 2026
androidx.navigation3:navigation3-*:1.0.1 ist veröffentlicht. Version 1.0.1 enthält diese Commits.
Abhängigkeitsupdate
Navigation3hängt jetzt vonNavigationEvent1.0.2 ab. Dadurch wird einIllegalStateException-Fehler behoben, der durch die Verwendung vonNavDisplaywährend derAndroidStudio-Vorabversionen verursacht wurde. (Id7212, b/477149762)
Version 1.0.0
19. November 2025
androidx.navigation3:navigation3-*:1.0.0 ist veröffentlicht. Version 1.0.0 enthält diese Commits.
Jetzt neu: Navigation3!
- Die Navigation3-Bibliothek ist jetzt stabil. Navigation3 ist der AndroidX Compose-First-Ansatz für die Navigation.
- Weitere Informationen finden Sie in unserem Blogpost zur Ankündigung, in den Ressourcen und in den Anleitungen.
Version 1.0.0-rc01
5. November 2025
androidx.navigation3:navigation3-*:1.0.0-rc01 ist veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
Fehlerkorrekturen
NavDisplaylegt jetzt auf der EbeneSceneeinenLocalLifecycleOwnerfest, mit dem Szenenautoren feststellen können, ob alle Übergänge abgeschlossen sind, indem sie prüfen, ob derLifecycle.StateRESUMEDist. Das Verhalten vonLocalLifecycleOwnerauf der EbeneNavEntryist unverändert: Es bleibt auch beiSTARTEDbegrenzt, wenn ein Übergang im Gange ist, und wird zusätzlich beiCREATEDbegrenzt, wenn diesesNavEntryaus dem Back Stack entfernt wurde und gerade animiert wird. (I03113, b/454045829)
Version 1.0.0-beta01
22. Oktober 2025
androidx.navigation3:navigation3-*:1.0.0-beta01 ist veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Änderungen
SceneStrategyScopehat jetzt nur noch einen öffentlichen Konstruktor ohne Argumente, der sich zum Testen vonSceneStrategyund des zurückgegebenenSceneeignet. Verwenden Sie für komplexere AnwendungsfällerememberSceneState(). (I8440c, b/451679047)
Fehlerkorrekturen
- Endlosschleife beim Verketten von
SceneStrategymitthenbehoben. (Iba3f0, b/450323470) - Das Flackern des Bildschirms beim Austauschen des an
NavDisplayübergebenenbackStackund bei der Verwendung von Animationen wurde behoben. (Ief7b5, b/450967248)
Version 1.0.0-alpha11
8. Oktober 2025
androidx.navigation3:navigation3-*:1.0.0-alpha11 ist veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.
API-Änderungen
- Die Methode
calculateScenefürSceneStrategyist nicht mehr@Composable. Verschieben Sie diese Arbeit stattdessen in die Konstruktion IhrerSceneStrategy-Methode (d.h. in einerememberMySceneStrategy()-Methode), mit der Sie die Lebensdauer allerrememberSaveable-Werte oder wichtigenremember-Anweisungen anhand der richtigen Werte definieren können. (If1733, b/448709506) - Der Parameter
onBackfürSceneStrategy.calculateScenewurde in den neuen Empfängerbereich vonSceneStrategyScopeverschoben, um deutlicher zu machen, dass es sich um einen optionalen Parameter handelt, und um einen Erweiterungspunkt für zukünftige Navigation3-Funktionen bereitzustellen. (I3aea3, b/448460407) - Der an
NavDisplayund anSceneStrategyübergebene Lambda-AusdruckonBackenthält keinencount: Int-Parameter mehr, der angibt, wann mehrere Einträge entfernt werden sollen. Stattdessen wird der() -> Unit-Lambda-Ausdruck jetzt mehrmals hintereinander aufgerufen, wenn in Ihrer Szene mehrere Einträge entfernt werden sollen. (Idedb5, b/446989346) - Entfernen Sie die Klasse
NavEntryWrapperund ersetzen Sie ihre Funktionalität durch eine finaleNavEntry-Klasse mit einem neuen sekundären Konstruktor, der einNavEntrymit neuem Inhalt akzeptiert. So wird die Unterstützung für das Verpacken eines Eintrags mit neuen Inhalten fortgesetzt. (I7da2a, b/444447130) - Die Funktion
navEntryDecorator, die einNavEntryDecorator-Objekt erstellt und zurückgibt, wurde entfernt und durch die KlasseNavEntryDecoratorersetzt, die jetzt öffentlich ist und für die Erstellung von Unterklassen verwendet werden kann. (If81f8, b/444447434, b/447381176) SavedStateNavEntryDecoratorwurde inSaveableStateHolderNavEntryDecoratorumbenannt, da Einträge mit einemSaveableStateHolderversehen werden. Der Decorator wurde außerdem von einer Funktion in eine Klasse umgewandelt, da er funktional eine Factory fürNavEntryDecoratorist. (Ie6013, b/447381176)- Für benutzerdefinierte Displays, die
SceneStateals Alternative zuNavDisplayverwenden, ist die Verwendung des CompositionLocal-ElementsLocalEntriesToRenderInCurrentScenenicht mehr erforderlich. Es ist jetzt intern. (Ic40ef, b/414668196) SceneSetupNavEntryDecoratorundrememberSceneSetupNavEntryDecorator()wurden aus der öffentlichen API-Oberfläche entfernt. Diese Funktion ist jetzt standardmäßig enthalten, ohne dass Sie sie manuell einbinden müssen. (Ieae42, b/444479133)NavEntry,DialogScene,SinglePaneSceneundSceneStateimplementieren jetzt alle „equals“. (I96121)- Die Scene-Schnittstelle hat ein neues Metadatenfeld, um szenenspezifische Metadaten für NavDisplay anzuhängen. Dadurch kann eine Szene die Metadaten für
NavDisplayüberschreiben, z. B. mit Übergängen. (I1fd96, b/443955625) - Vereinfachen Sie die Signatur von
rememberNavBackStack, indem Sie den redundanten generischen Typparameter entfernen. Die Funktion akzeptiert jetztvararg elements: NavKey. (I03e45) - Die Standardanimationen für
NavDisplaysind jetzt Teil der allgemeinen API, sodass sie von allen Plattformen aus aufgerufen werden können. (I71af9, b/447147159) - Benennen Sie
EntryProviderBuilderinEntryProviderScopeum, um genau widerzuspiegeln, dass die Klasse eine Kotlin-DSL ist, die einen Bereich zum Erstellen vonNavEntriesbietet. (Ia7465)
Fehlerkorrekturen
rememberNavBackStack()erzwingt jetzt die polymorphe Serialisierung für NavKey und erfordert ein benutzerdefiniertesSavedStateConfiguration, das so konfiguriert ist, dass der Status korrekt wiederhergestellt wird. KDoc wurde aktualisiert, um die Anforderung zu berücksichtigen, dass alle NavKey-Untertypen im bereitgestellten SerializersModule registriert werden müssen. (I6de37,I782f2, b/446664383)
Version 1.0.0-alpha10
24. September 2025
androidx.navigation3:navigation3-*:1.0.0-alpha10 ist veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
API-Änderungen
- Fügen Sie eine neue
NavDisplay-Überladung hinzu, die eine Liste vonNavEntry<T>akzeptiert, die mitrememberDecoratedNavEntriesversehen wurde. (I4025b, b/441940314) DialogScenewurde in ein neues Paket verschoben. (Ia5840)- Öffentliche API
DecorateNavEntryentfernen. Verwenden Sie stattdessenrememberDecoratedNavEntries, um einen NavEntry mit einer Liste von Decorators zu umschließen. (Id8c09) - Die Navigation3-Benutzeroberfläche bietet jetzt neue Standard-
transitionSpec-Eigenschaften. (Ibcabd) - Es wurde ein neues
SceneState-Objekt hinzugefügt, mit dem Szenen verwaltet werden können. Außerdem wird eine neueNavDisplay-Überladung bereitgestellt, dieSceneStateundNavigationEventStateakzeptiert. (Idfb46, b/444479133) - Mit
NavDisplaykönnen Sie jetzt die Übergänge basierend auf demSceneanpassen, zu dem Sie wechseln und von dem Sie kommen. Dazu werden diecurrentStateundtargetStatedesTransitionherangezogen. (I906cc, b/443872322) NavigationEventInfoist jetzt einabstract classstatt eininterface. Alle benutzerdefinierten Implementierungen wurden aktualisiert, sodass sie von der Klasse erben (z. B.data class MyInfo : NavigationEventInfo()). (I1e59c, b/444734264)- Die
navigationevent-compose-Handler-APIs werden aktualisiert.NavigationEventHandlerundNavigationBackHandler(und Varianten) unterstützen jetzt eine neue Überladung, die ein hochgestuftesNavigationEventStateakzeptiert. Die einfachen Überladungen (mitcurrentInfo) bleiben erhalten und verwenden jetzt intern dieses neue Zustandsmodell. (Ic3251, b/444734264) - Alle Scene APIs wurden von navigation3-ui nach navigation3-runtime verschoben. Sie sind jetzt auf allen Plattformen verfügbar, die von navigation3-runtime unterstützt werden. (I431d0, b/444449993)
- Neue
rememberDecoratedNavEntries-Überladung hinzugefügt, die eine Liste vonNavEntryzum Dekorieren akzeptiert. Die Eingabeeinträge können bereits mit anderen Eintrags-Decorators versehen sein. (I5a034, b/444230270) - Parameter vom Typ „navigation3“ mit Platzhalter entfernen (I02540)
- Die Verarbeitung von Generics für die
entryProvider-DSL wurde verbessert. Wenn Sie zuvorandroidx.navigation3.runtime.entryimportiert haben, ist dies nicht mehr erforderlich. (I299fc) - Beschränken Sie die reflexionsbasierte
NavBackStackSerializer-Überladung auf Android. Dadurch werden implizite Laufzeit-Serialisierungsfehler auf Nicht-Android-Plattformen verhindert, da die expliziteSavedStateConfiguration-Überladung in plattformübergreifendem Code erzwungen wird. (I73313, b/420443609) swipeEdgevonNavigationEventwird zu einem@IntDef(Icee54, b/443950342)NavBackStack-Serialisierung auf Android beschränken. Dadurch werden Laufzeitfehler auf Nicht-Android-Plattformen verhindert. Verwenden Sie zum Speichern des Status auf mehreren Plattformen die ÜberladungrememberNavBackStackmit einem explizitenSavedStateConfiguration. (I1e418, b/420443609)
Fehlerkorrekturen
- Absturz während der intelligenten „Zurück“-Geste behoben, wenn die verschachtelte
NavDisplayeinen einzelnen untergeordneten Eintrag hat. (I2cdc0, b/441933162)
Version 1.0.0-alpha09
10. September 2025
androidx.navigation3:navigation3-*:1.0.0-alpha09 ist veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
API-Änderungen
DecoratedNavEntryProviderwurde durchrememberDecoratedNavEntriesersetzt, wodurch NavEntries erstellt und zurückgegeben werden, die mit der Liste der bereitgestellten Decorators versehen sind (I0fe1c, b/441328236).NavBackStackist jetzt generisch für den TypNavKey. So können Apps und Bibliotheken benutzerdefinierte Schlüsseltypen für ihre Back Stacks definieren, anstatt aufNavKeybeschränkt zu sein. (I4d190,Iad2f4, b/420443609)NavBackStackist jetzt@kotlinx.serialization.Serializable. Dadurch kann der Navigationsstatus bei Prozessbeendigung und Konfigurationsänderungen ohne zusätzlichen Boilerplate-Code gespeichert und wiederhergestellt werden. (I2c3cf, b/420443609)RememberNavBackStackwurde nachcommonMainverschoben, damit es auf allen Plattformzielen bereitgestellt wird. (Id69e7, b/420443609)
Fehlerkorrekturen
NavDisplayverschiebt jetzt jede einzelneNavEntryin die richtigeLifecycle.State. (I30aac, b/440145700)- Ein Problem wurde behoben, bei dem
NavDisplayalle verschachteltenNavigationEventDispatcherOwnerignorierte, die überLocalNavigationEventDispatcherOwnerderNavigationEvent-Bibliothek festgelegt wurden. (I6224a)
Änderungen an Abhängigkeiten
- Navigation3 hängt jetzt von NavigationEvent Alpha08 ab.
Version 1.0.0-alpha08
27. August 2025
androidx.navigation3:navigation3-*:1.0.0-alpha08 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
Navigation3 Runtime-Artefakten wurden neue Kotlin MultiPlatform-Ziele (KMP) hinzugefügt.Navigation3 Runtimeunterstützt jetzt die folgenden Plattformen: JVM (Android und Desktop), Native (Linux, iOS, watchOS, macOS, MinGW) und Web (JavaScript, WasmJS). (I55078, b/424410398, b/419294028, b/419046226). Hinweis: Dadurch werden keine KMP-Ziele für dasNavigation3 UI-Artefakt bereitgestellt. Auf anderen Plattformen müssen Sie eine eigene benutzerdefinierteNavDisplayimplementieren. Wenn Sie möchten, dass es unterstützt wird, stimmen Sie hier für das Jetbrains-Problem ab und verfolgen Sie den Fortschritt für zusätzliche Unterstützung dort.- Das Objekt
NavDisplayInfoist jetzt öffentlich und kann verwendet werden, um die Liste der sichtbaren Einträge ausNavDisplayabzurufen. (Ibc91f)
API-Änderungen
- Es wurde ein neues
NavBackStackSerializerhinzugefügt, das in Verbindung mitrememberNavBackStackverwendet werden kann, um den Status wiederherzustellen.rememberNavBackStack()akzeptiert jetzt auch einSavedStateConfiguration, mit dem Sie Ihre eigene Konfiguration bereitstellen können. (I2f4d2, I4cd58, b/420443609)
Fehlerkorrekturen
- Es wurde ein Problem behoben, bei dem die Navigation dazu führte, dass falsche Lifecycle-Events ausgelöst wurden. (I8bf6d, b/425901162, b/434109022)
Bekannte Probleme
- In I8bf6d wurde ein Fehler eingeführt, der dazu führte, dass Lebenszyklen auf Szenen statt auf einzelnen Einträgen basierten. Dadurch wurde der Lebenszyklus in allen Fällen unterbrochen, in denen der für
NavEntrybereitgestelltekeykeinStringist oder IhrNavEntrydencontentKeynicht überschrieben und auf denkeygesetzt hat. Beachten Sie, dass dadurch erzwungen wird, dass Ihr Schlüssel in einemBundlegespeichert werden kann. Dies wurde für die nächste Version behoben. (b/440145700)
Version 1.0.0-alpha07
13. August 2025
androidx.navigation3:navigation3-*:1.0.0-alpha07 ist veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
MinSdk-Update
- Der Standardwert für „minSdk“ für AndroidX wurde von API 21 auf API 23 verschoben (Ibdfca, b/380448311, b/435705964, b/435705223).
API-Änderungen
SavedStateNavEntryDecoratorverwendet jetzt die inSaveableStateProviderintegrierteSaveableStateRegistry, um Zustände zu speichern und wiederherzustellen. (If8d9a)- Der
predictivePopTransitionSpecwird jetzt der Rand, von dem aus gewischt wird, als Parameter übergeben. So kannst du den Übergang basierend auf dem Rand anpassen, von dem aus der Nutzer die intelligente „Zurück“-Touchgeste gestartet hat. (I753a8)
Fehlerkorrekturen
- Es wurde ein Problem behoben, durch das benutzerdefinierte Szenen unendlich neu berechnet wurden, weil die letzte Szene nicht gespeichert wurde. (I7ba84, b/418153031)
Abhängigkeitsupdate
- Navigation3 hängt jetzt von Navigationsereignis
1.0.0-alpha06ab.
Version 1.0.0-alpha06
30. Juli 2025
androidx.navigation3:navigation3-*:1.0.0-alpha06 ist veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Abhängigkeitsupdate
- Navigation3 hängt jetzt von Navigationsereignis
1.0.0-alpha05ab.
Version 1.0.0-alpha05
2. Juli 2025
androidx.navigation3:navigation3-*:1.0.0-alpha05 ist veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Geändertes Verhalten
- Der Status von
NavEntrybasiert jetzt ausschließlich auf der aktuellen Liste der Decorator, die anNavDisplayübergeben werden. Das bedeutet, dass Decorators bei mehreren Back Stacks entlang der Back Stacks ausgetauscht werden sollten, um den Status der NavEntries im Back Stack beizubehalten. Andernfalls werden die Status gelöscht, als ob die Einträge entfernt worden wären (anstatt eines Austauschs). (I7a759, b/428033667)
Version 1.0.0-alpha04
18. Juni 2025
androidx.navigation3:navigation3-*:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
NavEntry.contentist jetzt privat. Wenn SieNavEntry-Inhalte aufrufen möchten, rufen Sie die neueNavEntry.Content()API auf, für die keinkey-Parameter mehr erforderlich ist. (Icd0fd, b/420991203)NavEntry.keyist jetzt ein privates Feld.NavEntryund die relevanten Status sollten durch das neue FeldcontentKeyidentifiziert werden, das aus dem neuen LambdacontentKeyFactorygeneriert wird und standardmäßig einen speicherbaren Hash ausNavEntry.keyenthält (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812)
Änderungen an Abhängigkeiten
- Navigation3 hängt jetzt vom neuen
androidx.navigationevent.compose-Artefakt ab.
Version 1.0.0-alpha03
4. Juni 2025
androidx.navigation3:navigation3-*:1.0.0-alpha03 ist veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
Navigation3löscht nicht mehr die Decorator-Zustände fürbackStacks, die ausgetauscht und durch eine anderebackStack-Instanz ersetzt wurden. (I28a42, b/415076044)
Version 1.0.0-alpha02
23. Mai 2025
androidx.navigation3:navigation3-*:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Problem mit
SavedStateNavEntryDecoratorbehoben, das zu Konflikten bei verschiedenen Datenklassen mit denselben Attributwerten führte. (b/418070648, Iff4775) - Ein Problem mit einer fehlenden Klasse wurde behoben, das zu Abstürzen führte, wenn die App ohne explizite Abhängigkeiten ausgeführt wurde. (b/419049149, I4b4ed)
Version 1.0.0-alpha01
20. Mai 2025
androidx.navigation3:navigation3-*:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Navigation3 ist eine neue Navigationsbibliothek, die speziell für die In-App-Navigation mit Jetpack Compose entwickelt wurde. Das androidx.navigation3.runtime-Artefakt stellt die Bausteine bereit, während das androidx.navigation3.ui-Artefakt die UI-Ebene über die NavDisplay API bereitstellt. Entwickler können ihren eigenen Status direkt in der zusammensetzbaren Funktion NavDisplay angeben, wodurch der Inhalt basierend auf Änderungen im Entwicklerstatus geändert wird.
@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey
val backStack = rememberNavBackStack(Home)
NavDisplay(backStack, entryProvider = entryProvider {
entry<Home> {
Column {
Text(“Home”)
Button(onClick = { backStack.add(Chat) } ) {
Text(“Go to Chat”)
}
}
}
entry<Chat> { /* My Composable Content */ }
})
Weitere Informationen finden Sie im Leitfaden zu Navigation3.