navigation3

  
Navigation 3 ist eine neue Navigationsbibliothek, die für die Verwendung mit Compose entwickelt wurde.
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.

Neues Problem melden

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 SceneInfo hat die Attribute title und url hinzugefügt, die automatisch aus den letzten NavEntry's-Metadaten der Szene ausgefüllt werden. Verwenden Sie TitleMetadataKey und UrlMetadataKey, 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 NavDisplay wurde durch die Migration zu DeferredAnimatedContent und die Behebung von Problemen bei der Übergabe von Übergängen korrigiert. I145eaedd b/430807423
    • DeferredAnimatedContent verwendet DeferredTransition, um Übergänge in eine verzögerte Phase (über defer) und eine automatische Phase (über animateTo) 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.

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

  • compileSdk wurde von 37 auf 36 herabgestuft. Version 1.2 hängt von Compose 1.10 ab, für das compileSdk 37 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 die ResultEventBus verwendet, die von LocalResultEventBus und ResultEventBusNavEntryDecorator bereitgestellt wird.
  • rememberResultEventBus wurde hinzugefügt, um das Hoisting von ResultEventBus außerhalb von ResultEventBusNavEntryDecorator und die Übergabe an rememberResultEventBusNavEntryDecorator zu unterstützen.
  • Auf übergebene Ergebnisse kann als Status mit ResultEventBus#conflateAsState zugegriffen werden oder sie können als Ergebnis-Flow mit ResultEffect erfasst werden.

Deep Link API

Navigation3 unterstützt jetzt Kotlin Multiplatform (KMP)-Deeplinks in androidx.navigation3.runtime.deeplink über DeepLinkRequest, DeepLinkUri und DeepLinkMatcher.

  • DeepLinkRequest und RequestExtras: Steht für eine Deeplink-Anfrage, die aus einem DeepLinkUri, einem URI-String oder einem Android-Intent erstellt wurde. Zusätzliche Anfragemetadaten können mit dem typsicheren Container RequestExtras angehängt werden, der mit der DSL requestExtras und RequestExtrasKey<T> erstellt wurde.
  • DeepLinkMatcher: Stellt einen Deeplink dar, der mit einem DeepLinkRequest abgeglichen 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 Sie DeepLinkMatcher.match aufrufen, wird ein MatchResult mit dem zugehörigen Navigationsschlüssel zurückgegeben, wenn eine Übereinstimmung gefunden wird. Es gibt zwei Standardimplementierungen von DeepLinkMatcher: UriDeepLinkMatcher für den Abgleich von Deeplinks basierend auf Uri und StaticKeyDeepLinkMatcher für den Abgleich von Deeplinks mit nur DeepLinkMatcher.Filter, die mit einem booleschen Wert übereinstimmen.
  • BackStackMatcher: Ein DeepLinkMatcher, um bei einer erfolgreichen Deeplink-Übereinstimmung einen synthetischen Back Stack zu erstellen. BackStackMatcher kann über die Erweiterungsfunktion DeepLinkMatcher.withBackStack erstellt werden.

