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
1. Juli 2026 1.1.4 - - 1.2.0-alpha05

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von navigation3 hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie die Abhängigkeiten für die benötigten Artefakte der Datei build.gradle für Ihre App oder Ihr Modul hinzu:

Groovy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.2.0-alpha05"
    implementation "androidx.navigation3:navigation3-ui:1.2.0-alpha05"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.2.0-alpha05")
    implementation("androidx.navigation3:navigation3-ui:1.2.0-alpha05")
}

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.

Für dieses Artefakt gibt es keine Versionshinweise.

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

  • Es wurde eine rememberResultEventBus-API hinzugefügt, die ein ResultEventBus zurückgibt, das an rememberResultEventBusNavEntryDecorator übergeben werden kann. So kann ein ResultEventBus außerhalb des ResultEventBusNavEntryDecorator platziert werden. (Ia655b, b/516995400)

DeepLinkRequest - Es wurden zwei KMP-kompatible Konstruktoren hinzugefügt: einer, der einen DeepLinkUri akzeptiert, und einer, der einen Rohstring-URI akzeptiert. (I3c088, b/513200887, b/522194187) - (Nur Android) Es wurde ein Konstruktor hinzugefügt, der ein Intent akzeptiert. (Ia0498, b/513200887, b/522194187) - Alle Konstruktoren haben ein zusätzliches extras-Feld für ein Map<String, Any>, um zusätzliche Anforderungsinformationen 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 aus der Karte mit einem RequestExtrasKey gelesen werden(I5091c, b/513200887). - (Nur Android) Es wurde eine ActionExtrasKey- und eine actionExtra-Funktion zum Erstellen einer Extras-Karte mit ActionExtrasKey hinzugefügt. (Id0c90, [b/513200887] - Die Funktionen MimeTypeExtrasKey und mimeTypeExtra wurden hinzugefügt, um eine Karte mit Extras 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 Stringgleichheit gesucht und die Groß-/Kleinschreibung nicht berücksichtigt. (Ie7e67, b/513191950)

API-Änderungen

DeepLinkRequest - Remove fromAction factory function. Verwenden Sie zum Erstellen einer Anfrage, die mit einer Aktion verknüpft ist, das neue Feld DeepLinkRequest.extras.(Id0c90, b/513200887) - Die fromMimeType-Fabrikfunktion wurde entfernt. Verwenden Sie das neue Feld DeepLinkRequest.extras, um eine Anfrage zu erstellen, die einem MIME-Typ zugeordnet ist. (I85131, b/513200887) - (Nur Android) Die fromIntent-Factory-Funktion wurde entfernt. Wird durch einen neuen Konstruktor ersetzt, der eine Intent- und eine Extras-Zuordnung akzeptiert. (Ia0498, b/513200887, b/522194187) - Die Factory-Funktionen fromUri und fromUriString wurden entfernt. Wird durch neue Konstruktoren ersetzt, 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 bei der Verwendung mit Matchers keine Typumwandlung für hierarchische Schlüssel erforderlich ist. (I1e453, b/525094876) - Der UriMatchResult-Konstruktorparameter für die Argumentzuordnung hat jetzt standardmäßig eine leere Zuordnung. (I3acdd) - Die abstrakte Klasse DeepLinkMatcher.Filter ist jetzt eine funktionale Schnittstelle. Das Konstruktorfeld filter wurde entfernt und sollte stattdessen direkt in der Unterklasse übergeben werden. (I9eb7d, b/522194187)

Fehlerkorrekturen - Ein eingeblendeter Eintrag verschwindet nicht mehr sofort, wenn er zu einem Eintrag mit verschachtelten Metadaten mit Lambda-Werten eingeblendet wird. (Idb872, b/520494430) - UriDeepLinkMatcher wurde korrigiert, sodass ein Null-UriMatchResult zurückgegeben wird, anstatt MissingFieldException auszugeben, wenn bei der Zuordnung erforderliche Argumente fehlen. (I5322f, b/524663005) - Eine UriDeeplinkMatcher mit einem URI mit dem Schema „https“ kann nur mit Anfragen abgeglichen werden, die ebenfalls das Schema „https“ haben. (Ibfe22, b/522304329) - Fehlerbehebung: UriDeepLinkMatcher wird jetzt korrekt als positive Übereinstimmung mit https identifiziert, wenn ein DeepLinkRequest mit einem UriDeepLinkMatcher abgeglichen wird.http (I3a62b, b/518804264) - Der DeepLinkMatcher.MatchResult-Vergleich gibt jetzt standardmäßig 0 zurück, wenn zwei Ergebnisse gleich sind. (I48ddb, b/518841353) - UriDeepLinkMatcher gibt jetzt einen Nullwert für UriMatchResult zurück, anstatt eine Ausnahme auszulösen, wenn die Abgleichsanfrage 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 entfernt 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 – ein angeforderter Deeplink mit einem DeepLinkUri und einem optionalen „mimeType“ oder einer optionalen Aktion(nur Android). Zusammen mit der neuen Klasse gibt es Begleitfunktionen zum Erstellen einer Instanz mit einem uri, einem mimeType oder einem action. Die Android-Plattform bietet auch eine Hilfsfunktion zum Erstellen einer Anfrage aus einem Intent. (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 dem Navigationsschlüssel zugeordnet, der diesen Deeplink unterstützt. Ein Navigationsschlüssel kann mehreren Matchern zugeordnet werden. Wenn Sie DeepLinkMatcher.match aufrufen, wird ein MatchResult zurückgegeben, das den zugehörigen Navigationsschlüssel enthält, wenn eine Übereinstimmung gefunden wird. Es gibt zwei Standardimplementierungen von DeepLinkMatcher: UriDeepLinkMatcher für den Abgleich von Deeplinks auf Grundlage von URI und StaticKeyDeepLinkMatcher für den Abgleich von Deeplinks mit nur DeepLinkMatcher.Filter, die über einen Boolean übereinstimmen. (I3798e, b/470282247)

  • UriDeepLinkMatcher eine meinungsbasierte 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 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 wurde hinzugefügt. Das ist eine Kotlin Multiplatform-Version von android.net.Uri. (Id4725, b/470282247)

API-Änderungen

  • Auf compileSdk 37 aktualisiert, um dem compileSdk von Compose zu entsprechen

Fehlerkorrekturen

  • Die AnimatedBottomSheetSample von IllegalArgumentException wurde korrigiert, wenn mehrere Overlays angezeigt werden. Die Beispiel-SceneStrategy berechnet jetzt korrekt den letzten Nicht-OverlayScene und zeigt ihn unter allen Overlayszenen an. (If2281, b/506733412)
  • Die NavigationEvent-Abhängigkeit wurde auf Version 1.1.1 aktualisiert. Dadurch wird der No-Op-NavigationEventHandler im Inspektionsmodus entfernt, um die Funktion „Vorhersagende 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

  • Benennen Sie onBack in onBackCompleted um und fügen Sie onBackCancelled zu NavigationBackHandler hinzu, um abgebrochene Zurück-Gesten zu unterstützen. (I92741)
  • Fügen Sie NavigationBackHandler hinzu, um die Verarbeitung von „Zurück“-Gesten und der intelligenten „Zurück“-Geste bei Verwendung von SceneState zu vereinfachen. So können Entwickler einfacher benutzerdefinierte UI-Komponenten erstellen, die die Standard-Zurück-Navigation und Vorhersage-Gesten unterstützen, ohne Backstack-Deltas manuell berechnen zu müssen. (I6a055)
  • Fügen Sie rememberNavigationEventState hinzu, um die Verbindung von SceneState mit der Verarbeitung von intelligenten „Zurück“-Gesten 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 von der 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

  • Wenn Sie über ein OverlayScene auf LocalNavAnimatedContentScope zugreifen, wird kein IllegalStateException mehr ausgelöst, da OverlayScenes jetzt ein No-Op-LocalAnimatedContentScope erhalten. (I2f00c, b/486067688)

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

  • Das Problem, dass ein eingeblendeter Eintrag sofort wieder verschwand, wenn er zu einem Eintrag mit verschachtelten Metadaten mit Lambda-Werten eingeblendet wurde, wurde behoben. (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 entfernt wurden. (Ia2b9e, b/502624496)

  • Die NavigationEvent-Abhängigkeit wurde auf Version 1.1.2 aktualisiert. Dadurch wurde die No-Op-Funktion NavigationEventHandler im Inspektionsmodus entfernt, um die Funktion „Vorhersagende 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 Version 1.1.1 aktualisiert. Dadurch wurde die No-Op-Funktion NavigationEventHandler im Inspektionsmodus entfernt, um die Funktion „Vorhersagende 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

  • Wenn Sie über ein OverlayScene auf LocalNavAnimatedContentScope zugreifen, wird kein IllegalStateException mehr ausgelöst, da OverlayScenes jetzt ein No-Op-LocalAnimatedContentScope erhalten. (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.

Version 1.1.0 ist jetzt stabil

Wichtige Änderungen seit Version 1.0.0

Gemeinsame Elemente zwischen Szenen - Navigation3 unterstützt jetzt die Behandlung von Szenen als Objekt für gemeinsame Elemente. So können Sie dafür sorgen, dass die Übergänge zwischen den Szenen flüssig sind. Sie können diese Funktion aktivieren, indem Sie entweder NavDisplay oder rememberSceneState eine SharedTransitionScope übergeben.

SceneDecoratorStrategy – Einführung von SceneDecoratorStrategy zur Unterstützung von Anwendungsfällen wie dem Dekorieren von Szenen mit gängigen UI-Komponenten oder dem Teilen von Status zwischen Szenen.

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 in der Metadatenzuordnung enthalten sein 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 NavDisplay Übergänge hinzuzufügen.

OverlayScene-Animationen – Die OverlayScene-Schnittstelle hat einen neuen onRemoved-Callback zum Anhalten. Dieser Callback wird aufgerufen, nachdem ein Schlüssel, der der Szene zugeordnet ist, aus dem Backstack entfernt wurde, aber bevor er die Komposition verlässt. So können Exit-Animationen, die in onRemovedaufgerufen werden, abgeschlossen werden, bevor die Overlay-Szene aus der Komposition entfernt wird.

Weitere Änderungen - NavDisplay und rememberSceneState verwenden jetzt ein List<SceneStrategy> anstelle des bisherigen einzelnen SceneStrategy-Parameters, der durch das Infix then verkettet wurde. – Sie können jetzt dynamisch Metadaten hinzufügen, wobei der Eintragschlüssel über die EntryProvider-DSL berücksichtigt wird.

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

  • Durch NavDisplay wird jetzt dafür gesorgt, dass Einträge, die unter Overlays angezeigt werden, ein Lifecycle von maximal STARTED haben. So wird sichergestellt, dass APIs wie dropUnlessResumed weiterhin funktionieren, wenn Dialogfelder verwendet werden. (If209f, b/483966071)
  • Ein Problem in NavDisplay wurde 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 ein List<SceneStrategy> anstelle des bisherigen einzelnen SceneStrategy-Parameters, der durch das Infix then verkettet wurde. Das entspricht eher dem List<SceneDecoratorStrategy<T>>, das beide APIs bereits verwenden. Die bisherigen APIs werden nicht mehr unterstützt. (I78b2c, b/482108465)
  • Es wurde ein Operator „#contains“ für Metadaten hinzugefügt, um zu prüfen, ob die Metadatenzuordnung das angegebene NavMetadataKey enthält. (Ic30db, b/485311895)
  • NavMetadataKey DialogKey für DialogSceneStrategy zur Verwendung mit Metadata 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 in der Metadatenzuordnung enthalten sein 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 NavDisplay Übergänge hinzuzufügen. (Ic10ef, Ic049c,b/476213928)

API-Änderungen

  • Die OverlayScene-Schnittstelle hat einen neuen onRemoved-Callback zum Anhalten. Dieser Callback wird aufgerufen, nachdem ein Schlüssel, der der Szene zugeordnet ist, 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 aufgeteilt. 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 kann. (If9385, b/477669607, b/477670333)

Fehlerkorrekturen

  • Ein Fehler wurde behoben, bei dem das Übergeben eines SharedTransitionLayout an NavDisplay oder rememberSceneState und die Verwendung von OverlayScene zu einem Absturz führte, da SharedTransitionLayout nur mit NavEntries funktioniert, die als Teil von 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 behoben, der durch die Verwendung von NavDisplay während der AndroidStudio-Vorschauversionen 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 dynamisch Metadaten hinzufügen, wobei der Eintragsschlüssel über die EntryProvider-DSL berücksichtigt wird. (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 die neue Funktion calculatedScene(Scene). Das bedeutet, dass SceneStrategy angepasst werden können, um anderen Szenen zusätzliche Funktionen zu bieten. (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 gemeinsam genutztes Elementobjekt. So können Sie dafür sorgen, dass die Übergänge zwischen den Szenen flüssig sind. Sie können diese Funktion aktivieren, indem Sie entweder NavDisplay oder rememberSceneState eine 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 ist jetzt von NavigationEvent 1.0.2 abhängig. Dadurch wird ein IllegalStateException behoben, der durch die Verwendung von NavDisplay während der AndroidStudio-Vorschauversionen 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.

Navigation3

  • Die Navigation3-Bibliothek ist jetzt stabil. Navigation3 ist der erste Ansatz für die Navigation in AndroidX Compose.
  • Weitere Informationen finden Sie in unserem Blogpost zur Ankündigung, auf der Seite Ressourcen und in den Rezepten.

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 einen LocalLifecycleOwner auf der Scene-Ebene fest, mit dem Szenenautoren prüfen können, ob alle Übergänge abgeschlossen sind, indem sie prüfen, ob Lifecycle.State RESUMED ist. Das Verhalten von LocalLifecycleOwner auf der Ebene NavEntry ist unverändert: Es bleibt auch bei STARTED, wenn ein Übergang läuft, und wird zusätzlich bei CREATED begrenzt, wenn NavEntry aus dem Backstack 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 für das isolierte Testen von SceneStrategy und dem zurückgegebenen Scene eignet. Für komplexere Anwendungsfälle verwenden Sie bitte rememberSceneState(). (I8440c, b/451679047)

Fehlerkorrekturen

  • Eine Endlosschleife beim Verketten von SceneStrategy mit then wurde behoben. (Iba3f0, b/450323470)
  • Das Bildschirmflackern beim Tauschen des an NavDisplay übergebenen backStack und bei 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. Stattdessen sollten Sie diese Arbeit in die Erstellung Ihrer SceneStrategy-Methode (d.h. in eine rememberMySceneStrategy()-Methode) verlagern, mit der Sie die Lebensdauer aller rememberSaveable-Werte oder wichtigen remember-Anweisungen auf der Grundlage der richtigen Werte vollständig definieren können. (If1733, b/448709506)
  • Der Parameter onBack für SceneStrategy.calculateScene wurde in den neuen Empfängerbereich SceneStrategyScope verschoben, um deutlicher zu machen, dass es sich um einen optionalen Parameter handelt, und um einen Erweiterungspunkt für zukünftige Navigation3-Funktionen zu schaffen. (I3aea3, b/448460407)
  • Die Lambda-Funktion onBack, die an NavDisplay und an Ihre SceneStrategy übergeben wird, enthält keinen count: Int-Parameter mehr, der angibt, wann mehrere Einträge entfernt werden sollen. Stattdessen wird die () -> Unit-Lambda-Funktion jetzt mehrmals hintereinander aufgerufen, wenn in Ihrer Szene mehrere Einträge angefordert werden. (Idedb5, b/446989346)
  • Entfernen Sie die NavEntryWrapper-Klasse 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 kann ein Eintrag weiterhin mit neuen Inhalten umbrochen werden. (I7da2a, b/444447130)
  • Die Funktion navEntryDecorator, die ein NavEntryDecorator erstellt und zurückgibt, wurde entfernt und durch die Klasse NavEntryDecorator ersetzt, die jetzt öffentlich und für die Unterklassifizierung verfügbar ist. (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator wurde in SaveableStateHolderNavEntryDecorator umbenannt, da Einträge damit mit einem SaveableStateHolder versehen werden. Der Decorator wurde auch von einer Funktion zu einer Klasse umgestaltet, da er funktional eine Factory für NavEntryDecorator ist. (Ie6013, b/447381176)
  • Für benutzerdefinierte Displays, die SceneState anstelle von NavDisplay verwenden, ist die Verwendung der Komposition LocalEntriesToRenderInCurrentScene nicht mehr erforderlich. Diese ist jetzt intern. (Ic40ef, b/414668196)
  • SceneSetupNavEntryDecorator und rememberSceneSetupNavEntryDecorator() wurden aus der öffentlichen API entfernt. Diese Funktion ist jetzt standardmäßig enthalten, ohne dass Sie sie manuell einfügen müssen. (Ieae42, b/444479133)
  • NavEntry, DialogScene, SinglePaneScene und SceneState implementieren jetzt alle „equals“. (I96121)
  • Die Szenenoberfläche hat ein neues Metadatenfeld, mit dem szenenspezifische Metadaten für NavDisplay angehängt werden können. So 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 gemeinsamen 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 für die korrekte Wiederherstellung des Status konfiguriert ist. Die KDoc-Dokumentation wurde aktualisiert, um der Anforderung Rechnung zu tragen, 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 dekoriert wurde. (I4025b, b/441940314)
  • DialogScene wurde in ein neues Paket verschoben. (Ia5840)
  • Entfernen Sie die öffentliche API DecorateNavEntry. Verwenden Sie stattdessen rememberDecoratedNavEntries, um einen NavEntry mit einer Liste von Dekoratoren zu umschließen. (Id8c09)
  • Die Navigation3-Benutzeroberfläche bietet jetzt neue Standard-transitionSpec-Properties. (Ibcabd)
  • Ein neues SceneState-Objekt wurde hinzugefügt, um die Verwaltung von Szenen zu erleichtern. Außerdem gibt es eine neue NavDisplay-Überladung, die SceneState und NavigationEventState akzeptiert. (Idfb46, b/444479133)
  • Mit NavDisplay können Sie die Übergänge jetzt anpassen. Dazu wird die Scene-Ausrichtung anhand der Transition-Werte currentState und targetState bestimmt. (I906cc, b/443872322)
  • NavigationEventInfo ist jetzt ein abstract class statt eines interface. Aktualisieren Sie alle benutzerdefinierten Implementierungen, damit sie von der Klasse erben (z. B. data class MyInfo : NavigationEventInfo()). (I1e59c, b/444734264)
  • Die Handler-APIs für navigationevent-compose wurden aktualisiert. NavigationEventHandler und NavigationBackHandler (und Varianten) unterstützen jetzt eine neue Überladung, die gehostete NavigationEventStates akzeptiert. Die einfachen Überladungen (mit currentInfo) bleiben erhalten und verwenden jetzt intern dieses neue Statusmodell. (Ic3251, b/444734264)
  • Alle Scene APIs wurden von navigation3-ui zu navigation3-runtime verschoben. Das bedeutet, dass sie jetzt auf allen Plattformen verfügbar sind, die von navigation3-runtime unterstützt werden. (I431d0, b/444449993)
  • Es wurde eine neue rememberDecoratedNavEntries-Überladung hinzugefügt, die eine Liste von NavEntry zum Dekorieren verwendet. Die Eingabe kann bereits mit anderen Eintragsdekorationen versehen sein. (I5a034, b/444230270)
  • Parameter vom Typ „navigation3“-Wildcard 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 auf Reflexion basierende NavBackStackSerializer-Überladung auf Android. Dadurch werden implizite Serialisierungsfehler zur Laufzeit auf Nicht-Android-Plattformen verhindert, da die Verwendung der expliziten SavedStateConfiguration-Überladung in Multiplattformcode erzwungen wird. (I73313, b/420443609)
  • Make NavigationEvent's swipeEdge an @IntDef (Icee54, b/443950342)
  • Beschränken Sie die NavBackStack-Serialisierung auf Android. So werden Laufzeitfehler auf Nicht-Android-Plattformen verhindert. Verwenden Sie für das plattformübergreifende Speichern des Status die rememberNavBackStack-Überladung mit einem expliziten SavedStateConfiguration. (I1e418, b/420443609)

Fehlerkorrekturen

  • Behebt einen Absturz während der Vorhersage für die Zurück-Geste, wenn ein verschachteltes 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, das NavEntries erstellt und zurückgibt, die mit der Liste der bereitgestellten Dekoratoren (I0fe1c, b/441328236) versehen sind.
  • NavBackStack ist jetzt generisch über den Typ NavKey. So können Apps und Bibliotheken benutzerdefinierte Schlüsseltypen für ihre Backstacks definieren, anstatt auf NavKey beschränkt zu sein. (I4d190,Iad2f4, b/420443609)
  • NavBackStack ist jetzt @kotlinx.serialization.Serializable. So lässt sich der Navigationsstatus bei Prozessbeendigung und Konfigurationsänderungen ohne zusätzlichen Boilerplate-Code speichern und wiederherstellen. (I2c3cf, b/420443609)
  • RememberNavBackStack wurde zu commonMain verschoben, damit es auf allen Plattformzielen verfügbar ist. (Id69e7, b/420443609)

Fehlerkorrekturen

  • NavDisplay verschiebt jetzt jede einzelne NavEntry korrekt 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 bei 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

  • Den Navigation3 Runtime-Artefakten wurden neue KMP-Ziele (Kotlin Multiplatform) 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: Dies bietet keine KMP-Ziele für das Navigation3 UI-Artefakt. Auf anderen Plattformen müssen Sie Ihre eigene benutzerdefinierte NavDisplay implementieren. Wenn Sie möchten, dass diese Funktion unterstützt wird, stimmen Sie hier für das Jetbrains-Problem ab und verfolgen Sie den Fortschritt.
  • Das NavDisplayInfo-Objekt ist jetzt öffentlich und kann verwendet werden, um die Liste der sichtbaren Einträge aus dem 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 durch die Navigation falsche Lebenszyklusereignisse ausgelöst wurden. (I8bf6d, b/425901162, b/434109022)

Bekannte Probleme

  • Durch 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. Dadurch wird erzwungen, dass Ihr Schlüssel in einem Bundle gespeichert werden kann. Dieser Fehler 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)
  • predictivePopTransitionSpec erhält jetzt den Wischrand als Parameter. So können Sie den Übergang anpassen, je nachdem, von welchem Rand der Nutzer die Vorhersage-Geste „Zurück“ gestartet hat. (I753a8)

Fehlerkorrekturen

  • Ein Problem wurde behoben, das dazu führte, dass benutzerdefinierte Szenen unendlich oft 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 Dekoratoren, die an NavDisplay übergeben werden. Das bedeutet, dass Dekoratoren bei mehreren Backstacks entlang Ihrer Backstacks getauscht werden sollten, um den Status der NavEntries im Backstack beizubehalten. Andernfalls werden die Status so gelöscht, als ob die Einträge entfernt worden wären (anstatt eines Tauschs). (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. Um NavEntry-Inhalte aufzurufen, rufen Sie die neue NavEntry.Content()-API auf. Für den Aufruf ist kein key-Parameter mehr erforderlich. (Icd0fd, b/420991203)
  • NavEntry.key ist jetzt ein privates Feld. Die NavEntry und die zugehörigen Status sollten über das neue Feld contentKey identifiziert werden, das aus der neuen Lambda-Funktion contentKeyFactory generiert wird und standardmäßig einen speicherbaren Hash enthält, der aus NavEntry.key generiert wird (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812).

Änderungen bei 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 Dekoratorstatus 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

  • Ein Problem mit dem SavedStateNavEntryDecorator wurde behoben, das zu Kollisionen für verschiedene Datenklassen mit denselben Attributwerten geführt hat. (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 enthält die Bausteine, während das androidx.navigation3.ui-Artefakt die UI-Ebene über die NavDisplay API bereitstellt. Entwickler können ihren eigenen Status direkt an die zusammensetzbare Funktion NavDisplay übergeben. Der Inhalt wird dann basierend auf Änderungen im Entwicklerstatus geändert.

@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 Navigation3-Leitfaden.