Navigation

Navigation ist ein Framework für die Navigation zwischen „Zielen“ innerhalb einer Android-App. Es bietet eine einheitliche API, unabhängig davon, ob Ziele als Fragmente, Aktivitäten oder andere Komponenten implementiert sind.
Letzte Aktualisierung Stabile Release Releasekandidat Beta-Release Alpha-Release
23. September 2026 2.10.2 - - -

Abhängigkeiten deklarieren

Für eine Abhängigkeit von Navigation musst du deinem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Google-Repository bei Maven.

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

Groovy

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21'
}
  
dependencies {
  def nav_version = "2.10.2"

  // Jetpack Compose Integration
  implementation "androidx.navigation:navigation-compose:$nav_version"

  // Views/Fragments Integration
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Feature module support for Fragments
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

  // Testing Navigation
  androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

  // JSON serialization library, works with the Kotlin serialization plugin.
  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3"
}

Kotlin

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  kotlin("plugin.serialization") version "2.0.21"
}

dependencies {
  val nav_version = "2.10.2"

  // Jetpack Compose integration
  implementation("androidx.navigation:navigation-compose:$nav_version")

  // Views/Fragments integration
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Feature module support for Fragments
  implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

  // Testing Navigation
  androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

  // JSON serialization library, works with the Kotlin serialization plugin
  implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

Safe Args

Wenn Sie Safe Args in Ihr Projekt einfügen möchten, fügen Sie die folgende classpath in Ihre build.gradle-Datei auf oberster Ebene ein:

Groovy

buildscript {
    repositories {
        google()
    }
    dependencies {
        def nav_version = "2.10.2"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

Kotlin

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.10.2"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

Außerdem müssen Sie eines von zwei verfügbaren Plug-ins anwenden.

Wenn Sie Java-Sprachcode generieren möchten, der für Java- oder gemischte Java- und Kotlin-Module geeignet ist, fügen Sie diese Zeile in die build.gradle-Datei Ihrer App oder Ihres Moduls ein:

Groovy

plugins {
  id 'androidx.navigation.safeargs'
}

Kotlin

plugins {
    id("androidx.navigation.safeargs")
}

Wenn Sie stattdessen Kotlin-Code generieren möchten, der für reine Kotlin-Module geeignet ist, fügen Sie Folgendes hinzu:

Groovy

plugins {
  id 'androidx.navigation.safeargs.kotlin'
}

Kotlin

plugins {
    id("androidx.navigation.safeargs.kotlin")
}

Gemäß Zu AndroidX migrieren muss android.useAndroidX=true in Ihrer gradle.properties-Datei vorhanden sein.

Informationen zur Verwendung von Kotlin-Erweiterungen finden Sie in der KTX-Dokumentation.

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.

Neues Problem melden

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Version 2.10.2

23. September 2026

androidx.navigation:navigation-*:2.10.2 ist veröffentlicht. Version 2.10.2 enthält diese Commits.

Abhängigkeitsupdates

  • androidx.lifecycle-Abhängigkeiten wurden auf Version 2.10.0 aktualisiert. I4505a9f9a

Version 2.10.1

9. September 2026

androidx.navigation:navigation-*:2.10.1 ist veröffentlicht. Version 2.10.1 enthält diese Commits.

Fehlerkorrekturen

  • Wenn NavHost Animationen überspringt, wird jetzt auch sizeTransform als Teil der übersprungenen Animation berücksichtigt, um unerwartetes Clipping zu verhindern. (I4f995, b/550924680)

Version 2.10.0

26. August 2026

androidx.navigation:navigation-*:2.10.0 ist veröffentlicht. Version 2.10.0 enthält diese Commits.

Wichtige Änderungen seit 2.9.0:

  • NavHost bietet jetzt eine Überladung, die die Parameter predictivePopEnterTransition und predictivePopExitTransition akzeptiert, um einen benutzerdefinierten Übergang während der intelligenten „Zurück“-Touchgeste zu ermöglichen.
  • handleDeepLink wurde so geändert, dass nur erkannte Deeplinks verarbeitet und alle anderen ignoriert werden. Wenn dies zu einem Fehler in Ihrer App führt, sollten Sie die Navigation über Deeplinks in Betracht ziehen, die in Ihrem Navigationsdiagramm definiert sind. Für Robolectric-Tests müssen Sie möglicherweise die Methode setPackage für ein vertrauenswürdiges Paket verwenden.
  • NavBackStackEntryInfo wurde hinzugefügt, um Back-Stack-Snapshots während Navigationsereignissen verfügbar zu machen. So können umfangreichere benutzerdefinierte Animationen für die intelligente „Zurück“-Geste erstellt werden.

Unterstützung weiterer Plattformen

  • Die Module navigation-common, navigation-runtime und navigation-testing unterstützen jetzt desktop, linux, macOS, iOS, javascript, WASM, watchos und tvos.

Version 2.10.0-rc01

12. August 2026

androidx.navigation:navigation-*:2.10.0-rc01 ist veröffentlicht. Version 2.10.0-rc01 enthält diese Commits.

Verhaltensänderungen

  • Das für die Navigation erforderliche Mindest-SDK wurde zusammen mit den anderen AndroidX-Bibliotheken auf API 24 verschoben. (I972da, b/474169350)

Version 2.10.0-beta01

29. Juli 2026

androidx.navigation:navigation-*:2.10.0-beta01 ist veröffentlicht. Version 2.10.0-beta01 enthält diese Commits.

API-Änderungen

  • NavBackStackEntryInfo wurde eingeführt, um Back-Stack-Snapshots während Navigationsereignissen verfügbar zu machen. Dadurch werden umfangreichere benutzerdefinierte Animationen für die intelligente „Zurück“-Geste ermöglicht. (Icb3b8)

Version 2.10.0-alpha06

1. Juli 2026

androidx.navigation:navigation-*:2.10.0-alpha06 ist veröffentlicht. Version 2.10.0-alpha06 enthält diese Commits.

Fehlerkorrekturen

  • handleDeepLink wurde so geändert, dass nur erkannte Deeplinks verarbeitet werden (Id4fe3, b/509640056)
  • ComposableFragment wurde geändert, um den vollständig qualifizierten Namen des Ziels anstelle eines Fragmentarguments zum Aufblähen von zusammensetzbaren Funktionen zu verwenden. (I65ded, b/509640586)
  • Ein Absturz in FragmentNavigator wurde behoben, der dazu führte, dass legitime Fragmente eine IllegalArgumentException auslösten, wenn Vorgänge optimiert wurden. (I093b0, b/340202276)
  • Ein Fehler in der Navigation mit Fragmenten wurde behoben, bei dem das programmatische Festlegen des Graphen nicht ordnungsgemäß wiederhergestellt wurde. (I41251, b/321147435)

Version 2.10.0-alpha05

19. Mai 2026

androidx.navigation:navigation-*:2.10.0-alpha05 ist veröffentlicht. Version 2.10.0-alpha05 enthält diese Commits.

Version 2.10.0-alpha04

6. Mai 2026

androidx.navigation:navigation-*:2.10.0-alpha04 ist veröffentlicht. Version 2.10.0-alpha04 enthält diese Commits.

Fehlerkorrekturen

  • Verbesserte NavHost, um mögliche NullPointerExceptions zu verhindern, die durch eine Race-Bedingung mit der intelligenten „Zurück“-Geste verursacht werden. (Ie36c6, b/500945998)

Version 2.10.0-alpha03

22. April 2026

androidx.navigation:navigation-*:2.10.0-alpha03 ist veröffentlicht. Version 2.10.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

  • Compose compileSdk wurde auf API 37 aktualisiert. Das bedeutet, dass bei der Verwendung von Compose mindestens die AGP-Version 9.2.0 erforderlich ist. (Id45cd, b/413674743)

Externer Beitrag

  • watchos- und tvos-Ziele zu den Modulen navigation-common, navigation-runtime und navigation-testing hinzugefügt (I60e46)
  • DefaultNavTransitions öffentlich machen (Ide293)

Version 2.10.0-alpha02

25. März 2026

androidx.navigation:navigation-*:2.10.0-alpha02 ist veröffentlicht. Version 2.10.0-alpha02 enthält diese Commits.

Version 2.10.0-alpha01

11. März 2026

androidx.navigation:navigation-*:2.10.0-alpha01 ist veröffentlicht. Version 2.10.0-alpha01 enthält diese Commits.

Neue Funktionen

  • NavHost bietet jetzt eine Überladung, die die Parameter predictivePopEnterTransition und predictivePopExitTransition akzeptiert, um einen benutzerdefinierten Übergang während der intelligenten „Zurück“-Touchgeste zu ermöglichen. (Iac9b0, b/478294569)

Aktualisierung der Mindest-SDK-Version

Externer Beitrag

  • navigation:navigation-common, navigation:navigation-runtime und navigation:navigation-testing unterstützen jetzt neben Android auch Desktop, Linux, macOS, iOS, JavaScript und WASM. Vielen Dank an Konstantin Tskhovrebov! (I035d9, Iec624, I1615d)

Version 2.9

Version 2.9.8

22. April 2026

androidx.navigation:navigation-*:2.9.8 ist veröffentlicht. Version 2.9.8 enthält diese Commits.

Fehlerkorrekturen

  • Verbesserte NavHost, um mögliche NullPointerExceptions zu verhindern, die durch eine Race-Bedingung mit der intelligenten „Zurück“-Geste verursacht werden. (Ie36c6, b/500945998)

Version 2.9.7

28. Januar 2026

androidx.navigation:navigation-*:2.9.7 ist veröffentlicht. Version 2.9.7 enthält diese Commits.

Fehlerkorrekturen

  • Bei der Navigation SafeArgs treten keine Probleme mehr mit dem Konfigurations-Caching auf, wenn sie mit Google-Diensten verwendet wird. (I57cda, b/458071608)
  • Der Konstruktor SavedStateHandle in „navigation-testing“ decodiert List<String> jetzt. (I26aac,b/454180135)

Version 2.9.6

5. November 2025

androidx.navigation:navigation-*:2.9.6 ist veröffentlicht. Version 2.9.6 enthält diese Commits.

Fehlerkorrekturen

  • Das Navigations-Plug-in SafeArgs wurde zu den modernen Android-Gradle-Plug-in-APIs migriert, um die Kompatibilität mit allen AGP-Releases ab Version 8.4.2 zu gewährleisten. Aufgrund dieser Änderungen wurde das Ausgabeverzeichnis für vom Plug-in generierte Dateien in den von AGP bereitgestellten Standardspeicherort geändert. (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197)
  • Für das Navigations-Plug-in SafeArgs muss die Property useAndroidX nicht mehr festgelegt werden, wenn es mit AGP 9.0.0-alpha04 oder höher verwendet wird. (I6c3a4, b/444746731, b/443106400)

Version 2.9.5

24. September 2025

androidx.navigation:navigation-*:2.9.5 ist veröffentlicht. Version 2.9.5 enthält diese Commits.

Fehlerkorrekturen

  • Navigation Safe Args kann jetzt die Unterstützung von AGP 9.0 für integriertes Kotlin verarbeiten. (I1d9d76)

Abhängigkeitsupdate

  • Das Navigation Safe Args-Plug-in hängt jetzt vom Android-Gradle-Plug-in in Version 8.4.2 ab. (b/431847270, I5932a)

Version 2.9.4

10. September 2025

androidx.navigation:navigation-*:2.9.4 ist veröffentlicht. Version 2.9.4 enthält diese Commits.

Fehlerkorrekturen

  • Absturz verhindern, wenn ein Ereignis für die intelligente „Zurück“-Geste während des Renderns eines Frames übermittelt wird, nachdem der Handler in einem NavHost-Übergang deaktiviert wurde. (I5667c, b/384186542)

Version 2.9.3

30. Juli 2025

androidx.navigation:navigation-*:2.9.3 ist veröffentlicht. Version 2.9.3 enthält diese Commits.

Fehlerkorrekturen

  • In NavController wurde ein Fehler behoben, der bei Verwendung von OnDestinationChangedListeners zu einem ConcurrentModificationException führte. (If7406, b/417784831)
  • Ein Fehler bei der Verwendung von navigate(uri, navOptions,navigationExtras), bei dem die Extras ignoriert wurden, wurde behoben. (I67fb7, b/430336813)

Version 2.9.2

16. Juli 2025

androidx.navigation:navigation-*:2.9.2 ist veröffentlicht. Version 2.9.2 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem der Eintrag nicht fortgesetzt wurde, wenn das Dialogfeld über dem Eintrag geschlossen wurde (Idb20e, b/418746335).
  • Der Fehler MissingFieldException beim Testen von SavedStateHandle mit typsicheren Routen bei Verwendung von benutzerdefinierten NavTypes wurde behoben. (I2f843, b/421002511)

Version 2.9.1

2. Juli 2025

androidx.navigation:navigation-*:2.9.1 ist veröffentlicht. Version 2.9.1 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem behoben, durch das NavEntries, die mit „singleTop“ instanziiert wurden, in ihrem Lifecycle.State nie über CREATED hinausgingen. (I043ba, b/421095236)

Version 2.9.0

7. Mai 2025

androidx.navigation:navigation-*:2.9.0 ist veröffentlicht. Version 2.9.0 enthält diese Commits.

Wichtige Änderungen seit Version 2.8.0

  • Navigation Safe Args-Aktionen werden jetzt mit der Annotation @CheckResult generiert, um sicherzustellen, dass sie verwendet werden.

SupportingPane-Schnittstelle

  • Benutzerdefinierte Navigatoren können ihre Ziele jetzt so kennzeichnen, dass sie die SupportingPane-Schnittstelle implementieren. Dadurch wird dem NavController signalisiert, dass diese Ziele zusammen mit anderen Zielen angezeigt werden. Über diese Schnittstelle können beispielsweise mehrere Ziele gleichzeitig RESUMED werden.

Compose Kotlin Multiplatform

  • Die Navigation bietet jetzt eine neue allgemeine NavController.handleDeepLink()-Funktion, die ein NavDeepLinkRequest anstelle eines Intent verwendet. So können auch andere Plattformen als Android Deeplinks richtig verarbeiten. Vielen Dank, Konstantin Tskhovrebov!
  • Die Navigation bietet jetzt NavUri, eine neue allgemeine Parser-Funktion, die eine kompatible API für den URI von Android auf anderen Plattformen ist. So kann ein URI plattformunabhängig erstellt werden. Vielen Dank, Konstantin Tskhovrebov!

Typsichere Funktionen

  • Die typsicheren APIs, die zuvor nur über reified-Methoden zugänglich waren, d.h. composable<YourScreen> hat jetzt nicht reifizierte Versionen, die direkt eine KClass-Instanz verwenden.
  • Die Typsicherheit für die Navigation unterstützt jetzt Wertklassen als Route oder als Argumenttyp einer Route.

Version 2.9.0-rc01

23. April 2025

androidx.navigation:navigation-*:2.9.0-rc01 ist veröffentlicht. Version 2.9.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Alle Nicht-Android-Plattformziele wurden aus Jetpack Navigation entfernt, da diese Ziele nicht funktionieren. Stattdessen werden jetzt Stubs für verschiedene Plattformen bereitgestellt.(I2877d)

Version 2.9.0-beta01

09. April 2025

androidx.navigation:navigation-*:2.9.0-beta01 ist veröffentlicht. Version 2.9.0-beta01 enthält diese Commits.

API-Änderungen

  • Die allgemeine API von parseStringAsNavUri wurde in eine NavUri-Factory-Funktion geändert, die einen String akzeptiert. (I4db6e, b/403616316)

Abhängigkeitsupdates

  • Diese Bibliothek ist jetzt auf die Kotlin 2.0-Sprachebene ausgerichtet und erfordert KGP 2.0.0 oder höher. (Idb6b5)

Version 2.9.0-alpha09

26. März 2025

androidx.navigation:navigation-*:2.9.0-alpha09 ist veröffentlicht. Version 2.9.0-alpha09 enthält diese Commits.

Neue Funktionen

  • Das navigation-testing-Modul unterstützt jetzt neben Android auch Desktop, Linux, macOS und iOS. (I2b770, b/398265336)
  • NavType wird jetzt neben Android auch auf Computern, Linux, macOS und iOS unterstützt. (I297d8)

Version 2.9.0-alpha08

12. März 2025

androidx.navigation:navigation-*:2.9.0-alpha08 ist veröffentlicht. Version 2.9.0-alpha08 enthält diese Commits.

Fehlerkorrekturen

  • Aus Navigation 2.8.9: Es wurde eine Regression in Navigation 2.8.8 behoben, bei der ein Deeplink genau mit allen Feldern einer Deeplink-Anfrage oder eines Deeplink-Intents übereinstimmen musste, um als Übereinstimmung zu gelten. Dies führte dazu, dass Deeplinks, die teilweise Feldübereinstimmungen enthielten und keine anderen hatten, nicht mehr funktionierten. (Ie5e36, b/399826566)

Externer Beitrag

  • Neue allgemeine Parserfunktion zum Erstellen eines NavUri. Vielen Dank, Konstantin Tskhovrebov! (If0a6a)

Version 2.9.0-alpha07

26. Februar 2025

androidx.navigation:navigation-*:2.9.0-alpha07 ist veröffentlicht. Version 2.9.0-alpha07 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem der Versuch, saveState mit nicht inklusivem Pop auszuführen, zu einem Null-savedState führte, was beim Wiederherstellen zu einem Absturz führen konnte. (I9f3e8, b/395091644)
  • Ab Navigation 2.8.8: Der NavDeepLink-Abgleich wurde korrigiert, sodass ein Deeplink und eine Deeplink-Anfrage genau in URI, Aktion und MIME übereinstimmen müssen. Ein Abgleich ist nicht mehr zulässig, wenn nur ein oder zwei Felder übereinstimmen. (I3b029, b/395712033)
  • Ab Navigation 2.8.8: Ein Fehler wurde behoben, bei dem Routen mit Platzhalterpfaden nicht mit einem hinzugefügten Deeplink übereinstimmten (I7ea92, b/389970341).

Externer Beitrag

  • Extrahieren Sie die APIs „navigation-common“, „navigation-runtime“ und „navigation-compose“ auf die gemeinsame Plattform. Vielen Dank, Konstantin Tskhovrebov! (I1e626, Ica76f, Idf479)

Bekannte Probleme

  • Aufgrund der Arbeiten zur Behebung von b/395712033 müssen Deeplinks fälschlicherweise dieselben Felder wie die Deeplink-Anfrage und/oder die Intent enthalten. Deeplinks müssen nur mit den Feldern übereinstimmen, die sie enthalten. Nicht enthaltene Felder sollten ignoriert werden. Dieses Problem wurde für eine spätere Version im Rahmen von b/399826566 behoben.

Version 2.9.0-alpha06

12. Februar 2025

androidx.navigation:navigation-*:2.9.0-alpha06 ist veröffentlicht. Version 2.9.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Navigation Safe Args-Aktionen werden jetzt mit der Annotation @CheckResult generiert, um sicherzustellen, dass sie verwendet werden. (I14d4c, b/356323084)

Fehlerkorrekturen

  • In NavController wurde ein Fehler behoben, bei dem fälschlicherweise versucht wurde, die backStack-Zustände in einem Array wiederherzustellen, obwohl sie in einer Liste gespeichert waren. (Idfb9b)
  • Aus Navigation 2.8.7: Navigation Safe Args unterstützt jetzt zusammensetzbare Ziele. (I35320, b/362791955)

Version 2.9.0-alpha05

29. Januar 2025

androidx.navigation:navigation-*:2.9.0-alpha05 ist veröffentlicht. Version 2.9.0-alpha05 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, das bei Verwendung von Navigation Compose zu einer unerwarteten Skalierungsanimation führte. (I480f4, b/353294030)
  • Ab Navigation 2.8.6: Über XML bereitgestellte NavDestination-Labels werden über NavType.get geparst, damit die benutzerdefinierte NavType-Logik berücksichtigt wird. (I7ec2f, b/388100796)
  • Über Navigation 2.8.6: Wenn Sie mit dataPattern zu einer Aktivität navigieren, versucht ActivityNavigator jetzt, den Argumentwert mit dem NavType des Arguments zu codieren. (I16376, b/383616432)
  • Aus Navigation 2.8.5: Es wurde ein Problem behoben, das bei Verwendung von Navigation Compose und dem Aufruf von „navigate“ im selben Frame, in dem die aktuelle Animation endet, zu einer unerwarteten Skalierungsanimation führte. (I26cb1, b/353294030)

Version 2.9.0-alpha04

11. Dezember 2024

androidx.navigation:navigation-*:2.9.0-alpha04 ist veröffentlicht. Version 2.9.0-alpha04 enthält diese Commits.

Neue Funktionen

In der folgenden Tabelle sind die reifizierten und KClass-APIs aufgeführt.

reified KClass
composable<TestClass> { } composable(TestClass::class) { }
navigation<NestedGraph>(startDestination = TestClass::class) navigation(route = NestedGraph::class, startDestination = TestClass::class)
dialog<TestClass> {} dialog(TestClass::class) {}
navDeepLink<TestClass>(baseUri) navDeepLink(TestClass::class, baseUri)
NavDeepLink.Builder.setUriPattern<TestClass>(baseUri) NavDeepLink.Builder.setUriPattern(TestClass::class, baseUri)
NavDestinationBuilder.deepLink<TestDeepLink>(baseUri) { } NavDestinationBuilder.deepLink(TestDeepLink::class, baseUri) { }
navController.getBackStackEntry<TestClass>() navController.getBackStackEntry(TestClass::class)
navController.popBackStack<TestClass>(true) navController.popBackStack(TestClass::class, true)
navController.clearBackStack<TestClass>() navController.clearBackStack(TestClass::class)
NavOptions.setPopUpTo<TestClass>() NavOptions.setPopUpTo(TestClass::class)
navOptions { popUpTo<TestClass> {...} } navOptions { popUpTo(TestClass::class) {...} }
NavGraph.setStartDestination<TestClass>() NavGraph.setStartDestination(TestClass::class)
NavGraph.findNode<TestClass>() NavGraph.findNode(TestClass::class)
backStackEntry.toRoute<TestClass>() backStackEntry.toRoute(TestClass::class)
savedStateHandle.toRoute<TestClass>() savedStateHandle.toRoute(TestClass::class)

API-Änderungen

  • Die Kotlin-spezifische NavGraph.setStartDestination-Überladung für Typsicherheit wird vor Java-Quellen verborgen. (Ic640c, b/364634035)

Fehlerkorrekturen

  • Aus Navigation 2.8.5: Es wurde ein Problem behoben, bei dem NavHost eine Ausnahme innerhalb von PredictiveBackHandler auslösen konnte, wenn der Back Stack auf einen Eintrag reduziert und im selben Frame ein System-Back ausgelöst wurde. (I1a429, b/375343407)
  • Aus Navigation 2.8.5: NavDestination NullPointerException beim Aktualisieren des startDestination eines Diagramms behoben. (I99421, b/361560785)

Externer Beitrag

Version 2.9.0-alpha03

13. November 2024

androidx.navigation:navigation-*:2.9.0-alpha03 ist veröffentlicht. Version 2.9.0-alpha03 enthält diese Commits.

Neue Funktionen

  • Die Typsicherheit für die Navigation unterstützt jetzt Wertklassen als Route oder als Argumenttyp einer Route. (I9344a, b/374347483)

Fehlerkorrekturen

  • Ein ConcurrentModificationException wurde behoben, der auftreten konnte, wenn ein an ein NavBackStackEntry angehängtes LifecycleObserver eine Änderung am Back Stack auslöste, wenn der Host-LifecycleOwner, z. B. die enthaltende Aktivität oder das enthaltende Fragment, seinen Lebenszyklusstatus änderte. (Ia9494)

Version 2.9.0-alpha02

30. Oktober 2024

androidx.navigation:navigation-*:2.9.0-alpha02 ist veröffentlicht. Version 2.9.0-alpha02 enthält diese Commits.

Externer Beitrag

  • Neue allgemeine NavController.handleDeepLink(request: NavDeepLinkRequest)-Methode. Vielen Dank, Konstantin Tskhovrebov! (I3e228)

Version 2.9.0-alpha01

16. Oktober 2024

androidx.navigation:navigation-*:2.9.0-alpha01 ist veröffentlicht. Version 2.9.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Benutzerdefinierte Navigatoren können ihre Ziele jetzt so kennzeichnen, dass sie die SupportingPane-Schnittstelle implementieren. Dadurch wird dem NavController signalisiert, dass diese Ziele zusammen mit anderen Zielen angezeigt werden. Über diese Schnittstelle können beispielsweise mehrere Ziele gleichzeitig RESUMED werden. (Id5559)
  • Aus Navigation 2.8.3: Es wurden neue Lint-Prüfungen für die Module navigation-common, navigation-runtime und navigation-compose hinzugefügt, um typsichere Routen zu identifizieren, die nicht korrekt mit @Serializable annotiert sind. Diese Prüfung wird auf alle NavGraphBuilder- und NavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Aus Navigation 2.8.3: Es wurden neue Lint-Prüfungen für die Module navigation-common, navigation-runtime und navigation-compose hinzugefügt, um typsichere Routen mit Enum-Argumenten zu identifizieren, die nicht korrekt mit @Keep annotiert sind. Diese Prüfung wird auf alle NavGraphBuilder- und NavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Geändertes Verhalten

  • Wenn Sie versuchen, einen NavController zu verwenden, der zuvor DESTROYED wurde, wird jetzt ein IllegalStateException ausgelöst. (I520da, b/369616172)

Fehlerkorrekturen

  • Die Ausnahme „Enum-Klasse nicht gefunden“ wurde aktualisiert, um die Verwendung der Annotation @Keep vorzuschlagen, falls die Enum-Klasse in minimierten Builds gelöscht wird. (I90e79, b/358137294)

Bekannte Probleme

  • Es gibt ein Problem mit den neuen Lint-Regeln, die in Navigation 2.8.* hinzugefügt wurden. Dadurch wird ein Obsolete custom lint check-Fehler verursacht, wenn versucht wird, Lint mit dem Android-Gradle-Plug-in 8.4 oder höher auszuführen. (b/368070326, b/371463741)

Version 2.8

Version 2.8.9

12. März 2025

androidx.navigation:navigation-*:2.8.9 ist veröffentlicht. Version 2.8.9 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde eine Regression in Navigation 2.8.8 behoben, bei der ein Deeplink genau mit allen Feldern einer Deeplink-Anfrage oder eines Deeplink-Intents übereinstimmen musste, um als Übereinstimmung zu gelten. Dies führte dazu, dass Deeplinks, die teilweise Feldübereinstimmungen enthielten und keine anderen hatten, nicht mehr funktionierten. (Ie5e36, b/399826566)

Version 2.8.8

26. Februar 2025

androidx.navigation:navigation-*:2.8.8 ist veröffentlicht. Version 2.8.8 enthält diese Commits.

Fehlerkorrekturen

  • Ein Fehler wurde behoben, bei dem Routen mit Platzhalterpfaden nicht mit einem hinzugefügten Deeplink übereinstimmten. (I7ea92, b/389970341)
  • Der Abgleich von NavDeepLink wurde korrigiert. Deeplinks und Deeplink-Anfragen müssen jetzt genau in URI, Aktion und MIME übereinstimmen. Ein Abgleich ist nicht mehr zulässig, wenn nur ein oder zwei Felder übereinstimmen. (I3227f, b/395712033)

Bekannte Probleme

  • Aufgrund der Arbeiten zur Behebung von b/395712033 müssen Deeplinks fälschlicherweise dieselben Felder wie die Deeplink-Anfrage und/oder die Intent enthalten. Deeplinks müssen nur mit den Feldern übereinstimmen, die sie enthalten. Nicht enthaltene Felder sollten ignoriert werden. Dieses Problem wurde für eine spätere Version im Rahmen von b/399826566 behoben.

Version 2.8.7

12. Februar 2025

androidx.navigation:navigation-*:2.8.7 ist veröffentlicht. Version 2.8.7 enthält diese Commits.

Fehlerkorrekturen

  • Navigation Safe Args unterstützt jetzt zusammensetzbare Ziele. (I35320, b/362791955)

Version 2.8.6

29. Januar 2025

androidx.navigation:navigation-*:2.8.6 ist veröffentlicht. Version 2.8.6 enthält diese Commits.

Fehlerkorrekturen

  • NavDestination-Labels, die über XML bereitgestellt werden, werden über NavType.get geparst, damit die benutzerdefinierte NavType-Logik berücksichtigt wird. (Id366d, b/388100796)
  • Wenn du mit dataPattern zu einer Aktivität navigierst, versucht ActivityNavigator jetzt, den Argumentwert mit dem NavType des Arguments zu codieren. (I1a71d, b/383616432)

Version 2.8.5

11. Dezember 2024

androidx.navigation:navigation-*:2.8.5 ist veröffentlicht. Version 2.8.5 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem NavHost eine Ausnahme innerhalb von PredictiveBackHandler auslösen konnte, wenn der Back Stack auf einen Eintrag reduziert und im selben Frame ein System-Back ausgelöst wurde. (I1a429, b/375343407)
  • NavDestination NullPointerException beim Aktualisieren des startDestination eines Diagramms wurde behoben. (I99421, b/361560785)
  • Es wurde ein Problem behoben, das bei Verwendung von Navigation Compose und dem Aufruf von „navigate“ im selben Frame, in dem die aktuelle Animation endet, zu einer unerwarteten Skalierungsanimation führte. (I26cb1, b/353294030)
  • Ein ConcurrentModificationException wurde behoben, der auftreten konnte, wenn ein an ein NavBackStackEntry angehängtes LifecycleObserver eine Änderung am Back Stack auslöste, wenn der Host-LifecycleOwner, z. B. die enthaltende Aktivität oder das enthaltende Fragment, seinen Lebenszyklusstatus änderte. (Ia9494)

Externer Beitrag

  • Die Typsicherheit für die Navigation unterstützt jetzt List<Enum> als Argumenttyp einer Route, ohne dass ein benutzerdefinierter NavType erforderlich ist. Vielen Dank, Csaba Kozák! (GH-725, b/375559962)

Version 2.8.4

13. November 2024

androidx.navigation:navigation-*:2.8.4 ist veröffentlicht. Version 2.8.4 enthält diese Commits.

Neue Funktionen

Fehlerkorrekturen

Version 2.8.3

16. Oktober 2024

androidx.navigation:navigation-*:2.8.3 ist veröffentlicht. Version 2.8.3 enthält diese Commits.

Neue Funktionen

  • Es wurden neue Lint-Prüfungen für die Module navigation-common, navigation-runtime und navigation-compose hinzugefügt, um typsichere Routen zu identifizieren, die nicht korrekt mit @Serializable annotiert sind. Diese Prüfung wird auf alle NavGraphBuilder- und NavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Es wurden neue Lint-Prüfungen für die Module navigation-common, navigation-runtime und navigation-compose hinzugefügt, um typsichere Routen mit Enum-Argumenten zu identifizieren, die nicht korrekt mit @Keep annotiert sind. Diese Prüfung wird auf alle NavGraphBuilder- und NavDeepLinkBuilder-Erweiterungsfunktionen angewendet. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem die neuen Lint-Regeln, die in Navigation 2.8.* hinzugefügt wurden, einen Obsolete custom lint check-Fehler verursachten, wenn versucht wurde, Lint mit dem Android-Gradle-Plug-in 8.4 oder höher auszuführen. (I1be3d, b/368070326, b/371463741)

Bekannte Probleme

  • Bei der Navigation-Lint-Prüfung wird ein Fehler vom Typ „Veraltete benutzerdefinierte Lint-Prüfung“ ausgegeben, wenn versucht wird, Lint mit Lint 16 (AGP 8.7) oder höher auszuführen. (b/371926651)

Version 2.8.2

2. Oktober 2024

androidx.navigation:navigation-*:2.8.2 ist veröffentlicht. Version 2.8.2 enthält diese Commits.

Neue Funktionen

  • Die Typsicherheit für die Navigation unterstützt jetzt serialisierbare Klassen, die Double, Double?, DoubleArray, DoubleArray?, List<Double> und List<Double>? enthalten, ohne dass ein benutzerdefinierter NavType erforderlich ist. (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)

Fehlerkorrekturen

  • Die Fehlermeldung, die angezeigt wird, wenn die Navigation das Argument einer Route nicht einem NavType zuordnen kann, wurde verbessert. Die neue Fehlermeldung enthält den Argumentnamen, den vollständig qualifizierten Namen des Arguments und den vollständig qualifizierten Namen der Route. (Id8416, b/346264232)

Version 2.8.1

18. September 2024

androidx.navigation:navigation-*:2.8.1 ist veröffentlicht. Version 2.8.1 enthält diese Commits.

Neue Funktionen

  • Es wurde eine neue Lint-Regel hinzugefügt, um die Verwendung der Funktion popBackStack zu erzwingen, die einen reifizierten Klassentyp verwendet, wenn versucht wird, mit typsicheren APIs zu popBackStack. (Ief161, b/358095343)

Fehlerkorrekturen

  • Für die Navigation muss die Route, die an die startDestination eines NavGraph übergeben wird, jetzt die Werte für alle erforderlichen Argumente enthalten. Dazu gehören auch Argumente, die nicht nullfähig sind und keinen Standardwert haben. (I18e74, b/362594265)
  • Navigation Safe Args unterstützt jetzt nicht-nullable Strings, sodass „null“-Werte unverändert geparst und im Bundle gespeichert werden. Dies weicht vom bisherigen Verhalten ab, bei dem „null“-Werte in ein Null-Objekt geparst wurden. Diese Änderung gilt nur für nicht-nullable String-Typen. Nullable-Strings bleiben unverändert. (I08b4a, b/348936238)
  • Ein Deeplink zu einer NavDestination ist nur noch über einen Deeplink möglich, der explizit zum Ziel hinzugefügt wurde. Das bedeutet auch, dass Sie nur mit der Überladung der Funktion „navigate“ zu einer Route eines Ziels navigieren können, die eine Stringroute verwendet. Dadurch wird eine Sicherheitslücke behoben, die es ermöglichte, einen Deeplink zu einem potenziell geschützten Ziel zu erstellen. (Ie30e6)

Abhängigkeitsupdate

  • Navigation Safe Args hängt jetzt von Kotlin 1.9.24 und nicht mehr von Kotlin 2.X ab. Entwickler müssen also kein Update durchführen. (a4129a)
  • Navigation Compose hängt jetzt von Compose 1.7.2 ab.

Version 2.8.0

4. September 2024

androidx.navigation:navigation-*:2.8.0 ist veröffentlicht. Version 2.8.0 enthält diese Commits.

Wichtige Änderungen seit 2.7.0

Typsicherheit in der Navigation Kotlin DSL

  • Die Navigation bietet jetzt Typsicherheit für die Kotlin-DSL (von Navigation Compose verwendet) mithilfe der Kotlin-Serialisierung. So können Sie Ziele in Ihrem Navigationsgraphen über typsichere Objekte und Datenklassen definieren:
    // Define a home destination that doesn't take any arguments
    @Serializable
    object Home

    // Define a profile destination that takes an ID
    @Serializable
    data class Profile(val id: String)

    // Now define your NavHost using type safe objects
    NavHost(navController, startDestination = Home) {
        composable<Home> {
            HomeScreen(onNavigateToProfile = { id ->
                navController.navigate(Profile(id))
            })
        }
        composable<Profile> { backStackEntry ->
            val profile: Profile = backStackEntry.toRoute()
            ProfileScreen(profile)
        }
    }

Weitere Informationen finden Sie im Blogpost Navigation Compose meet Typsicherheit.

Intelligente „Zurück“-Geste in Navigation Compose

  • Navigation Compose unterstützt jetzt die intelligente „Zurück“-Geste in der App über die neuen SeekableTransitionState APIs von compose-animation. So können Sie mit der „Zurück“-Geste das vorherige Ziel mit Ihrem benutzerdefinierten Übergang sehen, bevor Sie sich entscheiden, die Transaktion über die abgeschlossene Geste zu bestätigen oder abzubrechen.

Navigation Fragment Composable

  • Es wurde ein neues navigation-fragment-compose-Artefakt hinzugefügt, das eine ComposableNavHostFragment-Alternative zu NavHostFragment enthält. Damit können Sie Ihren Navigations-XML-Dateien zusammensetzbare Ziele hinzufügen. Jedes composable-Ziel muss als @Composable-Methode auf oberster Ebene ohne Argumente ausgedrückt werden, deren voll qualifizierter Name als android:name-Attribut für jedes Ziel verwendet wird. Wenn Sie zu einem dieser Ziele navigieren, wird ein Containerfragment erstellt, um den zusammensetzbaren Inhalt anzuzeigen.
  // In HomeScreen.kt
  @Composable
  fun HomeScreen() {
    // Your Composable content here
  }

  // In your navigation.xml
  <composable
    android:id="@+id/home_screen"
    android:name="com.example.HomeScreenKt\$HomeScreen" />

Weitere Änderungen

  • Navigation Compose hängt jetzt von Compose 1.7.0 ab.
  • Die Navigation bietet jetzt eine neue CollectionNavType<T>-Klasse, eine Unterklasse von NavType<T> für sammlungsbasierte Argumente wie Listen, Arrays und Maps. Alle standardmäßigen NavType-Arrays (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType und StringArrayType) übernehmen jetzt diese neue Klasse.
  • NavType bietet jetzt integrierte Unterstützung für Listen mit Ganzzahlen, Strings, booleschen Werten, Gleitkommazahlen und Long-Werten.

Version 2.8.0-rc01

21. August 2024

androidx.navigation:navigation-*:2.8.0-rc01 ist veröffentlicht. Version 2.8.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Ein Absturz der Navigation wurde behoben, der auftrat, wenn Enum-Klassen der obersten Ebene als typsichere Argumente übergeben wurden. (I0ba76, b/358137294)
  • Navigation 2.8 funktioniert jetzt korrekt mit SDK 34 und wird erst mit der Version 2.9 zusammen mit den anderen AndroidX-Bibliotheken auf SDK 35 umgestellt. (b/358798728)

Version 2.8.0-beta07

7. August 2024

androidx.navigation:navigation-*:2.8.0-beta07 ist veröffentlicht. Version 2.8.0-beta07 enthält diese Commits.

Bekannte Probleme

  • Aufgrund von b/358137294 werden nur Enums unterstützt, die in einer anderen Klasse verschachtelt sind. Enums auf oberster Ebene werden in der nächsten Version unterstützt.

Fehlerkorrekturen

  • Wenn Sie zu doppelten oder gemeinsamen Zielen navigieren, wird das nächstgelegene übereinstimmende Ziel vom aktuellen Standort im Diagramm priorisiert. (Ic89a4, b/352006850)
  • Die Navigation in Safe Args wurde um ein neues NavType.EnumType erweitert. Das bedeutet, dass für Enum-Typen keine benutzerdefinierten NavTypes mehr erforderlich sind. Beachten Sie, dass der SerialName des Enum der standardmäßige vollständig qualifizierte Name sein muss. (I66d22, b/346475493)
  • Die Navigation in Safe Args bietet jetzt integrierte Unterstützung für Argumenttypen, die Nullwerte zulassen, einschließlich Int?, Long?, Float?, Boolean? und Enum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237)
  • Die startDestination der NavGraph verwenden jetzt die Standardargumentwerte, wenn die an die NavGraph übergebene startDestination-Route genau mit der startDestination.route übereinstimmt. (I13762, b/354046047)

Version 2.8.0-beta06

24. Juli 2024

androidx.navigation:navigation-*:2.8.0-beta06 ist veröffentlicht. Version 2.8.0-beta06 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem die Lint-Prüfungen von WrongStartDestinationType nicht nach Companion-Objekten im übergebenen Klassentyp gesucht haben, sodass Lint den Fehler nicht erkannt hat. (I92b09)

Version 2.8.0-beta05

10. Juli 2024

androidx.navigation:navigation-*:2.8.0-beta05 ist veröffentlicht. Version 2.8.0-beta05 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem die singleTop-Navigation abstürzte, wenn verschachtelte NavGraphs dieselbe startDestination-Route hatten. (I17b94, b/294408596)

Version 2.8.0-beta04

26. Juni 2024

androidx.navigation:navigation-*:2.8.0-beta04 ist veröffentlicht. Version 2.8.0-beta04 enthält diese Commits.

Fehlerkorrekturen

  • Die Navigation unterstützt jetzt die Navigation mit leeren Strings in Pfadargumenten. (Ic5dbd, b/339481310)
  • Die Fehlermeldung für benutzerdefinierte Serializer, die direkt in Klassenfeldern über @Serializable(with =...) deklariert werden, wurde verbessert, um klarzustellen, dass diese Funktion derzeit nicht unterstützt wird. (I052b0, b/341319151)
  • Die SavedStateHandleFactory-Test-API kann jetzt in Nicht-Android-Tests verwendet werden. Dazu muss Robolectric jedoch das Parsen von Argumenten mit Bundles unterstützen. (I76cdc, b/340966212)
  • Ein Absturz wurde behoben, der beim Wiederherstellen des Zustands auftrat, wenn die App nach einer Prozessbeendigung mit typsicherer Navigation in Compose fortgesetzt wurde. (Ia8f38, b/341801005)
  • In Navigation Compose wurde ein Problem behoben, bei dem nach dem Abbrechen der intelligenten „Zurück“-Touchgeste das NavBackStackEntry, zu dem der Nutzer zurückkehrt, nie wieder in den Lebenszyklusstatus RESUMED zurückkehrt. Außerdem wird so dafür gesorgt, dass das zurückkehrende Ziel korrekt zurückanimiert wird, anstatt nach einem Wischen an die richtige Stelle zu springen. (I97a0c, b/346608857)
  • Wenn Sie die intelligente „Zurück“-Geste mit Navigation Compose verwenden, hat das Ziel, das entfernt wird, jetzt die richtige Z-Reihenfolge und wird korrekt über dem eingehenden Ziel animiert. (I2077b, b/345993681)

Version 2.8.0-beta03

12. Juni 2024

androidx.navigation:navigation-*:2.8.0-beta03 ist veröffentlicht. Version 2.8.0-beta03 enthält diese Commits.

API-Änderungen

  • CollectionNavType hat eine neue abstrakte emptyCollection()-Methode. Überschreiben Sie dies, um eine leere Sammlung zu verarbeiten, die als Argument übergeben wird. (Ie4d84, b/341723133)

Fehlerkorrekturen

  • Dokumentation zu NavType.serializeAsValue und serializeAsValues hinzugefügt, um hervorzuheben, dass die endgültigen Ausgaben URI-codiert sein sollten. (Ida6bd, b/344943214)
  • Es wurde ein Absturz behoben, der beim Aufrufen von toRoute<T> mit einem Null-CollectionNavType-Argument auftrat. Wenn Sie mit einem Null-CollectionNavType navigieren, ist das Ausgabeargument der Standardwert, der in Ihrer serialisierbaren Klasse deklariert ist, oder der Rückgabewert von emptyCollection(), wenn kein Standardwert vorhanden ist. (I84158, Id630f, b/342672856)

Version 2.8.0-beta02

29. Mai 2024

androidx.navigation:navigation-*:2.8.0-beta02 ist veröffentlicht. Version 2.8.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • Ein Absturz von ClassCastException bei Verwendung von NavBackStackEntry.toRoute mit einem benutzerdefinierten NavType, das null sein kann, wurde behoben. (I1c29b, b/342239473)
  • Es wurden Probleme bei der Wiederherstellung des Back-Stack-Status der Navigation behoben, die beim Versuch auftraten, einen Back-Stack-Eintrag wiederherzustellen, der nicht über die ID vom aktuellen Ziel aus erreichbar ist. Da Routen auf IDs basieren, waren auch Ziele betroffen, die mit Routen erstellt wurden. Außerdem wird ein Absturz behoben, der durch den Aufruf von clearBackStack() verursacht wurde und auf dasselbe Problem zurückzuführen war. (I423c3, b/339908057)

Version 2.8.0-beta01

14. Mai 2024

androidx.navigation:navigation-*:2.8.0-beta01 ist veröffentlicht. Version 2.8.0-beta01 enthält diese Commits.

API-Änderungen

  • SavedStateHandle.toRoute() akzeptiert jetzt den Parameter typeMap für benutzerdefinierte Argumenttypen. (Ie39fb, b/339026523)
  • navigation-testing wurde eine Test-API hinzugefügt, um ein SavedStateHandle aus einem serialisierbaren Kotlin-Objekt zu erstellen. (Id4867, b/339080702)

Fehlerkorrekturen

  • Fehlende Parameterdokumente für Kotlin DSL-Funktionen für die Navigation wurden hinzugefügt. (I26a36)

Version 2.8.0-alpha08

1. Mai 2024

androidx.navigation:navigation-*:2.8.0-alpha08 ist veröffentlicht. Version 2.8.0-alpha08 enthält diese Commits.

Safe Args in Navigation Compose

Diese Funktion verwendet die Kotlin-Serialisierung, damit Sie Ziele in Ihrem Navigationsgraphen über typsichere Objekte und Datenklassen definieren können:

  // Define a home destination that doesn't take any arguments
  @Serializable
  object Home

  // Define a profile destination that takes an ID
  @Serializable
  data class Profile(val id: String)

  // Now define your NavHost using type safe objects
  NavHost(navController, startDestination = Home) {
      composable<Home> {
          HomeScreen(onNavigateToProfile = { id ->
              navController.navigate(Profile(id))
          })
      }
      composable<Profile> { backStackEntry ->
          val profile: Profile = backStackEntry.toRoute()
          ProfileScreen(profile)
      }
  }

Weitere Informationen finden Sie im Blogpost Navigation Compose meet Typsicherheit.

Neue Funktionen

  • Das Artefakt navigation-fragment-compose bietet jetzt ein LocalFragment-CompositionLocal für zusammensetzbare Methoden innerhalb eines ComposableFragment. (If35e5)
  • NavType bietet jetzt integrierte Unterstützung für Listen mit Ganzzahlen, Strings, booleschen Werten, Gleitkommazahlen und Long-Werten. (I4b6dd, Ia914c, b/188693139)

Version 2.8.0-alpha07

17. April 2024

androidx.navigation:navigation-*:2.8.0-alpha07 ist veröffentlicht. Version 2.8.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Fügt ein neues navigation-fragment-compose-Artefakt hinzu, das eine ComposableNavHostFragment-Alternative zu NavHostFragment enthält, mit der Sie Ihren Navigations-XML-Dateien composable-Ziele hinzufügen können. Jedes composable-Ziel muss als @Composable-Methode auf oberster Ebene ohne Argumente ausgedrückt werden, deren voll qualifizierter Name als android:name-Attribut für jedes Ziel verwendet wird. Wenn Sie zu einem dieser Ziele navigieren, wird ein Containerfragment erstellt, um den zusammensetzbaren Inhalt anzuzeigen. (I0ef2e, b/265480755)

    // In HomeScreen.kt
    @Composable
    fun HomeScreen() {
      // Your Composable content here
    }
    
    // In your navigation.xml
    <composable
      android:id="@+id/home_screen"
      android:name="com.example.HomeScreenKt\$HomeScreen" />
    

API-Änderungen

  • Die Unterstützung für Safe Args in Navigation Compose wurde mit einem Ansatz auf Basis der Kotlin-Serialisierung fortgesetzt. Diese APIs sind nicht fertig und mit der Annotation ExperimentalSafeArgsApi gekennzeichnet. Diese Annotation wird entfernt, wenn die gesamte API-Oberfläche in einer zukünftigen Version vollständig ist. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)

Version 2.8.0-alpha06

3. April 2024

androidx.navigation:navigation-*:2.8.0-alpha06 ist veröffentlicht. Version 2.8.0-alpha06 enthält diese Commits.

API-Änderungen

Fehlerkorrekturen

  • NavHost verwendet jetzt Alignment.TopStart als Standardargument für „contentAlignment“. Dies entspricht der Standardeinstellung für AnimatedContent und behebt einige Fälle von unerwarteten Übergängen bei der Skalierung von der Mitte aus. (I09e72, b/330111602)
  • Wenn die intelligente „Zurück“-Touchgeste bei Verwendung von Navigation Compose ausgeführt wird, schließt NavHost den benutzerdefinierten Übergang jetzt korrekt ab, anstatt ihn sofort zu beenden. (I99017, b/327292110)

Version 2.8.0-alpha05

20. März 2024

androidx.navigation:navigation-*:2.8.0-alpha05 ist veröffentlicht. Version 2.8.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Sie können jetzt Argumente direkt in der startDestination-Route an die startDestination von NavGraph übergeben, ohne defaultValue zu verwenden. Dies gilt auch für verschachtelte NavGraph-startDestinations. (I0e0b5, b/109505019, b/188693139)

API-Änderungen

  • Neue abstrakte Klasse CollectionNavType<T> hinzugefügt, eine Unterklasse von NavType<T> für sammlungsbasierte Argumente wie Listen, Arrays und Maps. (Ic6d63, b/188693139)
  • Alle standardmäßigen NavType-Arrays (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType und StringArrayType) sind jetzt vom Typ CollectionNavType (Idcf79, b/188693139)
  • NavType bietet jetzt eine neue offene valueEquals-API, mit der ermittelt werden kann, ob zwei Werte desselben Typs gleich sind. (I6cb97, b/327229511)

Fehlerkorrekturen

  • Suchparameter in Deeplinks können jetzt Werte in Form von geschweiften Klammern um den Argumentnamen (z.B. {argName}) als gültige Werte für stringbasierte NavTypes enthalten. Dadurch wird ein Problem behoben, bei dem ein solcher Wert für alle Typen als ungültig (oder als fehlender Wert) betrachtet wurde. (I18302, b/327274038)
  • NavController-Funktionen, die Routen wie navigate oder popBackStack unterstützen, können jetzt Routen mit Argumenten des Arrays NavTypes korrekt abgleichen. (Iea805, b/327229511)

Version 2.8.0-alpha04

6. März 2024

androidx.navigation:navigation-*:2.8.0-alpha04 ist veröffentlicht. Version 2.8.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Sie können jetzt die SizeTranform für Ihre Übergänge in Navigation Compose angeben, indem Sie sie als Teil der Initialisierung für die Funktionen composable und/oder navigation definieren. (I91062, b/296912651)

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem NavHost in Compose Navigation den Übergang nicht richtig anzeigte, wenn „Zurück“ ohne Geste verwendet wurde. (Iceeae, b/325998468)

Version 2.8.0-alpha03

21. Februar 2024

androidx.navigation:navigation-*:2.8.0-alpha03 ist veröffentlicht. Version 2.8.0-alpha03 enthält diese Commits.

API-Änderungen

  • NavBackStackEntry.savedStateHandle ist jetzt als @MainThread gekennzeichnet, da Code verwendet wird, der ohnehin im Hauptthread ausgeführt werden muss. (Ibb988, b/299523245)

Fehlerkorrekturen

  • In der Navigation wurde ein Problem behoben, das dazu führte, dass NavGraph-ViewModels zu früh DESTROYED wurden, weil die ViewModel des zugehörigen Eintrags nicht Teil des gespeicherten Status war. (Ib6bb7, b/317581849)

Abhängigkeitsupdate

Version 2.8.0-alpha02

7. Februar 2024

androidx.navigation:navigation-*:2.8.0-alpha02 ist veröffentlicht. Version 2.8.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Navigation Compose unterstützt jetzt die intelligente „Zurück“-Geste in der App über die neuen SeekableTransitionState APIs von compose-animation. So können Sie mit der „Zurück“-Geste das vorherige Ziel mit Ihrem benutzerdefinierten Übergang sehen, bevor Sie sich entscheiden, die Transaktion über die abgeschlossene Geste zu bestätigen oder abzubrechen. (I8b8e9)

Version 2.8.0-alpha01

24. Januar 2024

androidx.navigation:navigation-*:2.8.0-alpha01 ist veröffentlicht. Version 2.8.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

  • Ein BackStackState-Leck wurde behoben, bei dem mehrere saveState-Aufrufe für ein Ziel dazu führten, dass mehrere Zustände gespeichert wurden, aber nur der erste wiederhergestellt werden konnte. (I598b0, b/309559751)
  • Es wurde ein Problem behoben, bei dem Argumente, die keine Strings sind, nicht richtig angezeigt wurden, wenn die NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet wurden. (#636, b/316676794)

Abhängigkeitsupdate

  • Navigation Compose hängt jetzt von Compose 1.7.0-alpha01 ab. Dadurch wurde ein Problem behoben, das zu einer unerwarteten Skalierungsanimation führen konnte. (b/297258205)

Externer Beitrag

  • Vielen Dank an SimonMarquis für die Behebung des Anzeigeproblems bei Nicht-String-Argumenten, wenn die NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet werden.

Version 2.7.7

Version 2.7.7

7. Februar 2024

androidx.navigation:navigation-*:2.7.7 ist veröffentlicht. Version 2.7.7 enthält diese Commits.

Fehlerkorrekturen

  • Backport aus Navigation 2.8.0-alpha01: Es wurde ein BackStackState-Leck behoben, bei dem mehrere saveState()-Aufrufe für eine einzelne NavBackStackEntry dazu führten, dass mehrere Zustände gespeichert wurden, aber nur der erste gespeicherte Zustand wiederhergestellt werden konnte. (I598b0, b/309559751)
  • Backport aus Navigation 2.8.0-alpha01: Es wurde ein Problem behoben, bei dem Argumente, die keine Strings sind, nicht richtig angezeigt wurden, wenn die NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet wurden. (#636, b/316676794)

Externer Beitrag

  • Vielen Dank an SimonMarquis für die Behebung des Anzeigeproblems bei Nicht-String-Argumenten, wenn die NavigationUI-Hilfsprogramme zum Ausfüllen des Titels von App-Leisten verwendet werden.

Version 2.7.6

Version 2.7.6

13. Dezember 2023

androidx.navigation:navigation-*:2.7.6 ist veröffentlicht. Version 2.7.6 enthält diese Commits.

Fehlerkorrekturen

  • Die Funktion NavGraph equals() berücksichtigt jetzt die Knoten des anderen Diagramms und nicht nur die des aufrufenden Diagramms. Dadurch wird sichergestellt, dass Graphen mit Knoten, die unterschiedliche IDs haben, nicht mehr als gleich betrachtet werden (I401cb, b/311414915).

Version 2.7.5

Version 2.7.5

1. November 2023

androidx.navigation:navigation-*:2.7.5 ist veröffentlicht. Version 2.7.5 enthält diese Commits.

Leistungsverbesserungen

  • Die Leistung (sowohl in Bezug auf die Zeit als auch auf die Anzahl der Zuweisungen) beim Vergleichen von zwei Diagrammen wurde erheblich verbessert. Das bedeutet, dass Aufrufe wie setGraph, die den neuen Graphen intern mit dem vorhandenen vergleichen, viel schneller sind und zu weniger übersprungenen Frames führen. Vielen Dank an Michał Z für die gründliche Analyse, die zu dieser Verbesserung geführt hat. (I6ad62)
  • NavHost rendert jetzt das Startziel im ersten Durchlauf der Zusammensetzung, anstatt auf den zweiten Durchlauf warten zu müssen, um den aktualisierten Status zu lesen. (I439a7, b/304852206)

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem der Back Stack entfernt wurde, wenn Sie setGraph mehrmals mit genau demselben Graphen aufgerufen haben, aber nur, wenn es im Graphen ein Ziel gab, das einen Aktionslink enthielt, der zwei Ziele verknüpfte. (Ieaed7)
  • Dialogfelder, die schnell nacheinander aufgerufen und geschlossen wurden, werden nicht mehr in die Liste der NavController.visibleEntries aufgenommen. (I67586, b/287969970)
  • Wenn ein Eintrag entfernt wird und danach eine Konfigurationsänderung erfolgt, wird der ViewModel des Eintrags jetzt ordnungsgemäß gelöscht, wenn saveState „false“ ist. (Idf242, b/298164648)
  • Es wurde ein Problem behoben, bei dem NavController denselben Deeplink mehrmals verarbeiten konnte, wenn der Back Stack vor einer Konfigurationsänderung oder einem Aufruf von setGraph vollständig leer war, aber nur, wenn für den eingehenden Intent das Flag FLAG_ACTIVITY_NEW_TASK gesetzt war. (I73c7f)

Abhängigkeitsupdates

  • Die Navigation mit Fragmenten hängt jetzt von Fragment 1.6.2 ab. Dadurch wurde ein Problem behoben, bei dem die ViewModel-Instanzen verschachtelter Fragmente beim Aufrufen von clearBackStack nicht gelöscht wurden.

Version 2.7.4

Version 2.7.4

4. Oktober 2023

androidx.navigation:navigation-*:2.7.4 ist veröffentlicht. Version 2.7.4 enthält diese Commits.

Neue Funktionen

  • Unterstützung für popUpTo hinzugefügt, um Routen mit Argumenten zu verwenden, damit zu einem bestimmten Eintrag zurückgekehrt werden kann, der genau diese Argumente verwendet. Dies entspricht der Unterstützung in popBackStack. (I731f4, b/299255572)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem das Unterbrechen einer Navigation mit einer anderen Navigation mit popUpTo zum Absturz von FragmentNavigator führte. (I3c848, b/301887045)
  • Es wurde ein Problem behoben, bei dem durch Drücken der Zurück-Taste des Systems die currentDestination nicht korrekt aktualisiert wurde, um dem angezeigten Fragment zu entsprechen. (Id0d6c, b/289877514)
  • Der Lebenszyklus von DialogFragment wechselt jetzt ordnungsgemäß in den Status RESUMED, wenn das Dialogfeld darüber geschlossen wird. (I88f0d, b/301811387)

Version 2.7.3

Version 2.7.3

20. September 2023

androidx.navigation:navigation-*:2.7.3 ist veröffentlicht. Version 2.7.3 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem in der Navigation mit Fragmenten wurde behoben, durch das die Liste visibleEntries falsche Einträge enthielt. (I5caa9, b/288520638)
  • Es wurde ein Problem behoben, durch das das Ziel des schwebenden Fensters (z. B. Dialogs, Bottomsheets usw.) nie einen RESUMED-Lebenszyklus-Callback erhalten hat. (I3b866, b/287505132)

Version 2.7.2

Version 2.7.2

6. September 2023

androidx.navigation:navigation-*:2.7.2 ist veröffentlicht. Version 2.7.2 enthält diese Commits.

Fehlerkorrekturen

  • Die Navigation hängt jetzt von Lifecycle 2.6.2 ab. Dadurch wird ein Problem bei der Interaktion zwischen rememberSaveable und NavHost von Navigation Compose behoben, das dazu führte, dass der rememberSaveable-Status von Zielen und alle zu ViewModel gehörenden SavedStateHandle-Instanzen nach einer Prozessbeendigung und Neuerstellung nicht ordnungsgemäß wiederhergestellt wurden. (b/298059596, b/289436035)
  • Es wurde ein Problem behoben, bei dem beim gleichzeitigen Anzeigen mehrerer Dialogfelder in Navigation Compose die teilweise verdeckten Dialogfelder (z.B. nicht das oberste Dialogfeld) im Lebenszyklusstatus CREATED statt im Status STARTED waren. (aosp/2728520, b/289257213)
  • Es wurde ein Problem behoben, das auftrat, wenn mehrere Dialogfelder gleichzeitig in Navigation Compose angezeigt wurden. Wenn das oberste Dialogfeld geschlossen wurde, blieb das neue oberste Dialogfeld im Lebenszyklusstatus STARTED hängen, anstatt korrekt zu RESUMED zu wechseln. (aosp/2629401, b/286371387)
  • Navigation Safe Args instanziiert seine Aufgabe nicht mehr sofort, wenn sie nicht tatsächlich ausgeführt wird. (I0e385, b/260322841)

Abhängigkeitsupdate

  • Navigation Compose hängt jetzt von Compose 1.5.1 ab.

Version 2.7.1

Version 2.7.1

23. August 2023

androidx.navigation:navigation-*:2.7.1 ist veröffentlicht. Version 2.7.1 enthält diese Commits.

Fehlerkorrekturen

  • In der Navigation mit Compose wurde ein Problem behoben, bei dem bei Verwendung eines Scaffold ein Fehler beim Zugriff auf ein Lifecycle.State.DESTROYED ViewModel auftreten konnte. (I1dc11, b/268422136)

Version 2.7.0

Version 2.7.0

9. August 2023

androidx.navigation:navigation-*:2.7.0 ist veröffentlicht. Version 2.7.0 enthält diese Commits.

Wichtige Änderungen seit Version 2.6.0

Animationen von Accompanist

Da AnimatedContent jetzt stabil ist, konnten wir den Code aus Accompanist Navigation Animation wieder in Navigation Compose verschieben.

Das bedeutet, dass die gesamte Unterstützung für das Festlegen benutzerdefinierter Übergänge, die in AnimatedNavHost vorhanden war, direkt in NavHost unterstützt wird.

An Accompanist Navigation Animation werden keine weiteren Änderungen vorgenommen und die Funktion wird bald offiziell eingestellt. Es wird dann auch eine Anleitung zur Migration zurück zu Navigation Compose geben. Diese wird der Migrationsanleitung entsprechen, nur in umgekehrter Reihenfolge. Wenn Sie bereits die neueste Accompanist-Alphaversion (0.31.2-alpha) verwenden, sind keine weiteren API-Änderungen erforderlich. (b/197140101)

Fehlerkorrekturen

  • NavHost in Navigation Compose fängt jetzt Systemaufrufe zum Zurückgehen korrekt ab, auch nachdem die Aktivität GESTOPPT und FORTGESETZT wurde. (Icb6de, b/279118447)

Abhängigkeitsupdates

  • Die Navigation hängt jetzt von Compose 1.5.0 ab, vorher von 1.1.0.

Version 2.7.0-rc01

26. Juli 2023

androidx.navigation:navigation-*:2.7.0-rc01 ist veröffentlicht. Version 2.7.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem die Lambdas EnterTransition und ExitTransition, die als Teil von NavHost erstellt wurden, möglicherweise auch nach dem Entfernen von NavHost aus der Komposition im Speicher verbleiben konnten. (I893d0)

Bekannte Probleme

  • In Navigation 2.6.x gibt es ein Problem, bei dem die Navigation mit „popUpTo“ zu einer IllegalArgumentException führen kann. Möglicherweise lässt sich diese Ausnahme vermeiden, wenn Sie Ihren Graphen umstrukturieren, ähnlich wie hier vorgeschlagen. (b/287133013)

Version 2.7.0-beta02

28. Juni 2023

androidx.navigation:navigation-*:2.7.0-beta02 ist veröffentlicht. Version 2.7.0-beta02 enthält diese Commits.

Fehlerkorrekturen

  • Navigation Compose hat jetzt die richtige Z-Reihenfolge für benutzerdefinierte Übergänge, die die Navigation mit der Option popUpTo verwenden.(/Ib1c3a, b/285153947)

Version 2.7.0-beta01

7. Juni 2023

androidx.navigation:navigation-*:2.7.0-beta01 ist veröffentlicht. Version 2.7.0-beta01 enthält diese Commits.

Fehlerkorrekturen

  • NavHost in Navigation Compose fängt jetzt Systemaufrufe zum Zurückgehen korrekt ab, auch nachdem Activity STOPPED und RESUMED wurde. (Icb6de, b/279118447)

Version 2.7.0-alpha01

24. Mai 2023

androidx.navigation:navigation-*:2.7.0-alpha01 ist veröffentlicht. Version 2.7.0-alpha01 enthält diese Commits.

Animationen von Accompanist

Da AnimatedContent jetzt stabil ist, konnten wir den Code aus Accompanist Navigation Animation wieder in Navigation Compose verschieben.

Das bedeutet, dass die gesamte Unterstützung für das Festlegen benutzerdefinierter Übergänge, die in AnimatedNavHost vorhanden war, direkt in NavHost unterstützt wird.

An Accompanist Navigation Animation werden keine weiteren Änderungen vorgenommen und die Funktion wird bald offiziell eingestellt. Es wird dann auch eine Anleitung zur Migration zurück zu Navigation Compose geben. Diese wird der Migrationsanleitung entsprechen, nur in umgekehrter Reihenfolge. Wenn Sie bereits die neueste Accompanist-Alphaversion (0.31.2-alpha) verwenden, sind keine weiteren API-Änderungen erforderlich. (b/197140101)

Fehlerkorrekturen

  • Aus Navigation 2.6.0-rc02: Es wurde ein Problem mit der Navigation in Fragmenten behoben, bei dem die Navigation mit popUpTo und das Entfernen eines Fragments aus dem Back Stack ohne Neuerstellung der Ansicht dazu führten, dass die Zurück-Funktion des Systems nicht mehr funktionierte. (Ieb8d4, b/281726455)

Abhängigkeitsupdates

  • Die Navigation hängt jetzt von Compose 1.5.0-beta01 ab.

Version 2.6.0

Version 2.6.0

7. Juni 2023

androidx.navigation:navigation-*:2.6.0 ist veröffentlicht. Version 2.6.0 enthält diese Commits.

Wichtige Änderungen an der Navigation seit Version 2.5.0

  • Die arguments von NavBackStackEntry und die an ein OnDestinationChangedListener übergebenen arguments sind jetzt nur noch eine Kopie der unveränderlichen Argumente, die beim Aufrufen des Ziels erstellt wurden. Das bedeutet, dass Änderungen an diesen Bundles bei nachfolgenden Zugriffen auf die arguments- oder andere OnDestinationChangedListener-Instanzen nicht berücksichtigt werden.
  • NavDeepLink unterstützt jetzt Standardwerte für Arrays, sodass wiederholte Abfrageparameter unterstützt werden, die dem Array-Typ des Arguments zugeordnet werden. NavType enthält jetzt auch eine Standardmethode, die überschrieben werden kann, um zwei geparste Werte zu kombinieren.
  • Benutzerdefinierte Unterklassen von NavType können jetzt serializeAsValue überschreiben, um einen Wert in einen String zu serialisieren. Dadurch können sowohl die Serialisierung als auch die Deserialisierung (über parseValue) vollständig in der Klasse NavType gekapselt werden. StringType überschreibt diese Methode jetzt, um Uri.encode für den angegebenen String aufzurufen.

Wichtige Änderungen an Navigation Compose seit Version 2.5.0

  • Wenn Sie sich eine Vorschau einer zusammensetzbaren Funktion mit NavHost ansehen, wird jetzt standardmäßig der startDestination des NavGraph angezeigt.
  • NavController.popBackStack(route), NavController.getBackStackEntry(route) und NavController.clearBackStack(route) unterstützen jetzt Routen mit teilweise oder vollständig ausgefüllten Argumenten. Die Argumente müssen genau mit den Argumenten des Eintrags übereinstimmen.
  • Wenn Sie versuchen, einen leeren NavDeepLink mit der Kotlin-DSL navDeepLink zu erstellen, wird jetzt eine Lint-Warnung angezeigt, die darauf hinweist, dass ein Deeplink einen URI, eine Aktion und/oder einen MIME-Typ benötigt, um gültig zu sein.

Wichtige Änderungen an der Navigation mit Fragmenten seit Version 2.5.0

  • NavHostFragment fängt den Button „Zurück“ des Systems nicht mehr selbst ab. Dadurch kann die zugrunde liegende FragmentManager die Systemrückgabe verarbeiten. Dadurch können Fragment 1.7.0-alpha01 und höher eine In-App-Animation für die intelligente „Zurück“-Geste auf Android U-Geräten bereitstellen.
  • Wenn Sie die Navigation mit Fragmenten verwenden und versuchen, manuell eine FragmentTransaction auszuführen, die dem Back Stack von FragmentManager ein Fragment hinzufügt, wird jetzt eine IllegalArgumentException ausgelöst. Fragmente sollten immer über die navigate() API hinzugefügt werden.
  • Wenn Sie den genauen String ${applicationId} als Platzhalter in den Attributen app:data und app:dataPattern im Aktivitätselement einer Navigations-XML-Datei verwenden, wird der Platzhalter beim Aufblähen automatisch mit dem packageName des Kontexts ausgefüllt.
  • Der FragmentNavigator verwendet jetzt die Übergangs-APIs, wenn NavBackStackEntries aufgerufen und angezeigt wird. Das bedeutet, dass der NavBackStackEntry Lifecycle jetzt wartet, bis die Spezialeffekte für das Ein- und Ausblenden des Fragments abgeschlossen sind, bevor er die endgültige Lifecycle.State verschiebt.
  • Der DialogFragmentNavigator verwendet jetzt die Übergangs-APIs, wenn NavBackStackEntries aufgerufen und angezeigt wird. Das bedeutet, dass der NavBackStackEntry Lifecycle jetzt wartet, bis der DialogFragment Lifecycle zu DESTROYED wechselt, bevor er selbst zu DESTROYED wechselt.
  • Mit NavHostFragment können Sie jetzt die NavController abrufen, sobald die NavHostFragment an die FragmentManager angehängt ist, und nicht erst nach onCreate().
  • Die Unterstützung von dynamischen Funktionsmodulen durch die Navigation hängt jetzt von der detaillierten Play Feature Delivery-Bibliothek ab.
  • Navigation Safe Args hängt jetzt von Android-Gradle-Plug-in-Version 7.3.0 ab. Das bedeutet, dass sie jetzt nur noch mit Versionen ab 7.3.0 kompatibel ist.

Wichtige Änderungen an NavigationUI seit Version 2.5.0

  • Wenn die ID eines Navigationsgraphen an AppBarConfiguration übergeben wird (z. B. über ein Menu), betrachtet NavigationUI jetzt nur das Startziel dieses Navigationsgraphen als Ziel auf oberster Ebene, anstatt fälschlicherweise jedes Ziel im Graphen als Ziel auf oberster Ebene zu markieren. Das Verhalten beim Übergeben der ID eines einzelnen Ziels bleibt unverändert. Diese Funktion ist auch für Ihren eigenen Code über die neue isTopLevelDestination-Funktion in AppBarConfiguration verfügbar.
  • Die setupWithNavController-Integrationen in NavigationUI für die Arbeit mit der oberen App-Leiste parsen jetzt R.string-Werte für ReferenceType-Argumente, die in Ihrer android:label gefunden werden, in ihre String-Werte, anstatt die automatisch generierte Ressourcen-Ganzzahl auszugeben.
  • NavigationUI stellt jetzt Logs bereit, wenn die Navigation über eine ausgewählte MenuItem fehlschlägt.

Version 2.6.0-rc02

24. Mai 2023

androidx.navigation:navigation-*:2.6.0-rc02 ist veröffentlicht. Version 2.6.0-rc02 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem mit der Navigation in Fragmenten behoben, bei dem die Navigation mit popUpTo und das Entfernen eines Fragments aus dem Back Stack ohne Neuerstellung der Ansicht dazu führten, dass die Zurück-Taste des Systems nicht mehr funktionierte. (Ieb8d4, b/281726455)

Version 2.6.0-rc01

10. Mai 2023

androidx.navigation:navigation-*:2.6.0-rc01 ist veröffentlicht. Version 2.6.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem in der Navigation mit Fragmenten behoben, bei dem das Entfernen eines Fragments über die Navigation mit popUpTo im Lebenszyklus-Callback onResume() zu einem IllegalStateException führte. (I21884, b/279644470)

Version 2.6.0-beta01

19. April 2023

androidx.navigation:navigation-*:2.6.0-beta01 ist veröffentlicht. Version 2.6.0-beta01 enthält diese Commits.

Neue Funktionen

  • NavBackStackEntry bietet jetzt eine benutzerdefinierte toString-Implementierung. (Iff00b)

Fehlerkorrekturen

  • Wenn Sie die Navigation mit Fragmenten verwenden und versuchen, manuell eine FragmentTransaction auszuführen, die dem Back Stack von FragmentManager ein Fragment hinzufügt, wird jetzt eine IllegalArgumentException ausgelöst. Fragmente sollten immer über die navigate() API hinzugefügt werden. (I6d38e)
  • Wenn es im selben Frame einen navigate gibt, der einen Eintrag hinzufügt, und einen popBackStack, der ihn entfernt, wird der resultierende oberste Eintrag im Back Stack jetzt konsistent an die RESUMED Lifecycle.State zurückgegeben. (Id8067, b/276495952)

Version 2.6.0-alpha09

5. April 2023

androidx.navigation:navigation-*:2.6.0-alpha09 ist veröffentlicht. Version 2.6.0-alpha09 enthält diese Commits.

Fehlerkorrekturen

  • Die Prüfungen auf ungültige Routen wurden korrigiert. Wenn ein NavDestination ein nicht-nullbares NavArgument enthält, muss die Route dieses Ziels Platzhalter für Argumente enthalten, die denselben Namen wie das nicht-nullbare NavArgument haben. (Ic62bf, b/274697949)
  • Deeplink-Navigationen basierend auf Action/MimeType schlagen jetzt fehl, wenn im Navigationsvorgang ein nicht nullfähiges NavArgument fehlt, das für das NavDestination erforderlich ist, mit dem das Action/MimeType übereinstimmt. (Ibfa17, b/271777424)
  • Wenn NavController ein Diagramm mit derselben Route und denselben Zielen wie das vorherige Diagramm festlegt, werden die aktuellen Diagrammknoten und die Back-Stack-Ziele jetzt ordnungsgemäß durch neue Instanzen ersetzt. Dadurch wird ein Absturz behoben, der bei der Verwendung von onLaunchSingleTop ohne Speichern des Status in Navigation Compose auftritt. Außerdem wurde ein Fehler behoben, bei dem beim Aufrufen von Zielen, die mit dem Stammgraphen verknüpft sind, ein falscher Back Stack erstellt wurde. (I5bc58, b/275258161, b/275407804)

Version 2.6.0-alpha08

22. März 2023

androidx.navigation:navigation-*:2.6.0-alpha08 ist veröffentlicht. Version 2.6.0-alpha08 enthält diese Commits.

Neue Funktionen

  • Mit NavHostFragment können Sie jetzt die NavController abrufen, sobald die NavHostFragment an die FragmentManager angehängt ist, und nicht erst nach onCreate(). (Ic6382, b/220186282)

Fehlerkorrekturen

  • Ein NullPointerException wurde behoben, der beim Aufrufen eines verschachtelten Graphen mit einem nicht nullfähigen Argument auftrat. (6b3581, b/249988437)
  • Wenn du nach der Navigation mit popUpTo die Systemfunktion „Zurück“ verwendest, wird der Status von NavController auf den richtigen Eintrag gesetzt. (I3a8ec, b/270447657)
  • FragmentNavigator entfernt jetzt Einträge ordnungsgemäß, wenn der Back Stack über die Zurück-Taste des Systems oder popBackStack() entfernt wird, und zwar unabhängig davon, ob die Transaktion Effekte für das Fragment verwendet oder nicht. (I81bdf)
  • Wenn Sie der FragmentManager von FragmentNavigator Fragmente hinzufügen, ohne die Navigation zu verwenden, führt dies nicht mehr zu einem Absturz. (b17204, b/274167493)

Abhängigkeitsupdates

Version 2.6.0-alpha07

8. März 2023

androidx.navigation:navigation-*:2.6.0-alpha07 ist veröffentlicht. Version 2.6.0-alpha07 enthält diese Commits.

Fehlerkorrekturen

  • Die API-Varianten getBackStackEntry, popBackStack und clearBackStack, die Routen akzeptieren, akzeptieren jetzt Routenmuster mit Argumenten und Abfrageparametern, die null sein können (I22294, b/269302500).
  • Ein Problem wurde behoben, bei dem durch den Aufruf von clearBackStack() über NavController der gespeicherte Status im Fragment-Manager, der mit dem gelöschten Back Stack verknüpft ist, nicht gelöscht wurde. (Ic1cce, b/271190202)
  • Es wurde eine Regression in 2.6.0-alpha06 behoben, die dazu führte, dass bei Verwendung der System-Zurück-Funktion zwischen Tabs das falsche MenuItem in der BottomNavigationView hervorgehoben wurde. (I634f6, b/270447657)
  • Es wurde eine Regression in 2.6.0-alpha06 behoben, die dazu führte, dass NavBackStackEntrys bei Verwendung von Animations nicht in den Status RESUMED verschoben wurden. (Ib3589, b/269646882)

Version 2.6.0-alpha06

22. Februar 2023

androidx.navigation:navigation-*:2.6.0-alpha06 ist veröffentlicht. Version 2.6.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Wenn Sie sich eine Vorschau einer zusammensetzbaren Funktion mit NavHost ansehen, wird jetzt standardmäßig der startDestination des NavGraph angezeigt. (I2b89f)

API-Änderungen

  • Alle NavController-navigate-Überladungen sind jetzt mit @MainThread annotiert, damit sie im Hauptthread aufgerufen werden. (I2c0b0, b/263427111)

Fehlerkorrekturen

  • Ein Absturz beim Versuch, mit der dynamischen Fragmentnavigation zu navigieren, wurde behoben. (I3ee29, b/268360479)
  • Fehler behoben, bei dem die untere Leiste nicht auf das richtige ausgewählte Element aktualisiert wurde, wenn über den Button „Zurück“ des Systems zu einem anderen Fragment navigiert wurde (If559f, b/269044426)

Bekannte Probleme

  • Wenn Sie die Navigation mit Fragmenten verwenden, erreicht der Lebenszyklus von NavBackStackEntry bei Verwendung von Animation-APIs nicht RESUMED. (b/269646882)
  • Wenn Sie die Navigation mit Fragmenten verwenden und mit BottomNavigation navigieren, wird der BottomMenuItem nicht korrekt aktualisiert, wenn Sie versuchen, einen Back Stack mit mehreren Einträgen wiederherzustellen. (b/270447657)
  • Wenn Sie die Navigation mit Fragmenten verwenden, wird nach dem Wiederherstellen des Status die NavBackStackEntry Lifecycle nicht DESTROYED, wenn das Fragment DESTROYED ist. (b/270610768)

Version 2.6.0-alpha05

8. Februar 2023

androidx.navigation:navigation-*:2.6.0-alpha05 ist veröffentlicht. Version 2.6.0-alpha05 enthält diese Commits.

Neue Funktionen

  • NavController.popBackStack(route), NavController.getBackStackEntry(route) und NavController.clearBackStack(route) unterstützen jetzt Routen mit teilweise oder vollständig ausgefüllten Argumenten. Die Argumente müssen genau mit den Argumenten des Eintrags übereinstimmen. (Iebd28, Ic678c, I3b37b, b/257514373)
  • Der FragmentNavigator verwendet jetzt die Übergangs-APIs, wenn NavBackStackEntries aufgerufen und angezeigt wird. Das bedeutet, dass der NavBackStackEntry Lifecycle jetzt wartet, bis die Spezialeffekte für das Ein- und Ausblenden des Fragments abgeschlossen sind, bevor er die endgültige Lifecycle.State verschiebt. (I3cb19, b/238686802)
  • Der DialogFragmentNavigator verwendet jetzt die Übergangs-APIs, wenn NavBackStackEntries aufgerufen und angezeigt wird. Das bedeutet, dass der NavBackStackEntry Lifecycle jetzt wartet, bis der DialogFragment Lifecycle zu DESTROYED wechselt, bevor er selbst zu DESTROYED wechselt. (I53ee5, b/261213893)

API-Änderungen

  • NavigatorState bietet jetzt die prepareForTransition API, mit der Navigators NavBackStackEntries in Zwischen-Lifecycle.States verschieben können. (I42c21, b/238686802)
  • Sie können jetzt über die Property backstack auf den Back Stack zugreifen, der mit einem NavGraphNavigator oder einem ComposeNavigator verknüpft ist. ComposeNavigator stellt jetzt auch den Callback onTransitionComplete() bereit, um einen NavBackStackEntry, der einen Navigations- oder popBackStack-Vorgang ausgeführt hat, als abgeschlossen zu markieren. (I02062, I718db, b/257519195)

Fehlerkorrekturen

  • Der Navigator-Status wird jetzt nicht mehr ausgeführt, wenn die push/popWithTransition APIs verwendet werden und der Eintrag bereits verarbeitet wird. (Iadbfa, b/261213893)
  • Wenn Sie launchSingleTop mit einem verschachtelten NavGraph verwenden, werden alle Ziele vom ursprünglichen Ziel bis zu seinem startDestination nur ordnungsgemäß oben im Backstack hinzugefügt. (Id4bea, b/253256629)
  • Die Navigation ersetzt jetzt die DialogFragment-Instanz ordnungsgemäß, wenn zum selben Ziel navigiert wird und das Flag launchSingleTop auf „true“ gesetzt ist. (I45b5a, b/149572817)
  • Navigation SafeArgs verursacht keinen Kompilierungsfehler mehr, wenn Argumente verwendet werden, die genau 19 Zeichen lang sind. (Id60bc, b/257110095)

Version 2.6.0-alpha04

9. November 2022

androidx.navigation:navigation-*:2.6.0-alpha04 ist veröffentlicht. Version 2.6.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Benutzerdefinierte Unterklassen von NavType können jetzt serializeAsValue überschreiben, um einen Wert in einen String zu serialisieren. Dadurch können sowohl die Serialisierung als auch die Deserialisierung (über parseValue) vollständig in der Klasse NavType gekapselt werden. StringType überschreibt diese Methode jetzt, um Uri.encode für den angegebenen String aufzurufen. (Ie5213, b/247637434)
  • NavigationUI stellt jetzt Logs bereit, wenn die Navigation über eine ausgewählte MenuItem fehlschlägt. (I2af5a, b/247730357)

Fehlerkorrekturen

  • Navigations-Deeplinks werden jetzt verzögert geparst, anstatt bei der Initialisierung des Graphen. Das kann die App-Leistung beim Start verbessern. (Iab0ab)
  • Ein Absturz wurde behoben, der durch das Navigieren nach oben nach dem Deeplinking zu einem Ziel mit Null-Standardargumenten verursacht wurde. (I51c24, b/243183636)

Abhängigkeitsupdate

  • Die Unterstützung von dynamischen Funktionsmodulen durch die Navigation hängt jetzt von der detaillierten Play Feature Delivery-Bibliothek ab. (Ib4ddc)
  • Navigation Safe Args hängt jetzt von Android-Gradle-Plug-in-Version 7.3.0 ab. Das bedeutet, dass sie jetzt nur noch mit Versionen ab 7.3.0 kompatibel ist. (I47e49)

Version 2.6.0-alpha03

24. Oktober 2022

androidx.navigation:navigation-*:2.6.0-alpha03 ist veröffentlicht. Version 2.6.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

  • Navigation 2.5.3: NavHost verursacht keinen NoSuchElementException mehr, wenn kein Ziel für die Erstellung des Crossfade verfügbar ist. Die Komposition wird jetzt einfach übersprungen. (Ieb46e, b/253299416)
  • Aus Navigation 2.5.3: Es wurde ein Problem behoben, bei dem gespeicherte Compose-Zustände (z.B. Verwendungen von rememberSaveable) nicht vergessen und entfernt wurden, wenn ein Ziel aus dem Back Stack entfernt wurde. (I64949)

Abhängigkeitsupdates

Version 2.6.0-alpha02

5. Oktober 2022

androidx.navigation:navigation-*:2.6.0-alpha02 ist veröffentlicht. Version 2.6.0-alpha02 enthält diese Commits.

Geändertes Verhalten

  • Wenn die ID eines Navigationsgraphen an AppBarConfiguration übergeben wird (z. B. über ein Menu), betrachtet NavigationUI jetzt nur das Startziel dieses Navigationsgraphen als Ziel auf oberster Ebene, anstatt fälschlicherweise jedes Ziel im Graphen als Ziel auf oberster Ebene zu markieren. Das Verhalten beim Übergeben der ID eines einzelnen Ziels bleibt unverändert. Diese Funktion ist auch für Ihren eigenen Code über die neue isTopLevelDestination-Funktion in AppBarConfiguration verfügbar. (Ie936e, b/238496771)

Fehlerkorrekturen

  • Die Komponente navigation:navigation-fragment hängt jetzt von der Fragment-Version 1.5.2 ab. (I00ba4)
  • Der ausgewählte Menüpunkt wird nicht mehr aktualisiert, wenn zu einem FloatingWindow-Ziel wie einem Dialogfeld navigiert wird. (I4cde8, b/240308330)

Version 2.6.0-alpha01

7. September 2022

androidx.navigation:navigation-*:2.6.0-alpha01 ist veröffentlicht. Version 2.6.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Die setupWithNavController-Integrationen in NavigationUI für die Arbeit mit der oberen App-Leiste parsen jetzt R.string-Werte für ReferenceType-Argumente, die in Ihrer android:label gefunden werden, in ihre String-Werte, anstatt die automatisch generierte Ressourcen-Ganzzahl auszugeben. (I5f803, b/167959935)
  • NavDeepLink unterstützt jetzt Standardwerte für Arrays, sodass wiederholte Abfrageparameter unterstützt werden, die dem Array-Typ des Arguments zugeordnet werden. NavType enthält jetzt auch eine Standardmethode, die überschrieben werden kann, um zwei geparste Werte zu kombinieren. (Id68c3, b/209977108)
  • Wenn Sie den genauen String ${applicationId} als Platzhalter in den Attributen app:data und app:dataPattern im Aktivitätselement einer Navigations-XML-Datei verwenden, wird der Platzhalter beim Aufblähen automatisch mit dem packageName des Kontexts ausgefüllt. (Iaabde, b/234223561)
  • Wenn Sie versuchen, einen leeren NavDeepLink mit der Kotlin-DSL navDeepLink zu erstellen, wird jetzt eine Lint-Warnung angezeigt, die darauf hinweist, dass ein Deeplink einen URI, eine Aktion und/oder einen MIME-Typ benötigt, um gültig zu sein. (I08d2f, b/154038883)

API-Änderungen

  • Neue Erweiterungsfunktion NavDestination hinzugefügt, um dynamische Labels mit Argumenten im Format android:label="{arg}" in String zu parsen. Unterstützt ReferenceType-Argumente, indem R.string-Werte in ihre Stringwerte geparst werden. (I07d89, b/236269380)

Geändertes Verhalten

  • Die arguments von NavBackStackEntry und die an ein OnDestinationChangedListener übergebenen arguments sind jetzt nur noch eine Kopie der unveränderlichen Argumente, die beim Aufrufen des Ziels erstellt wurden. Das bedeutet, dass Änderungen an diesen Bundles bei nachfolgenden Zugriffen auf die arguments- oder andere OnDestinationChangedListener-Instanzen nicht berücksichtigt werden. (I676f5)

Fehlerkorrekturen

  • Unter Navigation 2.5.2: Bei der dynamischen Navigation wird jetzt versucht, Aktivitätsziele aus anderen Modulen zu installieren, bevor dorthin navigiert wird. (Ia2c16, b/240292838)
  • Aus Navigation 2.5.2: Die Navigation ersetzt jetzt die Fragmentinstanz ordnungsgemäß, wenn zum selben Ziel navigiert und das Flag launchSingleTop auf „true“ gesetzt wird. (I5a2f1, b/237374580)
  • Aus Navigation 2.5.2: Es wurde ein IllegalStateException behoben, der durch die Navigation zu einem doppelt verschachtelten Diagramm verursacht wurde, das ein übergeordnetes Element mit einem neuen Startziel hat, das aus dem Backstack entfernt wurde. (I9f7cb, b/243778589)

Version 2.5

Version 2.5.3

24. Oktober 2022

androidx.navigation:navigation-*:2.5.3 ist veröffentlicht. Version 2.5.3 enthält diese Commits.

Fehlerkorrekturen

  • NavHost verursacht keinen NoSuchElementException mehr, wenn kein Ziel für die Erstellung des Crossfade verfügbar ist. Die Komposition wird jetzt einfach übersprungen. (Ieb46e, b/253299416)
  • Es wurde ein Problem behoben, bei dem der gespeicherte Compose-Status (z.B. Verwendungen von rememberSaveable) nicht vergessen und entfernt wurde, wenn ein Ziel aus dem Back Stack entfernt wurde. (I64949)

Version 2.5.2

7. September 2022

androidx.navigation:navigation-*:2.5.2 ist veröffentlicht. Version 2.5.2 enthält diese Commits.

Fehlerkorrekturen

  • Die dynamische Navigation versucht jetzt, Aktivitätsziele aus anderen Modulen zu installieren, bevor sie dorthin navigiert. (Ia2c16, b/240292838)
  • Die Navigation ersetzt jetzt die Fragment-Instanz ordnungsgemäß, wenn zum selben Ziel navigiert und das Flag launchSingleTop auf „true“ gesetzt wird. (I5a2f1, b/237374580)
  • IllegalStateException behoben, der durch die Navigation zu einem doppelt verschachtelten Diagramm verursacht wurde, das ein übergeordnetes Element mit einem neuen entfernten Startziel teilt. (I9f7cb, b/243778589)

Abhängigkeitsupdate

Version 2.5.1

27. Juli 2022

androidx.navigation:navigation-*:2.5.1 ist veröffentlicht. Version 2.5.1 enthält diese Commits.

Fehlerkorrekturen

  • Navigation Safe Args verursacht keine Warnungen mehr zu verworfenen Funktionen in generierten Klassen, wenn benutzerdefinierte Argumenttypen verwendet werden, die in einem Bundle gespeichert sind. (Id86ed, b/237725966)

Abhängigkeitsupdates

Version 2.5.0

29. Juni 2022

androidx.navigation:navigation-*:2.5.0 ist veröffentlicht. Version 2.5.0 enthält diese Commits.

Wichtige Änderungen seit 2.4.0

  • CreationExtras-Integration: Navigation kann jetzt über CreationExtras von Lifecycle 2.5.0 einen zustandslosen ViewModelProvider.Factory bereitstellen.

Navigation SafeArgs

  • Navigation Safe Args hat die Android Gradle Plugin-Abhängigkeit auf 7.0.4 aktualisiert. Die Kompatibilität mit AGP-Versionen vor 7.0 wurde entfernt.
  • Das build.gradle-Attribut „namespace“ wird jetzt unterstützt und kann anstelle von „applicationId“ verwendet werden.

Weitere Änderungen

  • Die visibleEntries API ist nicht mehr experimentell und bietet eine Funktion zum Abrufen aller Einträge, deren Ziel gemäß NavController derzeit sichtbar ist.

Version 2.5.0-rc02

15. Juni 2022

androidx.navigation:navigation-*:2.5.0-rc02 ist veröffentlicht. Version 2.5.0-rc02 enthält diese Commits.

Fehlerkorrekturen

  • Ein Absturz, der durch schnelles Wechseln zwischen den unteren Zielen bei Verwendung von Navigation Compose NavHost verursacht wurde, wurde behoben. (I3979a, b/234054916)
  • Navigation SafeArgs stürzt nicht mehr ab, wenn ein applicationIdSuffix und ein Namespace verwendet werden, ohne dass ein applicationId vorhanden ist, oder wenn sich applicationId und Namespace unterscheiden. (I754b1, b/233119646)
  • NavArgument hat jetzt eine benutzerdefinierte toString()-Funktion, um die internen Werte des Arguments anzuzeigen. (I900a8)

Version 2.5.0-rc01

11. Mai 2022

androidx.navigation:navigation-*:2.5.0-rc01 ist veröffentlicht. Version 2.5.0-rc01 enthält diese Commits.

Neue Funktionen

  • Es wurde eine neue Lint-Regel hinzugefügt, die davor warnt, <deeplink>-Elemente in <activity>-Elementen in der navigation.xml-Datei zu platzieren.(Ic15a5, b/178403185)

Fehlerkorrekturen

  • Komponierbare Bereiche in NavHost und DialogHost werden jetzt in der erwarteten Reihenfolge verworfen, d.h. innere komponierbare Elemente werden vor äußeren komponierbaren Elementen verworfen. (I157e6)
  • Navigation SafeArgs verwendet jetzt PathSensitivity.RELATIVE in der ArgumentsGenerationTask, um die Cache-Verschiebbarkeit zu ermöglichen. Das bedeutet, dass der Cache-Eintrag jetzt von einem CI-Build zu einem lokalen Build wiederverwendet werden kann. (I5f67c, b/173420454)
  • Die Lint-Regel UnrememberedGetBackStackEntryDetector wurde aktualisiert, um sicherzustellen, dass der Aufruf von remember, der den Aufruf von getBackStackEntry() umgibt, auch ein NavBackStackEntry-Objekt als Schlüssel übergibt.(Ib7081, b/227382831)

Version 2.5.0-beta01

20. April 2022

androidx.navigation:navigation-*:2.5.0-beta01 ist veröffentlicht. Version 2.5.0-beta01 enthält diese Commits.

Fehlerkorrekturen

  • DialogNavigator verwendet jetzt popWithTransition, wenn ein dismiss()-Aufruf ausgeführt wird. Dadurch wird eine Race-Bedingung behoben, die bei Verwendung eines ViewModel-Ziels innerhalb eines dialog-Ziels auftritt und zu einem IllegalStateException führt, wenn das Dialogfeld entweder über die Zurück-Taste des Systems oder durch Tippen außerhalb des Dialogfelds geschlossen wird. (Id7376, b/226552301)

Abhängigkeitsupdates

  • Die Navigation hängt jetzt von Lifecycle 2.5.0-beta01 ab. Dadurch wird ein IllegalStateException behoben, der auftrat, wenn ein NavHost in einem anderen NavHost in einem nicht primären Tab der unteren Navigationsleiste verschachtelt wurde, wenn mehrere Back Stacks verwendet wurden.

Version 2.5.0-alpha04

6. April 2022

androidx.navigation:navigation-*:2.5.0-alpha04 ist veröffentlicht. Version 2.5.0-alpha04 enthält diese Commits.

API-Änderungen

Fehlerkorrekturen

  • NavHost hängt jetzt von visibleEntries aus dem NavController ab, um zu bestimmen, welche Einträge zusammengestellt werden sollen. Das bedeutet, dass bei Verwendung eines verschachtelten NavHost der innere NavHost jetzt ordnungsgemäß ausgeblendet werden sollte. (I4ba2b, b/225394514)
  • Der von NavController bereitgestellte visibleEntries StateFlow basiert jetzt auf dem maximalen Lebenszyklusstatus des Eintrags und nicht mehr auf dem aktuellen Lebenszyklusstatus. Das bedeutet, dass die Liste der sichtbaren Einträge auch dann gleich bleibt, wenn der Hostlebenszyklus des navController unter STARTED fällt. (I9e2a8, b/225394514)
  • SavedStateViewFactory unterstützt jetzt die Verwendung von CreationExtras, auch wenn es mit einem SavedStateRegistryOwner initialisiert wurde. Wenn Extras angegeben sind, werden die initialisierten Argumente ignoriert. (I6c43b, b/224844583)
  • NavDeepLink kann jetzt URIs mit einem einzelnen Suchparameter ohne Wert parsen. (I0efe8, b/148905489)
  • Leere Strings werden jetzt als gültige Argumente in Deeplinks betrachtet. (I70a0d, b/217399862)
  • Navigation Safe Args stürzt nicht mehr ab, wenn Namespaces verwendet werden und kein AndroidManifest.xml vorhanden ist. (I17ccf, b/227229815)

Version 2.5.0-alpha03

23. Februar 2022

androidx.navigation:navigation-*:2.5.0-alpha03 ist veröffentlicht. Version 2.5.0-alpha03 enthält diese Commits.

API-Änderungen

  • Sie können jetzt CreationExtras an by navGraphViewModels übergeben, um ein ViewModel zu erstellen. (I29217, b/217618359)

Fehlerkorrekturen

  • NavDeepLinks unterstützt jetzt codierte Zeilenumbruchzeichen, die in Routen/Deeplink-URIs eingebettet sind. (I513d1, b/217815060)
  • CreationExtras funktioniert jetzt korrekt, wenn es mit NavBackStackEntries verwendet wird, um ViewModels zu erstellen. (I69161, b/217617710)
  • Navigation Safe Args unterstützt jetzt die Verwendung des in der build.gradle definierten Namespace anstelle des Pakets im AndroidManifest. (I659ef, b/217414933)

Version 2.5.0-alpha02

9. Februar 2022

androidx.navigation:navigation-*:2.5.0-alpha02 ist veröffentlicht. Version 2.5.0-alpha02 enthält diese Commits.

Fehlerkorrekturen

  • Aus Navigation 2.4.1: Die NavHostFragment legt jetzt die OnBackPressedDispatcher ordnungsgemäß fest, wenn die Ansichtsbindung mit verschachtelten Diagrammen verwendet wird. (Ifbb51, b/214577959)
  • Über Navigation 2.4.1: Beim Deeplinking über mehrere verschachtelte NavGraphs enthält der Back Stack jetzt auch Zwischenstartziele. (I504c0, b/214383060)

Version 2.5.0-alpha01

26. Januar 2022

androidx.navigation:navigation-*:2.5.0-alpha01 ist veröffentlicht. Version 2.5.0-alpha01 enthält diese Commits.

Neue Funktionen

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem der Zugriff auf ein ViewModel, das über by navGraphViewModels() aus dem onCreate() eines Fragments erstellt wurde, mit einem IllegalStateException fehlschlug. (I8a14d)
  • NavDeepLinks decodieren Argumente nicht mehr unnötigerweise zweimal, d. h., die richtigen Argumente werden jetzt an das endgültige Ziel übergeben. (I31b0a, b/210711399)

Safe Args

  • Safe Args hängt jetzt von der Android-Gradle-Plug-in-Version 7.0.4 ab. Das bedeutet, dass Navigation Safe Args nicht mehr mit Android Studio-Versionen vor 7.0 kompatibel ist, aber jetzt mit dem Android-Gradle-Plug-in 7.1.0 und höher kompatibel ist. (I41c88, b/213086135, b/207670704)

Version 2.4.2

Version 2.4.2

6. April 2022

androidx.navigation:navigation-*:2.4.2 ist veröffentlicht. Version 2.4.2 enthält diese Commits.

Fehlerkorrekturen

Version 2.4.1

Version 2.4.1

9. Februar 2022

androidx.navigation:navigation-*:2.4.1 ist veröffentlicht. Version 2.4.1 enthält diese Commits.

Fehlerkorrekturen

  • In NavHostFragment wird jetzt OnBackPressedDispatcher richtig festgelegt, wenn die Ansichtsbindung mit verschachtelten Graphen verwendet wird. (Ifbb51, b/214577959)
  • Beim Deeplink über mehrere verschachtelte NavGraphs enthält der Back Stack jetzt die Zwischenstartziele. (I504c0, b/214383060)
  • Backport aus Navigation 2.5.0-alpha01: Es wurde ein Problem behoben, bei dem der Zugriff auf ein über by navGraphViewModels() erstelltes ViewModel aus dem onCreate() eines Fragments mit einem IllegalStateException fehlschlug. (I8a14d)
  • Backport aus Navigation 2.5.0-alpha01: NavDeepLinks decodieren Argumente nicht mehr unnötigerweise zweimal. Das bedeutet, dass die korrekt decodierten Argumente jetzt an das endgültige Ziel übergeben werden. (I31b0a, b/210711399)
  • Backport aus Navigation 2.5.0-alpha01: Safe Args hängt jetzt von der Android-Gradle-Plug-in-Version 7.0.4 ab. Das bedeutet, dass Navigation Safe Args nicht mehr mit Android Studio-Versionen vor 7.0 kompatibel ist, aber jetzt mit dem Android-Gradle-Plug-in 7.1.0 und höher kompatibel ist. (I41c88, b/213086135, b/207670704)

Version 2.4.0

Version 2.4.0

26. Januar 2022

androidx.navigation:navigation-*:2.4.0 ist veröffentlicht. Version 2.4.0 enthält diese Commits.

Wichtige Änderungen seit Version 2.3.0

  • Alle Navigationsartefakte wurden in Kotlin neu geschrieben. Dadurch wurde die Null-Zulässigkeit von Klassen verbessert, die Generics verwenden (z. B. NavType-Unterklassen). Alle Kotlin-Erweiterungsfunktionen, die früher Teil der -ktx-Artefakte waren, wurden in die entsprechenden Hauptartefakte verschoben. Die -ktx-Artefakte werden weiterhin veröffentlicht, sind aber vollständig leer.
  • Das Artefakt navigation-fragment enthält jetzt eine vordefinierte Implementierung eines Layouts mit zwei Bereichen über die neue AbstractListDetailFragment. Dieses Fragment verwendet ein SlidingPaneLayout, um einen Listenbereich (der von Ihrer Unterklasse bereitgestellt wird) und einen Detailbereich zu verwalten, der ein NavHostFragment als Implementierung verwendet, wie in unserer Beispielimplementierung zu sehen ist.
  • Die Methode currentBackStackEntryAsFlow() für NavController stellt ein Flow bereit, das immer dann ausgegeben wird, wenn sich die aktuelle NavBackStackEntry ändert. Dieser Ablauf kann als Alternative zur manuellen Verwaltung eines OnDestinationChangedListener verwendet werden.
  • NavController bietet jetzt die Möglichkeit, über das experimentelle Attribut visibleEntries eine Liste aller sichtbaren NavBackStackEntry-Instanzen als StateFlow abzurufen.
  • Es ist jetzt möglich, die Klasse NavType zu erweitern, um benutzerdefinierte NavTypes zu erstellen. Benutzerdefinierte Typen werden nur unterstützt, wenn Sie Ihren Navigationsgraphen programmatisch erstellen, z. B. über die Kotlin-DSL für Navigationsgraphen.
  • Die Navigation bietet jetzt die APIs findStartDestination() und getHierarchy(), mit denen sich eine benutzerdefinierte NavigationUI implementieren lässt. findStartDestination() ist eine Erweiterungsfunktion für NavGraph, mit der das tatsächliche Startziel ermittelt wird, das angezeigt wird, wenn Sie zum Graphen navigieren, auch wenn startDestination selbst ein verschachteltes NavGraph ist. getHierarchy() ist eine Funktion in NavDestination, mit der Sie prüfen können, ob sich ein bestimmtes Ziel in der Hierarchie eines anderen Ziels befindet.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • NavigationUI-Methoden, die ein BottomNavigationView-Objekt akzeptiert haben, wurden so aktualisiert, dass sie stattdessen die in Material 1.4.0 eingeführte Basisklasse NavigationBarView akzeptieren. Dadurch können diese Methoden mit dem NavigationRailView verwendet werden.

  • Wenn ein <action>-Element über XML aufgebläht wird, können für Animationsattribute Attribute verwendet werden, die mit der Syntax app:enterAnim="?attr/transitionEnter" aus dem Design abgerufen werden.

  • Safe Args generiert jetzt für jede NavArgs-Klasse eine fromSavedStateHandle()-Methode. (#122, b/136967621)

    class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
      // Create a HomeDestinationArgs class with type safe accessors for each argument
      // defined on your destination
      private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle)
    }
    

Navigationsrouten und die Kotlin-DSL

In früheren Versionen der Navigation musste jedes Ziel eine konstante Ganzzahl-ID haben, die es eindeutig von seinen gleichgeordneten Zielen unterscheidet und es Ihnen ermöglicht, entweder direkt oder über eine Aktion zu diesem Ziel zu navigate(). Das ist zwar weiterhin gültig und nützlich, insbesondere wenn Sie Ihren Navigationsgraphen in XML definieren und automatisch generierte R.id-Konstanten oder Safe Args verwenden können (die diese Konstanten verwenden, um Code zur Build-Zeit zu generieren). Dieses System eindeutiger Ganzzahlen erfasste jedoch nicht die semantische Bedeutung und Ausdruckskraft, die erforderlich sind, um vollständig dynamische Graphen zu unterstützen, die zur Laufzeit programmatisch über die Navigation Kotlin DSL erstellt werden.

Mit diesem Release wird eine neue Option eingeführt, mit der ein Ziel in einem Navigationsgraphen anhand seiner Route eindeutig identifiziert werden kann. Eine Route ist ein String, der den eindeutigen Pfad zu einem Ziel definiert. Alle Kotlin DSL-Methoden, die eine Ziel-ID akzeptiert haben, wurden eingestellt und durch eine entsprechende API ersetzt, die eine Route akzeptiert.

Jede Route sollte als „Pfad“-Teil eines Uri behandelt werden, der dieses Ziel definiert, z.B. home, profile/{userId}, profile/{userId}/friends usw. Wenn die Identität eines Ziels mit einem bestimmten Inhalt verknüpft ist, sollten diese dynamischen Argumente Teil der Route sein und denselben Regeln wie implizite Deeplinks folgen.

Alle NavController-APIs, die bisher nur eine ID akzeptiert haben, haben jetzt eine Überladung, die eine Route String akzeptiert. Dazu gehören navigate(), popBackStack(), popUpTo() und getBackStackEntry().

Dies hatte einige Auswirkungen auf die API:

  • Das Kotlin-Attribut popUpTo in der Kotlin-DSL wurde zugunsten von popUpToId eingestellt.
  • Die getStartDestination() API wurde zugunsten von getStartDestinationId() eingestellt.

Im Gegensatz zur Navigation nach ID gelten für die Navigation nach Route dieselben Regeln wie für implizite Deeplinks. Sie können direkt zu jedem Ziel in jedem verschachtelten Graphen navigieren. So können diese Routen in Projekten mit mehreren Modulen verwendet werden, ohne dass jedem Ziel explizit ein extern sichtbarer Deeplink hinzugefügt werden muss.

Navigation Compose

Das Artefakt navigation-compose ermöglicht die Integration der Navigationskomponente in Jetpack Compose. Dabei werden @Composable-Funktionen als Ziele in Ihrer Anwendung verwendet.

Diese Version bietet:

  • Eine NavHost komponierbare Funktion, mit der Sie Ihren Navigationsgraphen über eine Kotlin-DSL mit composable- und dialog-Zielen erstellen können. Außerdem werden optionale Navigatoren wie die von Accompanist Navigation Material unterstützt.
  • Obligatorische Unterstützung für Überblendungen zwischen Zielen. Mit Accompanist Navigation Animation können Sie die Ein- und Ausstiegsübergänge mithilfe experimenteller Compose APIs steuern.
  • Festlegung des Bereichs eines Lifecycle für jedes zusammensetzbare Ziel. Jedes Ziel erreicht den Status RESUMED nur, wenn alle eingehenden Übergänge abgeschlossen sind, und wechselt sofort zu STARTED, wenn ausgehende Übergänge beginnen. So können Sie alle IllegalStateException- und Multi-Touch-Probleme vermeiden, indem Sie einen navigate-Aufruf nur dann auslösen, wenn der Lifecycle RESUMED ist.
  • Bereichseingrenzung von ViewModel (über die viewModel() API von Lifecycle ViewModel Compose 2.4.0 oder hiltViewModel() von Hilt Navigation Compose 1.0.0 auf Zielebene, um einen Bereich bereitzustellen, der Konfigurationsänderungen übersteht und im Back Stack bleibt (wenn der Composable-Inhalt ansonsten verworfen wird), und ein Signal in der onCleared() des ViewModels, das das dauerhafte Verwerfen und Bereinigen des mit diesem NavBackStackEntry verknüpften Zustands anzeigt.
  • Festlegung des Bereichs des rememberSaveable-Zustands auf Zielebene, sodass der gesamte zusammensetzbare Zustand automatisch gespeichert und wiederhergestellt wird, wenn Sie zu einem Ziel zurückkehren.
  • Vollständige Unterstützung für das Speichern und Wiederherstellen des Status von NavController und des Status des Ziels nach Prozessbeendigung und Neuerstellung.
  • Automatische Integration mit dem Button „Zurück“ des Systems.
  • Unterstützung für die Übergabe von Argumenten, das Anhängen von Deeplinks an Ziele und die Rückgabe eines Ergebnisses an vorherige Ziele.

  • Spezifische Hilfsprogramme in rememberNavController() und currentBackStackEntryAsState() erstellen, um das Hochstufen des Status und das Verbinden des NavController mit Composables außerhalb des NavHost (z. B. einer unteren Navigationsleiste) zu ermöglichen.

val navController = rememberNavController()
Scaffold { innerPadding ->
    NavHost(navController, "home", Modifier.padding(innerPadding)) {
        composable("home") {
            // This content fills the area provided to the NavHost
            HomeScreen()
        }
        dialog("detail_dialog") {
            // This content will be automatically added to a Dialog() composable
            // and appear above the HomeScreen or other composable destinations
            DetailDialogContent()
        }
    }
}

Weitere Informationen finden Sie im Leitfaden zur Navigation mit Compose.

Mehrere Back Stacks

Der NavController ist für die Verwaltung des Back Stacks von Zielen verantwortlich. Er fügt dem Back Stack Ziele hinzu, wenn du zu ihnen navigate(), und entfernt sie, wenn du popBackStack() aufrufst oder den Zurück-Button des Systems auslöst. Die vorhandene Klasse NavOptions und die Einbindung in <action>-Elemente in der XML-Datei des Navigationsgraphen wurden erweitert, um das Speichern und Wiederherstellen des Backstacks zu unterstützen.

Im Rahmen dieser Änderung speichern und stellen die NavigationUI-Methoden von onNavDestinationSelected(), BottomNavigationView.setupWithNavController() und NavigationView.setupWithNavController() jetzt automatisch den Status von entfernten Zielen wieder her. Dadurch werden mehrere Back Stacks ohne Codeänderungen unterstützt. Wenn Sie die Navigation mit Fragmenten verwenden, ist dies die empfohlene Methode für die Einbindung mehrerer Back Stacks.

Die zugrunde liegenden APIs zum Speichern und Wiederherstellen des Status werden über eine Reihe von Oberflächen bereitgestellt:

  • In der Navigations-XML kann das Element <action> jetzt die booleschen Attribute app:popUpToSaveState und app:restoreState verwenden, um den Status aller über app:popUpTo entfernten Ziele zu speichern und den Status des als app:destination übergebenen Ziels wiederherzustellen:

    <action
      android:id=”@+id/swap_stack”
      app:destination=”@id/second_stack”
      app:restoreState=”true”
      app:popUpTo=”@id/first_stack_start_destination”
      app:popUpToSaveState=”true” />
    
  • In der navOptions Kotlin DSL können Sie die boolesche Property restoreState und die boolesche Property saveState im popUpTo-Builder hinzufügen:

    // Use the navigate() method that takes a navOptions DSL Builder
    navController.navigate(selectedBottomNavRoute) {
      launchSingleTop = true
      restoreState = true
      popUpTo(navController.graph.findStartDestination().id) {
        saveState = true
      }
    }
    
  • Wenn Sie ein NavOptions-Objekt manuell über die NavOptions.Builder erstellen, können Sie die setRestoreState() und die neue Überladung für setPopUpTo() verwenden, die einen zusätzlichen saveState-Parameter akzeptiert.

    NavOptions navOptions = new NavOptions.Builder()
      .setLaunchSingleTop(true)
      .setRestoreState(true)
      .setPopUpTo(NavGraph.findStartDestination(navController.getGraph()).getId(),
        false, // inclusive
        true) // saveState
      .build();
    navController.navigate(selectedBottomNavId, null, navOptions);
    
  • Programmatische Aufrufe von popBackStack() können jetzt einen zusätzlichen saveState-Parameter enthalten.

  • Mit der Methode clearBackStack() können Sie alle Status löschen, die mit popBackStack() oder popUpToSaveState gespeichert wurden.

In allen Fällen speichert und stellt der NavController den Status jedes NavBackStackEntry wieder her, einschließlich aller ViewModel-Instanzen, die auf das Navigationsziel beschränkt sind. Die Navigator-APIs wurden aktualisiert, damit jede Navigator das Speichern und Wiederherstellen des eigenen Status unterstützt.

Verhaltensänderungen

  • NavDeepLinkBuilder fügt jetzt PendingIntent.FLAG_IMMUTABLE zu PendingIntent hinzu, das von createPendingIntent() zurückgegeben wird. Dadurch wird sichergestellt, dass diese API wie erwartet funktioniert, wenn sie auf Android 12 ausgerichtet ist.
  • Die Navigation hängt jetzt von Lifecycle 2.3.1 ab und markiert jetzt setGraph(), popBackStack(), navigateUp() und navigate(), die Methoden, die den NavBackStackEntry Lifecycle aktualisieren, als @MainThread. Dadurch wird die Navigation an die in Lifecycle 2.3.0 eingeführte Erzwingung des Hauptthreads angepasst.
  • Bei Deeplinks wird jetzt geprüft, ob alle erforderlichen Argumente (die ohne Standardwerte) im Uri vorhanden sind.
  • Bei geparsten NavDeepLink-Argumenten werden Rautenzeichen jetzt wie Fragezeichen als Trennzeichen zwischen Pfadsegmenten behandelt. Dadurch wird verhindert, dass sich ein Argument über das Rautenzeichen erstreckt.
  • Beim Generieren von Aktionen werden Argumente ohne Standardwerte im von Safe Args generierten Kotlin-Code jetzt vor Argumenten mit Standardwerten als Parameter platziert.
  • Beim Generieren von Argumenten platziert Safe Args jetzt Parameter ohne Standardwerte vor Parametern mit Standardwerten.
  • Safe-Args hängt jetzt vom Android-Gradle-Plug-in 4.2.0 ab. Die Warnung, dass applicationIdTextResource verwendet wird, sollte jetzt nicht mehr angezeigt werden.

Bekannte Probleme

  • In Navigation 2.5.0-alpha01 behoben: Der Zugriff auf ein ViewModel, das über by navGraphViewModels() aus dem onCreate() eines Fragments erstellt wurde, schlägt mit einem IllegalStateException fehl. (b/213504272)
  • In Navigation 2.5.0-alpha01 behoben: Safe Args 2.4.0 ist nicht mit dem Android-Gradle-Plug-in 7.1.0 und höher kompatibel. (b/213086135)
  • Beim Deeplinking mit mehreren verschachtelten Navigationsgraphen wird der vollständige Backstack nicht korrekt erstellt. (b/214383060)

Version 2.4.0-rc01

15. Dezember 2021

androidx.navigation:navigation-*:2.4.0-rc01 ist veröffentlicht. Version 2.4.0-rc01 enthält diese Commits.

Verhaltensänderungen

  • Bei geparsten NavDeepLink-Argumenten werden Rautenzeichen jetzt wie Fragezeichen als Trennzeichen zwischen Argumenten behandelt. (I21309, b/180042703)

Fehlerkorrekturen

  • Deeplinks ignorieren keine Argumente mehr, deren Werte mit dem Namen des Platzhalters übereinstimmen. (If8017, b/207389470)
  • NavController stürzt nicht mehr ab, wenn ein verschachteltes Ziel mit Übergängen nach der Wiederherstellung von NavController entfernt wird. (I0f7c9, b/205021623)
  • Die Fehlermeldung bei Verwendung eines ungültigen startDestination wird jetzt standardmäßig auf die Route des Startziels gesetzt, sofern eine verfügbar ist. (I86b9d, b/208041894)

Fehlerkorrekturen für Navigation Compose

  • Ein potenzieller Absturz wurde behoben, der durch schnelles Wechseln zwischen dem Startziel und einem anderen Ziel über die Elemente im unteren Navigationsmenü verursacht wurde. (Ic8976, b/208887901)
  • Dialogziele werden jetzt nach Konfigurationsänderungen oder Prozessbeendigung ordnungsgemäß oben auf dem Bildschirm wiederhergestellt. (I4c0dc, b/207386169)
  • Es wurde ein Problem behoben, bei dem der Versuch, einen ViewModel aus dem NavBackStackEntry eines Dialogfelds abzurufen, fehlschlug, wenn das Dialogfeld geschlossen wurde. (I6b96d, b/206465487)
  • Es wurde ein Problem behoben, bei dem die Verwendung von activity-Zielen mit NavHost von Navigation Compose zu unendlichen Neuzusammensetzungen führte. (I8f64c)
  • Es wurde ein Leck in Navigation Compose behoben, bei dem nach einer Konfigurationsänderung oder Prozessbeendigung ein Verweis auf die alte Aktivität beibehalten wurde. (I4efcb, b/204905432)

Safe Args-Fehlerkorrekturen

  • SafeArgs stürzt nicht mehr ab, wenn versucht wird, benutzerdefinierte Parcelable-Arrays nach einer Prozessbeendigung wiederherzustellen. (I618e8, b/207315994)
  • Ein Fehler in Safe Args wurde behoben, der verhinderte, dass boolesche Arrays den Wert null haben. (I8c396, b/174787525)

Version 2.4.0-beta02

3. November 2021

androidx.navigation:navigation-*:2.4.0-beta02 ist veröffentlicht. Version 2.4.0-beta02 enthält diese Commits.

API-Änderungen

  • Bei der Verarbeitung von expliziten und impliziten Deeplinks wird jetzt automatisch das Flag saveState hinzugefügt, wenn zu einem anderen Graphen navigiert wird. Dadurch wird sichergestellt, dass Code wie NavigationUI.setupWithNavController und Code, der mehrere Back Stacks verwendet, wie erwartet funktioniert. (Ic8807)

Geändertes Verhalten

  • Deeplink-Muster werden jetzt in NavDeepLink verzögert kompiliert, anstatt während der Inflation. Dadurch sollte sich die Inflationszeit von Navigationsgraphen mit Deeplinks verbessern. (b8d257, b/184149935)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem NavBackStackEntries nach dem Wechsel zu Lifecycle.State.STARTED auf Lifecycle.State.CREATED verschoben wurden, wenn die NavHost direkt der setContent() der Aktivität hinzugefügt wurde. (Ia5ac1, b/203536683)
  • Es wurde eine Race-Bedingung behoben, bei der das Entfernen eines DialogFragment-Ziels aus dem Back Stack vor dem eigentlichen Anzeigen des Dialogfelds das Dialogfeld nicht wirklich schloss. Dies führte zu einem Absturz, wenn das fehlerhafte Dialogfeld vom Nutzer manuell geschlossen wurde. (I687e5)
  • Es wurde ein Problem behoben, bei dem die onNavDestinationSelected API auf NavigationUI den Wert true zurückgegeben hat, auch wenn Sie nicht tatsächlich navigate() zu diesem Navigationsgraphen ausgeführt haben. Es wird jetzt dieselbe Logik verwendet, die intern von setupWithNavController verwendet wird, um nur die MenuItem auszuwählen, die dem aktuellen Ziel mit der hierarchy des Ziels zugeordnet sind. (I2b053)

Version 2.4.0-beta01

27. Oktober 2021

androidx.navigation:navigation-*:2.4.0-beta01 ist veröffentlicht. Version 2.4.0-beta01 enthält diese Commits.

Neue Funktionen

  • Sie können jetzt by navGraphViewModel mit einer Route anstelle einer ID verwenden, um die Navigation Kotlin DSL mit Fragmenten besser zu unterstützen. (I901e3, b/201446416)

API-Änderungen

  • Die visibleEntries API ist jetzt experimentell. (I93f6f)

Fehlerkorrekturen

  • ViewModels werden nicht mehr gelöscht, wenn Übergänge durch Hin- und Herwechseln zwischen denselben Bildschirmen unterbrochen werden (Id52d8, b/200817333).
  • Für Nullable-NavDeepLink-Argumente ist kein Standardwert mehr erforderlich, wenn Deeplinks zu NavDestinations hinzugefügt werden. (I5aad4, b/201320030)
  • NavBackStackEntries mit unterschiedlichen Lebenszyklen werden nicht mehr als gleich betrachtet. Das bedeutet, dass NavHost alle Ziele ordnungsgemäß neu zusammensetzt, wenn die Navigation mit „singleTop“ erfolgt und wenn Elemente im unteren Menü neu ausgewählt werden. (I1b351, b/196997433)
  • Es wurde ein Problem mit AbstractListDetailFragment behoben, das dazu führte, dass die Attribute layout_width und layout_weight im von onCreateListPaneView() zurückgegebenen Listenbereich falsch verarbeitet oder ignoriert wurden. (f5fbf3)
  • Der visuelle Status von Dialogzielen bleibt jetzt korrekt mit dem Status des DialogFragmentNavigator synchronisiert. Das bedeutet, dass durch den manuellen Aufruf der asynchronen dismiss() API für DialogFragment jetzt alle Dialogziele über dem geschlossenen Dialogfeld ordnungsgemäß gelöscht werden. Dies hat keine Auswirkungen auf Fälle, in denen Sie popUpTo oder popBackStack() verwenden, um das Dialogfeld zu schließen. (I77ba2)
  • AbstractAppBarOnDestinationChangedListener hat jetzt klarere Fehlermeldungen für onDestinationChanged(). (Ie742d)

Version 2.4.0-alpha10

29. September 2021

androidx.navigation:navigation-*:2.4.0-alpha10 ist veröffentlicht. Version 2.4.0-alpha10 enthält diese Commits.

Neue Funktionen

  • NavController bietet jetzt die Möglichkeit, eine Liste aller sichtbaren NavBackStackEntry-Instanzen über den visibleEntries-StateFlow abzurufen (Ia964e).
  • rememberNavController() akzeptiert jetzt eine optionale Gruppe von Navigator-Instanzen, die dem zurückgegebenen NavController hinzugefügt werden, um optionale Navigatoren wie die von Accompanist Navigation Material besser zu unterstützen. (I4619e)

Fehlerkorrekturen

  • Die dynamische Navigation stürzt nicht mehr ab, wenn die Aktivität neu erstellt wird. (Ifa6a3, b/197942869)
  • Es wurde ein Problem mit dem Button „Zurück“ des Systems behoben, das nur auftritt, wenn zu einem zusammensetzbaren Ziel zurückgekehrt wird, das ein NavHost enthält. (3ed148, b/195668143)
  • SafeArgs generiert jetzt die Argumente für fromBundle() und fromSavedStateHandle() in der richtigen Parameterreihenfolge. (I824a8, b/200059831)

Version 2.4.0-alpha09

15. September 2021

androidx.navigation:navigation-*:2.4.0-alpha09 ist veröffentlicht. Version 2.4.0-alpha09 enthält diese Commits.

Neue Funktionen

  • Sie können jetzt die Methode clearBackStack() verwenden, um alle mit popBackStack() oder popUpToSaveState gespeicherten Status zu löschen. (I80a0f)
  • Sie können jetzt eine Liste von Argumenten und/oder Deeplinks an den Builder des verschachtelten Navigationsgraphen übergeben. Diese werden dann automatisch dem resultierenden Graphen hinzugefügt. (I8a470, b/182545357)

API-Änderungen

  • Die Kotlin DSL-Funktion navArgument ist jetzt Teil von navigation-common statt navigation-compose. Dazu müssen Importe aktualisiert werden, um diese Funktion weiterhin verwenden zu können. (I1d095)

Geändertes Verhalten

  • Beim Generieren von Argumenten platziert Safe Args jetzt Parameter ohne Standardwerte vor Parametern mit Standardwerten. (I89709, b/198493585)

Fehlerkorrekturen

  • Bei Verwendung von Navigation Compose werden NavGraphs erst dann DESTROYED, wenn alle ihre untergeordneten Elemente DESTROYED sind. (I86552, b/198741720)
  • Für Nullable-NavDeepLink-Argumente ist kein Standardwert mehr erforderlich. (Ia14ef, b/198689811)
  • Wenn Sie setGraph() mit einem neuen Graphen aufrufen, werden jetzt zusätzlich zum bisherigen Verhalten, bei dem der Back Stack entfernt wurde, auch alle gespeicherten Back Stacks gelöscht. (I97f96)
  • Ein Problem wurde behoben, bei dem OnDestinationChangedListener-Instanzen und der currentBackStackEntryFlow bei Verwendung von launchSingleTop nicht benachrichtigt wurden. (Iaaebc)

Abhängigkeitsupdates

Version 2.4.0-alpha08

1. September 2021

androidx.navigation:navigation-*:2.4.0-alpha08 ist veröffentlicht. Version 2.4.0-alpha08 enthält diese Commits.

Neue Funktionen

  • Es ist jetzt möglich, die Klasse NavType zu erweitern, um benutzerdefinierte NavTypes zu erstellen. Benutzerdefinierte Typen werden nur unterstützt, wenn Sie Ihren Navigationsgraphen programmatisch erstellen, z. B. über die Kotlin-DSL für Navigationsgraphen. (I78440, b/196871885)

Geändertes Verhalten

  • Beim Generieren von Aktionen werden Argumente ohne Standardwerte im von Safe Args generierten Kotlin-Code jetzt vor Argumenten mit Standardwerten als Parameter platziert. (Idb697, b/188855904)
  • Bei Deeplinks wird jetzt geprüft, ob alle erforderlichen Argumente (die ohne Standardwerte) im Uri vorhanden sind. (#204, b/185527157)

Fehlerkorrekturen

  • Wenn Sie getBackStackEntry und previousBackStackEntry in composable() in Verbindung mit remember() verwenden, wird keine Ausnahme mehr ausgelöst, weil kein Ziel im Back Stack vorhanden ist. (I75138, b/194313238)
  • Navigation Compose wird jetzt ordnungsgemäß neu zusammengesetzt, wenn Back-Stack-Argumente geändert und launchSingleTop=true verwendet wird. (Iebd69, b/186392337)
  • Beim Aufruf von setGraph mit einem Graphen mit 13 oder 29 Zielen wird kein ArrayIndexOutOfBoundsException mehr zurückgegeben. (I1a9f1, b/195171984)
  • Der SafeArgs-Java-Generator sollte beim Generieren von Args-Klassen keine Lint-Warnungen mehr verursachen. (I1a666, b/185843837)

Externer Beitrag

  • Vielen Dank an ospixd, der dafür gesorgt hat, dass bei Deeplinks geprüft wird, ob alle erforderlichen Argumente (die ohne Standardwerte) im Uri vorhanden sind. (#204, b/185527157)

Version 2.4.0-alpha07

18. August 2021

androidx.navigation:navigation-*:2.4.0-alpha07 ist veröffentlicht. Version 2.4.0-alpha07 enthält diese Commits.

Fehlerkorrekturen

  • Navigation Compose speichert den Status jetzt nach Konfigurationsänderungen und beim Ändern von Graphen, wenn die Funktion für mehrere Back Stacks verwendet wird. (If5a3d, b/195141957)
  • Wenn Sie denselben Tab noch einmal auswählen, während Sie Navigation Compose mit mehreren Back Stacks verwenden, wird kein leerer Bildschirm mehr angezeigt. (I860dc, b/194925622)
  • NavHost beobachtet jetzt Änderungen im Lifecycle.State von NavBackStackEntrys. Das bedeutet, dass die Verwendung eines NavHost in einem Fragment jetzt bei Änderungen des Lebenszyklus ordnungsgemäß neu zusammengesetzt wird, anstatt einen leeren Bildschirm anzuzeigen. (I4eb85, b/195864489)
  • Es wurde ein Problem behoben, bei dem das Schließen eines DialogFragment den Status des NavController nach dem Neuerstellen der Aktivität (z.B. nach einer Konfigurationsänderung) nicht korrekt aktualisiert hat. (Icd72b)
  • Ein Problem wurde behoben, bei dem das Schließen eines Dialogfeldziels die Verarbeitung des System-Buttons „Zurück“ durch den NavController nicht aktualisierte. Dies konnte dazu führen, dass der NavController den Button „Zurück“ abfing, obwohl er keinen Back Stack zum Schließen hatte. (If3b34)
  • Safe-args generiert jetzt automatisch eine toSavedStateHandle-Methode für Argumente, mit der Sie Ihren ViewModel-Code testen können. (If1e2d, b/193353880)

Version 2.4.0-alpha06

4. August 2021

androidx.navigation:navigation-*:2.4.0-alpha06 ist veröffentlicht. Version 2.4.0-alpha06 enthält diese Commits.

API-Änderungen

  • Die Methoden requireSlidingPaneLayout() und requireDetailPaneNavHostFragment() für AbstractListDetailFragment wurden in getSlidingPaneLayout() bzw. getDetailPaneNavHostFragment() umbenannt. (I34a08)

Geändertes Verhalten

  • Bei der Navigation mit Animationen (z. B. Crossfade) erreicht die Lifecycle des neuen Ziels jetzt erst dann den RESUMED, wenn die Animation abgeschlossen ist. (If0543, b/172112072, b/194301889)
  • In Navigation Compose wird der Graph jetzt von NavHost als Teil der ersten Komposition festgelegt. (Ieb7be)

Fehlerkorrekturen

  • Wenn das letzte Ziel eines Navigationsgraphen entfernt wird, wird kein ClassCastException mehr ausgelöst. (If0543, b/172112072, b/194301889)
  • Es wurde ein NullPointerException behoben, der auftrat, wenn ein Deeplink ohne Uri hinzugefügt und über eine Route oder einen Deeplink navigiert wurde. (938a0c, b/193805425)
  • Ein Problem in Navigation Compose wurde behoben, bei dem ein Deeplink-NavBackStackEntry den Status RESUMED nicht erreichte. (I192c5)
  • Es wurde ein Problem behoben, bei dem das Schließen eines Dialogziels die Verarbeitung des System-Buttons „Zurück“ durch den NavController nicht aktualisierte. Dies konnte dazu führen, dass der NavController den Button „Zurück“ abfing, obwohl kein Back Stack zum Schließen vorhanden war. (aosp/1782668)

Version 2.4.0-alpha05

21. Juli 2021

androidx.navigation:navigation-*:2.4.0-alpha05 ist veröffentlicht. Version 2.4.0-alpha05 enthält diese Commits.

Geändertes Verhalten

  • NavHost von Navigation Compose verwendet jetzt immer Überblendungen, wenn zwischen Zielen navigiert wird. (I07049, b/172112072)
  • Sie können jetzt Änderungen am Graphen eines NavHost vornehmen. Graphen mit demselben „startDestination“ und denselben Zielen im Graphen werden als gleich betrachtet und der Back Stack NavController wird nicht gelöscht. (I0b8db, b/175392262)

Fehlerkorrekturen

  • Ein NoSuchElementException beim Aufrufen von popBackStack() innerhalb eines LifecycleObserver, das an ein NavBackStackEntry angehängt ist, wurde behoben. Dieser Fehler wurde durch wiedereintretende Aktualisierungen des Status des NavControllers verursacht. (I64621)
  • AbstractListDetailFragment ermöglicht jetzt, dass SlidingPaneLayout vollständig aus deinem APK entfernt wird, wenn AbstractListDetailFragment nicht verwendet wird. (I611ad)
  • NavGraph und NavDestination überschreiben jetzt die equals-Methode, sodass zwei Objekte mit denselben Werten als gleich betrachtet werden. (I166eb, b/175392262)

Version 2.4.0-alpha04

1. Juli 2021

androidx.navigation:navigation-*:2.4.0-alpha04 ist veröffentlicht. Version 2.4.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Das Artefakt navigation-fragment enthält jetzt eine vordefinierte Implementierung eines Layouts mit zwei Bereichen über die neue AbstractListDetailFragment. Dieses Fragment verwendet ein SlidingPaneLayout, um einen Listenbereich (der von Ihrer Unterklasse bereitgestellt wird) und einen Detailbereich zu verwalten, der ein NavHostFragment als Implementierung verwendet, wie in unserer Beispielimplementierung zu sehen ist. (Iac4be, b/191276636)
  • Der NavHost des Artefakts navigation-compose unterstützt jetzt neben composable-Zielen auch dialog-Ziele. Diese Dialogziele werden jeweils in einem Composable Dialog angezeigt, das über dem aktuellen composable-Ziel schwebt. (I011d0)
val navController = rememberNavController()
    Scaffold { innerPadding ->
        NavHost(navController, "home", Modifier.padding(innerPadding)) {
            composable("home") {
                // This content fills the area provided to the NavHost
                HomeScreen()
            }
            dialog("detail_dialog") {
                // This content will be automatically added to a Dialog() composable
                // and appear above the HomeScreen or other composable destinations
                DetailDialogContent()
            }
        }
    }

API-Änderungen

  • Die Funktion add in NavigatorState wurde in push umbenannt. Alle aktuellen Aufrufe von add() müssen in push() geändert werden. (Ie89fc, b/172112072)
  • Benutzerdefinierte Navigator-Instanzen können jetzt die APIs pushWithTransaction und popWithTransition auf NavigatorState verwenden, um ein Ziel asynchron zu pushen oder zu poppen. Diese APIs werden noch von keinem der enthaltenen Navigatoren verwendet. (Ic4d7c, b/172112072)

Geändertes Verhalten

  • NavDeepLinkBuilder fügt jetzt PendingIntent.FLAG_IMMUTABLE zu PendingIntent hinzu, das von createPendingIntent() zurückgegeben wird. Dadurch wird sichergestellt, dass diese API wie erwartet funktioniert, wenn sie auf Android 12 ausgerichtet ist. (If8c52)

Fehlerkorrekturen

  • Es wurde ein Problem mit <include-dynamic> behoben, bei dem an den Graphen übergebene Argumente nicht korrekt an den dynamisch eingebundenen Graphen übergeben wurden. (I3e115)
  • Ein NullPointerException wurde behoben, der auftrat, wenn zu einem Ziel mit einem string[]-Argument mit dem Standardwert @null navigiert wurde. (I1fbe8)
  • ProGuard-Regeln für @Navigator.Name hinzugefügt, um Probleme bei der Verwendung des R8 3.1-Vollmodus zu beheben. (I2add9, b/191654433)
  • SafeArgs schlägt nicht mehr fehl, wenn Sie Ihre App mit Kotlin-Versionen vor 1.5.0 erstellen. (Icd1ff, b/190739257)

Version 2.4.0-alpha03

16. Juni 2021

androidx.navigation:navigation-*:2.4.0-alpha03 ist veröffentlicht. Version 2.4.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem zwei navigate()-Aufrufe erforderlich waren, um zu einem enthaltenen dynamischen Graphen zu navigieren. (I7785c, b/188859835)
  • Eine Regression, die in Navigation 2.4.0-alpha01 eingeführt wurde, wurde behoben. Dabei wurde das Aufwärtssymbol von setupActionBarWithNavController() nicht ordnungsgemäß entfernt, wenn Sie sich auf einem Ziel der obersten Ebene befanden. (I5d443, b/189868637)
  • Ein IllegalStateException beim Aufrufen von popBackStack() nach dem vorherigen Entfernen des Root-Diagramms des NavController wurde behoben. (I2a330, b/190265699)
  • ProGuard-Regeln für by navArgs() werden jetzt ordnungsgemäß angewendet, wenn navigation-common oder davon abhängige Artefakte verwendet werden. (I68800, b/190082521)
  • Eine OnDestinationChangedListener, die beim ersten Empfang eines Callbacks navigate() aufruft, erhält jetzt ordnungsgemäß einen zweiten Callback mit dem Ziel, zu dem sie navigiert ist. (Ie5f9e, b/190228815)
  • Safe Args stürzt nicht mehr ab, wenn es mit dynamischen Funktionsmodulen und AGP 7.0 oder höher verwendet wird. (I69518, b/189966576)

Bekanntes Problem

  • Safe Args schlägt bei Verwendung von Gradle 6.7.0 aufgrund einer Abhängigkeit von einer älteren Kotlin-Version mit dem Fehler Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’ fehl. Dies kann durch ein Update auf Gradle 7.0 umgangen werden. (b/190739257)

Version 2.4.0-alpha02

2. Juni 2021

androidx.navigation:navigation-*:2.4.0-alpha02 ist veröffentlicht. Version 2.4.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Routen werden jetzt für Aktivitäts-, Fragment- und Dialogziele sowie in der gesamten DynamicNavigation Kotlin DSL unterstützt. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
  • NavigationUI hat vorübergehend experimentelle APIs hinzugefügt, mit denen Sie das Speichern Ihres Status deaktivieren können. Das Speichern des Status ist zwar das richtige Verhalten, es gibt jedoch immer noch veraltete Bibliotheken (z. B. beibehaltene Fragmente), die beim Speichern des Status nicht unterstützt werden können. So haben Apps die Möglichkeit, langsam von nicht unterstützten APIs wegzukommen. (Idf93c)
  • Die Navigation bietet jetzt die APIs findDestination() und getHierarchy(), mit denen sich eine benutzerdefinierte NavigationUI implementieren lässt. findDestination() ist eine Erweiterungsfunktion für NavGraph, mit der ein Ziel im Graphen gefunden wird. getHierarchy() ist eine Funktion in NavDestination, mit der geprüft werden kann, ob sich ein bestimmtes Ziel in der Hierarchie eines anderen Ziels befindet.(I2932f, b/188183365)

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • NavigationUI-Methoden, die ein BottomNavigationView akzeptiert haben, wurden aktualisiert und akzeptieren jetzt die in Material 1.4.0 eingeführte Basisklasse NavigationBarView. Dadurch können diese Methoden mit dem NavigationRailView verwendet werden. (Ib0b36, b/182938895)

  • Wenn ein <action>-Element über XML aufgebläht wird, können Animationsattribute Attribute verwenden, die mit der Syntax app:enterAnim="?attr/transitionEnter" aus Ihrem Design abgerufen werden. (I07bc1, b/178291654)

API-Änderungen

  • Kotlin-DSL-Builder, die eine ID verwenden, wurden eingestellt und sollten durch Builder ersetzt werden, die Routen verwenden (I85b42, b/188816479) (I9f58f, b/188816479).

Fehlerkorrekturen

  • DialogFragmentNavigator verwendet jetzt die NavigatorState.pop() API, um den NavController zu informieren, wenn ein Dialogfeld durch Drücken der Zurück-Taste des Systems oder durch Klicken außerhalb des Dialogfelds geschlossen wird. So wird sichergestellt, dass der Status des NavController immer mit dem Status des Navigators synchron ist. (I2ead9)
  • Die Navigation gibt keinen ConcurrentModificationException mehr zurück, wenn die Liste der OnDestinationChangedListeners über einen onDestinationChanged-Callback manipuliert wird. (Ib1707, b/188860458)

  • Safe Args stürzt nicht mehr ab, wenn versucht wird, Richtungseigenschaften in Kotlin zu generieren. (Id2416, b/188564435)

  • Die Methode „setId“ für „NavDestination“ ist jetzt korrekt mit @IdRes annotiert, sodass sie nur Ressourcen-IDs akzeptiert. (I69b80)

  • Der int-Parameter von findNode ist jetzt resId statt resid. (I7711d)

Abhängigkeitsupdate

  • Safe-Args hängt jetzt vom Android-Gradle-Plug-in 4.2.0 ab. Die Warnung, dass applicationIdTextResource verwendet wird, sollte jetzt nicht mehr angezeigt werden. (I6d67b, b/172824579)

Version 2.4.0-alpha01

18. Mai 2021

androidx.navigation:navigation-*:2.4.0-alpha01 ist veröffentlicht. Version 2.4.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Die Methode currentBackStackEntryAsFlow() für NavController stellt ein Flow bereit, das immer dann ausgegeben wird, wenn sich die aktuelle NavBackStackEntry ändert. Dieser Ablauf kann als Alternative zur manuellen Verwaltung eines OnDestinationChangedListener verwendet werden. (I19c4a, #89, b/163947280)

Mehrere Back Stacks

Der NavController ist für die Verwaltung des Back Stacks von Zielen verantwortlich. Er fügt dem Back Stack Ziele hinzu, wenn du zu ihnen navigate(), und entfernt sie, wenn du popBackStack() aufrufst oder den Zurück-Button des Systems auslöst. Die vorhandene Klasse NavOptions und die Einbindung in <action>-Einträge in der XML-Datei des Navigationsgraphen wurden erweitert, um das Speichern und Wiederherstellen des Backstacks zu unterstützen. (b/80029773)

Im Rahmen dieser Änderung speichern und stellen die NavigationUI-Methoden von onNavDestinationSelected(), BottomNavigationView.setupWithNavController() und NavigationView.setupWithNavController() jetzt automatisch den Status von entfernten Zielen wieder her. Dadurch werden mehrere Back Stacks ohne Codeänderungen unterstützt. Wenn Sie die Navigation mit Fragmenten verwenden, ist dies die empfohlene Methode für die Einbindung mehrerer Back Stacks. (Ie07ca)

Die zugrunde liegenden APIs zum Speichern und Wiederherstellen des Status werden über eine Reihe von Oberflächen bereitgestellt:

  • In der Navigations-XML kann das Element <action> jetzt die booleschen Attribute app:popUpToSaveState und app:restoreState verwenden, um den Status aller über app:popUpTo entfernten Ziele zu speichern und den Status des als app:destination übergebenen Ziels wiederherzustellen:

    <action
      android:id=”@+id/swap_stack”
      app:destination=”@id/second_stack”
      app:restoreState=”true”
      app:popUpTo=”@id/first_stack_start_destination”
      app:popUpToSaveState=”true” />
    
  • In der navOptions Kotlin DSL können Sie die boolesche Property restoreState und die boolesche Property saveState im popUpTo-Builder hinzufügen:

    // Use the navigate() method that takes a navOptions DSL Builder
    navController.navigate(selectedBottomNavRoute) {
      launchSingleTop = true
      restoreState = true
      popUpTo(navController.graph.startDestinationId) {
        saveState = true
      }
    }
    
  • Wenn Sie ein NavOptions-Objekt manuell über die NavOptions.Builder erstellen, können Sie die setRestoreState() und die neue Überladung für setPopUpTo() verwenden, die einen zusätzlichen saveState-Parameter akzeptiert.

    NavOptions navOptions = new NavOptions.Builder()
      .setLaunchSingleTop(true)
      .setRestoreState(true)
      .setPopUpTo(navController.getGraph().getStartDestinationId(),
        false, // inclusive
        true) // saveState
      .build();
    navController.navigate(selectedBottomNavId, null, navOptions);
    
  • Programmatische Aufrufe von popBackStack() können jetzt einen zusätzlichen saveState-Parameter enthalten.

In allen Fällen speichert und stellt der NavController den Status jedes NavBackStackEntry wieder her, einschließlich aller ViewModel-Instanzen, die auf das Navigationsziel beschränkt sind. Die Navigator-APIs wurden aktualisiert, damit jede Navigator das Speichern und Wiederherstellen des eigenen Status unterstützt.

Die ComposeNavigator, die für composable-Ziele in Navigation Compose verwendet wird, sowie die FragmentNavigator und DynamicFragmentNavigator, die für <fragment>-Ziele in Navigation mit Fragmenten verwendet werden, wurden aktualisiert, um die neuen Navigator APIs zu verwenden und das Speichern und Wiederherstellen des Status zu unterstützen.

Navigationsrouten

Eine Route ist ein String, das ein Ziel eindeutig identifiziert. Bisher wurde dieses Konzept nur in Navigation Compose verwendet, ist jetzt aber Teil der zentralen Navigation APIs. Dies ist eine Alternative zur Verwendung von Ganzzahl-IDs beim Erstellen des Graphen über die Navigation Kotlin DSL. (b/172823546)

Alle APIs, die bisher nur eine ID akzeptiert haben, haben jetzt eine Überladung, die eine Route String akzeptiert. Dazu gehören navigate(), popBackStack(), popUpTo() und getBackStackEntry().

Dies hatte einige Auswirkungen auf die API:

  • Das Kotlin-Attribut popUpTo in der Kotlin-DSL wurde zugunsten von popUpToId eingestellt. (I59c73, b/172823546)
  • Die getStartDestination() API wurde zugunsten von getStartDestinationId() eingestellt. (I0887f, b/172823546)

Für Entwickler, die ein Upgrade von früheren Versionen von Navigation Compose auf Navigation Compose 2.4.0-alpha01 durchführen, bedeutet dies, dass die folgenden Importe von Erweiterungsmethoden nicht mehr erforderlich sind und entfernt werden sollten:

import androidx.navigation.compose.navigation
import androidx.navigation.compose.createGraph
import androidx.navigation.compose.getBackStackEntry
import androidx.navigation.compose.navigate
import androidx.navigation.compose.popUpTo

Das Argument KEY_ROUTE wurde durch das Attribut route in NavDestination ersetzt, sodass Sie navBackStackEntry.destination.route direkt aufrufen können.

API-Änderungen

  • Alle Navigationsartefakte wurden in Kotlin neu geschrieben. Dadurch wurde die Null-Zulässigkeit von Klassen verbessert, die Generics verwenden (z. B. NavType-Unterklassen). Alle Kotlin-Erweiterungsfunktionen, die früher Teil der -ktx-Artefakte waren, wurden in die entsprechenden Hauptartefakte verschoben. Die -ktx-Artefakte werden weiterhin veröffentlicht, sind aber vollständig leer. (b/184292145)
  • NavDeepLinkBuilder unterstützt jetzt das Hinzufügen mehrerer unterschiedlicher Ziele zum generierten Back Stack. (I3ee0d, b/147913689)
  • Factory-Funktionen für DynamicNavHostFragment hinzugefügt (Icd515, b/175222619)
  • Die eindeutige ID eines NavBackStackEntry wird jetzt als Teil der öffentlichen API angezeigt. (Ie033a)
  • Die Felder name und argument sowie die Destrukturierungsfunktionen von NamedNavArgument sind jetzt öffentlich. (#174, b/181320559)
  • Es wurde eine neue NavBackStackEntry#provideToCompositionLocals-Erweiterung eingeführt, die den NavBackStackEntry für die relevanten CompositionLocals bereitstellt. (#175, b/187229439)

Safe Args

  • Safe Args generiert jetzt für jede NavArgs-Klasse eine fromSavedStateHandle()-Methode. (#122, b/136967621)

    class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
      // Create a HomeDestinationArgs class with type safe accessors for each argument
      // defined on your destination
      private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle)
    }
    
  • Safe Args wurde aktualisiert, um von KotlinPoet 1.8.0 abhängig zu sein. (#172, b/183990444)

Geändertes Verhalten

  • Die Navigation hängt jetzt von Lifecycle 2.3.1 ab und markiert jetzt setGraph(), popBackStack(), navigateUp() und navigate(), die Methoden, die den NavBackStackEntry Lifecycle aktualisieren, als @MainThread. Dadurch wird die Navigation an die in Lifecycle 2.3.0 eingeführte Erzwingung des Hauptthreads angepasst. (b/171125856)
  • Beim Parsen von Enum-Argumenten aus Deeplinks wird die Groß-/Kleinschreibung jetzt nicht mehr berücksichtigt. So kann ein Deeplink wie http://www.example.com/red mit einem Deeplink www.example.com/{color} übereinstimmen, auch wenn das Enum den Wert RED hat. (#152, b/135857840)

Compose-Kompatibilität

  • androidx.navigation:navigation-compose:2.4.0-alpha01 ist nur mit Compose-Version 1.0.0-beta07 und höher kompatibel.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem nachgestellte Argumentplatzhalter Vorrang vor Deeplinks mit einem übereinstimmenden genauen Suffix hatten. (#153, b/184072811)
  • NavHostFragment unterstützt jetzt benutzerdefinierte Navigatoren, die dieselbe @Navigator.Name("dialog") wie die Standard-DialogFragmentNavigator verwenden. (Ib1c2c, b/175979140)
  • Das Verhalten von NavigatorProvider#addNavigator wurde verbessert, sodass wiederholte Aufrufe mit derselben Instanz keine Probleme mehr verursachen. (#176, b/187443146)

Externe Beiträge

  • Vielen Dank an simonschiller für die Unterstützung von Safe Args, die eine fromSavedStateHandle()-Methode für jede NavArgs-Klasse generiert. (#122, b/136967621)
  • Vielen Dank an Bradleycorn, der dafür gesorgt hat, dass beim Parsen von Enum-Argumenten aus Deeplinks die Groß-/Kleinschreibung nicht berücksichtigt wird. (#152, b/135857840)
  • Vielen Dank an osipxd für die Behebung eines Problems, bei dem nachgestellte Argumentplatzhalter Vorrang vor Deeplinks mit einem übereinstimmenden genauen Suffix hatten. (#153, b/184072811)
  • Vielen Dank an tatocaster für die Aktualisierung von Safe Args, sodass es von KotlinPoet 1.8.0 abhängt. (#172, b/183990444)
  • Vielen Dank an jossiwolf für die Veröffentlichung der Felder name und argument sowie der Destrukturierungsfunktionen von NamedNavArgument. (#174, b/181320559)
  • Vielen Dank an jossiwolf für die Einführung einer neuen NavBackStackEntry#provideToCompositionLocals-Erweiterung, die den NavBackStackEntry für die relevanten CompositionLocals bereitstellt. (#175, b/187229439)
  • Vielen Dank an jossiwolf für die Verbesserung des Verhaltens von NavigatorProvider#addNavigator, damit es bei wiederholtem Aufruf mit derselben Instanz nicht zu Problemen kommt. (#176, b/187443146)

Version 1.0.0-alpha10

7. April 2021

androidx.navigation:navigation-compose:1.0.0-alpha10 ist veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

API-Änderungen

  • NavHost akzeptiert jetzt ein Modifier, das an den zusammensetzbaren Container übergeben wird, der die zusammensetzbaren Ziele umschließt. (I85aca, b/175125483)

Fehlerkorrekturen

  • NavHost funktioniert jetzt auch, wenn kein OnBackPressedDispatcherOwner gefunden wird, z. B. bei der Vorschau von NavHost. (I7d8b4)
  • Navigation Compose hängt jetzt von Navigation 2.3.5 ab. Dadurch wurde ein Problem behoben, das bei der Verwendung von BackHandler innerhalb eines NavHost-Ziels aufgetreten ist. (I7e63b, b/182284739)

Version 1.0.0-alpha09

10. März 2021

androidx.navigation:navigation-compose:1.0.0-alpha09 ist veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

API-Änderungen

  • LocalViewModelStoreOwner.current gibt jetzt einen nullable ViewModelStoreOwner zurück, um besser feststellen zu können, ob ein ViewModelStoreOwner in der aktuellen Komposition verfügbar ist. APIs, die einen ViewModelStoreOwner erfordern, z. B. viewModel() und NavHost, lösen weiterhin eine Ausnahme aus, wenn kein ViewModelStoreOwner festgelegt ist. (Idf39a)

Fehlerkorrekturen

  • Navigation Compose hängt jetzt von Navigation 2.3.4 ab. Diese Version enthält die Korrektur für den Versuch, dasselbe ViewModelStore-Objekt festzulegen, nachdem der Graph festgelegt wurde. (I65c24, b/177825470)

Version 1.0.0-alpha08

24. Februar 2021

androidx.navigation:navigation-compose:1.0.0-alpha08 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Neue Funktionen

  • NavHost füllt jetzt die CompositionLocal LocalSavedStateRegistryOwner mit der NavBackStackEntry des Ziels. So wird sichergestellt, dass alle direkt in der SavedStateRegistry gespeicherten Zustände zusammen mit dem Ziel gespeichert und wiederhergestellt werden. (I435d7, b/179469431)

Version 1.0.0-alpha07

10. Februar 2021

androidx.navigation:navigation-compose:1.0.0-alpha07 ist veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

Abhängigkeitsupdates

Version 1.0.0-alpha06

28. Januar 2021

androidx.navigation:navigation-compose:1.0.0-alpha06 ist veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

  • Es wurde eine getBackStackEntry(route: String)-Erweiterungsmethode für NavController hinzugefügt, die die zugehörige NavBackStackEntry zurückgibt. (If8931)

Version 1.0.0-alpha05

13. Januar 2021

androidx.navigation:navigation-compose:1.0.0-alpha05 ist veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Aktualisiert, um von Compose 1.0.0-alpha10 abhängig zu sein.

Version 1.0.0-alpha04

16. Dezember 2020

androidx.navigation:navigation-compose:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

  • Aktualisiert für die Kompatibilität mit Compose 1.0.0-alpha09.

Version 1.0.0-alpha03

2. Dezember 2020

androidx.navigation:navigation-compose:1.0.0-alpha03 ist veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein Problem behoben, durch das popBackStack() und navigateUp() nach einer Konfigurationsänderung oder einer Prozessbeendigung und ‑neuerstellung nicht funktionierten. (Icea47, b/173281473)
  • Die Navigation zu einem verschachtelten Graphen in Ihrem NavHost funktioniert jetzt ordnungsgemäß. (I0948d, b/173647694)

Version 1.0.0-alpha02

11. November 2020

androidx.navigation:navigation-compose:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

  • Navigation Compose unterstützt jetzt NavOptions für die Verwendung von popUpTo- und launchSingleTop-Vorgängen (If96c3, b/171468994)
  • Es wurde eine Navigationsfunktion hinzugefügt, die eine Route anstelle einer ID verwendet. Damit können Sie verschachtelte Graphen in der Navigation Compose DSL erstellen. (I1661d)
  • „startDestination“ steht jetzt in der Liste der Parameter für einen NavHost vor der Route (Ie620e).
  • Sie können jetzt ein Diagramm mit der Route als Startziel außerhalb einer NavHost-Komposition erstellen. (Iceb75)

Version 1.0.0-alpha01

28. Oktober 2020

android.navigation:navigation-compose:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Das Artefakt navigation-compose ermöglicht die Integration der Navigationskomponente in Jetpack Compose. Dabei werden @Composable-Funktionen als Ziele in Ihrer Anwendung verwendet.

Diese erste Version bietet:

  • Eine NavHost komponierbare Funktion, mit der Sie Ihren Navigationsgraphen über eine Kotlin-DSL erstellen können.
  • Festlegung des Bereichs für Lebenszyklus, ViewModel und gespeicherten Zustand auf Zielebene.
  • Automatische Integration mit dem Button „Zurück“ des Systems.
  • Unterstützung für die Übergabe von Argumenten, das Anhängen von Deeplinks an Ziele und die Rückgabe eines Ergebnisses an vorherige Ziele.
  • Spezifische Hilfsprogramme in rememberNavController() und currentBackStackEntryAsState() erstellen, um das Hochstufen des Status und das Verbinden des NavController mit Composables außerhalb des NavHost (z. B. einer unteren Navigationsleiste) zu ermöglichen.

Weitere Informationen finden Sie im Leitfaden zur Navigation mit Compose.

Version 2.3.5

Version 2.3.5

7. April 2021

androidx.navigation:navigation-*:2.3.5 ist veröffentlicht. Version 2.3.5 enthält diese Commits.

Neue Funktionen

  • Wenn Sie mit einem NavDeepLinkRequest oder Uri navigieren, können Sie jetzt auf den Uri, die Aktion und den MIME-Typ im resultierenden Ziel zugreifen, indem Sie den Intent aus Argumenten über KEY_DEEP_LINK_INTENT abrufen. Dies spiegelt die Funktionalität wider, die bereits für externe Deeplinks verfügbar ist. (I975c3, b/181521877)

Fehlerkorrekturen

  • OnBackPressedCallbacks, die einem Dispatcher mit NavBackStackEntry als LifecycleOwner hinzugefügt wurden, fangen jetzt „Zurück“ ordnungsgemäß ab, nachdem der Aktivitätslebenszyklus STOPPED und dann STARTED ist (Iff94f, b/182284739).
  • Beim Parsen von Deeplink-Domains wird die Groß-/Kleinschreibung nicht mehr berücksichtigt. www.example.com stimmt also sowohl mit www.example.com als auch mit www.Example.com überein. Bei den Namen der Suchparameter wird weiterhin zwischen Groß- und Kleinschreibung unterschieden. (#144, b/153829033)
  • Es wurde ein NullPointerException behoben, der auftreten konnte, wenn ein Ziel mehrere nicht nullable Standardargumente hatte und Sie zu diesem Ziel navigierten, während Sie nur einen Teil dieser Argumente überschrieben. (aosp/1644827)

Abhängigkeitsupdates

  • Das Gradle-Plug-in „Navigation Safe Args“ hängt jetzt vom Kotlin-Gradle-Plug-in 1.4.31 ab. (aosp/1661058, b/181156413)

Externer Beitrag

  • Vielen Dank an bentrengrove für die Pull-Anfrage, mit der das Parsen von Deeplink-Domains unabhängig von der Groß- und Kleinschreibung gemacht wurde. (#144, b/153829033)

Version 2.3.4

Version 2.3.4

10. März 2021

androidx.navigation:navigation-*:2.3.4 ist veröffentlicht. Version 2.3.4 enthält diese Commits.

Neue Funktionen

  • ReferenceType-Argumente können jetzt richtig geparst werden, wenn sie als Teil eines Deeplink-URI gesendet werden. Es werden sowohl der ganzzahlige Rohwert als auch Hexadezimalwerte mit dem Präfix 0x unterstützt. (#127, b/179166693)
  • Der android:defaultValue für ein Argument mit app:argType="float" unterstützt jetzt ganzzahlige Standardwerte, sodass Sie android:defaultValue="0" verwenden können, anstatt 0.0 verwenden zu müssen. (#117, b/173766247)

Fehlerkorrekturen

  • Problem behoben, bei dem der Installationsfortschritt hängen blieb, wenn die Unterstützung für dynamische Funktionen in der Navigation verwendet wurde. (Ib27a7, b/169636207)
  • Der Aufruf von setViewModelStore oder setLifecycleOwner mit demselben Objekt, das bereits festgelegt wurde, ist jetzt ein No-Op (Idf491, b/177825470).
  • Safe-Args fügt jetzt bei Verwendung von Java Unterdrückungsannotationen zu den richtigen Methoden hinzu. (I8fbc5, b/179463137)

Externe Beiträge

  • Vielen Dank an JvmName für die Pull-Anfrage, mit der sichergestellt wird, dass ReferenceType-Argumente jetzt ordnungsgemäß geparst werden können, wenn sie als Teil eines Deeplink-URI gesendet werden. (#127, b/179166693)
  • Vielen Dank an tatocaster für die Pull-Anfrage, mit der defaultValue für ein Argument mit app:argType=”float” jetzt ganzzahlige Standardwerte unterstützt. (#117, b/173766247)

Version 2.3.3

Version 2.3.3

27. Januar 2021

androidx.navigation:navigation-*:2.3.3 ist veröffentlicht. Version 2.3.3 enthält diese Commits.

Fehlerkorrekturen

  • Es kommt nicht mehr zu einem Absturz, wenn ein NavBackStackEntry entfernt wird, bevor sein Lifecycle zu CREATED verschoben wird. (Ie3ba3)
  • Es wurde eine Regression behoben, die durch b/171364502 verursacht wurde, bei der die Navigation zu einer Aktivität mit dem Animationsressourcenwert 0 einen ResourceNotFoundException verursachte. (I7aedb, b/176819931)

Version 2.3.2

Version 2.3.2

2. Dezember 2020

androidx.navigation:navigation-*:2.3.2 ist veröffentlicht. Version 2.3.2 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde eine Regression in NavigationUI behoben, bei der die Verwendung eines <activity>-Ziels mit onNavDestinationSelected dazu führte, dass die Navigation zur Aktivität fehlschlug. (I22e34, b/171364502)
  • Ein Problem wurde behoben, bei dem navigation-dynamic-features-fragment dazu führte, dass mehrmals zum neu installierten Ziel navigiert wurde. (aosp/1486056, b/169636207)
  • Es wurde ein Problem behoben, bei dem Standardargumente bei Verwendung von launchSingleTop nicht an OnDestinationChangedListener-Instanzen gesendet wurden. (I2c5cb)
  • Es wurde ein Problem behoben, bei dem beim Navigieren zu einem verschachtelten Navigationsgraphen keine neue Graphinstanz im Back Stack erstellt wurde. (Ifc831)
  • Es wurde ein Problem behoben, bei dem die Verwendung von navigate() mit einem popUpTo, der das letzte Ziel in einem Navigationsgraphen entfernt hat, den Navigationsgraphen nicht sofort zerstört und aus dem Back Stack entfernt hat. (I910a3)
  • Navigation SafeArgs verwendet jetzt KotlinPoet Version 1.7.2, die Unterstützung für den expliziten API-Modus von Kotlin bietet. (I918b5)
  • NavHostFragment.findNavController(Fragment) prüft jetzt zusätzlich zu den vorhandenen Prüfungen der Fragmenthierarchie und der Ansichtshierarchie des Fragments auch die Stammdekoransicht eines DialogFragments. So können Sie Dialogfragmente testen, die die Navigation mit FragmentScenario und Navigation.setViewNavController() verwenden. (I69e0d)

Version 2.3.1

Version 2.3.1

14. Oktober 2020

androidx.navigation:navigation-*:2.3.1 ist veröffentlicht. Version 2.3.1 enthält diese Commits.

Neue Funktionen

  • Der Navigations-UI wurden Standard-Animator-Ressourcen hinzugefügt. Sie werden gegenüber den Standard-Animationsressourcen empfohlen. (b/167430145)
  • „NavOptions“ überschreibt jetzt die Methoden „hashcode“ und „equals“ (b/161586466)
  • Die Navigation enthält jetzt das aktuelle Ziel in der IllegalArgumentException „Kein Ziel mit ID“, was das Debugging für Entwickler verbessern sollte. (b/168311416)

Fehlerkorrekturen

  • Safe Args bricht die Rückgabezeile nicht mehr um, auch wenn der generierte Argumentklassenname länger als 100 Zeichen ist. (b/168584987)

Änderungen an Abhängigkeiten

  • navigation-ui hängt jetzt von DrawerLayout 1.1.1 ab, sodass NavigationUI die Leiste auch dann öffnen kann, wenn LOCK_MODE_LOCKED_CLOSED oder LOCK_MODE_LOCKED_OPEN verwendet wird. (b/162253907)
  • Safe Args hängt jetzt von KotlinPoet 1.6.0 ab (aosp/1435911).
  • Safe Args hängt jetzt von AGP 4.0.1 ab (aosp/1442337).

Version 2.3.0

Version 2.3.0

24. Juni 2020

androidx.navigation:navigation-*:2.3.0 ist veröffentlicht. Version 2.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 2.2.0

  • Integration von Funktionsmodulen: Mit den Artefakten navigation-dynamic-features-runtime und navigation-dynamic-features-fragment können Sie zu Zielen navigieren, die in Funktionsmodulen definiert sind. Die Installation der Funktionsmodule wird dabei automatisch nach Bedarf durchgeführt. Weitere Informationen finden Sie unter Mit Funktionsmodulen navigieren.
  • Navigationstests: Das Artefakt navigation-testing bietet einen TestNavHostController, mit dem Sie das aktuelle Ziel festlegen und den Back Stack nach Navigationsvorgängen prüfen können. Weitere Informationen finden Sie unter Navigation testen.
  • Ergebnis zurückgeben: Über den NavBackStackEntry, der mit jedem Ziel im Back Stack der Navigation verknüpft ist, können Sie jetzt auf ein SavedStateHandle zugreifen, das sich zum Speichern kleiner Mengen gespeicherter Zustände eignet, die mit einem bestimmten Back-Stack-Eintrag verknüpft werden sollen. Weitere Informationen finden Sie unter Ergebnis an das vorherige Ziel zurückgeben.
  • NavigationUI-Unterstützung für Openable: Alle Verwendungen von DrawerLayout in NavigationUI wurden durch die allgemeinere Openable-Schnittstelle ersetzt, die in CustomView 1.1.0 hinzugefügt und von DrawerLayout in DrawerLayout 1.1.0 implementiert wurde.
  • Unterstützung von Aktionen und MIME-Typen in Deeplinks: Deeplinks wurden erweitert, um neben dem zuvor verfügbaren app:uri auch app:action und app:mimeType zu unterstützen. NavController unterstützt jetzt die Navigation nach einer beliebigen Kombination dieser Felder über die neue NavDeepLinkRequest-Klasse. Weitere Informationen findest du unter Mit NavDeepLinkRequest navigieren.

Bekannte Probleme

  • Die Unterstützung für Deeplink-Aktionen und MIME-Typen ist in Manifest Merger noch nicht verfügbar. Bis diese Arbeit abgeschlossen ist, enthalten alle generierten <intent-filter>-Elemente aus dem <nav-graph>-Element in Ihrem Manifest weder Ihren MIME-Typ im <data>-Element noch Ihre benutzerdefinierte <action>. Sie müssen Ihrem Manifest manuell einen geeigneten <intent-filter> hinzufügen.

Version 2.3.0-rc01

10. Juni 2020

androidx.navigation:navigation-*:2.3.0-rc01 ist veröffentlicht. Version 2.3.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Es wurde ein NullPointerException behoben, der auftrat, wenn eine Instanz eines Ziels ohne Argumente durch eine andere Instanz mit Argumenten mit singleTop ersetzt wurde. (b/158006669)
  • Alle von NavController ausgelösten destination is unknown-Ausnahmen enthalten jetzt zusätzliche Debugging-Informationen, um den Status von NavController zu ermitteln. (b/157764916)

Version 2.3.0-beta01

20. Mai 2020

androidx.navigation:navigation-*:2.3.0-beta01 sind veröffentlicht. Version 2.3.0-beta01 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem Lifecycle von NavBackStackEntry nach der Prozessbeendigung nicht richtig aktualisiert wurde. (b/155218371)
  • OnDestinationChangedListener-Instanzen, die vor dem Aufruf von setGraph() registriert wurden, wird nach einer Prozessbeendigung jetzt das wiederhergestellte Ziel gesendet. (b/155218371)
  • Wenn Sie singleTop verwenden, werden die Argumente von NavBackStackEntry jetzt korrekt aktualisiert und die aktualisierten Argumente werden an alle OnDestinationChangeListener-Instanzen gesendet. (b/156545508)

Abhängigkeitsupdates

Version 2.3.0-alpha06

29. April 2020

androidx.navigation:navigation-*:2.3.0-alpha06 ist veröffentlicht. (Version 2.3.0-alpha06 enthält diese Commits.)

Neue Funktionen

  • Deeplinks wurden erweitert, um neben dem zuvor verfügbaren app:uri auch app:action und app:mimeType zu unterstützen. NavController unterstützt jetzt die Navigation über eine beliebige Kombination dieser Felder über die neue NavDeepLinkRequest-Klasse. (b/136573074, b/135334841)

API-Änderungen

  • Die Kotlin-DSL-Unterstützung für dynamische Navigationsziele wurde erheblich erweitert. (b/148969800)

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem Deeplink-Intents ignoriert wurden, wenn ein verschachteltes Startziel verwendet wurde. (b/154532067)

Version 2.3.0-alpha05

15. April 2020

androidx.navigation:navigation-*:2.3.0-alpha05 ist veröffentlicht. Version 2.3.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Für dynamische Diagrammeinschlüsse mit <include-dynamic> müssen Sie app:graphPackage nicht mehr angeben. Es wird ein Standardwert verwendet, indem das Suffix moduleName nach einem Punkt an applicationId angehängt wird. Wenn Sie Ihre graphPackage anpassen müssen, wird jetzt ein ${applicationId}-Platzhalter unterstützt. (b/152696768)
  • Die Kotlin-DSL für Navigationsgraphen stellt jetzt ein defaultArguments-Map für Aktionen bereit. Damit können Standardwerte für <action>-Elemente in Navigations-XML-Dateien festgelegt werden. (b/150345605)

Fehlerkorrekturen

  • Ab Navigation 2.2.2: Es wurde ein IllegalStateException behoben, der beim Deeplinking zum Startziel des Graphen auftrat, wenn mehrere NavHostFragment-Instanzen in der Aktivität vorhanden waren. (b/147378752)

Abhängigkeitsupdates

Version 2.3.0-alpha04

18. März 2020

androidx.navigation:navigation-*:2.3.0-alpha04 ist veröffentlicht. Version 2.3.0-alpha04 enthält diese Commits.

Neue Funktionen

  • In der Navigation Kotlin DSL wurde Unterstützung für Funktionsmodul-Aktivitäten und Fragmentziele hinzugefügt. (b/148969800)

API-Änderungen

  • Die Klasse DynamicExtras verwendet kein Builder-Muster mehr und kann jetzt direkt erstellt werden. (aosp/1253671)
  • DynamicActivityNavigator verwendet jetzt im Konstruktor ein Context anstelle eines Activity. (aosp/1250252)

Fehlerkorrekturen

  • NavigationUI ignoriert leere Labels (d.h. ein Ziel mit android:label=””) nicht mehr und legt den Titel jetzt korrekt als leeren String fest. (b/148679860)

Abhängigkeitsupdates

  • Die Artefakte für dynamische Navigationsfunktionen hängen jetzt von Play Core 1.6.5 ab. (b/149556401)

Version 2.3.0-alpha03

4. März 2020

androidx.navigation:navigation-*:2.3.0-alpha03 ist veröffentlicht. Version 2.3.0-alpha03 enthält diese Commits.

API-Änderungen

  • Anstatt sich auf die konkrete DrawerLayout-Klasse zu verlassen, verwendet AppBarConfiguration jetzt die in CustomView 1.1.0-alpha02 eingeführte Openable-Schnittstelle (die DrawerLayout ab DrawerLayout 1.1.0-alpha04 implementiert), sodass Sie benutzerdefinierte Implementierungen von Openable mit NavigationUI verwenden können. (b/129030452)

Fehlerkorrekturen

  • Die ProGuard-Regeln für navigation-common-ktx behalten jetzt nur die verwendeten NavArgs-Klassen bei, anstatt alle NavArgs-Instanzen. (b/150213558)

Änderungen an Abhängigkeiten

  • Die Abhängigkeit von Navigation von Core 1.2.0 wurde rückgängig gemacht. Navigation hängt jetzt von Core 1.1.0 ab, damit Entwickler nicht gezwungen sind, zu einer neueren Abhängigkeit zu wechseln, wenn Navigation nicht von neuen APIs in Core 1.2.0 abhängt.

Version 2.3.0-alpha02

19. Februar 2020

androidx.navigation:navigation-*:2.3.0-alpha02 ist veröffentlicht. Version 2.3.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Mit NavBackStackEntry kannst du jetzt auf einen SavedStateHandle zugreifen, der sich zum Speichern kleiner Mengen gespeicherter Zustände eignet, die mit einem bestimmten Back-Stack-Eintrag verknüpft werden sollen. Ein Beispiel für einen Anwendungsfall finden Sie unter Ergebnis zurückgeben. (b/79672220)

API-Änderungen

  • Die Komfortmethoden getCurrentBackStackEntry() und getPreviousBackStackEntry() wurden hinzugefügt, um das Abrufen eines NavBackStackEntry für das aktuelle und das vorherige Ziel zu vereinfachen. (b/79672220)

Fehlerkorrekturen

  • navigateUp() übergibt jetzt die Argumente des aktuellen Ziels und das KEY_DEEP_LINK_INTENT an das vorherige Ziel, wenn die App im eigenen Aufgabenstapel gestartet wird. (b/147456890)

Änderungen an Abhängigkeiten

Version 2.3.0-alpha01

5. Februar 2020

androidx.navigation:navigation-*:2.3.0-alpha01 ist veröffentlicht. Version 2.3.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Das neue navigation-testing-Artefakt stellt eine TestNavHostController-Klasse bereit. Diese Klasse bietet eine Alternative zur Verwendung eines simulierten NavController beim Testen der Navigation. Sie können damit das aktuelle Ziel festlegen und den Back Stack nach Navigationsvorgängen prüfen. (b/140884273)
  • Mit dem neuen navigation-dynamic-features-fragment (und seiner transitiven Abhängigkeit navigation-dynamic-features-runtime) können Sie Ziele oder ganze Navigationsgraphen (über <include-dynamic>) aus Funktionsmodulen einbeziehen. So können On-Demand-Funktionsmodule nahtlos installiert werden, wenn Sie zu diesen Zielen navigieren. Weitere Informationen finden Sie unter Mit Funktionsmodulen navigieren. (b/132170186)

Diverse Fehlerkorrekturen

  • Aus Navigation 2.2.1: Deeplinks ohne Suchparameter ignorieren jetzt Suchparameter korrekt, anstatt sie an nachfolgende {argument}-Elemente anzuhängen oder den Deeplink nicht abzugleichen. (b/147447512)
  • Aus Navigation 2.2.1: Die navigation-ui-ProGuard-Regeln für DrawerArrowDrawable wurden aktualisiert, damit android.enableJetifier=true nicht erforderlich ist. (b/147610424)
  • Aus Navigation 2.2.1: Das navigation-common-ktx-Modul hat jetzt einen eindeutigen Manifestpaketnamen, anstatt denselben Manifestpaketnamen wie navigation-runtime-ktx zu verwenden. (aosp/1141947)

Abhängigkeitsupdates

Version 2.2.2

Version 2.2.2

15. April 2020

androidx.navigation:navigation-*:2.2.2 sind veröffentlicht. Version 2.2.2 enthält diese Commits.

Fehlerkorrekturen

  • Ein IllegalStateException-Fehler beim Deeplinking zum Startziel des Graphen, wenn mehrere NavHostFragment-Instanzen in der Aktivität vorhanden sind, wurde behoben. (b/147378752)
  • NavigationUI ignoriert leere Labels (d.h. ein Ziel mit android:label=””) nicht mehr und legt den Titel jetzt korrekt als leeren String fest. Diese Funktion wurde bereits in Navigation 2.3.0-alpha04 veröffentlicht. (b/148679860)
  • Die ProGuard-Regeln für navigation-common-ktx behalten jetzt nur die verwendeten NavArgs-Klassen bei, anstatt alle NavArgs-Instanzen. Diese Funktion wurde bereits in Navigation 2.3.0-alpha03 veröffentlicht. (b/150213558

Abhängigkeitsupdates

Version 2.2.1

Version 2.2.1

5. Februar 2020

androidx.navigation:navigation-*:2.2.1 ist veröffentlicht. Version 2.2.1 enthält diese Commits.

Diverse Fehlerkorrekturen

  • Bei Deeplinks ohne Suchparameter werden jetzt alle Suchparameter ignoriert, anstatt sie an nachfolgende {argument}-Elemente anzuhängen oder den Deeplink nicht abzugleichen. (b/147447512)
  • Die navigation-ui-ProGuard-Regeln für DrawerArrowDrawable wurden aktualisiert, damit android.enableJetifier=true nicht erforderlich ist. (b/147610424)
  • Das Modul navigation-common-ktx hat jetzt einen eindeutigen Manifest-Paketnamen, anstatt denselben Manifest-Paketnamen wie navigation-runtime-ktx zu verwenden. (aosp/1141947)

Abhängigkeitsupdates

Version 2.2.0

Version 2.2.0

22. Januar 2020

androidx.navigation:navigation-*:2.2.0 ist veröffentlicht. Version 2.2.0 enthält diese Commits.

Wichtige Änderungen seit Version 2.1.0

  • NavBackStackEntry: Sie können jetzt NavController.getBackStackEntry() aufrufen und die ID eines Ziels oder Navigationsgraphen im Back Stack übergeben. Der zurückgegebene NavBackStackEntry enthält neben den Argumenten, die zum Starten dieses Ziels verwendet wurden, auch ein navigationsgesteuertes LifecycleOwner, ViewModelStoreOwner (das gleiche, das von NavController.getViewModelStoreOwner() zurückgegeben wird) und SavedStateRegistryOwner.
  • Lifecycle ViewModel SavedState-Integration: SavedStateViewModelFactory ist jetzt die Standard-Factory, wenn by navGraphViewModels() oder der ViewModelProvider-Konstruktor mit einem ViewModelStoreOwner verwendet wird, das von NavController.getBackStackEntry() oder NavController.getViewModelStoreOwner() zurückgegeben wird.
  • Unterstützung von Suchparametern für Deeplinks: Deeplinks mit Suchparametern unterstützen jetzt neu angeordnete Suchparameter. Argumente mit einem Standardwert oder Argumente, die null sein können, sind jetzt beim Abgleich von Deeplinks optional.
  • Verbesserte Unterstützung für Animationen: NavHostFragment verwendet jetzt FragmentContainerView aus Fragment 1.2.0. Dadurch werden Probleme mit der Z-Reihenfolge von Animationen und der Weiterleitung von Fenstereinzügen an Fragmente behoben.

Version 2.2.0-rc04

18. Dezember 2019

androidx.navigation:navigation-*:2.2.0-rc04 ist veröffentlicht. Version 2.2.0-rc04 enthält diese Commits.

Diverse Fehlerkorrekturen

  • Die von navigation-ui verwendeten Standard-Einblendungsanimationen wurden an die angepassten Einblendungsanimationen in Fragment 1.2.0-rc04 angepasst. (b/145769814)

Version 2.2.0-rc03

4. Dezember 2019

androidx.navigation:navigation-*:2.2.0-rc03 ist veröffentlicht. Version 2.2.0-rc03 enthält diese Commits.

Diverse Fehlerkorrekturen

  • Es wurde ein Problem beim Parsen von Deeplinks behoben, das auftrat, wenn Suchparameter und ein Argument als letzter Teil des Pfads verwendet wurden. Dadurch wurde verhindert, dass mehr als ein Zeichen des letzten Pfadarguments geparst wurde. (b/144554689)
  • Ein Problem beim Parsen von Deeplinks wurde behoben, bei dem optionale Parameter "@null" anstelle von null erhielten. (b/141613546)
  • NavHostFragment stellt das Diagramm jetzt nach einer Konfigurationsänderung korrekt wieder her, wenn es mit FragmentContainerView verwendet wird. (b/143752103)

Änderungen an Abhängigkeiten

  • Die Navigation hängt jetzt von Lifecycle 2.2.0-rc03, Lifecycle ViewModel SavedState 1.0.0-rc03, Activity 1.1.0-rc03 und Fragment 1.2.0-rc03 ab, sofern zutreffend.

Version 2.2.0-rc02

7. November 2019

androidx.navigation:navigation-*:2.2.0-rc02 ist veröffentlicht. Version 2.2.0-rc02 enthält diese Commits.

Änderungen an Abhängigkeiten

  • Die Navigation hängt jetzt von androidx.lifecycle 2.2.0-rc02 ab.

Version 2.2.0-rc01

23. Oktober 2019

androidx.navigation:navigation-*:2.2.0-rc01 wird ohne Änderungen seit 2.2.0-beta01 veröffentlicht. Version 2.2.0-rc01 enthält diese Commits.

Version 2.2.0-beta01

9. Oktober 2019

androidx.navigation:navigation-*:2.2.0-beta01 ist veröffentlicht. Version 2.2.0-beta01 enthält diese Commits.

Neue Funktionen

  • NavDestination und die zugehörigen Unterklassen überschreiben jetzt toString(), um beim Debugging hilfreichere Informationen bereitzustellen. (b/141264986)

Verhaltensänderungen

  • Zusätzliche Suchparameter werden jetzt beim Abgleich von Deeplinks ignoriert, anstatt dass der Abgleich fehlschlägt. (b/141482822)

Diverse Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem Argumente im Pfad eines Deeplinks ignoriert wurden, wenn auch Suchparameter angegeben waren. (b/141505755)
  • Die Kotlin-Erweiterung navArgs() für Activity gibt jetzt eine bessere Fehlermeldung aus, wenn keine Extras vorhanden sind. (b/141408999)
  • Von Safe Args generierte Directions-Java-Klassen enthalten jetzt Standardwerte. (b/141099045)
  • Von Safe Args generierte Args-Java-Klassen enthalten jetzt Standardwerte. (b/140123727)
  • Wenn ein Toolbar verwendet wird, animiert NavigationUI die Textänderung nicht mehr, wenn zwischen zwei Zielen der obersten Ebene gewechselt wird. (b/140848160)

Version 2.2.0-alpha03

18. September 2019

androidx.navigation:navigation-*:2.2.0-alpha03 ist veröffentlicht. Version 2.2.0-alpha03 enthält diese Commits.

Verhaltensänderungen

  • Wenn Sie setViewModelStore() nach setGraph aufrufen, wird jetzt ein IllegalStateException zurückgegeben. Dies sollte immer von der NavHost im Rahmen der Ersteinrichtung festgelegt werden, damit alle NavBackStackEntry-Instanzen einen einheitlichen Speicher für ViewModel-Instanzen haben. (aosp/1111821)

Diverse Fehlerkorrekturen

  • Ein ConcurrentModificationException bei der Verwendung von ViewModel-Instanzen, die an mehrere verschiedene ViewModelStore-Instanzen mit Navigationsdiagramm-Bereich angehängt sind, wurde behoben. (aosp/1112257)

Version 2.2.0-alpha02

5. September 2019

androidx.navigation:navigation-*:2.2.0-alpha02 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Neue Funktionen

  • Deeplinks mit Suchparametern unterstützen jetzt neu angeordnete Suchparameter. Argumente mit einem Standardwert oder Argumente, die null sein können, sind jetzt beim Abgleich von Deeplinks optional. (b/133273839)
  • Sie können jetzt NavController.getBackStackEntry() aufrufen und die ID eines Ziels oder Navigationsgraphen im Back Stack übergeben. Der zurückgegebene NavBackStackEntry enthält neben den Argumenten, die zum Starten dieses Ziels verwendet wurden, auch ein navigationsgesteuertes LifecycleOwner, ViewModelStoreOwner (das gleiche, das von NavController.getViewModelStoreOwner() zurückgegeben wird) und SavedStateRegistryOwner. (aosp/1101691, aosp/1101710)

Diverse Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem das Hinzufügen eines NavHostFragment zu ViewPager2 mit einem IllegalArgumentException fehlschlug. (b/133640271)
  • NavInflater ruft getResourceName() jetzt nicht mehr unnötig auf, wodurch die Inflationszeit um bis zu 40 % verkürzt wird. (b/139213740)

Version 2.2.0-alpha01

7. August 2019

androidx.navigation:navigation-*:2.2.0-alpha01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Neue Funktionen

  • SavedStateViewModelFactory ist jetzt die Standard-Factory, wenn by navGraphViewModels() oder der ViewModelProvider-Konstruktor mit einem von NavController.getViewModelStoreOwner() zurückgegebenen ViewModelStoreOwner verwendet wird. (b/135716331)

API-Änderungen

Diverse Fehlerkorrekturen

  • NavHostFragment verwendet jetzt FragmentContainerView, wodurch Probleme mit der Z-Reihenfolge von Animationen und der Weiterleitung von Fenster-Insets an Fragmente behoben werden. (b/137310379)

Version 2.1.0

Version 2.1.0

5. September 2019

androidx.navigation:navigation-*:2.1.0 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Wichtige Änderungen seit Version 2.0.0

  • ViewModels auf einen Navigationsgraphen beschränken: Sie können jetzt ViewModels erstellen, die auf der Ebene des Navigationsgraphen beschränkt sind. Verwenden Sie dazu den Property-Delegaten by navGraphViewModels() für Kotlin-Nutzer, die die -ktx-Bibliotheken verwenden, oder die getViewModelStoreOwner() API, die zu NavController hinzugefügt wurde. Weitere Informationen finden Sie unter UI-bezogene Daten zwischen Zielen freigeben.
  • Dialogziele: Sie können jetzt <dialog>-Ziele erstellen, die ein DialogFragment anzeigen, wenn Sie sie navigate. NavHostFragment unterstützt standardmäßig Dialogziele. Weitere Informationen finden Sie unter Ziel aus einem DialogFragment erstellen.
  • Navigation per URI: Sie können jetzt mit einem Uri ein navigate ausführen. Dabei wird der <deepLink> verwendet, den Sie einem Ziel hinzugefügt haben, um dorthin zu navigieren. Weitere Informationen finden Sie unter Mit URI navigieren.
  • NavHostController: APIs, die speziell für die Erstellung eines benutzerdefinierten NavHost verwendet werden, wurden nach NavHostController verschoben. Dadurch können Implementierungen ihre NavController mit dem Hosting-LifecycleOwner, OnBackPressedDispatcher und ViewModelStore verbinden.

Version 2.1.0-rc01

7. August 2019

androidx.navigation:navigation-*:2.1.0-rc01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

API-Änderungen

  • Die verworfene getViewModelStore() API auf NavController, die in 2.1.0-alpha02 eingeführt wurde, wurde entfernt. (aosp/1091021)

Version 2.1.0-beta02

19. Juli 2019

androidx.navigation:*:2.1.0-beta02 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Diverse Fehlerkorrekturen

  • Unbeabsichtigte jacoco-Abhängigkeit entfernt, die in 2.1.0-beta01 eingeführt wurde. (b/137782950)

Version 2.1.0-beta01

17. Juli 2019

androidx.navigation:*:2.1.0-beta01 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Neue Funktionen

  • NavigationUI animiert jetzt das Entfernen der Aufwärtsschaltfläche, wenn setupWithNavController() mit einem Toolbar oder CollapsingToolbarLayout verwendet wird. (b/131403621)

Diverse Fehlerkorrekturen

  • Ein Timing-Problem bei der Verwendung mehrerer NavHostFragments mit demselben Container mit findNavController() wurde behoben. (b/136021571)

Version 2.1.0-alpha06

2. Juli 2019

androidx.navigation:*:2.1.0-alpha06 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Neue Funktionen

  • Das von NavHostFragment verwendete Attribut app:navGraph wurde jetzt in das Artefakt navigation-runtime verschoben. Benutzerdefinierte Navigatoren, die über XML hinzugefügt werden können, sollten dieses Attribut verwenden, um die Integration in den Hostbereich des Navigationseditors zu ermöglichen. (b/133880955)

API-Änderungen

  • Die getViewModelStore() API auf NavController wurde zugunsten der neuen getViewModelStoreOwner()-Methode eingestellt, die eine ViewModelStoreOwner zurückgibt. (aosp/987010)
  • Die Implementierung von Zielen mit unverankerten Fenstern, z. B. <dialog>-Zielen, wurde in eine Markierungsschnittstelle (FloatingWindow) verallgemeinert, die jetzt von allen <dialog>-Zielen implementiert wird. NavigationUI-Methoden für die Interaktion mit der oberen App-Leiste ignorieren jetzt FloatingWindow-Ziele. (b/133600763)

Verhaltensänderungen

  • Die Navigation wird jetzt korrekt mit dem synchronisiert, was auf dem Bildschirm angezeigt wird, wenn ein <dialog>-Ziel verwendet wird. Daher werden in der Navigation jetzt automatisch <dialog>-Ziele entfernt, wenn Sie zu einem Ziel navigieren, das kein Dialogfeld und keine Aktivität ist, z. B. ein <fragment>-Ziel. (b/134089818)

Diverse Fehlerkorrekturen

  • In der Navigation wird jetzt die Animation unterdrückt, die beim Neuerstellen der Aktivität beim Verarbeiten eines Deeplinks auftritt. Dadurch wird ein visuelles Flackern behoben. (b/130362979)
  • Es wurde ein Fehler behoben, durch den der Back Stack der Navigation nicht mehr synchron war, wenn ein Fragment entfernt wurde, während das ursprüngliche Fragment hinzugefügt wurde. (b/133832218)

Version 2.1.0-alpha05

5. Juni 2019

androidx.navigation:*:2.1.0-alpha05 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

API-Änderungen

  • Hostbezogene APIs in NavController wurden umbenannt und in eine neue Unterklasse von NavController, NavHostController, verschoben. (aosp/966091)
  • Die Methode setHostOnBackPressedDispatcherOwner() von NavController wurde durch die Methode setOnBackPressedDispatcher() von NavHostController ersetzt. Jetzt muss setLifecycleOwner() vor dem Aufruf aufgerufen werden. (aosp/965409)
  • NavHostController enthält jetzt eine enableOnBackPressed(boolean)-Methode, die die NavHostOnBackPressedManager-Klasse ersetzt, die zuvor von setHostOnBackPressedDispatcherOwner() zurückgegeben wurde. (aosp/966091)

Diverse Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das der Back Stack nach der Navigation per URI nicht korrekt war. (b/132509387)
  • Deeplinks, die automatisch von NavController verarbeitet werden, werden jetzt nur einmal ausgelöst. (b/132754763)

Version 2.1.0-alpha04

16. Mai 2019

androidx.navigation:*:2.1.0-alpha04 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Diverse Fehlerkorrekturen

  • NavHostFragment berücksichtigt app:defaultNavHost korrekt, wenn Ereignisse des System-Buttons „Zurück“ abgefangen werden. Dadurch wird eine Regression in Navigation 2.1.0-alpha03 behoben. b/132077777
  • DialogFragmentNavigator verarbeitet jetzt popBackStack()- und navigateUp()-Vorgänge korrekt. b/132576764
  • Ein IllegalStateException: unknown destination during restore-Problem wurde behoben, das beim wiederholten Navigieren zwischen verschachtelten Graphen auftrat. b/131733658

Version 2.1.0-alpha03

7. Mai 2019

androidx.navigation:*:2.1.0-alpha03 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Bekannte Probleme

  • NavHostFragment fängt trotz Verwendung von app:defaultNavHost="false" weiterhin den System-Button „Zurück“ ab. b/132077777

Neue Funktionen

  • Du kannst jetzt <dialog> Ziele erstellen, für die ein DialogFragment angezeigt wird, wenn du sie navigate. NavHostFragment unterstützt standardmäßig Dialogziele. b/80267254
  • Zusätzlich zum Aufruf von navigate mit einer Ressourcen-ID oder einer NavDirections-Instanz kannst du jetzt über eine Uri navigieren, die die <deepLink> verwendet, die du einem Ziel hinzugefügt hast, um zum richtigen Ziel zu navigieren. b/110412864

Verhaltensänderungen

  • Die von NavigationUI bereitgestellten Standardanimationen wurden von 400 ms auf 220 ms beschleunigt, um der Standardanimationsgeschwindigkeit von Aktivitäten und Fragmenten zu entsprechen. b/130055522

API-Änderungen

  • Die Methode createFragmentNavigator() von NavHostFragment wurde eingestellt und ihre Funktionalität wurde in die neue Methode onCreateNavController() verschoben. So ist klarer, dass dies der richtige Einstiegspunkt ist, um benutzerdefinierte Navigatoren hinzuzufügen, wenn Sie eine Unterklasse von NavHostFragment erstellen. b/122802849
  • NavDestination wurde die Methode hasDeepLink() hinzugefügt, mit der Sie prüfen können, ob ein bestimmter Uri von diesem Ziel oder, im Fall von NavGraph, von einem beliebigen Ziel im Navigationsdiagramm verarbeitet werden kann. b/117437718

Diverse Fehlerkorrekturen

  • Standardargumente werden jetzt korrekt an OnDestinationChangedListener-Instanzen übergeben. b/130630686
  • NavHostFragment fängt jetzt System-Zurück-Ereignisse mit OnBackPressedDispatcher ab. Dadurch wird ein Problem behoben, das bei der bedingten Navigation in Fragment-Lebenszyklusmethoden bei der Rückkehr zu einem Fragment auftrat. b/111598096
  • Bei Safe Args wird ein android:defaultValue=”@null” mit einem nicht angegebenen app:argType jetzt korrekt als string-Argument abgeleitet. b/129629192

Version 2.1.0-alpha02

3. April 2019

androidx.navigation:*:2.1.0-alpha02 ist veröffentlicht. Die in dieser Version enthaltenen Commits finden Sie hier.

Neue Funktionen

  • Sie können jetzt ViewModels erstellen, die auf der Ebene des Navigationsgraphen über den Attributdelegierten by navGraphViewModels() für Kotlin-Nutzer oder über die getViewModelStore() API, die zu NavController hinzugefügt wurde, zugänglich sind. b/111614463

API-Änderungen

  • Sie können jetzt einem <activity>-Ziel ein app:targetPackage hinzufügen, um den übereinstimmenden Paketnamen einzuschränken. app:targetPackage="${applicationId}" wird unterstützt, um das Paket auf Ihre eigene Anwendungs-ID zu beschränken. b/110975456

Diverse Fehlerkorrekturen

  • Das android:name für <activity>-Ziele wird beim Aufblähen nicht mehr in eine Klasse geparst, um ClassNotFoundExceptions bei der Verwendung dynamischer Funktionen zu verhindern. b/124538597

Version 2.1.0-alpha01

19. März 2019

Dies ist die erste Alpha-Version von Navigation 2.1.0.

Änderungen an Abhängigkeiten

  • Die Navigation hängt jetzt von androidx.core:core:1.0.1 und androidx.fragment:fragment:1.1.0-alpha05 ab. In dieser Version wird auch die Abhängigkeit von androidx.legacy:legacy-support-core-utils:1.0.0 entfernt. b/128632612

API-Änderungen

  • Eine neue Navigation.createNavigateOnClickListener(NavDirections)-Methode wurde als Alternative zum Erstellen eines Klick-Listeners mit einer Ressourcen-ID und einem Bundle hinzugefügt. b/127631752
  • FragmentNavigator.instantiateFragment wurde eingestellt. Die Standardimplementierung verwendet jetzt FragmentFactory, um Fragmente zu instanziieren. b/119054429

Fehlerkorrekturen

  • Die Navigation sendet keinen Null-Bundle mehr, wenn Argumente an ein Ziel angehängt sind. Dadurch wird ein Problem bei der Verwendung von android:defaultValue="@null" behoben. b/128531879
  • Safe Args hängt jetzt von KotlinPoet 1.1.0 ab, wodurch ein Problem mit extrem langen Paketnamen behoben wird. b/123654948

Version 2.0.0

Version 2.0.0

14. März 2019

Die Navigation 2.0.0 wird ohne Änderungen gegenüber 2.0.0-rc02 veröffentlicht.

Version 2.0.0-rc02

6. März 2019

Navigation 2.0.0-rc02 bietet neue Artefakte mit der Gruppen-ID androidx.navigation und ändert die Abhängigkeiten in die AndroidX-Entsprechungen.

Das Verhalten von 2.0.0-rc02 ist mit dem Verhalten von Navigation 1.0.0-rc02 identisch. Für die Aktualisierung von 1.0.0-rc02 sind keine Änderungen an Ihrem Code erforderlich, außer dass Sie Ihre Abhängigkeiten an die neuen Abhängigkeiten anpassen müssen.

Ihr Projekt muss zu AndroidX migriert worden sein, damit Sie die 2.X-Releases der Navigation SDK verwenden können. Navigation 1.0 Stable ist die letzte Version, die die Support Library-Abhängigkeiten verwendet. Alle zukünftigen Entwicklungen nach Version 1.0 basieren auf AndroidX und auf der stabilen Version 2.0.

Abhängigkeiten vor AndroidX

Fügen Sie für die Navigation-Versionen vor AndroidX die folgenden Abhängigkeiten hinzu:

dependencies {
    def nav_version = "1.0.0"

    implementation "android.arch.navigation:navigation-fragment:$nav_version" // For Kotlin use navigation-fragment-ktx
    implementation "android.arch.navigation:navigation-ui:$nav_version" // For Kotlin use navigation-ui-ktx
}

Fügen Sie für Safe Args den folgenden classpath in die build.gradle-Datei auf der obersten Ebene ein:

buildscript {
    repositories {
        google()
    }
    dependencies {
        classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
    }
}

Version 1.0.0

Version 1.0.0

14. März 2019

Die Navigation 1.0.0 wird ohne Änderungen gegenüber 1.0.0-rc02 veröffentlicht.

Version 1.0.0-rc02

26. Februar 2019

Dies ist der zweite Releasekandidat für die stabile Version 1.0.0 von Navigation. Diese Version enthält eine Reihe von Fehlerkorrekturen.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem popBackStack() ignoriert wurde, wenn das Root-Diagramm keine ID hatte. b/126251695
  • navigateUp() verarbeitet jetzt die Rückkehr zur Aufgabe deiner App korrekt, wenn sie nach der Verarbeitung eines Deeplinks ohne FLAG_ACTIVITY_NEW_TASK aufgerufen wird. b/126082008
  • Ein Problem wurde behoben, bei dem ActivityNavigator.applyPopAnimationsToPendingTransition nicht die richtige Pop-Exit-Animation angewendet hat b/126237567
  • Kotlin-Code, der von Safe Args generiert wird, maskiert jetzt Kotlin-Schlüsselwörter wie in und fun im Paketnamen, der mit der Klasse R verknüpft ist. b/126020455

Version 1.0.0-rc01

21. Februar 2019

Dies ist ein Releasekandidat für die stabile Version 1.0.0 von Navigation. Diese Version enthält eine Fehlerkorrektur.

Fehlerkorrekturen

  • Problem bei der Verwendung von Fragmenten und singleTop-Navigationsvorgängen behoben b/124294805

Version 1.0.0-beta02

12. Februar 2019

Diese Version umfasst eine Reihe kleinerer Verbesserungen und wichtiger Fehlerkorrekturen.

Neue Funktionen

  • Sie können jetzt 0 als android:defaultValue für reference-Argumente verwenden. b/124248602

Verhaltensänderungen

  • Genaue Deeplink-Übereinstimmungen werden jetzt gegenüber Deeplinks mit .*- oder Argumentübereinstimmungen priorisiert. b/123969518

Fehlerkorrekturen

  • popBackStack() und navigateUp geben jetzt korrekt false zurück, wenn das letzte Ziel im Back Stack entfernt wird. Dadurch wird eine Regression behoben, die in 1.0.0-beta01 eingeführt wurde. b/123933201
  • Die Navigation legt jetzt beim Wiederherstellen des gespeicherten Instanzstatus die ClassLoader korrekt fest. Dadurch werden Probleme vermieden, wenn benutzerdefinierte Klassen im gespeicherten Status von Navigator oder in Argumenten verwendet werden, die an ein NavDestination gesendet werden. b/123893858
  • Von Safe Args generierte NavArgs-Klassen stürzen nicht mehr ab, wenn ein Parcelable[]-Argument aus dem gespeicherten Instanzstatus wiederhergestellt wird. b/123963545
  • Safe Args bereinigt jetzt unnötige generierte Kotlin-Klassen ordnungsgemäß. b/124120883

Version 1.0.0-beta01

4. Februar 2019

Dies ist die erste Betaversion der Navigation API. Es wird erwartet, dass die Navigation API bis zur nächsten Version stabil bleibt, sofern kein kritisches Problem auftritt. Diese Version enthält einige Fehlerkorrekturen und Verhaltensänderungen.

Verhaltensänderungen

  • Die Navigation sorgt jetzt dafür, dass Standardwerte für Argumente zur Laufzeit und über Safe Args identisch behandelt werden. Daher können nur Argumente mit einem app:argType="reference" einen Standardwert haben, der auf eine andere Ressource verweist (z. B. @color/colorPrimary). Wenn Sie versuchen, einen Referenzstandardwert mit einem anderen app:argType zu verwenden, wird beim Parsen der Navigations-XML eine Ausnahme ausgelöst. b/123551990
  • Safe Args hängt jetzt vom Android-Gradle-Plug-in 3.3.0 ab aosp/888413
  • Safe Args hängt jetzt von Kotlin 1.3.20 ab aosp/888414

Fehlerkorrekturen

  • Safe Args können jetzt in Bibliotheks- und Funktionsmodulen in allen Versionen des Android-Gradle-Plug-ins verwendet werden. b/121304903
  • Es wurde eine Regression behoben, die dazu führte, dass ein einzelner popBackStack()-Vorgang alle Kopien eines Ziels vom Back Stack entfernte, anstatt nur ein einzelnes Ziel auf einmal. b/123552990
  • Ein Problem wurde behoben, bei dem der Status von FragmentNavigator nicht mehr mit dem Status von NavController synchronisiert war, was beim Versuch, den Back Stack wiederherzustellen, zu einem IllegalStateException führte. b/123803044
  • Ein Problem wurde behoben, bei dem der von NavigationUI verarbeitete Zurückpfeil nicht angezeigt wurde, wenn ProGuard mit Obfuskation verwendet wurde. b/123449431
  • Der von Safe Args generierte Code verarbeitet jetzt ordnungsgemäß die Verwendung eines app:argType, das auf eine statische innere Klasse im Format .OuterClass$InnerClass verweist. b/123736741
  • Der von Safe Args generierte Java-Code verarbeitet jetzt globale Aktionen und tief verschachtelte Ziele ordnungsgemäß. b/123347762

Version 1.0.0-alpha11

23. Januar 2019

Dies ist ein Hotfix-Release von 1.0.0-alpha10, mit dem ein Problem mit Safe Args behoben wird.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem Safe Args die Directions-Klasse, die mit globalen Aktionen verknüpft ist, nicht importieren konnte. b/123307342

Version 1.0.0-alpha10

23. Januar 2019

Bekannte Probleme

  • Safe Args kann die mit globalen Aktionen verknüpfte Directions-Klasse nicht importieren. b/123307342

Diese Version enthält funktionsgefährdende API-Änderungen. Weitere Informationen finden Sie unten im Abschnitt Funktionsgefährdende Änderungen.

Neue Funktionen

  • Kotlin-Nutzer können jetzt den Property-Delegaten by navArgs() verwenden, um eine Referenz auf eine von Safe Args generierte NavArgs-Klasse in einer Activity oder einem Fragment abzurufen. b/122603367
  • Mit Safe Args können Sie jetzt Kotlin-Code generieren, indem Sie das Plug-in androidx.navigation.safeargs.kotlin anwenden. Der Kotlin-Code wurde speziell für reine Kotlin-Module entwickelt. Dabei werden Standardargumente und unveränderliche Klassen anstelle des Builder-Musters verwendet, das weiterhin über das vorherige androidx.navigation.safeargs-Plug-in verfügbar ist. b/110263087

Geändertes Verhalten

  • Übereinstimmende Deeplinks werden jetzt bevorzugt, wenn sie die meisten übereinstimmenden Argumente haben. b/118393029
  • Wenn setGraph() auf einem NavController aufgerufen wird, wird jetzt der Back Stack zurückgesetzt. b/111450672
  • Unbekannte Deeplinks lösen keine IllegalStateException mehr aus, sondern werden ignoriert. Dadurch werden Probleme mit verschachtelten oder mehreren NavHostFragments behoben. b/121340440

Funktionsgefährdende Änderungen

  • Die Methode NavOptions.applyPopAnimationsToPendingTransition() zum Anwenden von Pop-Animationen auf eine Aktivität wurde nach ActivityNavigator verschoben. b/122413117
  • Safe Args vermeidet jetzt das Duplizieren identischer Klassen für Aktionen ohne Argumente. Der Rückgabetyp für Methoden ohne Argumente in generierten NavDirections-Klassen ist jetzt NavDirections. b/123233147
  • Von Safe Args generierte Directions-Klassen haben keinen öffentlichen Konstruktor mehr. Sie sollten nur mit den generierten statischen Methoden interagieren. b/123031660
  • Von Safe Args generierte NavDirections-Klassen haben keinen öffentlichen Konstruktor mehr. Sie sollten nur über die statischen Methoden in den generierten Directions-Klassen generiert werden. b/122963206
  • Der zurückgegebene Bundle aus dem getArguments() von NavDirections wird jetzt als @NonNull und nicht mehr als @Nullable gekennzeichnet. b/123243957

Fehlerkorrekturen

  • NavDeepLinkBuilder verarbeitet jetzt mehrere gleichzeitige PendingIntents an dasselbe Ziel korrekt. Dazu werden die von Ihnen übergebenen Argumente verwendet, um die Eindeutigkeit zu bestimmen. b/120042732
  • NavController verarbeitet jetzt popBackStack()-Vorgänge korrekt, wenn ein verschachteltes NavHostFragment oder andere untergeordnete Fragmente mit einem Back Stack verwendet werden. b/122770335
  • NavigationUI legt jetzt die Inhaltsbeschreibung der Schaltfläche „Nach oben“ korrekt fest. b/120395362
  • Von Safe Args generierte Directions-Klassen verarbeiten jetzt globale Aktionen, die dieselbe ID wie eine Aktion für ein Ziel haben, korrekt. b/122962504
  • Von Safe Args generierte NavDirections-Klassen haben jetzt korrekte hashCode()-Werte, wenn equals() „true“ zurückgibt. b/123043662
  • FragmentNavigator gibt jetzt eine bessere Fehlermeldung aus, wenn Sie versuchen, benutzerdefinierte FragmentTransactions für die FragmentManager von NavHostFragment auszuführen. Sie sollten immer getChildFragmentManager() verwenden. b/112927148

Version 1.0.0-alpha09

18. Dezember 2018

Diese Version enthält funktionsgefährdende API-Änderungen. Weitere Informationen finden Sie unten im Abschnitt Funktionsgefährdende Änderungen.

Wir haben uns entschieden, das android.arch.navigation:navigation-testing-Artefakt nicht weiterzuentwickeln. Es hat sich zwar für interne Tests von NavController als hilfreich erwiesen, wir empfehlen jedoch dringend alternative Teststrategien, z. B. das Mocking der NavController-Instanz, um zu prüfen, ob die richtigen navigate()-Aufrufe ausgeführt werden. Dieser Ansatz wird im Vortrag zu Single Activity auf dem AndroidDevSummit 2018 ausführlich erläutert. Wir arbeiten an einer zusätzlichen Dokumentation, die sich speziell mit dem Testen mit Navigation befasst.

Neue Funktionen

  • Bei MenuItems mit menuCategory="secondary" wird der Back Stack nicht mehr entfernt, wenn sie mit NavigationUI-Methoden verwendet werden. b/120104424
  • Mit AppBarConfiguration können Sie jetzt eine Fallback-OnNavigateUpListener-Instanz festlegen, die aufgerufen wird, wenn navController.navigateUp() den Wert false zurückgibt. b/79993862 b/120690961

Funktionsgefährdende Änderungen

  • Wenn Sie einen <argument> mit einem argType="reference" verwenden, parst Navigation die Referenz nicht mehr, sondern stellt die Rohressourcen-ID selbst bereit. b/111736515
  • onNavDestinationSelected() kehrt jetzt standardmäßig zum Startziel des Navigationsdiagramms zurück, sodass sie mit den setup-Methoden konsistent sind. Fügen Sie menuCategory="secondary" zu MenuItem hinzu, um zu vermeiden, dass der Back Stack entfernt wird. aosp/852869
  • Die fromBundle()-Methoden der generierten Args-Klassen verwenden jetzt einen Nicht-Null-Bundle anstelle eines Null-Bundle. aosp/845616

Fehlerkorrekturen

  • Argumente werden jetzt korrekt aus Deeplinks als der richtige argType geparst, anstatt immer als Strings b/110273284
  • Navigation exportiert jetzt die öffentlichen Ressourcen korrekt b/121059552
  • Safe Args ist jetzt mit dem Android-Gradle-Plug-in 3.4 Canary 4 und höher kompatibel (b/119662045).

Version 1.0.0-alpha08

6. Dezember 2018

Diese Version enthält funktionsgefährdende API-Änderungen. Weitere Informationen finden Sie unten im Abschnitt Funktionsgefährdende Änderungen.

Neue Funktionen

  • Wenn Ziellabels mit NavigationUI-Methoden verwendet werden, werden {argName}-Instanzen in Ihrem android:label jetzt automatisch durch das richtige Argument ersetzt. b/80267266
  • Die Navigation hängt jetzt von der Support-Bibliothek 28.0.0 ab (b/120293333).

Funktionsgefährdende Änderungen

  • OnNavigatedListener wurde in OnDestinationChangedListener umbenannt b/118670572
  • OnDestinationChangedListener übergibt jetzt auch die Bundle von Argumenten. aosp/837142
  • Die Attribute app:clearTask und app:launchDocument sowie die zugehörigen Methoden wurden entfernt. Verwenden Sie app:popUpTo mit dem Stamm Ihres Graphen, um alle Ziele aus dem Back Stack zu entfernen. b/119628354
  • ActivityNavigator.Extras verwendet jetzt ein Builder-Muster und bietet die Möglichkeit, beliebige Intent.FLAG_ACTIVITY_-Flags festzulegen. aosp/828140
  • NavController.onHandleDeepLink wurde in handleDeepLink umbenannt. aosp/836063
  • Viele Klassen und Methoden, die nicht für die Erstellung von abgeleiteten Klassen vorgesehen sind, z. B. NavOptions, NavInflater, NavDeepLinkBuilder und AppBarConfiguration, wurden als final deklariert. aosp/835681
  • Die verworfene Methode NavHostFragment.setGraph() wurde entfernt aosp/835684
  • Die verworfene Methode NavigationUI.navigateUp(DrawerLayout, NavController) wurde entfernt. aosp/835684
  • Die Fragmenterstellung wurde nach FragmentNavigator verschoben, sodass die Fragmenterstellung einfacher an einen FragmentFactory delegiert werden kann. b/119054429
  • Der Konstruktor für NavGraphNavigator verwendet keinen Context mehr. aosp/835340
  • NavigatorProvider ist jetzt eine Klasse und keine Schnittstelle mehr. Die von getNavigatorProvider() zurückgegebene NavigatorProvider hat ihre Funktionalität nicht geändert. aosp/830660
  • NavDestination.navigate() wurde entfernt. Stattdessen navigate() auf Navigator aufrufen. aosp/830663
  • Umfangreiches Refactoring von Navigator, sodass OnNavigatorNavigatedListener nicht mehr erforderlich ist und stattdessen navigate die NavDestination zurückgibt, zu der navigiert wurde.
  • Navigator-Instanzen können keine Pop-Ereignisse mehr an NavController senden. Du kannst einen OnBackPressedCallback verwenden, um das Drücken des Buttons „Zurück“ abzufangen und navController.popBackStack() aufzurufen. aosp/833716

Fehlerkorrekturen

  • popUpTo funktioniert jetzt einheitlich, wenn das Ziel ein <navigation>-Element ist. b/116831650
  • Es wurden mehrere Fehler behoben, die bei der Verwendung verschachtelter Diagramme zu einem IllegalArgumentException führten. b/118713731 b/113611083 b/113346925 b/113305559
  • Das Attribut dataPattern von <activity>-Zielen füllt jetzt Argumente aus Nicht-String-Argumenten, indem toString() aufgerufen wird. b/120161365

Safe Args

  • Safe Args unterstützt serialisierbare Objekte, einschließlich Enum-Werte. Für Enum-Typen kann ein Standardwert festgelegt werden, indem das Enum-Literal ohne den Klassennamen verwendet wird (z. B. app:defaultValue="READ"). b/111316353
  • Safe Args unterstützt Arrays aller unterstützten Typen b/111487504
  • Safe Args ignoriert jetzt Unterordner von Ressourcenverzeichnissen b/117893516
  • Safe Args fügt gegebenenfalls @Override-Anmerkungen hinzu b/117145301

Version 1.0.0-alpha07

29. Oktober 2018

Neue Funktionen

Funktionsgefährdende Änderungen

  • Das Modul navigation-testing-ktx wurde in navigation-testing artifact integriert und wird nicht mehr veröffentlicht.
  • Das Artefakt navigation-testing ist jetzt von der Kotlin-Standardbibliothek abhängig. Die API wurde geändert, um besser mit Kotlin-Konventionen übereinzustimmen. Sie können sie aber weiterhin für in Java geschriebene Tests verwenden.
  • Im Metadatenmanifest registrierte Navigationsgraphen werden nicht mehr unterstützt. b/118355937
  • Aktionen können nicht mehr an <activity>-Ziele angehängt werden. aosp/785539

Fehlerkorrekturen

  • Deeplinks parsen jetzt Suchparameter korrekt. b/110057514
  • Bei Aktivitätszielen werden jetzt alle Ein- und Ausblendanimationen korrekt angewendet. b/117145284
  • Ein Absturz, der nach Konfigurationsänderungen bei Verwendung benutzerdefinierter Navigatoren auftritt, wurde behoben. b/110763345

Safe Args

  • Safe Args haben jetzt eine feste Abhängigkeit vom Android-Gradle-Plug-in 3.2.1. b/113167627
  • Wegbeschreibungen können jetzt für innere Klassen generiert werden. b/117407555
  • Ein Problem beim Generieren von Wegbeschreibungen zu einem <include>-Graphen wurde behoben. b/116542123

Version 1.0.0-alpha06

20. September 2018

Neue Funktionen

API-Änderungen

  • Funktionsgefährdende Änderung: Die Navigator-Methode navigate() verwendet jetzt den Parameter Navigator.Extras.
  • Die Methode getGraph() von NavController ist jetzt NonNull b/112243286

Fehlerkorrekturen

  • NavigationUI.setupWithNavController() gibt keine Ansichten mehr preis, wenn es mit Ansichten aus einzelnen Zielen verwendet wird b/111961977
  • Navigator onSaveState() wird jetzt nur noch einmal aufgerufen b/112627079

Safe Args

  • Die Directions-Klassen für Navigationsziele erweitern jetzt die Directions-Klasse des übergeordneten Elements, falls vorhanden b/79871405
  • Die Klassen „Directions“ und „Args“ haben jetzt eine nützliche toString()-Implementierung b/111843389

Version 1.0.0-alpha05

10. August 2018

Fehlerkorrekturen

  • Ein Fehler wurde behoben, der zu einem fehlerhaften Backstack-Verhalten führte. b/111907708
  • Fehler in equals() der generierten Args-Klassen behoben. b/111450897
  • Ein Build-Fehler in Safe Args wurde behoben. b/109409713
  • Fehler bei der Konvertierung von Ressourcenkennungen in Java-Namen behoben b/111602491
  • Fehlermeldungen zur Null-Zulässigkeit im Safe Args-Plug-in wurden behoben.
  • Fehlende Null-Zulässigkeits-Annotationen hinzufügen.

Version 1.0.0-alpha04

19. Juli 2018

Navigation 1.0.0-alpha04 und das zugehörige Gradle-Plug-in „Safe Args“ enthalten eine Reihe von API-Änderungen, Verhaltensänderungen und Fehlerkorrekturen.

API-/Verhaltensänderungen

  • NavHostFragment legt das aktuelle Fragment immer als primäres Navigationsfragment fest. Dadurch wird sichergestellt, dass untergeordnete Fragmentmanager vor dem äußeren NavController entfernt werden b/111345778

Safe Args

  • Funktionsgefährdende Änderung: app:type wurde in app:argType geändert, um Konflikte mit anderen Bibliotheken wie ConstraintLayout 2.0.0-alpha1 zu vermeiden. b/111110548
  • Fehlermeldungen von Safe Args sind jetzt anklickbar b/111534438
  • Args-Klassen bestätigen jetzt, dass NonNull-Attribute tatsächlich nicht null sind b/111451769
  • Den generierten Klassen „NavDirections“ und „Args“ wurden zusätzliche NonNull-Annotationen hinzugefügt b/111455455 b/111455456

Fehlerkorrekturen

  • Ein Problem mit dem Button „Zurück“ des Systems nach dem Deeplinking zu einem Fragmentziel wurde behoben b/111515685

Version 1.0.0-alpha03

12. Juli 2018

Navigation 1.0.0-alpha03 und das zugehörige Gradle-Plug-in „Safe Args“ enthalten eine Reihe von API-Änderungen, Verhaltensänderungen und Fehlerkorrekturen.

API-/Verhaltensänderungen

  • Eine NavigationUI.setupWithNavController-Methode für die Symbolleiste wurde hinzugefügt b/109868820
  • Eine NavigationUI.setupWithNavController-Methode für CollapsingToolbarLayout wurde hinzugefügt b/110887183
  • „popBackStack()“ gibt jetzt „false“ zurück, wenn der Back Stack leer ist oder die angegebene Ziel-ID nicht im Back Stack enthalten ist b/110893637
  • FragmentNavigator ignoriert jetzt Navigationsvorgänge, nachdem FragmentManager den Status gespeichert hat. Dadurch werden „Can not perform this action after onSaveInstanceState“-Ausnahmen vermieden b/110987825

Safe Args

  • Funktionsgefährdende Änderung: Nicht alphanumerische Zeichen in Aktions- und Argumentnamen werden in den entsprechenden NavDirections-Methodennamen durch Camel-Case-Schreibweise ersetzt.
    • Beispiel: DemoController.index wird zu setDemoControllerIndex b/79995048
    • Beispiel: action_show_settings wird zu actionShowSettings b/79642240
  • Funktionsgefährdende Änderung: Argumente werden jetzt standardmäßig als nicht null betrachtet. Um Nullwerte für String- und Parcelable-Argumente zuzulassen, fügen Sie app:nullable="true" hinzu. b/79642307
  • Sie können jetzt app:type="long" mit defaultValues im Format „123L“ verwenden. b/79563966
  • Parcelable-Argumente werden jetzt unterstützt, wobei ein vollständig qualifizierter Klassenname für app:type verwendet wird. Der einzige unterstützte Standardwert ist "@null" b/79563966
  • Args-Klassen implementieren jetzt equals() und hashCode() b/79642246
  • Das Safe Args-Plug-in kann jetzt auf Bibliotheksprojekte angewendet werden b/80036553
  • Das Safe Args-Plug-in kann jetzt auf Feature-Projekte angewendet werden b/110011752

Fehlerkorrekturen

  • Probleme bei der Navigation während Fragment-Lebenszyklusmethoden behoben b/109916080
  • Probleme beim mehrmaligen Navigieren durch verschachtelte Diagramme wurden behoben b/110178671
  • Probleme bei der Verwendung von setPopUpTo mit dem ersten Ziel im Diagramm wurden behoben b/109909461
  • Ein Problem wurde behoben, bei dem alle app:defaultValue-Werte als Strings übergeben wurden b/110710788
  • Das mit dem Android-Gradle-Plug-in 3.2 Beta 01 gebündelte aapt2 fügt jetzt Beibehaltungsregeln für jedes android:name-Attribut in Navigations-XML-Dateien hinzu b/79874119
  • Speicherleck beim Ersetzen des Standard-FragmentNavigators behoben b/110900142

Version 1.0.0-alpha02

7. Juni 2018

Geändertes Verhalten

  • FragmentNavigator verwendet jetzt setReorderingAllowed(true). b/109826220

  • Die Navigation decodiert jetzt Argumente, die aus Deeplink-URLs geparst wurden, mit URLDecode. b/79982454

Fehlerkorrekturen

  • Ein IllegalStateException beim Aufrufen von „navigate“ aus Fragment-Lebenszyklusmethoden wurde behoben. b/79632233

  • Die Navigation hängt jetzt von der Support-Bibliothek 27.1.1 ab, um das Flackern bei der Verwendung von Animationen zu beheben. b/80160903

  • Ein IllegalArgumentException bei Verwendung von defaultNavHost="true" als untergeordnetes Fragment wurde behoben. b/79656847

  • Ein StackOverflowError bei Verwendung von NavDeepLinkBuilder wurde behoben. b/109653065

  • Ein IllegalArgumentException-Fehler beim Zurücknavigieren zu einem verschachtelten Diagramm wurde behoben. b/80453447

  • Ein Problem mit überlappenden Fragmenten bei Verwendung von launchSingleTop wurde behoben. b/79407969

  • Die Navigation erstellt jetzt den richtigen synthetischen Backstack für verschachtelte Graphen. b/79734195

  • NavigationUI hebt jetzt das richtige Element hervor, wenn ein verschachtelter Graph als MenuItem verwendet wird. b/109675998

API-Änderungen

  • Das Attribut clearTask für Aktionen und die zugehörige API in NavOptions wurden verworfen. b/80338878

  • Das Attribut launchDocument für Aktionen und die zugehörige API in NavOptions wurden verworfen. b/109806636

Version 1.0.0-alpha01

8. Mai 2018

Navigation bietet ein Framework zum Erstellen der In-App-Navigation. Diese erste Version ist 1.0.0-alpha01.