Umgang mit der intelligenten „Zurück“-Geste

  • NavigationBackHandler und rememberNavigationEventState wurden hinzugefügt, um die Verbindung von SceneState mit der intelligenten „Zurück“-Touchgeste (onBackCompleted und onBackCancelled) 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.contentKey ist jetzt standardmäßig eine Kombination aus key.toString() und key::class.toString(), um Schlüsselkonflikte zwischen data object-Schlüsseln zu vermeiden, die denselben einfachen Namen auf verschiedenen Schnittstellen haben.
  • EntryProvider priorisiert jetzt den Abgleich basierend auf Schlüsselinstanzen gegenüber Schlüsseltypen.
  • Es wurde eine Lint-Prüfung hinzugefügt, um sicherzustellen, dass Scene-Implementierungen entweder data classs sind oder equals und hashCode implementieren.

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.extras wurde von Map<String, Any> in eine neue typsichere kartenähnliche Klasse RequestExtras refaktoriert, in der Paare von RequestExtrasKey<T> zu T gespeichert werden. RequestExtras kann mit der requestExtras-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 derselbe Scene verwendet wird. (Ibdf0d, b/542316099)
  • NavEntry.contentKey ist jetzt standardmäßig eine Kombination aus key.toString() und key::class.toString(). So wird sichergestellt, dass Datenobjekte, die denselben Namen haben, aber unterschiedliche Schnittstellen implementieren, nicht mehr dieselbe contentKey haben. Die key::class der JS-Plattform gibt jedoch nur den einfachen Klassennamen anstelle des vollständig qualifizierten Namens zurück. Daher sollte die JS-Plattform weiterhin benutzerdefinierte contentKey für Datenobjekte mit doppelten Namen implementieren. (I1fbbb, b/512534342)
  • Es wurde ein Problem behoben, bei dem IllegalArgumentException von SaveableStateProvider fü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 weitere DeepLinkMatcher.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 gibt BackStackMatcher ein BackStackMatchResult zurück, das WrappedMatchResult erweitert und das ursprüngliche Übereinstimmungsergebnis sowie den mit dem Lambda erstellten Back Stack enthält. Die BackStackMatcher kann nur mit der neuen Erweiterungsfunktion DeepLinkMatcher.withBackStack erstellt werden. (Ibf987, b/470282247)

  • Eine abstrakte DeepLinkSerializer-Klasse wurde hinzugefügt, die KSerializer erweitert, um value : T als String zu codieren und zu decodieren. DeepLinkSerializer kann verwendet werden, um nicht primitive Deeplink-Argumente zu serialisieren. Kompatibel mit rememberSaveable und rememberNavBackStack. (Id3c9f, b/470282247)

  • DeepLinkMatcher hat einen zweiten Typparameter out R : DeepLinkMatcher.MatchResult<T> hinzugefügt, damit Entwickler auf die Attribute der von DeepLinkMatcher.match() zurückgegebenen abgeleiteten Klasse MatchResult zugreifen können, ohne eine Typumwandlung vornehmen zu müssen. (I693d3, b/470282247)

  • Die Obergrenze für DeepLinkMatcher.MatchResult's T wurde von Any? in Any geändert. (I6bf1a)

  • Das Konstruktorfeld uri von DeepLinkRequest ist jetzt standardmäßig auf „null“ gesetzt. Der uriString des sekundären Konstruktors wurde in uri umbenannt. (Ia0f14, b/522194187)

Fehlerkorrekturen

  • ResultEffect verwendet jetzt rememberUpdatedState, um das neueste onResult-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.uri hinzugefü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)
  • EntryProvider priorisiert jetzt den Abgleich basierend auf Schlüsselinstanzen gegenüber Schlüsseltypen. (Ib5ec9, b/533331924)
  • SceneState berechnet 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 UriDeepLinkMatcher nicht mit einer Anfrage übereinstimmte, wenn das URI-Muster kein Schema enthielt oder nicht mit einem doppelten Schrägstrich begann. Beispielsweise führt www.example.com/home jetzt zu Übereinstimmungen mit http://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 rememberResultEventBus API wurde hinzugefügt, die ein ResultEventBus zurückgibt, das an rememberResultEventBusNavEntryDecorator übergeben werden kann. Dadurch kann ein ResultEventBus außerhalb des ResultEventBusNavEntryDecorator hochgezogen 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 einen Map<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 eine put-Funktion zum Speichern von Paaren aus RequestExtrasKey und Any. Mit der Erweiterungsfunktion Map<String, Any>.get(key) kann mit einem RequestExtrasKey aus der Karte gelesen werden. (I5091c, b/513200887)
  • (Nur Android) Die Funktionen ActionExtrasKey und actionExtra wurden hinzugefügt, um eine Extras-Map mit ActionExtrasKey zu erstellen. (Id0c90, [b/513200887]
  • Die Funktionen MimeTypeExtrasKey und mimeTypeExtra wurden hinzugefügt, um eine Extras-Map mit MimeTypeExtrasKey zu erstellen. (I85131, b/513200887)

DeepLinkMatcher

  • Die Funktionen DeepLinkMatcher.mimeTypeFilter und DeepLinkMatcher.actionFilter wurden hinzugefügt, um DeepLinkMatcher.Filters zu erstellen, die DeepLinkRequest nach mimeType oder action filtern (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 Feld DeepLinkRequest.extras. (Id0c90, b/513200887)
  • fromMimeType Factory-Funktion wurde entfernt. Wenn Sie eine Anfrage erstellen möchten, die mit einem mimeType verknüpft ist, verwenden Sie das neue Feld DeepLinkRequest.extras. (I85131, b/513200887)
  • (Nur Android) Die Factory-Funktion fromIntent wurde entfernt. Ersetzt durch einen neuen Konstruktor, der einen Intent und eine Extras-Zuordnung verwendet. (Ia0498, b/513200887, b/522194187)
  • Die Factory-Funktionen fromUri und fromUriString wurden entfernt. Ersetzt durch neue Konstruktoren, die entweder einen DeepLinkUri oder einen Rohstring-URI verwenden. (Id5b6f, b/522194187)
  • DeepLinkMatcher, DeepLinkMatcher.MatchResult und 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 UriMatchResult für die Argumentzuordnung ist jetzt standardmäßig eine leere Zuordnung. (I3acdd)
  • Die abstrakte Klasse DeepLinkMatcher.Filter ist jetzt eine funktionale Schnittstelle. Das Konstruktorfeld filter wird 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)
  • UriDeepLinkMatcher wurde korrigiert, sodass ein Null-UriMatchResult zurückgegeben wird, anstatt MissingFieldException auszulösen, wenn während des Abgleichs erforderliche Argumente fehlen. (I5322f, b/524663005)
  • Eine UriDeeplinkMatcher mit einer URI mit HTTPS-Schema kann nur mit Anfragen abgeglichen werden, die ebenfalls ein HTTPS-Schema haben. (Ibfe22, b/522304329)
  • UriDeepLinkMatcher wurde korrigiert, um das http-Schema beim Abgleich von DeepLinkRequest mit UriDeepLinkMatcher korrekt als positive Übereinstimmung mit https zu identifizieren. (I3a62b, b/518804264)
  • Der DeepLinkMatcher.MatchResult-Komparator gibt jetzt standardmäßig 0 zurück, wenn zwei Ergebnisse gleich sind. (I48ddb, b/518841353)
  • UriDeepLinkMatcher gibt jetzt einen Null-UriMatchResult zurü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 ModalBottomSheet unerwartet 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:

  • DeepLinkRequest einen angeforderten Deeplink, der einen DeepLinkUri und optional einen mimeType oder eine Aktion (nur Android) enthält. Zusammen mit der neuen Klasse gibt es Companion-Funktionen, mit denen eine Instanz mit einem uri, einem mimeType oder einem action erstellt 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"
    )
    
  • DeepLinkMatcher steht für einen Deeplink, der mit einem DeepLinkRequest abgeglichen 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 Sie DeepLinkMatcher.match aufrufen, wird ein MatchResult mit dem zugehörigen Navigationsschlüssel zurückgegeben, wenn eine Übereinstimmung gefunden wird. Es gibt zwei Standardimplementierungen von DeepLinkMatcher: UriDeepLinkMatcher für den Abgleich von Deeplinks basierend auf dem URI und StaticKeyDeepLinkMatcher für den Abgleich von Deeplinks nur mit DeepLinkMatcher.Filter, die mit einem Boolean übereinstimmen. (I3798e, b/470282247)

  • UriDeepLinkMatcher: Eine vordefinierte Implementierung von DeepLinkMatcher, die Deeplinks verarbeitet, indem DeepLinkUri mit 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 ?: HomeKey
    
  • DeepLinkUri hinzugefügt, eine Kotlin-Multiplatform-Version von android.net.Uri (Id4725, b/470282247)

API-Änderungen

  • Auf compileSdk 37 erhöht, um der compileSdk von Compose zu entsprechen

Fehlerkorrekturen

  • IllegalArgumentException von AnimatedBottomSheetSample bei der Anzeige mehrerer Overlays korrigiert. Im Beispiel SceneStrategy wird jetzt der letzte Wert, der nicht OverlayScene ist, korrekt berechnet und unter allen Overlay-Szenen angezeigt. (If2281, b/506733412)
  • Die Abhängigkeit NavigationEvent wurde 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

  • onBack wurde in onBackCompleted umbenannt und onBackCancelled wurde zu NavigationBackHandler hinzugefügt, um die Verarbeitung abgebrochener Zurück-Gesten zu unterstützen. (I92741)
  • Fügen Sie NavigationBackHandler hinzu, um die Verarbeitung von „Zurück“-Gesten und intelligenten „Zurück“-Gesten bei Verwendung von SceneState zu 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 rememberNavigationEventState hinzu, um die Verbindung von SceneState mit der Verarbeitung der intelligenten „Zurück“-Geste zu vereinfachen. (Iae49c)

Neue Funktionen

  • Es wurde eine ResultEventBus API hinzugefügt, mit der Ergebnisse zwischen NavEntries mit dem LocalResultEventBus übergeben werden können, das vom neuen ResultEventBusNavEntryDecorator bereitgestellt wird. Übergebene Ergebnisse können als Status mit ResultEventBus#conflateAsState oder als Ergebnisfluss mit ResultEffect bewertet 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 ein OverlayScene führt nicht mehr zu einem IllegalStateException, da OverlayScenes jetzt mit einem No-Op-LocalAnimatedContentScope bereitgestellt werden. (I2f00c, b/486067688)

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.contentKey ist jetzt standardmäßig eine Kombination aus key.toString() und key::class.toString(). So wird sichergestellt, dass Datenobjekte, die denselben Namen haben, aber unterschiedliche Schnittstellen implementieren, nicht mehr dieselbe contentKey haben. Die key::class der JS-Plattform gibt jedoch nur den einfachen Klassennamen anstelle des vollständig qualifizierten Namens zurück. Daher sollte die JS-Plattform weiterhin benutzerdefinierte contentKey für Datenobjekte mit doppelten Namen implementieren. (I1fbbb, b/512534342)
  • Es wurde ein Problem behoben, bei dem IllegalArgumentException von SaveableStateHolder fü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 jetzt NavEntry, die mit einer Schlüsselinstanz erstellt wurden, z. B. entry(key = userKey) { ... }, gegenüber NavEntry, die mit einer Schlüsselklasse wie entry<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 ModalBottomSheet unerwartet 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-NavigationEventHandler im 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-NavigationEventHandler im 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 ein OverlayScene führt nicht mehr zu einem IllegalStateException, da OverlayScenes jetzt mit einem No-Op-LocalAnimatedContentScope bereitgestellt 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

  • NavDisplay sorgt jetzt dafür, dass Einträge, die unter Overlays angezeigt werden, einen Lifecycle von maximal STARTED haben. So wird sichergestellt, dass APIs wie dropUnlessResumed weiterhin funktionieren, wenn Dialogfelder verwendet werden. (If209f, b/483966071)
  • In NavDisplay wurde 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

  • NavDisplay und rememberSceneState verwenden jetzt einen List<SceneStrategy> anstelle des vorherigen einzelnen SceneStrategy-Parameters, der durch den Infix then verkettet wurde. Dies entspricht eher dem List<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 NavMetadataKey enthält. (Ic30db, b/485311895)
  • NavMetadataKey DialogKey für DialogSceneStrategy zur 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 neue NavMetadataKeys für NavDisplay-Übergänge hinzugefügt, damit sie mit der neuen metadata-DSL verwendet werden können, um Übergänge zu NavDisplay hinzuzufügen. (Ic10ef, Ic049c,b/476213928)

API-Änderungen

  • Die OverlayScene-Schnittstelle hat einen neuen onRemoved-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 in onRemoved aufgerufen werden, abgeschlossen werden, bevor die Overlay-Szene aus der Komposition entfernt wird. (I29a72, b/440558061)
  • SceneStrategy hat die Dekorationsfunktion in eine neue SceneDecoratorStrategy ausgelagert. Diese neue Schnittstelle sollte zum Dekorieren von Szenen verwendet werden. Es gibt neue APIs für NavDisplay und rememberSceneState, mit denen SceneDecoratorStrategies hinzugefügt werden können. (If9385, b/477669607, b/477670333)

Fehlerkorrekturen

  • Es wurde ein Fehler behoben, bei dem die Übergabe eines SharedTransitionLayout an NavDisplay oder rememberSceneState und die Verwendung eines beliebigen OverlayScene zu einem Absturz führte, da die Verwendung von SharedTransitionLayout nur mit NavEntries funktioniert, die als Teil des AnimatedContent gerendert werden, und OverlayScene separat in eigenen Fenstern gerendert werden. (I1bb76, b/478664101)

Abhängigkeitsupdate

  • Ab Navigation3 1.0.1: Navigation3 hängt jetzt von NavigationEvent 1.0.2 ab. Dadurch wird ein IllegalStateException-Fehler behoben, der durch die Verwendung von NavDisplay während der AndroidStudio-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

  • SceneStrategy unterstützt jetzt das Verschachteln von Szenen über eine neue calculatedScene(Scene)-Funktion. Das bedeutet, dass SceneStrategys 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

  • Navigation3 unterstü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 entweder NavDisplay oder rememberSceneState einen SharedTransitionScope ü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

  • Navigation3 hängt jetzt von NavigationEvent 1.0.2 ab. Dadurch wird ein IllegalStateException-Fehler behoben, der durch die Verwendung von NavDisplay während der AndroidStudio-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

  • NavDisplay legt jetzt auf der Ebene Scene einen LocalLifecycleOwner fest, mit dem Szenenautoren feststellen können, ob alle Übergänge abgeschlossen sind, indem sie prüfen, ob der Lifecycle.State RESUMED ist. Das Verhalten von LocalLifecycleOwner auf der Ebene NavEntry ist unverändert: Es bleibt auch bei STARTED begrenzt, wenn ein Übergang im Gange ist, und wird zusätzlich bei CREATED begrenzt, wenn dieses NavEntry aus 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

  • SceneStrategyScope hat jetzt nur noch einen öffentlichen Konstruktor ohne Argumente, der sich zum Testen von SceneStrategy und des zurückgegebenen Scene eignet. Verwenden Sie für komplexere Anwendungsfälle rememberSceneState(). (I8440c, b/451679047)

Fehlerkorrekturen

  • Endlosschleife beim Verketten von SceneStrategy mit then behoben. (Iba3f0, b/450323470)
  • Das Flackern des Bildschirms beim Austauschen des an NavDisplay übergebenen backStack und 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 calculateScene für SceneStrategy ist nicht mehr @Composable. Verschieben Sie diese Arbeit stattdessen in die Konstruktion Ihrer SceneStrategy-Methode (d.h. in eine rememberMySceneStrategy()-Methode), mit der Sie die Lebensdauer aller rememberSaveable-Werte oder wichtigen remember-Anweisungen anhand der richtigen Werte definieren können. (If1733, b/448709506)
  • Der Parameter onBack für SceneStrategy.calculateScene wurde in den neuen Empfängerbereich von SceneStrategyScope verschoben, 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 NavDisplay und an SceneStrategy übergebene Lambda-Ausdruck onBack enthält keinen count: 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 NavEntryWrapper und ersetzen Sie ihre Funktionalität durch eine finale NavEntry-Klasse mit einem neuen sekundären Konstruktor, der ein NavEntry mit 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 ein NavEntryDecorator-Objekt erstellt und zurückgibt, wurde entfernt und durch die Klasse NavEntryDecorator ersetzt, die jetzt öffentlich ist und für die Erstellung von Unterklassen verwendet werden kann. (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator wurde in SaveableStateHolderNavEntryDecorator umbenannt, da Einträge mit einem SaveableStateHolder versehen werden. Der Decorator wurde außerdem von einer Funktion in eine Klasse umgewandelt, da er funktional eine Factory für NavEntryDecorator ist. (Ie6013, b/447381176)
  • Für benutzerdefinierte Displays, die SceneState als Alternative zu NavDisplay verwenden, ist die Verwendung des CompositionLocal-Elements LocalEntriesToRenderInCurrentScene nicht mehr erforderlich. Es ist jetzt intern. (Ic40ef, b/414668196)
  • SceneSetupNavEntryDecorator und rememberSceneSetupNavEntryDecorator() 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, SinglePaneScene und SceneState implementieren 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 jetzt vararg elements: NavKey. (I03e45)
  • Die Standardanimationen für NavDisplay sind jetzt Teil der allgemeinen API, sodass sie von allen Plattformen aus aufgerufen werden können. (I71af9, b/447147159)
  • Benennen Sie EntryProviderBuilder in EntryProviderScope um, um genau widerzuspiegeln, dass die Klasse eine Kotlin-DSL ist, die einen Bereich zum Erstellen von NavEntries bietet. (Ia7465)

Fehlerkorrekturen

  • rememberNavBackStack() erzwingt jetzt die polymorphe Serialisierung für NavKey und erfordert ein benutzerdefiniertes SavedStateConfiguration, 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 von NavEntry<T> akzeptiert, die mit rememberDecoratedNavEntries versehen wurde. (I4025b, b/441940314)
  • DialogScene wurde in ein neues Paket verschoben. (Ia5840)
  • Öffentliche API DecorateNavEntry entfernen. Verwenden Sie stattdessen rememberDecoratedNavEntries, 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 neue NavDisplay-Überladung bereitgestellt, die SceneState und NavigationEventState akzeptiert. (Idfb46, b/444479133)
  • Mit NavDisplay können Sie jetzt die Übergänge basierend auf dem Scene anpassen, zu dem Sie wechseln und von dem Sie kommen. Dazu werden die currentState und targetState des Transition herangezogen. (I906cc, b/443872322)
  • NavigationEventInfo ist jetzt ein abstract class statt ein interface. 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. NavigationEventHandler und NavigationBackHandler (und Varianten) unterstützen jetzt eine neue Überladung, die ein hochgestuftes NavigationEventState akzeptiert. Die einfachen Überladungen (mit currentInfo) 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 von NavEntry zum 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 zuvor androidx.navigation3.runtime.entry importiert 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 explizite SavedStateConfiguration-Überladung in plattformübergreifendem Code erzwungen wird. (I73313, b/420443609)
  • swipeEdge von NavigationEvent wird 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 Überladung rememberNavBackStack mit einem expliziten SavedStateConfiguration. (I1e418, b/420443609)

Fehlerkorrekturen

  • Absturz während der intelligenten „Zurück“-Geste behoben, wenn die verschachtelte NavDisplay einen 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

  • DecoratedNavEntryProvider wurde durch rememberDecoratedNavEntries ersetzt, wodurch NavEntries erstellt und zurückgegeben werden, die mit der Liste der bereitgestellten Decorators versehen sind (I0fe1c, b/441328236).
  • NavBackStack ist jetzt generisch für den Typ NavKey. So können Apps und Bibliotheken benutzerdefinierte Schlüsseltypen für ihre Back Stacks definieren, anstatt auf NavKey beschränkt zu sein. (I4d190,Iad2f4, b/420443609)
  • NavBackStack ist 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)
  • RememberNavBackStack wurde nach commonMain verschoben, damit es auf allen Plattformzielen bereitgestellt wird. (Id69e7, b/420443609)

Fehlerkorrekturen

  • NavDisplay verschiebt jetzt jede einzelne NavEntry in die richtige Lifecycle.State. (I30aac, b/440145700)
  • Ein Problem wurde behoben, bei dem NavDisplay alle verschachtelten NavigationEventDispatcherOwner ignorierte, die über LocalNavigationEventDispatcherOwner der NavigationEvent-Bibliothek festgelegt wurden. (I6224a)

Änderungen an Abhängigkeiten

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 Runtime unterstü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 das Navigation3 UI-Artefakt bereitgestellt. Auf anderen Plattformen müssen Sie eine eigene benutzerdefinierte NavDisplay implementieren. 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 NavDisplayInfo ist jetzt öffentlich und kann verwendet werden, um die Liste der sichtbaren Einträge aus NavDisplay abzurufen. (Ibc91f)

API-Änderungen

  • Es wurde ein neues NavBackStackSerializer hinzugefügt, das in Verbindung mit rememberNavBackStack verwendet werden kann, um den Status wiederherzustellen. rememberNavBackStack() akzeptiert jetzt auch ein SavedStateConfiguration, 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 NavEntry bereitgestellte key kein String ist oder Ihr NavEntry den contentKey nicht überschrieben und auf den key gesetzt hat. Beachten Sie, dass dadurch erzwungen wird, dass Ihr Schlüssel in einem Bundle gespeichert 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

API-Änderungen

  • SavedStateNavEntryDecorator verwendet jetzt die in SaveableStateProvider integrierte SaveableStateRegistry, um Zustände zu speichern und wiederherzustellen. (If8d9a)
  • Der predictivePopTransitionSpec wird 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

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

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 NavEntry basiert jetzt ausschließlich auf der aktuellen Liste der Decorator, die an NavDisplay ü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.content ist jetzt privat. Wenn Sie NavEntry-Inhalte aufrufen möchten, rufen Sie die neue NavEntry.Content() API auf, für die kein key-Parameter mehr erforderlich ist. (Icd0fd, b/420991203)
  • NavEntry.key ist jetzt ein privates Feld. NavEntry und die relevanten Status sollten durch das neue Feld contentKey identifiziert werden, das aus dem neuen Lambda contentKeyFactory generiert wird und standardmäßig einen speicherbaren Hash aus NavEntry.key enthä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

  • Navigation3 löscht nicht mehr die Decorator-Zustände für backStacks, die ausgetauscht und durch eine andere backStack-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 SavedStateNavEntryDecorator behoben, 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.