Nawigacja

Nawigacja to platforma do poruszania się między „miejscami docelowymi” w aplikacji na Androida, która udostępnia spójny interfejs API niezależnie od tego, czy miejsca docelowe są implementowane jako fragmenty, aktywności czy inne komponenty.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
23 września 2026 r. 2.10.2 - - -

Deklarowanie zależności

Aby dodać zależność od nawigacji, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

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

Aby dodać do projektu Safe Args, w pliku najwyższego poziomu build.gradle umieść ten kod:classpath

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")
    }
}

Musisz też zastosować jedną z 2 dostępnych wtyczek.

Aby wygenerować kod w języku Java odpowiedni dla modułów Java lub mieszanych modułów Java i Kotlin, dodaj ten wiersz do pliku build.gradle aplikacji lub modułu:

Groovy

plugins {
  id 'androidx.navigation.safeargs'
}

Kotlin

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

Aby wygenerować kod w języku Kotlin odpowiedni dla modułów tylko w tym języku, dodaj:

Groovy

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

Kotlin

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

W pliku gradle.properties musisz mieć android.useAndroidX=true zgodnie z informacjami w artykule Migracja do AndroidaX.

Informacje o korzystaniu z rozszerzeń Kotlin znajdziesz w dokumentacji ktx.

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Przed utworzeniem nowego problemu zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 2.10.2

23 września 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.2 Wersja 2.10.2 zawiera te zatwierdzenia.

Aktualizacje zależności

  • Zaktualizowano zależności androidx.lifecycle do wersji 2.10.0. I4505a9f9a

Wersja 2.10.1

9 września 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.1 Wersja 2.10.1 zawiera te zatwierdzenia.

Poprawki błędów

  • W przypadkach, gdy NavHost pomija animacje, będzie teraz również uwzględniać sizeTransform jako część pominiętej animacji, aby zapobiec nieoczekiwanemu przycinaniu. (I4f995, b/550924680)

Wersja 2.10.0

26 sierpnia 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0 Wersja 2.10.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.9.0:

  • NavHost udostępnia teraz przeciążenie, które akceptuje parametry predictivePopEnterTransition i predictivePopExitTransition, aby umożliwić niestandardowe przejście podczas gestu przewidywanego przejścia wstecz.
  • Plik handleDeepLink został zmodyfikowany, aby zapewnić obsługę tylko rozpoznanych precyzyjnych linków, a wszystkie pozostałe będą ignorowane. Jeśli powoduje to błąd w aplikacji, rozważ przejście na nawigację za pomocą precyzyjnych linków zdefiniowanych w wykresie nawigacji. W przypadku testów Robolectric może być konieczne użycie metody setPackage w odniesieniu do zaufanego pakietu.
  • Dodano NavBackStackEntryInfo, aby udostępniać migawki stosu wstecznego podczas zdarzeń nawigacji. Umożliwia to tworzenie bardziej rozbudowanych niestandardowych animacji przewidywanego przejścia wstecz.

Obsługa dodatkowych platform

  • Moduły navigation-common, navigation-runtime i navigation-testing obsługują teraz te języki: desktop, linux, macOS, iOS, javascript, WASM, watchos i tvos.

Wersja 2.10.0-rc01

12 sierpnia 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-rc01 Wersja 2.10.0-rc01 zawiera te zatwierdzenia.

Zmiany w działaniu

  • Minimalna wersja pakietu SDK do nawigacji została przeniesiona do interfejsu API 24 wraz z pozostałymi bibliotekami AndroidX. (I972da, b/474169350)

Wersja 2.10.0-beta01

29 lipca 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-beta01 Wersja 2.10.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Wprowadź NavBackStackEntryInfo, aby udostępniać zrzuty stosu wstecznego podczas zdarzeń nawigacji. Umożliwia to tworzenie bardziej rozbudowanych, niestandardowych animacji przewidywanego przejścia wstecz. (Icb3b8)

Wersja 2.10.0-alpha06

1 lipca 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-alpha06 Wersja 2.10.0-alpha06 zawiera te zatwierdzenia.

Poprawki błędów

  • Zmodyfikowano handleDeepLink, aby zapewnić obsługę tylko rozpoznanych precyzyjnych linków (Id4fe3, b/509640056)
  • Zmieniono ComposableFragment, aby używać pełnej i jednoznacznej nazwy z miejsca docelowego zamiast argumentu fragmentu do rozwijania funkcji typu „composable”. (I65ded, b/509640586)
  • Naprawiliśmy błąd w FragmentNavigator, który powodował, że prawidłowe fragmenty zgłaszały błąd IllegalArgumentException, gdy operacje były optymalizowane. (I093b0, b/340202276)
  • Naprawiliśmy błąd w nawigacji z użyciem fragmentów, który powodował, że ustawienie wykresu w sposób zautomatyzowany nie było prawidłowo przywracane. (I41251, b/321147435)

Wersja 2.10.0-alpha05

19 maja 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-alpha05 Wersja 2.10.0-alpha05 zawiera te zatwierdzenia.

Wersja 2.10.0-alpha04

6 maja 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-alpha04 Wersja 2.10.0-alpha04 zawiera te zatwierdzenia.

Poprawki błędów

  • Ulepszono NavHost, aby zapobiegać możliwym NullPointerException spowodowanym przez sytuację wyścigu z przewidywanym przejściem wstecz. (Ie36c6, b/500945998)

Wersja 2.10.0-alpha03

22 kwietnia 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-alpha03 Wersja 2.10.0-alpha03 zawiera te zatwierdzenia.

Poprawki błędów

  • Zaktualizowano Compose compileSdk do interfejsu API 37. Oznacza to, że w przypadku korzystania z Compose wymagana jest wersja AGP 9.2.0 lub nowsza. (Id45cd, b/413674743)

Zewnętrzny wkład

  • Cele watchos i tvos dodane do modułów navigation-common, navigation-runtime i navigation-testing (I60e46)
  • Ustaw DefaultNavTransitions jako publiczny (Ide293)

Wersja 2.10.0-alpha02

25 marca 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-alpha02 Wersja 2.10.0-alpha02 zawiera te zatwierdzenia.

Wersja 2.10.0-alpha01

11 marca 2026 r.

Publikacja androidx.navigation:navigation-*:2.10.0-alpha01 Wersja 2.10.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • NavHost udostępnia teraz przeciążenie, które akceptuje parametry predictivePopEnterTransition i predictivePopExitTransition, aby umożliwić niestandardowe przejście podczas gestu przewidywanego przejścia wstecz. (Iac9b0, b/478294569)

Aktualizacja minimalnej wersji pakietu SDK

  • Domyślna wartość minSdk została zmieniona z interfejsu API na poziomie 21 na interfejs API na poziomie 23, podobnie jak w przypadku pozostałych bibliotek AndroidX. (Ibdfca, b/380448311, b/435705964, b/435705223)

Zewnętrzny wkład

  • navigation:navigation-common, navigation:navigation-runtime i navigation:navigation-testing obsługują teraz oprócz Androida także komputery, systemy Linux, macOS i iOS oraz JavaScript i WASM. Dziękujemy Konstantinowi Tskhovrebovowi (I035d9, Iec624, I1615d).

Wersja 2.9

Wersja 2.9.8

22 kwietnia 2026 r.

Publikacja androidx.navigation:navigation-*:2.9.8 Wersja 2.9.8 zawiera te zatwierdzenia.

Poprawki błędów

  • Ulepszono NavHost, aby zapobiegać możliwym NullPointerException spowodowanym przez sytuację wyścigu z przewidywanym przejściem wstecz. (Ie36c6, b/500945998)

Wersja 2.9.7

28 stycznia 2026 r.

Publikacja androidx.navigation:navigation-*:2.9.7 Wersja 2.9.7 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja SafeArgs nie ma już problemów z buforowaniem konfiguracji podczas korzystania z usług Google. (I57cda, b/458071608)
  • Naprawiliśmy błąd, który powodował, że konstruktor testowy SavedStateHandle w navigation-testing nie dekodował List<String>. (I26aac,b/454180135)

Wersja 2.9.6

5 listopada 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.6 Wersja 2.9.6 zawiera te zatwierdzenia.

Poprawki błędów

  • Wtyczka Navigation SafeArgs została przeniesiona do nowoczesnych interfejsów API wtyczki Androida do obsługi Gradle, co powinno zapewnić jej zgodność ze wszystkimi wersjami AGP 8.4.2 lub nowszymi. W wyniku tych zmian katalog wyjściowy generowania plików przez wtyczkę został zmieniony na domyślną lokalizację udostępnianą przez AGP. (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197)
  • Wtyczka Navigation SafeArgs nie będzie już wymagać ustawienia właściwości useAndroidX, gdy będzie używana z AGP 9.0.0-alpha04+. (I6c3a4, b/444746731, b/443106400)

Wersja 2.9.5

24 września 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.5 Wersja 2.9.5 zawiera te zatwierdzenia.

Poprawki błędów

  • Navigation Safe Args może teraz obsługiwać wbudowany język Kotlin we wtyczce Androida do obsługi Gradle 9.0. (I1d9d76)

Aktualizacja zależności

  • Wtyczka Navigation Safe Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 8.4.2. (b/431847270, I5932a)

Wersja 2.9.4

10 września 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.4 Wersja 2.9.4 zawiera te zatwierdzenia.

Poprawki błędów

  • Zapobieganie awarii, gdy zdarzenie przewidywanego przejścia wstecz jest dostarczane w połowie klatki po wyłączeniu modułu obsługi w ramach przejścia NavHost. (I5667c, b/384186542)

Wersja 2.9.3

30 lipca 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.3 Wersja 2.9.3 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd w NavController, który powodował ConcurrentModificationException podczas korzystania z OnDestinationChangedListeners. (If7406, b/417784831)
  • Naprawiliśmy błąd, który powodował, że podczas używania navigate(uri, navOptions,navigationExtras) dodatki były ignorowane. (I67fb7, b/430336813)

Wersja 2.9.2

16 lipca 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.2 Wersja 2.9.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem polegający na tym, że wpis nie był wznawiany po zamknięciu okna nad nim (Idb20e, b/418746335).
  • Naprawiono błąd MissingFieldException podczas testowania SavedStateHandle z trasami z zabezpieczeniami wpisywania przy użyciu niestandardowego NavTypes. (I2f843, b/421002511)

Wersja 2.9.1

2 lipca 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.1 Wersja 2.9.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że NavEntries utworzone za pomocą trybu singleTop nigdy nie przekraczały stanu CREATED w Lifecycle.State. (I043ba, b/421095236)

Wersja 2.9.0

7 maja 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0 Wersja 2.9.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.8.0

  • Działania Navigation Safe Args są teraz generowane z adnotacją @CheckResult, aby zapewnić ich użycie.

Interfejs SupportingPane

  • Niestandardowe nawigatory mogą teraz oznaczać swoje miejsca docelowe jako implementujące interfejs SupportingPane, co wskazuje NavController, że te miejsca docelowe będą wyświetlane obok innych. Dzięki temu interfejsowi można na przykład RESUMED wiele miejsc docelowych jednocześnie.

Compose Kotlin Multiplatform

  • Nawigacja oferuje teraz nową, wspólną funkcję NavController.handleDeepLink(), która przyjmuje NavDeepLinkRequest zamiast Intent. Dzięki temu platformy inne niż Android mogą prawidłowo obsługiwać precyzyjne linki. Dziękujemy, Konstantin Tskhovrebov!
  • Nawigacja oferuje teraz NavUri, nową wspólną funkcję parsera, która jest zgodnym interfejsem API dla identyfikatora URI Androida na innych platformach. Dzięki temu można utworzyć identyfikator URI w sposób niezależny od platformy. Dziękujemy, Konstantin Tskhovrebov!

Funkcje bezpieczne pod względem typów

  • Interfejsy API z zabezpieczeniami wpisywania, które wcześniej były dostępne tylko za pomocą metod reified, czyli composable<YourScreen> mają teraz wersje bez reifikacji, które bezpośrednio przyjmują instancję KClass.
  • Zabezpieczenia wpisywania w nawigacji obsługują teraz klasy wartości jako trasę lub typ argumentu trasy.

Wersja 2.9.0-rc01

23 kwietnia 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-rc01 Wersja 2.9.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Usunęliśmy z komponentu Jetpack Navigation wszystkie platformy docelowe inne niż platforma Androida, ponieważ nie działają one prawidłowo. Zamiast tego są teraz dostępne kody pośredniczące dla różnych platform (I2877d).

Wersja 2.9.0-beta01

9 kwietnia 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-beta01 Wersja 2.9.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Wspólny interfejs API parseStringAsNavUri został zmieniony na funkcję fabryczną NavUri, która przyjmuje ciąg znaków. (I4db6e, b/403616316)

Aktualizacje zależności

  • Ta biblioteka jest teraz kierowana na poziom języka Kotlin 2.0 i wymaga KGP w wersji 2.0.0 lub nowszej. (Idb6b5)

Wersja 2.9.0-alpha09

26 marca 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha09 Wersja 2.9.0-alpha09 zawiera te zatwierdzenia.

Nowe funkcje

  • Moduł navigation-testing obsługuje teraz komputery, systemy Linux, macOS i iOS, a także Androida. (I2b770, b/398265336)
  • Funkcja NavType jest teraz obsługiwana na komputerach, urządzeniach z systemem Linux, macOS i iOS, a także na urządzeniach z Androidem. (I297d8)

Wersja 2.9.0-alpha08

12 marca 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha08 Wersja 2.9.0-alpha08 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja 2.8.9: naprawiliśmy regresję wykrytą w Nawigacji 2.8.8, która wymagała, aby precyzyjny link dokładnie pasował do wszystkich pól żądania lub intencji precyzyjnego linku, aby został uznany za dopasowanie. Spowodowało to, że precyzyjne linki, które zawierały częściowe dopasowania pól i nie miały innych, przestały działać. (Ie5e36, b/399826566)

Zewnętrzny wkład

  • Nowa funkcja wspólnego parsera do tworzenia NavUri. Dziękujemy, Konstantin Tskhovrebov! (If0a6a)

Wersja 2.9.0-alpha07

26 lutego 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha07 Wersja 2.9.0-alpha07 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że próba wykonania operacji saveState z niepełnym wyskakującym okienkiem powodowała zwrócenie wartości null w savedState, co mogło powodować awarię podczas przywracania. (I9f3e8, b/395091644)
  • Od wersji Navigation 2.8.8: naprawiono dopasowywanie NavDeepLink, w którym precyzyjny link i żądanie precyzyjnego linku muszą dokładnie pasować do identyfikatora URI, działania i typu MIME. Dopasowanie nie jest już dozwolone, jeśli pasują tylko 1 lub 2 pola. (I3b029, b/395712033)
  • Od wersji Navigation 2.8.8: naprawiliśmy błąd, który powodował, że trasy ze ścieżkami z symbolem wieloznacznym nie pasowały do dodanego precyzyjnego linku (I7ea92, b/389970341).

Zewnętrzny wkład

  • Wyodrębnij interfejsy API navigation-common, navigation-runtime i navigation-compose do wspólnej platformy. Dziękujemy, Konstantin Tskhovrebov! (I1e626, Ica76f, Idf479)

Znane problemy

  • Ze względu na prace związane z rozwiązaniem problemu b/395712033 precyzyjne linki nieprawidłowo wymagają wszystkich tych samych pól co żądanie precyzyjnego linku lub Intent. Precyzyjne linki powinny być dopasowywane tylko do pól, które zawierają, a pola, które nie są uwzględnione, powinny być ignorowane. Ten problem został rozwiązany w późniejszej wersji w ramach b/399826566.

Wersja 2.9.0-alpha06

12 lutego 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha06 Wersja 2.9.0-alpha06 zawiera te zatwierdzenia.

Nowe funkcje

  • Działania Navigation Safe Args są teraz generowane z adnotacją @CheckResult, aby zapewnić ich użycie. (I14d4c, b/356323084)

Poprawki błędów

  • Naprawiliśmy błąd w NavController, który powodował, że stany backStack były nieprawidłowo przywracane do tablicy, gdy były zapisywane na liście. (Idfb9b)
  • Nawigacja 2.8.7: Navigation Safe Args obsługuje teraz miejsca docelowe funkcji kompozycyjnych. (I35320, b/362791955)

Wersja 2.9.0-alpha05

29 stycznia 2025 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha05 Wersja 2.9.0-alpha05 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował nieoczekiwaną animację skalowania podczas korzystania z Navigation Compose. (I480f4, b/353294030)
  • Z Nawigacji 2.8.6: etykiety NavDestination podane w kodzie XML będą analizowane przez NavType.get, aby zapewnić przestrzeganie niestandardowej logiki NavType. (I7ec2f, b/388100796)
  • Z Navigation 2.8.6: podczas przechodzenia do aktywności za pomocą dataPattern ActivityNavigator będzie teraz próbować zakodować wartość argumentu za pomocą NavType argumentu. (I16376, b/383616432)
  • Nawigacja 2.8.5: rozwiązaliśmy problem, który powodował nieoczekiwaną animację skalowania podczas korzystania z Navigation Compose i wywoływania nawigacji w tej samej klatce, w której kończy się bieżąca animacja. (I26cb1, b/353294030)

Wersja 2.9.0-alpha04

11 grudnia 2024 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha04 Wersja 2.9.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

W tabeli poniżej znajdziesz interfejsy API reified i KClass.

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)

Zmiany w interfejsie API

  • Przeciążenie NavGraph.setStartDestination dla zabezpieczeń wpisywania w języku Kotlin jest ukryte w źródłach Javy. (Ic640c, b/364634035)

Poprawki błędów

  • Navigation 2.8.5: rozwiązaliśmy problem, który powodował, że NavHost mógł zgłaszać wyjątek w PredictiveBackHandler, jeśli stos wsteczny został zmniejszony do 1 wpisu, a w tej samej klatce został wywołany systemowy przycisk wstecz. (I1a429, b/375343407)
  • Nawigacja 2.8.5: naprawiono błąd NavDestination NullPointerException podczas aktualizowania startDestination wykresu. (I99421, b/361560785)

Zewnętrzny wkład

Wersja 2.9.0-alpha03

13 listopada 2024 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha03 Wersja 2.9.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Zabezpieczenia wpisywania w nawigacji obsługują teraz klasy wartości jako trasę lub typ argumentu trasy. (I9344a, b/374347483)

Poprawki błędów

  • Naprawiliśmy błąd (ConcurrentModificationException), który mógł wystąpić, gdy element LifecycleObserver dołączony do elementu NavBackStackEntry wywoływał zmianę stosu wstecznego, gdy host LifecycleOwner, taki jak zawierająca go aktywność lub fragment, zmieniał stan cyklu życia. (Ia9494)

Wersja 2.9.0-alpha02

30 października 2024 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha02 Wersja 2.9.0-alpha02 zawiera te zatwierdzenia.

Zewnętrzny wkład

  • Nowa metoda NavController.handleDeepLink(request: NavDeepLinkRequest). Dziękujemy, Konstantin Tskhovrebov! (I3e228)

Wersja 2.9.0-alpha01

16 października 2024 r.

Publikacja androidx.navigation:navigation-*:2.9.0-alpha01 Wersja 2.9.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Niestandardowe nawigatory mogą teraz oznaczać swoje miejsca docelowe jako implementujące interfejs SupportingPane, co wskazuje NavController, że te miejsca docelowe będą wyświetlane obok innych. Dzięki temu interfejsowi można na przykład RESUMED wiele miejsc docelowych jednocześnie. (Id5559)
  • Nawigacja 2.8.3: dodaliśmy nowe testy lint dla modułów navigation-common, navigation-runtime i navigation-compose, aby ułatwić identyfikowanie tras bezpiecznych pod względem typów, które nie są prawidłowo oznaczone adnotacją @Serializable. Ta kontrola jest stosowana do wszystkich funkcji rozszerzeń NavGraphBuilder i NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Z Navigation 2.8.3: dodano nowe testy Lint dla modułów navigation-common, navigation-runtime i navigation-compose, aby ułatwić identyfikowanie tras bezpiecznych pod względem typów z argumentami Enum, które nie są prawidłowo oznaczone adnotacją @Keep. Ta kontrola jest stosowana do wszystkich funkcji rozszerzeń NavGraphBuilder i NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Zmiany w zachowaniu

  • Próba użycia NavController, który został wcześniej DESTROYED, spowoduje teraz błąd IllegalStateException. (I520da, b/369616172)

Poprawki błędów

  • Zaktualizowano wyjątek „Nie znaleziono klasy Enum”, aby sugerować użycie adnotacji @Keep w przypadku usunięcia klasy Enum w zminimalizowanych kompilacjach. (I90e79, b/358137294)

Znane problemy

  • Występuje problem z nowymi regułami analizy kodu dodanymi w wersji Navigation 2.8.*, który powoduje błąd Obsolete custom lint check podczas próby uruchomienia analizy kodu za pomocą wtyczki Androida do obsługi Gradle w wersji 8.4 lub nowszej (b/368070326, b/371463741).

Wersja 2.8

Wersja 2.8.9

12 marca 2025 r.

Publikacja androidx.navigation:navigation-*:2.8.9 Wersja 2.8.9 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd regresji wykryty w Navigation 2.8.8, który wymagał, aby precyzyjny link dokładnie pasował do wszystkich pól żądania lub intencji precyzyjnego linku, aby został uznany za dopasowanie. Spowodowało to, że precyzyjne linki, które zawierały częściowe dopasowania pól i nie miały innych, przestały działać. (Ie5e36, b/399826566)

Wersja 2.8.8

26 lutego 2025 r.

Publikacja androidx.navigation:navigation-*:2.8.8 Wersja 2.8.8 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że trasy ze ścieżkami ze znakami wieloznacznymi nie pasowały do dodanego precyzyjnego linku. (I7ea92, b/389970341)
  • Naprawiono dopasowywanie NavDeepLink, w którym precyzyjny link i żądanie precyzyjnego linku muszą dokładnie pasować do identyfikatora URI, działania i typu MIME. Dopasowanie nie jest już dozwolone, jeśli pasują tylko 1 lub 2 pola. (I3227f, b/395712033)

Znane problemy

  • Ze względu na prace związane z rozwiązaniem problemu b/395712033 precyzyjne linki nieprawidłowo wymagają wszystkich tych samych pól co żądanie precyzyjnego linku lub Intent. Precyzyjne linki powinny być dopasowywane tylko do pól, które zawierają, a pola, które nie są uwzględnione, powinny być ignorowane. Ten problem został rozwiązany w późniejszej wersji w ramach b/399826566.

Wersja 2.8.7

12 lutego 2025 r.

Publikacja androidx.navigation:navigation-*:2.8.7 Wersja 2.8.7 zawiera te zatwierdzenia.

Poprawki błędów

  • Navigation Safe Args obsługuje teraz miejsca docelowe funkcji kompozycyjnych. (I35320, b/362791955)

Wersja 2.8.6

29 stycznia 2025 r.

Publikacja androidx.navigation:navigation-*:2.8.6 Wersja 2.8.6 zawiera te zatwierdzenia.

Poprawki błędów

  • Etykiety NavDestination podane w pliku XML zostaną przeanalizowane przez NavType.get, aby zapewnić przestrzeganie niestandardowej logiki NavType. (Id366d, b/388100796)
  • Podczas przechodzenia do aktywności za pomocą dataPattern ActivityNavigator będzie teraz próbować zakodować wartość argumentu za pomocą NavType argumentu. (I1a71d, b/383616432)

Wersja 2.8.5

11 grudnia 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.5 Wersja 2.8.5 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że NavHost mogło zgłaszać wyjątek w PredictiveBackHandler, jeśli stos wsteczny został zmniejszony do 1 wpisu, a w tej samej klatce został wywołany systemowy przycisk Wstecz. (I1a429, b/375343407)
  • Naprawiono błąd NavDestination NullPointerException podczas aktualizowania startDestination wykresu. (I99421, b/361560785)
  • Rozwiązaliśmy problem, który powodował nieoczekiwaną animację skalowania podczas korzystania z Navigation Compose i wywoływania nawigacji w tej samej klatce, w której kończy się bieżąca animacja. (I26cb1, b/353294030)
  • Naprawiliśmy błąd (ConcurrentModificationException), który mógł wystąpić, gdy element LifecycleObserver dołączony do elementu NavBackStackEntry wywoływał zmianę stosu wstecznego, gdy host LifecycleOwner, taki jak zawierająca go aktywność lub fragment, zmieniał stan cyklu życia. (Ia9494)

Zewnętrzny wkład

  • Zabezpieczenia wpisywania w nawigacji obsługują teraz List<Enum> jako typ argumentu trasy bez konieczności używania niestandardowego NavType. Dziękujemy, Csaba Kozák! (GH-725, b/375559962)

Wersja 2.8.4

13 listopada 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.4 Wersja 2.8.4 zawiera te zatwierdzenia.

Nowe funkcje

Poprawki błędów

Wersja 2.8.3

16 października 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.3 Wersja 2.8.3 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy nowe testy linta dla modułów navigation-common, navigation-runtime i navigation-compose, aby ułatwić identyfikowanie tras bezpiecznych pod względem typów, które nie są prawidłowo oznaczone adnotacją @Serializable. Ta kontrola jest stosowana do wszystkich funkcji rozszerzeń NavGraphBuilder i NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Dodaliśmy nowe kontrole linta w modułach navigation-common, navigation-runtime i navigation-compose, aby ułatwić identyfikowanie tras z zabezpieczeniami wpisywania z argumentami Enum, które nie są prawidłowo oznaczone adnotacją @Keep. Ta kontrola jest stosowana do wszystkich funkcji rozszerzeń NavGraphBuilder i NavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Poprawki błędów

  • Naprawiliśmy błąd, który powodował, że nowe reguły analizy kodu dodane w Navigation 2.8.* powodowały błąd Obsolete custom lint check podczas próby uruchomienia analizy kodu za pomocą wtyczki Androida do obsługi Gradle w wersji 8.4 lub nowszej. (I1be3d, b/368070326, b/371463741)

Znane problemy

  • Podczas próby uruchomienia narzędzia Lint w wersji 16 (AGP 8.7) lub nowszej narzędzie Navigation Lint zgłosi błąd „Nieaktualne niestandardowe sprawdzenie Lint”. (b/371926651)

Wersja 2.8.2

2 października 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.2 Wersja 2.8.2 zawiera te zatwierdzenia.

Nowe funkcje

  • Zabezpieczenia wpisywania nawigacji obsługują teraz klasy Serializable, które zawierają Double, Double?, DoubleArray, DoubleArray?, List<Double> i List<Double>?, bez konieczności używania niestandardowego NavType. (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)

Poprawki błędów

  • Ulepszyliśmy komunikat o błędzie, który pojawia się, gdy nawigacja nie może zmapować argumentu trasy na NavType. Nowy komunikat o błędzie będzie zawierać nazwę argumentu, pełną i jednoznaczną nazwę argumentu oraz pełną i jednoznaczną nazwę trasy. (Id8416, b/346264232)

Wersja 2.8.1

18 września 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.1 Wersja 2.8.1 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nową regułę linta, która zapewnia użycie funkcji popBackStack, która przyjmuje typ klasy reified, gdy próbujesz wykonać popBackStack za pomocą interfejsów API z zabezpieczeniami wpisywania. (Ief161, b/358095343)

Poprawki błędów

  • Nawigacja wymaga teraz, aby trasa przekazana do funkcji startDestination elementu NavGraph zawierała wartości wszystkich wymaganych argumentów, w tym argumentów, które nie mogą mieć wartości null i nie mają wartości domyślnej. (I18e74, b/362594265)
  • W Navigation Safe Args dodano obsługę ciągów znaków, które nie mogą mieć wartości null, dzięki czemu wartości „null” będą analizowane i przechowywane w pakiecie w niezmienionej postaci. To odejście od dotychczasowego zachowania, w którym wartości „null” są analizowane jako obiekt null. Ta zmiana dotyczy tylko typów ciągów znaków, które nie mogą mieć wartości null. Ciągi znaków, które mogą mieć wartość null, pozostają bez zmian. (I08b4a, b/348936238)
  • Nie można już utworzyć precyzyjnego linku do NavDestination, chyba że został on wyraźnie dodany do miejsca docelowego. Oznacza to też, że do trasy miejsca docelowego możesz przejść tylko za pomocą przeciążenia funkcji nawigacji, które przyjmuje trasę w postaci ciągu tekstowego. Naprawiliśmy lukę, która umożliwiała precyzyjne linkowanie do potencjalnie chronionego miejsca docelowego. (Ie30e6)

Aktualizacja zależności

  • Komponent Navigation Safe Args zależy teraz od Kotlina 1.9.24, a nie od Kotlina 2.X, dzięki czemu deweloperzy nie muszą przeprowadzać aktualizacji. (a4129a)
  • Komponent Navigation Compose zależy teraz od Compose 1.7.2.

Wersja 2.8.0

4 września 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0 Wersja 2.8.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.7.0

Bezpieczeństwo typów w Navigation Kotlin DSL

  • Nawigacja zapewnia teraz bezpieczeństwo typów w Kotlin DSL (używanym przez Navigation Compose) za pomocą serializacji Kotlin, co umożliwia definiowanie miejsc docelowych w grafie nawigacji za pomocą obiektów i klas danych bezpiecznych pod względem typów:
    // 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)
        }
    }

Więcej informacji znajdziesz w poście na blogu dotyczącym zabezpieczeń wpisywania w Navigation Compose.

Przewidywane przejście wstecz w Navigation Compose

  • Navigation Compose obsługuje teraz funkcję przewidywania gestu wstecz w aplikacji dzięki nowym interfejsom API SeekableTransitionState z compose-animation. Dzięki temu możesz użyć gestu przejścia wstecz, aby zobaczyć poprzednie miejsce docelowe z niestandardowym przejściem, zanim zdecydujesz, czy chcesz wykonać transakcję za pomocą ukończonego gestu, czy ją anulować.

Navigation Fragment Composable

  • Dodaliśmy nowy artefakt navigation-fragment-compose, który zawiera alternatywę ComposableNavHostFragment dla NavHostFragment, która umożliwia dodawanie kompozycyjnych miejsc docelowych do plików XML nawigacji. Każde miejsce docelowe composable musi być wyrażone jako metoda najwyższego poziomu bez argumentów @Composable, której pełna i jednoznaczna nazwa jest używana jako atrybut android:name w każdym miejscu docelowym. Podczas przechodzenia do jednego z tych miejsc docelowych tworzony jest fragment zawierający, który wyświetla zawartość funkcji kompozycyjnej.
  // 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" />

Inne zmiany

  • Nawigacja w Compose zależy teraz od Compose 1.7.0.
  • Nawigacja udostępnia teraz nową klasę CollectionNavType<T>, podklasę NavType<T> dla argumentów opartych na kolekcjach, takich jak listy, tablice i mapy. Wszystkie domyślne tablice NavType (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType i StringArrayType) dziedziczą teraz z tej nowej klasy.
  • NavType ma teraz wbudowaną obsługę list liczb całkowitych, ciągów tekstowych, wartości logicznych, liczb zmiennoprzecinkowych i liczb typu long.

Wersja 2.8.0-rc01

21 sierpnia 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-rc01 Wersja 2.8.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd powodujący awarię nawigacji podczas przekazywania klas Enum najwyższego poziomu jako argumentów zabezpieczeń wpisywania. (I0ba76, b/358137294)
  • Nawigacja 2.8 działa teraz prawidłowo z pakietem SDK 34 i nie przejdzie na pakiet SDK 35 aż do wersji 2.9 wraz z pozostałymi bibliotekami AndroidX. (b/358798728)

Wersja 2.8.0-beta07

7 sierpnia 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta07 Wersja 2.8.0-beta07 zawiera te zatwierdzenia.

Znane problemy

  • Z powodu błędu b/358137294 od razu obsługiwane są tylko typy wyliczeniowe zagnieżdżone w innej klasie. Typy wyliczeniowe najwyższego poziomu będą obsługiwane w następnej wersji.

Poprawki błędów

  • Podczas przechodzenia do zduplikowanych lub udostępnionych miejsc docelowych nawigacja będzie traktować priorytetowo najbliższe pasujące miejsce docelowe z bieżącej lokalizacji na wykresie. (Ic89a4, b/352006850)
  • W nawigacji w Safe Args dodano nowy element NavType.EnumType. Oznacza to, że typy Enum nie wymagają już niestandardowych NavType. Pamiętaj, że SerialName Enum musi być domyślną pełną i jednoznaczną nazwą. (I66d22, b/346475493)
  • Nawigacja w Safe Args ma teraz wbudowaną obsługę typów argumentów, które mogą mieć wartość null, w tym Int?, Long?, Float?, Boolean? i Enum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237)
  • startDestination w NavGraph będzie teraz używać domyślnych wartości argumentów, jeśli trasa startDestination przekazana do NavGraph jest dokładnie taka sama jak startDestination.route. (I13762, b/354046047)

Wersja 2.8.0-beta06

24 lipca 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta06 Wersja 2.8.0-beta06 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że testy linta WrongStartDestinationType nie sprawdzały obiektów towarzyszących w przekazanym typie klasy, co uniemożliwiało lintowi wykrycie błędu. (I92b09)

Wersja 2.8.0-beta05

10 lipca 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta05 Wersja 2.8.0-beta05 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd powodujący awarię nawigacji singleTop, gdy zagnieżdżone elementy NavGraphs korzystają z tej samej trasy startDestination. (I17b94, b/294408596)

Wersja 2.8.0-beta04

26 czerwca 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta04 Wersja 2.8.0-beta04 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja obsługuje teraz nawigację z pustymi ciągami znaków w argumentach ścieżki. (Ic5dbd, b/339481310)
  • Ulepszyliśmy komunikat o błędzie dotyczący niestandardowych serializatorów zadeklarowanych bezpośrednio w polach klasy za pomocą @Serializable(with =...), aby wyjaśnić, że ta funkcja nie jest obecnie obsługiwana. (I052b0, b/341319151)
  • Interfejs API testu SavedStateHandleFactory może być teraz używany w testach innych niż na Androidzie, ale będzie wymagać Robolectric do obsługi analizowania argumentów za pomocą pakietów. (I76cdc, b/340966212)
  • Naprawiliśmy błąd powodujący awarię podczas przywracania stanu po wznowieniu aplikacji po śmierci procesu z użyciem nawigacji bezpiecznej pod względem typów w Compose. (Ia8f38, b/341801005)
  • Rozwiązaliśmy problem w Navigation Compose, który powodował, że po anulowaniu gestu przewidywanego przejścia wstecz element NavBackStackEntry, do którego użytkownik wraca, nigdy nie wracał do stanu cyklu życia RESUMED. Dzięki temu miejsce docelowe, do którego wracasz, będzie prawidłowo animowane, a nie po prostu wskakiwało na swoje miejsce po przesunięciu. (I97a0c, b/346608857)
  • Podczas korzystania z przewidywanego przejścia wstecz z Navigation Compose miejsce docelowe, które jest usuwane, będzie teraz miało prawidłową kolejność osi Z, co pozwoli na prawidłowe animowanie nad przychodzącym miejscem docelowym. (I2077b, b/345993681)

Wersja 2.8.0-beta03

12 czerwca 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta03 Wersja 2.8.0-beta03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • CollectionNavType ma nową metodę abstrakcyjną emptyCollection(). Zastąp tę metodę, aby obsłużyć pustą kolekcję przekazaną jako argument. (Ie4d84, b/341723133)

Poprawki błędów

  • Dodaliśmy dokumentację dotyczącą NavType.serializeAsValue i serializeAsValues, aby podkreślić, że ostateczne dane wyjściowe powinny być zakodowane w formacie URI. (Ida6bd, b/344943214)
  • Naprawiliśmy błąd powodujący awarię podczas wywoływania toRoute<T> z argumentem CollectionNavType o wartości null. Podczas nawigacji z wartością null CollectionNavType argumentem wyjściowym będzie domyślna wartość zadeklarowana w klasie Serializable lub wartość zwracana przez emptyCollection(), jeśli nie ma wartości domyślnej. (I84158, Id630f, b/342672856)

Wersja 2.8.0-beta02

29 maja 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta02 Wersja 2.8.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd powodujący awarię ClassCastException podczas używania NavBackStackEntry.toRoute z niestandardowym NavType, który może mieć wartość null. (I1c29b, b/342239473)
  • Rozwiązaliśmy problemy z przywracaniem stanu stosu wstecznego nawigacji, które występowały podczas próby przywrócenia wpisu stosu wstecznego, który nie jest dostępny za pomocą identyfikatora z bieżącego miejsca docelowego. Ponieważ trasy są oparte na identyfikatorach, miało to też wpływ na miejsca docelowe utworzone za pomocą tras. Rozwiązuje to też problem z awarią spowodowaną wywołaniem metody clearBackStack(), która miała ten sam problem. (I423c3, b/339908057)

Wersja 2.8.0-beta01

14 maja 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-beta01 Wersja 2.8.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • SavedStateHandle.toRoute() przyjmuje teraz parametr typeMap dla niestandardowych typów argumentów. (Ie39fb, b/339026523)
  • Dodaliśmy testowy interfejs API do navigation-testing, aby umożliwić tworzenie SavedStateHandle z obiektu Kotlin Serializable. (Id4867, b/339080702)

Poprawki błędów

  • Dodano brakującą dokumentację parametrów funkcji DSL nawigacji w języku Kotlin. (I26a36)

Wersja 2.8.0-alpha08

1 maja 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha08 Wersja 2.8.0-alpha08 zawiera te zmiany.

Safe Args w Navigation Compose

Ta funkcja używa serializacji Kotlin, aby umożliwić definiowanie miejsc docelowych na wykresie nawigacyjnym za pomocą obiektów i klas danych z zabezpieczeniami wpisywania:

  // 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)
      }
  }

Więcej informacji znajdziesz w poście na blogu dotyczącym zabezpieczeń wpisywania w Navigation Compose.

Nowe funkcje

  • Artefakt navigation-fragment-compose udostępnia teraz element LocalFragment CompositionLocal metodom kompozycyjnym w ramach ComposableFragment. (If35e5)
  • NavType ma teraz wbudowaną obsługę list liczb całkowitych, ciągów tekstowych, wartości logicznych, liczb zmiennoprzecinkowych i liczb typu long. (I4b6dd, Ia914c, b/188693139)

Wersja 2.8.0-alpha07

17 kwietnia 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha07 Wersja 2.8.0-alpha07 zawiera te zmiany.

Nowe funkcje

  • Dodaje nowy artefakt navigation-fragment-compose, który zawiera alternatywę ComposableNavHostFragment dla NavHostFragment, która umożliwia dodawanie miejsc docelowych composable do plików XML nawigacji. Każde miejsce docelowe composable musi być wyrażone jako metoda najwyższego poziomu bez argumentów @Composable, której pełna i jednoznaczna nazwa jest używana jako atrybut android:name w każdym miejscu docelowym. Podczas przechodzenia do jednego z tych miejsc docelowych tworzony jest fragment zawierający, który wyświetla zawartość funkcji kompozycyjnej. (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" />
    

Zmiany w interfejsie API

  • Nadal obsługujemy Safe Args w Navigation Compose, korzystając z podejścia opartego na serializacji w Kotlinie. Te interfejsy API nie są ukończone i są oznaczone adnotacją ExperimentalSafeArgsApi. Ta adnotacja zostanie usunięta, gdy w przyszłej wersji zostanie ukończona cała powierzchnia interfejsu API. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)

Wersja 2.8.0-alpha06

3 kwietnia 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha06 Wersja 2.8.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

Poprawki błędów

  • NavHost używa teraz Alignment.TopStart jako domyślnego argumentu contentAlignment. Dzięki temu jest on zgodny z domyślnym ustawieniem w AnimatedContent i rozwiązuje niektóre problemy z nieoczekiwanym skalowaniem od środka. (I09e72, b/330111602)
  • Podczas korzystania z Navigation Compose i wykonywania gestu przewidywanego przejścia wstecz NavHost będzie teraz prawidłowo kończyć niestandardowe przejście, zamiast natychmiast kończyć działanie. (I99017, b/327292110)

Wersja 2.8.0-alpha05

20 marca 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha05 Wersja 2.8.0-alpha05 zawiera te zmiany.

Nowe funkcje

  • Teraz możesz przekazywać argumenty do startDestination NavGraph bezpośrednio w trasie startDestination bez korzystania z defaultValue. Dotyczy to również zagnieżdżonych elementów NavGraph startDestinations. (I0e0b5, b/109505019, b/188693139)

Zmiany w interfejsie API

  • Dodano nową klasę abstrakcyjną CollectionNavType<T>, podklasę NavType<T> dla argumentów opartych na kolekcjach, takich jak listy, tablice i mapy. (Ic6d63, b/188693139)
  • Wszystkie domyślne tablice NavType (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType i StringArrayType) są teraz typu CollectionNavType (Idcf79, b/188693139).
  • NavType udostępnia teraz nowy otwarty interfejs API valueEquals, który określa, czy 2 wartości tego samego typu są sobie równe. (I6cb97, b/327229511)

Poprawki błędów

  • Parametry zapytania w precyzyjnych linkach umożliwiają teraz używanie wartości w postaci nawiasów klamrowych wokół nazwy argumentu (np. {argName}) jako prawidłowych wartości dla argumentu NavTypes opartego na ciągu znaków. Rozwiązuje to problem, który powodował, że taka wartość była uznawana za nieprawidłową (lub brak wartości) we wszystkich typach. (I18302, b/327274038)
  • Funkcje NavController, które obsługują trasy takie jak navigate lub popBackStack, mogą teraz prawidłowo dopasowywać trasy wypełnione argumentami tablicy NavTypes. (Iea805, b/327229511)

Wersja 2.8.0-alpha04

6 marca 2024 roku

Publikacja androidx.navigation:navigation-*:2.8.0-alpha04 Wersja 2.8.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Możesz teraz określić SizeTranform dla przejść w Navigation Compose, definiując je w ramach inicjowania funkcji composable lub navigation. (I91062, b/296912651)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że funkcja NavHost w Compose Navigation nie wyświetlała prawidłowo przejścia, gdy używany był systemowy przycisk Wstecz bez gestu. (Iceeae, b/325998468)

Wersja 2.8.0-alpha03

21 lutego 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha03 Wersja 2.8.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • NavBackStackEntry.savedStateHandle jest teraz oznaczony jako @MainThread, ponieważ używa kodu, który i tak musi znajdować się w głównym wątku. (Ibb988, b/299523245)

Poprawki błędów

  • Naprawiliśmy błąd w komponencie Navigation, który powodował zbyt wczesne DESTROYED obiektów ViewModel NavGraph, ponieważ powiązany wpis ViewModel nie był częścią zapisanego stanu. (Ib6bb7, b/317581849)

Aktualizacja zależności

Wersja 2.8.0-alpha02

7 lutego 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha02 Wersja 2.8.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

  • Navigation Compose obsługuje teraz funkcję przewidywania gestu wstecz w aplikacji dzięki nowym interfejsom API SeekableTransitionState z compose-animation. Dzięki temu możesz użyć gestu przejścia wstecz, aby zobaczyć poprzednie miejsce docelowe z niestandardowym przejściem, zanim zdecydujesz, czy chcesz wykonać transakcję za pomocą ukończonego gestu, czy ją anulować. (I8b8e9)

Wersja 2.8.0-alpha01

24 stycznia 2024 r.

Publikacja androidx.navigation:navigation-*:2.8.0-alpha01 Wersja 2.8.0-alpha01 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy wyciek BackStackState, w przypadku którego wielokrotne wywołania saveState w miejscu docelowym powodowały zapisanie wielu stanów, ale można było przywrócić tylko pierwszy z nich. (I598b0, b/309559751)
  • Rozwiązaliśmy problem, który powodował, że argumenty inne niż ciągi znaków nie były prawidłowo wyświetlane, gdy do wypełniania tytułu pasków aplikacji używane były funkcje pomocnicze NavigationUI. (#636, b/316676794)

Aktualizacja zależności

Zewnętrzny wkład

  • Dziękujemy użytkownikowi SimonMarquis za rozwiązanie problemu z wyświetlaniem argumentów innych niż ciągi znaków podczas używania funkcji pomocniczych NavigationUI do wypełniania tytułu pasków aplikacji.

Wersja 2.7.7

Wersja 2.7.7

7 lutego 2024 r.

Publikacja androidx.navigation:navigation-*:2.7.7 Wersja 2.7.7 zawiera te zatwierdzenia.

Poprawki błędów

  • Przeniesione z Nawigacji 2.8.0-alpha01: naprawiono wyciek BackStackState, w przypadku którego wielokrotne wywołania saveState() w jednym NavBackStackEntry powodowały zapisanie wielu stanów, ale można było przywrócić tylko pierwszy zapisany stan. (I598b0, b/309559751)
  • Przeniesione z Nawigacji 2.8.0-alpha01: rozwiązaliśmy problem, który powodował, że argumenty inne niż ciąg znaków nie były prawidłowo wyświetlane podczas używania funkcji pomocniczych NavigationUI do wypełniania tytułu pasków aplikacji. (#636, b/316676794)

Zewnętrzny wkład

  • Dziękujemy użytkownikowi SimonMarquis za rozwiązanie problemu z wyświetlaniem argumentów innych niż ciągi znaków podczas używania funkcji pomocniczych NavigationUI do wypełniania tytułu pasków aplikacji.

Wersja 2.7.6

Wersja 2.7.6

13 grudnia 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.6 Wersja 2.7.6 zawiera te zatwierdzenia.

Poprawki błędów

  • Funkcja NavGraph equals() uwzględnia teraz prawidłowo węzły drugiego wykresu, a nie tylko wykresu wywołującego. Dzięki temu wykresy z węzłami o różnych identyfikatorach nie będą już uznawane za równe (I401cb, b/311414915).

Wersja 2.7.5

Wersja 2.7.5

1 listopada 2023 roku

Publikacja androidx.navigation:navigation-*:2.7.5 Wersja 2.7.5 zawiera te zatwierdzenia.

Ulepszenia wydajności

  • Znacznie poprawiliśmy wydajność (zarówno pod względem czasu, jak i liczby alokacji) porównywania 2 wykresów. Oznacza to, że wywołania takie jak setGraph, które wewnętrznie porównują nowy wykres z istniejącym, są znacznie szybsze i powodują mniej pominiętych klatek. Dziękujemy Michałowi Z za dokładną analizę, która doprowadziła do tego ulepszenia. (I6ad62)
  • NavHost będzie teraz renderować miejsce docelowe w pierwszym przebiegu kompozycji, zamiast czekać na drugi przebieg, aby odczytać zaktualizowany stan. (I439a7, b/304852206)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że stos wsteczny był usuwany, jeśli metoda setGraph została wywołana więcej niż raz z tym samym grafem, ale tylko wtedy, gdy na grafie znajdowało się miejsce docelowe zawierające link do działania łączący 2 miejsca docelowe. (Ieaed7)
  • Okna, które zostały otwarte i szybko zamknięte, nie będą już widoczne na liście NavController.visibleEntries. (I67586, b/287969970)
  • Gdy wpis zostanie usunięty, a następnie nastąpi zmiana konfiguracji, ViewModel wpisu zostanie teraz prawidłowo wyczyszczony, jeśli saveState ma wartość false. (Idf242, b/298164648)
  • Naprawiliśmy błąd, który powodował, że NavController mógł obsługiwać ten sam precyzyjny link więcej niż raz, jeśli stos wsteczny był całkowicie pusty przed zmianą konfiguracji lub wywołaniem setGraph tylko wtedy, gdy przychodzący obiekt Intent miał ustawioną flagę FLAG_ACTIVITY_NEW_TASK. (I73c7f)

Aktualizacje zależności

  • Nawigacja z użyciem fragmentów zależy teraz od fragmentu 1.6.2, co rozwiązuje problem polegający na tym, że instancje ViewModel zagnieżdżonych fragmentów nie były czyszczone podczas wywoływania clearBackStack.

Wersja 2.7.4

Wersja 2.7.4

4 października 2023 roku

Publikacja androidx.navigation:navigation-*:2.7.4 Wersja 2.7.4 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy obsługę popUpTo, aby umożliwić korzystanie z tras z argumentami i powrót do konkretnego wpisu, który używa tych samych argumentów, co odpowiada obsłudze w popBackStack. (I731f4, b/299255572)

Poprawki błędów

  • Naprawiliśmy problem, który powodował awarię FragmentNavigator, gdy nawigacja została przerwana przez inną nawigację za pomocą popUpTo. (I3c848, b/301887045)
  • Rozwiązaliśmy problem, który powodował, że naciśnięcie przycisku Wstecz w systemie powodowało nieprawidłowe aktualizowanie elementu currentDestination, który nie pasował do wyświetlanego fragmentu. (Id0d6c, b/289877514)
  • Cykl życia DialogFragment będzie teraz prawidłowo przechodzić do stanu RESUMED po zamknięciu okna dialogowego nad nim. (I88f0d, b/301811387)

Wersja 2.7.3

Wersja 2.7.3

20 września 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.3 Wersja 2.7.3 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd w Nawigacji z użyciem fragmentów, który powodował, że lista visibleEntries zawierała nieprawidłowe wpisy. (I5caa9, b/288520638)
  • Rozwiązaliśmy problem, który powodował, że miejsce docelowe pływającego okna (np. Dialogs, Bottomsheets) nigdy nie otrzymywało wywołania zwrotnego cyklu życia RESUMED. (I3b866, b/287505132)

Wersja 2.7.2

Wersja 2.7.2

6 września 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.2 Wersja 2.7.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja zależy teraz od Lifecycle 2.6.2, co rozwiązuje problem z interakcją między rememberSaveable a NavHost w Navigation Compose, która powodowała, że stan rememberSaveable miejsc docelowych i wszystkie instancje SavedStateHandle należące do ViewModel nie były prawidłowo przywracane po śmierci procesu i ponownym utworzeniu. (b/298059596, b/289436035)
  • Rozwiązaliśmy problem, który występował podczas jednoczesnego wyświetlania wielu okien dialogowych w Navigation Compose, gdy częściowo zasłonięte okna (np. nie te na samej górze) były w stanie cyklu życia CREATED zamiast STARTED. (aosp/2728520, b/289257213)
  • Rozwiązaliśmy problem, który występował, gdy w Navigation Compose wyświetlanych było jednocześnie kilka okien. Zamknięcie najwyższego okna powodowało, że nowe najwyższe okno pozostawało w stanie cyklu życia STARTED, zamiast prawidłowo przechodzić do stanu RESUMED. (aosp/2629401, b/286371387)
  • Navigation Safe Args nie tworzy już instancji zadania, jeśli nie jest ono faktycznie wykonywane. (I0e385, b/260322841)

Aktualizacja zależności

  • Nawigacja w Compose zależy teraz od Compose 1.5.1.

Wersja 2.7.1

Wersja 2.7.1

23 sierpnia 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.1 Wersja 2.7.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd w Nawigacji w Compose, który powodował, że podczas korzystania z Scaffold mógł pojawić się błąd związany z próbą uzyskania dostępu do Lifecycle.State.DESTROYED ViewModel. (I1dc11, b/268422136)

Wersja 2.7.0

Wersja 2.7.0

9 sierpnia 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.0 Wersja 2.7.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.6.0

Animacje z Accompanist

Teraz, gdy biblioteka AnimatedContent jest stabilna, udało nam się przenieść kod z Accompanist Navigation Animation z powrotem do Navigation Compose.

Oznacza to, że wszystkie funkcje ustawiania niestandardowych przejść, które były dostępne w AnimatedNavHost, są bezpośrednio obsługiwane w NavHost.

Nie będziemy wprowadzać żadnych dodatkowych zmian w bibliotece Accompanist Navigation Animation i wkrótce oficjalnie ją wycofamy. Udostępnimy też wskazówki dotyczące migracji z powrotem do Navigation Compose, ale będzie to odwrotność przewodnika po migracji bez konieczności wprowadzania innych zmian w interfejsie API, jeśli używasz już najnowszej wersji alfa biblioteki Accompanist (0.31.2-alpha). (b/197140101)

Poprawki błędów

  • NavHost w Navigation Compose teraz prawidłowo przechwytuje wywołania systemowe przycisku Wstecz, nawet po zatrzymaniu i wznowieniu aktywności. (Icb6de, b/279118447)

Aktualizacje zależności

  • Nawigacja zależy teraz od Compose 1.5.0, a nie 1.1.0.

Wersja 2.7.0-rc01

26 lipca 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.0-rc01 Wersja 2.7.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że funkcje lambda EnterTransition i ExitTransition utworzone w ramach NavHost mogły pozostawać w pamięci nawet po usunięciu NavHost z kompozycji. (I893d0)

Znane problemy

  • W Nawigacji 2.6.x występuje problem, który może powodować błąd IllegalArgumentException podczas nawigacji z użyciem popUpTo. Możesz uniknąć tego wyjątku, zmieniając strukturę grafu, podobnie jak w przypadku porady sugerowanej tutaj. (b/287133013)

Wersja 2.7.0-beta02

28 czerwca 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.0-beta02 Wersja 2.7.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja w Compose ma teraz prawidłową kolejność osi Z w przypadku niestandardowych przejść, które używają nawigacji z opcją popUpTo (/Ib1c3a, b/285153947).

Wersja 2.7.0-beta01

7 czerwca 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.0-beta01 Wersja 2.7.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • NavHost w Navigation Compose teraz prawidłowo przechwytuje wywołania systemowe przycisku Wstecz, nawet po STOPPED i RESUMED Activity. (Icb6de, b/279118447)

Wersja 2.7.0-alpha01

24 maja 2023 r.

Publikacja androidx.navigation:navigation-*:2.7.0-alpha01 Wersja 2.7.0-alpha01 zawiera te zatwierdzenia.

Animacje z Accompanist

Teraz, gdy biblioteka AnimatedContent jest stabilna, udało nam się przenieść kod z Accompanist Navigation Animation z powrotem do Navigation Compose.

Oznacza to, że wszystkie funkcje ustawiania niestandardowych przejść, które były dostępne w AnimatedNavHost, są bezpośrednio obsługiwane w NavHost.

Nie będziemy wprowadzać żadnych dodatkowych zmian w bibliotece Accompanist Navigation Animation i wkrótce oficjalnie ją wycofamy. Udostępnimy też wskazówki dotyczące migracji z powrotem do Navigation Compose, ale będzie to odwrotność przewodnika po migracji bez konieczności wprowadzania innych zmian w interfejsie API, jeśli używasz już najnowszej wersji alfa biblioteki Accompanist (0.31.2-alpha). (b/197140101)

Poprawki błędów

  • Nawigacja 2.6.0-rc02: rozwiązaliśmy problem z nawigacją we fragmentach, w przypadku którego nawigowanie za pomocą popUpTo i wyciąganie fragmentu ze stosu wstecznego bez ponownego tworzenia jego widoku powodowało, że systemowy przycisk Wstecz przestawał działać. (Ieb8d4, b/281726455)

Aktualizacje zależności

  • Nawigacja zależy teraz od Compose w wersji 1.5.0-beta01.

Wersja 2.6.0

Wersja 2.6.0

7 czerwca 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0 Wersja 2.6.0 zawiera te zatwierdzenia.

Ważne zmiany w komponencie Navigation od wersji 2.5.0

  • arguments i arguments NavBackStackEntry przekazywane do OnDestinationChangedListener są teraz tylko kopią niezmiennych argumentów utworzonych podczas przechodzenia do miejsca docelowego. Oznacza to, że zmiany wprowadzone w tych pakietach nie będą odzwierciedlane w kolejnych dostępach do arguments ani innych instancji OnDestinationChangedListener.
  • NavDeepLink obsługuje teraz wartości domyślne tablic, co umożliwia obsługę powtarzających się parametrów zapytania, które będą mapowane na typ tablicy argumentu. NavType zawiera teraz domyślną metodę, którą można zastąpić, aby połączyć 2 przeanalizowane wartości.
  • Niestandardowe podklasy NavType mogą teraz zastępować serializeAsValue, aby serializować wartość do ciągu znaków, co pozwala na całkowite hermetyzowanie serializacji i deserializacji (za pomocą parseValue) w klasie NavType. StringType zastępuje teraz tę metodę, aby wywołać Uri.encode w przypadku podanego String.

Ważne zmiany w Navigation Compose od wersji 2.5.0

  • Podczas wyświetlania podglądu funkcji kompozycyjnej z NavHost domyślnie będzie teraz wyświetlany element startDestination NavGraph.
  • NavController.popBackStack(route), NavController.getBackStackEntry(route), NavController.clearBackStack(route) teraz wszystkie obsługują trasy z częściowo lub całkowicie wypełnionymi argumentami. Pamiętaj, że argumenty muszą dokładnie odpowiadać argumentom wpisu.
  • Próba utworzenia pustego elementu NavDeepLink za pomocą navDeepLink Kotlin DSL spowoduje teraz wyświetlenie ostrzeżenia linta wskazującego, że precyzyjny link musi zawierać identyfikator URI, działanie lub typ MIME, aby był prawidłowy.

Ważne zmiany w nawigacji z użyciem fragmentów od wersji 2.5.0

  • NavHostFragment nie przechwytuje już systemowego przycisku Wstecz. Dzięki temu bazowy element FragmentManager może obsługiwać systemowy przycisk Wstecz. Dzięki temu Fragment 1.7.0-alpha01 i nowsze wersje mogą wyświetlać animację przewidywanego przejścia wstecz w aplikacji na urządzeniach z Androidem U.
  • Jeśli podczas korzystania z komponentu Navigation z fragmentami spróbujesz ręcznie wykonać operację FragmentTransaction, która dodaje fragment do stosu wstecznego FragmentManager, zostanie wygenerowany wyjątek IllegalArgumentException. Fragmenty należy zawsze dodawać za pomocą interfejsu API navigate().
  • Jeśli użyjesz ciągu znaków ${applicationId} jako obiektu zastępczego w atrybutach app:data i app:dataPattern w elemencie aktywności pliku XML nawigacji, obiekt zastępczy zostanie automatycznie wypełniony wartością packageName kontekstu po rozwinięciu.
  • FragmentNavigator używa teraz interfejsów API przejść podczas nawigacji i wyświetlania NavBackStackEntries. Oznacza to, że NavBackStackEntry Lifecycle będzie teraz czekać na zakończenie efektów specjalnych fragmentu wejściowego i wyjściowego, zanim przeniesie ich ostateczny Lifecycle.State.
  • DialogFragmentNavigator używa teraz interfejsów API przejść podczas nawigacji i wyświetlania NavBackStackEntries. Oznacza to, że NavBackStackEntry Lifecycle będzie teraz czekać, aż DialogFragment Lifecycle przejdzie do stanu DESTROYED, zanim sam przejdzie do stanu DESTROYED.
  • NavHostFragment umożliwia teraz pobranie NavController, gdy tylko NavHostFragment zostanie dołączony do FragmentManager, a nie dopiero po onCreate().
  • Obsługa modułów funkcji dynamicznych przez komponent Navigation zależy teraz od szczegółowej biblioteki Play Feature Delivery.
  • Komponent Navigation Safe Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 7.3.0. Oznacza to, że jest teraz zgodny tylko z wersjami 7.3.0 i nowszymi.

Ważne zmiany w NavigationUI od wersji 2.5.0

  • Gdy przekazujesz identyfikator wykresu nawigacyjnego do AppBarConfiguration (np. za pomocą Menu), NavigationUI traktuje teraz tylko miejsce docelowe tego wykresu nawigacyjnego jako miejsce docelowe najwyższego poziomu, zamiast nieprawidłowo oznaczać każde miejsce docelowe na wykresie jako miejsce docelowe najwyższego poziomu. Sposób przekazywania identyfikatora pojedynczego miejsca docelowego pozostaje bez zmian. Ta sama funkcja jest dostępna w Twoim kodzie dzięki nowej funkcji isTopLevelDestination w AppBarConfiguration.
  • Integracje setupWithNavController w NavigationUI do pracy z górnym paskiem aplikacji będą teraz analizować wartości R.string argumentów ReferenceType znalezionych w android:label i przekształcać je w wartości typu String zamiast generować automatycznie liczbę całkowitą zasobu.
  • NavigationUI udostępnia teraz logi, gdy nie uda się nawigować za pomocą wybranego MenuItem.

Wersja 2.6.0-rc02

24 maja 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-rc02 Wersja 2.6.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem z nawigacją we fragmentach, który powodował, że nawigowanie za pomocą popUpTo i usuwanie fragmentu ze stosu wstecznego bez ponownego tworzenia jego widoku powodowało, że systemowy przycisk Wstecz przestawał działać. (Ieb8d4, b/281726455)

Wersja 2.6.0-rc01

10 maja 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-rc01 Wersja 2.6.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd w nawigacji z fragmentami, który powodował, że usunięcie fragmentu za pomocą metody navigate z popUpTo w wywołaniu zwrotnym cyklu życia onResume() powodowało błąd IllegalStateException. (I21884, b/279644470)

Wersja 2.6.0-beta01

19 kwietnia 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-beta01 Wersja 2.6.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • NavBackStackEntry udostępnia teraz niestandardową implementację toString. (Iff00b)

Poprawki błędów

  • Jeśli podczas korzystania z komponentu Navigation z fragmentami spróbujesz ręcznie wykonać operację FragmentTransaction, która dodaje fragment do stosu wstecznego FragmentManager, zostanie wygenerowany wyjątek IllegalArgumentException. Fragmenty należy zawsze dodawać za pomocą interfejsu API navigate(). (I6d38e)
  • Gdy w tej samej ramce występuje navigate, który dodaje wpis, i popBackStack, który go usuwa, wynikowy wpis na górze stosu wstecznego będzie teraz konsekwentnie wracać do RESUMED Lifecycle.State. (Id8067, b/276495952)

Wersja 2.6.0-alpha09

5 kwietnia 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha09 Wersja 2.6.0-alpha09 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy sprawdzanie nieprawidłowych tras, dzięki czemu jeśli NavDestination zawiera niepusty NavArgument, trasa tego miejsca docelowego musi zawierać obiekty zastępcze dla argumentów o takiej samej nazwie jak niepusty NavArgument. (Ic62bf, b/274697949)
  • Nawigacja za pomocą precyzyjnych linków oparta na Action/MimeType będzie teraz kończyć się niepowodzeniem, jeśli w operacji nawigacji brakuje wartości NavArgument, która nie może być pusta, a której wymaga NavDestination, do którego pasuje Action/MimeType. (Ibfa17, b/271777424)
  • Gdy NavController ustawia wykres z tą samą trasą i miejscami docelowymi co poprzedni wykres, prawidłowo zastępuje bieżące węzły wykresu i miejsca docelowe stosu wstecznego nowymi instancjami. Rozwiązaliśmy problem z awarią podczas korzystania z onLaunchSingleTop bez zapisywania stanu w Navigation Compose. Rozwiązaliśmy też błąd, który powodował, że przechodzenie do miejsc docelowych powiązanych z wykresem głównym powodowało tworzenie nieprawidłowego stosu wstecznego. (I5bc58, b/275258161, b/275407804)

Wersja 2.6.0-alpha08

22 marca 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha08 Wersja 2.6.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

  • NavHostFragment umożliwia teraz pobranie NavController, gdy tylko NavHostFragment zostanie dołączony do FragmentManager, a nie dopiero po onCreate(). (Ic6382, b/220186282)

Poprawki błędów

  • Naprawiliśmy błąd NullPointerException, który występował podczas wyskakującego okienka z wykresem zagnieżdżonym zawierającym argument, który nie może mieć wartości null. (6b3581, b/249988437)
  • Jeśli po przejściu do innego miejsca za pomocą popUpTo użyjesz systemowego przycisku Wstecz, stan NavController zostanie przywrócony do prawidłowego wpisu. (I3a8ec, b/270447657)
  • FragmentNavigator będzie teraz prawidłowo usuwać wpisy, gdy stos wsteczny zostanie usunięty za pomocą przycisku wstecz systemu lub popBackStack(), niezależnie od tego, czy transakcja używa efektów dla fragmentu. (I81bdf)
  • Dodawanie fragmentów do FragmentNavigator FragmentManager bez używania nawigacji nie będzie już powodować awarii. (b17204, b/274167493)

Aktualizacje zależności

Wersja 2.6.0-alpha07

8 marca 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha07 Wersja 2.6.0-alpha07 zawiera te zatwierdzenia.

Poprawki błędów

  • Warianty interfejsu API getBackStackEntry, popBackStack, clearBackStack, które przyjmują trasy, teraz przyjmują wzorce tras z argumentami i parametrami zapytania, które mogą mieć wartość null (I22294, b/269302500).
  • Rozwiązaliśmy problem, który powodował, że wywołanie metody clearBackStack() z NavController nie powodowało wyczyszczenia zapisanego stanu w menedżerze fragmentów powiązanym z wyczyszczonym stosem wstecznym. (Ic1cce, b/271190202)
  • Naprawiliśmy błąd regresji w wersji 2.6.0-alpha06, który powodował, że podczas używania systemowego przycisku wstecz między kartami podświetlany był nieprawidłowy element MenuItem w BottomNavigationView. (I634f6, b/270447657)
  • Naprawiliśmy błąd regresji w wersji 2.6.0-alpha06, który powodował, że obiekty NavBackStackEntry nie były przenoszone do stanu RESUMED, gdy używane były obiekty Animation. (Ib3589, b/269646882)

Wersja 2.6.0-alpha06

22 lutego 2023 roku

Publikacja androidx.navigation:navigation-*:2.6.0-alpha06 Wersja 2.6.0-alpha06 zawiera te zatwierdzenia.

Nowe funkcje

  • Podczas wyświetlania podglądu funkcji kompozycyjnej z NavHost domyślnie będzie teraz wyświetlany element startDestination NavGraph. (I2b89f)

Zmiany w interfejsie API

  • Wszystkie przeciążenia NavController navigate są teraz oznaczone adnotacją @MainThread, aby mieć pewność, że są wywoływane w głównym wątku. (I2c0b0, b/263427111)

Poprawki błędów

  • Naprawiliśmy błąd powodujący awarię podczas próby nawigacji przy użyciu dynamicznej nawigacji po fragmentach. (I3ee29, b/268360479)
  • Naprawiliśmy błąd, który powodował, że po przejściu do innego fragmentu za pomocą systemowego przycisku Wstecz dolny pasek nie aktualizował się do prawidłowo wybranego elementu (If559f, b/269044426).

Znane problemy

  • Podczas korzystania z nawigacji z fragmentami cykl życia NavBackStackEntry nie osiąga stanu RESUMED, gdy używane są interfejsy API Animation. (b/269646882)
  • Jeśli podczas korzystania z nawigacji z fragmentami i nawigowania za pomocą BottomNavigation spróbujesz przywrócić stos wsteczny z wieloma wpisami, BottomMenuItem nie zostanie prawidłowo zaktualizowany. (b/270447657)
  • Gdy używasz nawigacji z fragmentami, po przywróceniu stanu NavBackStackEntry Lifecycle nie otrzymuje DESTROYED, gdy jego fragment jest DESTROYED . (b/270610768)

Wersja 2.6.0-alpha05

8 lutego 2023 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha05 Wersja 2.6.0-alpha05 zawiera te zatwierdzenia.

Nowe funkcje

  • NavController.popBackStack(route), NavController.getBackStackEntry(route), NavController.clearBackStack(route) teraz wszystkie obsługują trasy z częściowo lub całkowicie wypełnionymi argumentami. Pamiętaj, że argumenty muszą dokładnie odpowiadać argumentom wpisu. (Iebd28, Ic678c, I3b37b, b/257514373)
  • FragmentNavigator używa teraz interfejsów API przejść podczas nawigacji i wyświetlania NavBackStackEntries. Oznacza to, że NavBackStackEntry Lifecycle będzie teraz czekać na zakończenie efektów specjalnych fragmentu wejściowego i wyjściowego, zanim przeniesie ich ostateczny Lifecycle.State. (I3cb19, b/238686802)
  • DialogFragmentNavigator używa teraz interfejsów API przejść podczas nawigacji i wyświetlania NavBackStackEntries. Oznacza to, że NavBackStackEntry Lifecycle będzie teraz czekać, aż DialogFragment Lifecycle przejdzie do stanu DESTROYED, zanim sam przejdzie do stanu DESTROYED. (I53ee5, b/261213893)

Zmiany w interfejsie API

  • NavigatorState udostępnia teraz interfejs API prepareForTransition, który umożliwia Navigator przenoszenie NavBackStackEntries do pośrednich Lifecycle.State. (I42c21, b/238686802)
  • Teraz możesz uzyskać dostęp do stosu wstecznego powiązanego z NavGraphNavigator lub ComposeNavigator za pomocą właściwości backstack. ComposeNavigator udostępnia teraz wywołanie zwrotne onTransitionComplete(), aby oznaczyć NavBackStackEntry, który wykonał operację nawigacji lub popBackStack, jako ukończony. (I02062, I718db, b/257519195)

Poprawki błędów

  • Stan nawigatora nie będzie teraz wykonywać żadnych działań, gdy używane są interfejsy API push/popWithTransition, a wpis jest już obsługiwany. (Iadbfa, b/261213893)
  • Jeśli używasz launchSingleTop z zagnieżdżonym NavGraph, wszystkie miejsca docelowe od pierwotnego miejsca docelowego do jego startDestination zostaną prawidłowo dodane na górze stosu wstecznego. (Id4bea, b/253256629)
  • Nawigacja będzie teraz prawidłowo zastępować instancję DialogFragment podczas nawigowania do tego samego miejsca docelowego z flagą launchSingleTop ustawioną na wartość „true”. (I45b5a, b/149572817)
  • Komponent Navigation SafeArgs nie będzie już powodować błędu kompilacji, gdy używane będą argumenty o długości dokładnie 19 znaków. (Id60bc, b/257110095)

Wersja 2.6.0-alpha04

9 listopada 2022 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha04 Wersja 2.6.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Niestandardowe podklasy NavType mogą teraz zastępować serializeAsValue, aby serializować wartość do ciągu znaków, co pozwala na całkowite hermetyzowanie serializacji i deserializacji (za pomocą parseValue) w klasie NavType. StringType zastępuje teraz tę metodę, aby wywołać Uri.encode w przypadku danego String. (Ie5213, b/247637434)
  • NavigationUI udostępnia teraz logi, gdy nie uda się nawigować za pomocą wybranego MenuItem. (I2af5a, b/247730357)

Poprawki błędów

  • Precyzyjne linki nawigacyjne są teraz analizowane leniwie, a nie podczas inicjowania wykresu, co może poprawić wydajność aplikacji podczas uruchamiania. (Iab0ab)
  • Naprawiliśmy błąd powodujący awarię po przejściu w górę po precyzyjnym linkowaniu do miejsca docelowego z pustymi argumentami domyślnymi. (I51c24, b/243183636)

Aktualizacja zależności

  • Obsługa modułów funkcji dynamicznych przez komponent Navigation zależy teraz od szczegółowej biblioteki Play Feature Delivery. (Ib4ddc)
  • Komponent Navigation Safe Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 7.3.0. Oznacza to, że jest teraz zgodny tylko z wersjami 7.3.0 i nowszymi. (I47e49)

Wersja 2.6.0-alpha03

24 października 2022 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha03 Wersja 2.6.0-alpha03 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja 2.5.3: NavHost nie będzie już powodować błędu NoSuchElementException, gdy nie będzie dostępnego miejsca docelowego dla Crossfade. Teraz po prostu pominie kompozycję. (Ieb46e, b/253299416)
  • Nawigacja 2.5.3: rozwiązaliśmy problem, który powodował, że zapisany stan Compose (np. użycie rememberSaveable) nie był zapominany i usuwany, gdy miejsce docelowe zostało usunięte ze stosu wstecznego. (I64949)

Aktualizacje zależności

Wersja 2.6.0-alpha02

5 października 2022 r.

Publikacja androidx.navigation:navigation-*:2.6.0-alpha02 Wersja 2.6.0-alpha02 zawiera te zatwierdzenia.

Zmiany w zachowaniu

  • Gdy przekazujesz identyfikator wykresu nawigacyjnego do AppBarConfiguration (np. za pomocą Menu), NavigationUI traktuje teraz tylko miejsce docelowe tego wykresu nawigacyjnego jako miejsce docelowe najwyższego poziomu, zamiast nieprawidłowo oznaczać każde miejsce docelowe na wykresie jako miejsce docelowe najwyższego poziomu. Sposób przekazywania identyfikatora pojedynczego miejsca docelowego pozostaje bez zmian. Ta sama funkcja jest dostępna w Twoim kodzie dzięki nowej funkcji isTopLevelDestination w AppBarConfiguration. (Ie936e, b/238496771)

Poprawki błędów

  • Komponent navigation:navigation-fragment zależy teraz od wersji 1.5.2 biblioteki Fragment. (I00ba4)
  • Wybrany element menu nie będzie już aktualizowany podczas przechodzenia do miejsca docelowego FloatingWindow, takiego jak okno. (I4cde8, b/240308330)

Wersja 2.6.0-alpha01

7 września 2022 roku

Publikacja androidx.navigation:navigation-*:2.6.0-alpha01 Wersja 2.6.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Integracje setupWithNavController w NavigationUI do pracy z górnym paskiem aplikacji będą teraz analizować wartości R.string argumentów ReferenceType znalezionych w android:label i przekształcać je w wartości typu String zamiast generować automatycznie liczbę całkowitą zasobu. (I5f803, b/167959935)
  • NavDeepLink obsługuje teraz wartości domyślne tablic, co umożliwia obsługę powtarzających się parametrów zapytania, które będą mapowane na typ tablicy argumentu. NavType zawiera teraz domyślną metodę, którą można zastąpić, aby połączyć 2 przeanalizowane wartości. (Id68c3, b/209977108)
  • Jeśli użyjesz ciągu znaków ${applicationId} jako obiektu zastępczego w atrybutach app:data i app:dataPattern w elemencie aktywności pliku XML nawigacji, obiekt zastępczy zostanie automatycznie wypełniony wartością packageName kontekstu po rozwinięciu. (Iaabde, b/234223561)
  • Próba utworzenia pustego elementu NavDeepLink za pomocą navDeepLink Kotlin DSL spowoduje teraz wyświetlenie ostrzeżenia linta wskazującego, że precyzyjny link musi zawierać identyfikator URI, działanie lub typ MIME, aby był prawidłowy. (I08d2f, b/154038883)

Zmiany w interfejsie API

  • Dodano nową funkcję rozszerzenia NavDestination, która umożliwia analizowanie etykiet dynamicznych z argumentami w formie android:label="{arg}" i przekształcanie ich w ciąg znaków. Obsługuje argumenty ReferenceType, analizując wartości R.string i zamieniając je na wartości typu String. (I07d89, b/236269380)

Zmiany w zachowaniu

  • arguments obiektu NavBackStackEntry i arguments przekazywane do OnDestinationChangedListener są teraz tylko kopią niezmiennych argumentów, które zostały utworzone podczas przechodzenia do miejsca docelowego. Oznacza to, że zmiany wprowadzone w tych pakietach nie będą odzwierciedlane w kolejnych dostępach do arguments ani innych instancji OnDestinationChangedListener. (I676f5)

Poprawki błędów

  • Nawigacja 2.5.2: nawigacja dynamiczna próbuje teraz prawidłowo zainstalować miejsca docelowe aktywności z innych modułów przed przejściem do nich. (Ia2c16, b/240292838)
  • Nawigacja 2.5.2: nawigacja będzie teraz prawidłowo zastępować instancję Fragmentu podczas przechodzenia do tego samego miejsca docelowego i ustawiania flagi launchSingleTop na wartość „true”. (I5a2f1, b/237374580)
  • Nawigacja 2.5.2: naprawiliśmy błąd IllegalStateException, który występował podczas przechodzenia do podwójnie zagnieżdżonego wykresu, który współdzieli element nadrzędny z nowym miejscem docelowym. (I9f7cb, b/243778589)

Wersja 2.5

Wersja 2.5.3

24 października 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.3 Wersja 2.5.3 zawiera te zatwierdzenia.

Poprawki błędów

  • NavHost nie będzie już powodować błędu NoSuchElementException, gdy nie będzie dostępnego miejsca docelowego do utworzenia Crossfade. Teraz po prostu pominie kompozycję. (Ieb46e, b/253299416)
  • Rozwiązaliśmy problem, który powodował, że zapisany stan Compose (np. użycie rememberSaveable) nie był usuwany, gdy miejsce docelowe zostało usunięte ze stosu wstecznego. (I64949)

Wersja 2.5.2

7 września 2022 roku

Publikacja androidx.navigation:navigation-*:2.5.2 Wersja 2.5.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja dynamiczna prawidłowo próbuje teraz zainstalować miejsca docelowe aktywności z innych modułów przed przejściem do nich. (Ia2c16, b/240292838)
  • Nawigacja będzie teraz prawidłowo zastępować instancję Fragmentu podczas przechodzenia do tego samego miejsca docelowego i ustawiania flagi launchSingleTop na wartość true. (I5a2f1, b/237374580)
  • Naprawiliśmy błąd IllegalStateException spowodowany przejściem do podwójnie zagnieżdżonego wykresu, który współdzieli element nadrzędny z nowym miejscem docelowym. (I9f7cb, b/243778589)

Aktualizacja zależności

Wersja 2.5.1

27 lipca 2022 roku

Publikacja androidx.navigation:navigation-*:2.5.1 Wersja 2.5.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Navigation Safe Args nie będzie już powodować ostrzeżeń o wycofaniu w wygenerowanych klasach, gdy używane są niestandardowe typy argumentów zapisane w Bundle. (Id86ed, b/237725966)

Aktualizacje zależności

Wersja 2.5.0

29 czerwca 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.0 Wersja 2.5.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.4.0

  • Integracja CreationExtras – Navigation może teraz udostępniać bezstanowy ViewModelProvider.Factory za pomocą CreationExtras Lifecycle 2.5.0.

Navigation SafeArgs

  • W pakiecie Navigation Safe Args uaktualniono zależność Android Gradle Plugin, aby korzystała z 7.0.4, co spowodowało utratę zgodności z wersjami AGP starszymi niż 7.0.
  • Dodaliśmy obsługę atrybutu build.gradle przestrzeni nazw, który ma być używany zamiast applicationId.

Inne zmiany

  • Interfejs API visibleEntries nie jest już eksperymentalny i udostępnia funkcję pobierania wszystkich wpisów, których miejsce docelowe jest obecnie widoczne zgodnie z NavController.

Wersja 2.5.0-rc02

15 czerwca 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.0-rc02 Wersja 2.5.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd powodujący awarię podczas szybkiego przełączania się między miejscami docelowymi u dołu ekranu przy użyciu funkcji Navigation Compose NavHost. (I3979a, b/234054916)
  • Navigation SafeArgs nie będzie już ulegać awarii podczas używania applicationIdSuffix i przestrzeni nazw bez applicationId lub gdy applicationId i przestrzeń nazw się różnią. (I754b1, b/233119646)
  • NavArgument ma teraz niestandardową funkcję toString(), która pokazuje wewnętrzne wartości argumentu. (I900a8)

Wersja 2.5.0-rc01

11 maja 2022 roku

Publikacja androidx.navigation:navigation-*:2.5.0-rc01 Wersja 2.5.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy nową regułę analizatora kodu, która ostrzega przed umieszczaniem elementów <deeplink> wewnątrz elementów <activity> w pliku navigation.xml (Ic15a5, b/178403185).

Poprawki błędów

  • Zakresy funkcji kompozycyjnych w NavHost i DialogHost są teraz usuwane w oczekiwanej kolejności, tzn. wewnętrzne funkcje kompozycyjne są usuwane przed zewnętrznymi. (I157e6)
  • Komponent SafeArgs nawigacji używa teraz PathSensitivity.RELATIVE w ArgumentsGenerationTask, aby umożliwić przenoszenie pamięci podręcznej. Oznacza to, że wpis w pamięci podręcznej może być teraz ponownie używany od kompilacji CI do kompilacji lokalnej. (I5f67c, b/173420454)
  • Reguła analizy kodu UnrememberedGetBackStackEntryDetector została zaktualizowana, aby wywołanie remember otaczające wywołanie getBackStackEntry() przekazywało również obiekt NavBackStackEntry jako klucz (Ib7081, b/227382831).

Wersja 2.5.0-beta01

20 kwietnia 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.0-beta01 Wersja 2.5.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • DialogNavigator używa teraz popWithTransition podczas wykonywania wywołania dismiss(). Rozwiązuje to problem z sytuacją wyścigu podczas używania ViewModel w miejscu docelowym dialog, który powodował błąd IllegalStateException, gdy użytkownik zamykał okno, używając przycisku wstecz lub klikając poza oknem. (Id7376, b/226552301)

Aktualizacje zależności

  • Nawigacja zależy teraz od Lifecycle 2.5.0-beta01, co rozwiązuje problem z IllegalStateException podczas zagnieżdżania jednego elementu NavHost w innym elemencie NavHost na niegłównej karcie dolnego paska nawigacyjnego, gdy używanych jest wiele stosów wstecznych.

Wersja 2.5.0-alpha04

6 kwietnia 2022 roku

Publikacja androidx.navigation:navigation-*:2.5.0-alpha04 Wersja 2.5.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Poprawki błędów

  • NavHost zależy teraz od visibleEntries z NavController, aby określić, które wpisy mają zostać utworzone. Oznacza to, że podczas korzystania z zagnieżdżonego elementu NavHost wewnętrzny element NavHost powinien teraz prawidłowo animować wyjście. (I4ba2b, b/225394514)
  • Wartość visibleEntries StateFlow podana przez NavController jest teraz oparta na maksymalnym stanie cyklu życia wpisu, a nie na bieżącym stanie cyklu życia. Oznacza to, że nawet jeśli cykl życia hosta navController spadnie poniżej stanu STARTED, lista widocznych wpisów pozostanie taka sama. (I9e2a8, b/225394514)
  • SavedStateViewFactory obsługuje teraz CreationExtras, nawet jeśli zainicjowano go za pomocą SavedStateRegistryOwner. Jeśli podano dodatkowe argumenty, zainicjowane argumenty są ignorowane. (I6c43b, b/224844583)
  • NavDeepLink może teraz analizować identyfikatory URI z jednym parametrem zapytania bez wartości. (I0efe8, b/148905489)
  • Pusty ciąg znaków jest teraz uznawany za prawidłowy argument w precyzyjnych linkach. (I70a0d, b/217399862)
  • Navigation Safe Args nie będzie już ulegać awarii, gdy używane są przestrzenie nazw i nie ma AndroidManifest.xml. (I17ccf, b/227229815)

Wersja 2.5.0-alpha03

23 lutego 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.0-alpha03 Wersja 2.5.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Możesz teraz przekazać CreationExtras do by navGraphViewModels, aby utworzyć ViewModel. (I29217, b/217618359)

Poprawki błędów

  • NavDeepLinks obsługuje teraz prawidłowo zakodowane znaki nowego wiersza umieszczone w identyfikatorach URI tras lub precyzyjnych linków. (I513d1, b/217815060)
  • CreationExtras będzie teraz działać prawidłowo, gdy będzie używany z NavBackStackEntries do tworzenia obiektów ViewModel. (I69161, b/217617710)
  • Navigation Safe Args obsługuje teraz używanie przestrzeni nazw zdefiniowanej w build.gradle zamiast pakietu w pliku AndroidManifest. (I659ef, b/217414933)

Wersja 2.5.0-alpha02

9 lutego 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.0-alpha02 Wersja 2.5.0-alpha02 zawiera te zatwierdzenia.

Poprawki błędów

  • Nawigacja 2.4.1: NavHostFragment będzie teraz prawidłowo ustawiać OnBackPressedDispatcher podczas korzystania z wiązania widoku z wykresami zagnieżdżonymi. (Ifbb51, b/214577959)
  • Nawigacja 2.4.1: podczas precyzyjnego linkowania przez wiele zagnieżdżonych elementów NavGraph stos wsteczny będzie teraz prawidłowo zawierać pośrednie miejsca docelowe. (I504c0, b/214383060)

Wersja 2.5.0-alpha01

26 stycznia 2022 r.

Publikacja androidx.navigation:navigation-*:2.5.0-alpha01 Wersja 2.5.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że próba uzyskania dostępu do elementu ViewModel utworzonego za pomocą by navGraphViewModels() z elementu onCreate() fragmentu kończyła się błędem IllegalStateException. (I8a14d)
  • NavDeepLink nie będzie już niepotrzebnie dekodować argumentów dwukrotnie, co oznacza, że do miejsca docelowego będą przekazywane prawidłowe argumenty. (I31b0a, b/210711399)

Safe Args

  • Wtyczka Safe Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 7.0.4. Oznacza to, że Navigation Safe Args nie będzie już zgodny z wersjami Android Studio starszymi niż 7.0, ale jest teraz zgodny z wtyczką Androida do obsługi Gradle w wersji 7.1.0 lub nowszej. (I41c88, b/213086135, b/207670704)

Wersja 2.4.2

Wersja 2.4.2

6 kwietnia 2022 roku

Publikacja androidx.navigation:navigation-*:2.4.2 Wersja 2.4.2 zawiera te zatwierdzenia.

Poprawki błędów

Wersja 2.4.1

Wersja 2.4.1

9 lutego 2022 r.

Publikacja androidx.navigation:navigation-*:2.4.1 Wersja 2.4.1 zawiera te zatwierdzenia.

Poprawki błędów

  • NavHostFragment będzie teraz prawidłowo ustawiać OnBackPressedDispatcher podczas używania wiązania widoku z wykresami zagnieżdżonymi. (Ifbb51, b/214577959)
  • Podczas precyzyjnego linkowania przez wiele zagnieżdżonych elementów NavGraph stos wsteczny będzie teraz prawidłowo zawierać pośrednie miejsca docelowe. (I504c0, b/214383060)
  • Przeniesione z Nawigacji 2.5.0-alpha01: rozwiązaliśmy problem, który powodował, że dostęp do modelu ViewModel utworzonego za pomocą by navGraphViewModels() z onCreate() fragmentu kończył się błędem IllegalStateException. (I8a14d)
  • Przeniesione z Nawigacji 2.5.0-alpha01: NavDeepLink nie dekoduje już niepotrzebnie argumentów dwukrotnie, co oznacza, że prawidłowo zdekodowane argumenty są teraz przekazywane do miejsca docelowego. (I31b0a, b/210711399)
  • Przeniesione z Nawigacji 2.5.0-alpha01: Safe Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 7.0.4. Oznacza to, że Navigation Safe Args nie będzie już zgodny z wersjami Android Studio starszymi niż 7.0, ale jest teraz zgodny z wtyczką Androida do obsługi Gradle w wersji 7.1.0 lub nowszej. (I41c88, b/213086135, b/207670704)

Wersja 2.4.0

Wersja 2.4.0

26 stycznia 2022 r.

Publikacja androidx.navigation:navigation-*:2.4.0 Wersja 2.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.3.0

  • Wszystkie artefakty nawigacji zostały przepisane w języku Kotlin. Poprawiliśmy dopuszczalność wartości null w klasach korzystających z typów ogólnych (takich jak podklasy NavType). Wszystkie funkcje rozszerzeń Kotlina, które wcześniej były częścią artefaktów -ktx, zostały przeniesione do odpowiednich artefaktów głównych. Artefakty -ktx będą nadal publikowane, ale będą całkowicie puste.
  • Artefakt navigation-fragment zawiera teraz gotową implementację układu z 2 panelami za pomocą nowego elementu AbstractListDetailFragment. Ten fragment używa SlidingPaneLayout do zarządzania panelem listy (który udostępnia Twoja podklasa) i okienkiem szczegółów, które używa NavHostFragment jako implementacji, jak widać w naszej przykładowej implementacji.
  • Metoda currentBackStackEntryAsFlow() w NavController udostępnia Flow, który jest emitowany przy każdej zmianie bieżącego NavBackStackEntry. Ten proces może być używany jako alternatywa dla ręcznego zarządzania OnDestinationChangedListener.
  • NavController umożliwia teraz pobieranie listy wszystkich widocznych instancji NavBackStackEntry jako StateFlow za pomocą eksperymentalnej właściwości visibleEntries.
  • Można teraz rozszerzyć klasę NavType, aby tworzyć niestandardowe typy NavType. Typy niestandardowe są obsługiwane tylko wtedy, gdy tworzysz wykres nawigacyjny automatycznie, np. za pomocą języka DSL Kotlin wykresu nawigacyjnego.
  • Nawigacja udostępnia teraz interfejsy API findStartDestination() i getHierarchy(), które mogą pomóc we wdrażaniu niestandardowego interfejsu NavigationUI. findStartDestination() to funkcja rozszerzenia w NavGraph, która lokalizuje rzeczywiste miejsce docelowe wyświetlane po przejściu do wykresu, nawet jeśli startDestination jest zagnieżdżonym NavGraph. getHierarchy() to funkcja w NavDestination, która pozwala sprawdzić, czy dane miejsce docelowe znajduje się w hierarchii innego miejsca docelowego.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • Metody NavigationUI, które przyjmowały BottomNavigationView, zostały zaktualizowane, aby przyjmowały klasę nadrzędną wprowadzoną w Material 1.4.0, NavigationBarView. Dzięki temu będzie można używać tych metod w NavigationRailView.

  • Podczas rozwijania elementu <action> za pomocą kodu XML atrybuty animacji mogą używać atrybutów pobranych z motywu za pomocą składni app:enterAnim="?attr/transitionEnter".

  • Safe Args generuje teraz metodę fromSavedStateHandle() dla każdej klasy NavArgs. (#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)
    }
    

Trasy nawigacji i Kotlin DSL

Poprzednie wersje komponentu Navigation wymagały, aby każde miejsce docelowe miało stały identyfikator w postaci liczby całkowitej, który jednoznacznie odróżniał je od innych miejsc docelowych i umożliwiał navigate() do tego miejsca docelowego bezpośrednio lub za pomocą działania. Chociaż nadal jest to prawidłowe i przydatne, zwłaszcza w przypadkach, gdy definiujesz graf nawigacji w XML i możesz używać automatycznie generowanych stałych R.id lub Safe Args (które używają tych stałych do generowania kodu w czasie kompilacji), ten system unikalnych liczb całkowitych nie oddaje znaczenia semantycznego i ekspresyjności potrzebnych do obsługi w pełni dynamicznych grafów tworzonych programowo w czasie działania za pomocą Navigation Kotlin DSL.

W tej wersji wprowadziliśmy nową opcję jednoznacznego identyfikowania miejsca docelowego na wykresie nawigacyjnym za pomocą trasy. Trasa to String, który definiuje unikalną ścieżkę do miejsca docelowego. Wszystkie metody DSL w języku Kotlin, które przyjmowały identyfikator miejsca docelowego, zostały wycofane i zastąpione odpowiednim interfejsem API, który przyjmuje trasę.

Każdą trasę należy traktować jako część „ścieżki” Uri, która definiuje to miejsce docelowe, np. home, profile/{userId}, profile/{userId}/friends itp. Gdy tożsamość miejsca docelowego jest powiązana z konkretnym elementem treści, te argumenty dynamiczne powinny być częścią trasy, zgodnie z tymi samymi regułami co precyzyjne linki typu implicit.

Wszystkie interfejsy API NavController, które wcześniej przyjmowały tylko identyfikator, mają teraz przeciążenie, które przyjmuje trasę String. Obejmuje to: navigate(), popBackStack(), popUpTo() i getBackStackEntry().

Miało to pewne konsekwencje dla interfejsu API:

  • Właściwość popUpTo w języku Kotlin w DSL Kotlin została wycofana na rzecz popUpToId.
  • Interfejs API getStartDestination() został wycofany na rzecz interfejsu getStartDestinationId().

W przeciwieństwie do nawigacji według identyfikatora nawigacja według trasy podlega tym samym regułom co precyzyjne linki typu implicit, ponieważ możesz bezpośrednio przejść do dowolnego miejsca docelowego na dowolnym zagnieżdżonym wykresie. Dzięki temu te trasy mogą być używane w projektach wielomodułowych bez konieczności dodawania do każdego miejsca docelowego widocznego z zewnątrz precyzyjnego linku.

Navigation Compose

Artefakt navigation-compose zapewnia integrację komponentu nawigacji z Jetpack Compose. Używa funkcji @Composable jako miejsc docelowych w aplikacji.

Ta wersja zawiera:

  • Funkcja kompozycyjna NavHost, która umożliwia utworzenie wykresu nawigacji za pomocą Kotlin DSL przy użyciu miejsc docelowych composable i dialog oraz obsługuje opcjonalne nawigatory, takie jak te z Accompanist Navigation Material.
  • Obowiązkowa obsługa płynnych przejść między miejscami docelowymi. Accompanist Navigation Animation można używać do kontrolowania przejść wejścia i wyjścia za pomocą eksperymentalnych interfejsów API Compose.
  • Zakres Lifecycle dla każdego miejsca docelowego, które można utworzyć. Każde miejsce docelowe osiąga stan RESUMED dopiero po zakończeniu przejść wejściowych i natychmiast przechodzi w stan STARTED, gdy rozpoczynają się przejścia wyjściowe. Pozwala to uniknąć wszystkich problemów z IllegalStateException i multidotykiem, ponieważ wywołanie navigate jest wyzwalane tylko wtedy, gdy Lifecycle ma stan RESUMED.
  • Określanie zakresu ViewModel (za pomocą interfejsu API viewModel() biblioteki Lifecycle ViewModel Compose 2.4.0 lub hiltViewModel() biblioteki Hilt Navigation Compose 1.0.0 na poziomie miejsca docelowego), co zapewnia zakres, który przetrwa zmiany konfiguracji i pozostanie na stosie wstecznym (gdy zawartość funkcji kompozycyjnej zostanie usunięta), oraz sygnał w metodzie onCleared() obiektu ViewModel, który wskazuje na trwałe usunięcie i wyczyszczenie stanu powiązanego z tym elementem NavBackStackEntry.
  • Określanie zakresu stanu rememberSaveable na poziomie miejsca docelowego, co zapewnia automatyczne zapisywanie i przywracanie wszystkich stanów funkcji kompozycyjnych po powrocie do miejsca docelowego.
  • Pełna obsługa zapisywania i przywracania stanu elementu NavController oraz stanu jego miejsca docelowego po śmierci procesu i jego ponownym utworzeniu.
  • Automatyczna integracja z systemowym przyciskiem Wstecz.
  • Obsługa przekazywania argumentów, dołączania precyzyjnych linków do miejsc docelowych i zwracania wyniku do poprzednich miejsc docelowych.

  • Utwórz określone funkcje pomocnicze w rememberNavController() i currentBackStackEntryAsState(), aby umożliwić podnoszenie stanu i łączenie NavController z komponentami kompozycyjnymi poza NavHost (np. dolnym paskiem nawigacyjnym).

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()
        }
    }
}

Więcej informacji znajdziesz w przewodniku po nawigacji w Compose.

Wiele stosów wstecznych

NavController odpowiada za zarządzanie stosem wstecznym miejsc docelowych, dodając miejsca docelowe do stosu wstecznego, gdy navigate() do nich, i usuwając je, gdy wywołujesz popBackStack() lub aktywujesz przycisk Wstecz systemu. Istniejąca klasa NavOptions i integracja z elementami <action> w pliku XML wykresu nawigacyjnego zostały rozszerzone, aby obsługiwać zapisywanie i przywracanie stosu wstecznego.

W ramach tej zmiany metody NavigationUI interfejsów onNavDestinationSelected(), BottomNavigationView.setupWithNavController() i NavigationView.setupWithNavController() automatycznie zapisują i przywracają stan usuniętych miejsc docelowych, co umożliwia obsługę wielu stosów wstecznych bez wprowadzania zmian w kodzie. Jeśli używasz nawigacji z fragmentami, jest to zalecany sposób integracji z wieloma stosami wstecznymi.

Podstawowe interfejsy API do zapisywania i przywracania stanu są udostępniane na kilka sposobów:

  • W pliku XML nawigacji element <action> może teraz używać atrybutów logicznych app:popUpToSaveState i app:restoreState, aby zapisywać stan wszystkich miejsc docelowych usuniętych za pomocą app:popUpTo i przywracać stan powiązany z miejscem docelowym przekazanym jako app:destination:

    <action
      android:id=”@+id/swap_stack”
      app:destination=”@id/second_stack”
      app:restoreState=”true”
      app:popUpTo=”@id/first_stack_start_destination”
      app:popUpToSaveState=”true” />
    
  • W navOptions Kotlin DSL możesz dodać właściwość logiczną restoreState i właściwość logiczną saveState w popUpTo builder:

    // Use the navigate() method that takes a navOptions DSL Builder
    navController.navigate(selectedBottomNavRoute) {
      launchSingleTop = true
      restoreState = true
      popUpTo(navController.graph.findStartDestination().id) {
        saveState = true
      }
    }
    
  • Podczas ręcznego tworzenia obiektu NavOptions za pomocą NavOptions.Builder możesz użyć setRestoreState() i nowego przeciążenia do setPopUpTo(), które przyjmuje dodatkowy parametr saveState.

    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);
    
  • Wywołania automatyczne do popBackStack() mogą teraz zawierać dodatkowy parametr saveState.

  • Możesz użyć metody clearBackStack(), aby wyczyścić stan zapisany za pomocą metody popBackStack() lub popUpToSaveState.

We wszystkich przypadkach NavController zapisze i przywróci stan każdego elementu NavBackStackEntry, w tym wszystkie instancje ViewModel o zakresie miejsca docelowego nawigacji. Interfejsy API Navigator zostały zaktualizowane, aby każdy element Navigator mógł zapisywać i przywracać swój stan.

Zmiany w zachowaniu

  • NavDeepLinkBuilder dodaje teraz PendingIntent.FLAG_IMMUTABLE do PendingIntent zwracanego przez createPendingIntent(), dzięki czemu ten interfejs API działa zgodnie z oczekiwaniami, gdy jest kierowany na Androida 12.
  • Nawigacja zależy teraz od Lifecycle 2.3.1 i oznacza metody setGraph(), popBackStack(), navigateUp() i navigate(), które aktualizują NavBackStackEntry Lifecycle, jako @MainThread, dostosowując nawigację do wymuszania wątku głównego wprowadzonego w Lifecycle 2.3.0.
  • Precyzyjne linki sprawdzają teraz, czy w Uri są obecne wszystkie wymagane argumenty (te bez wartości domyślnych).
  • W argumentach analizowanych przez NavDeepLink znaki krzyżyka są teraz traktowane tak samo jak znaki zapytania jako separator między segmentami ścieżki, co zapobiega rozciąganiu argumentu na znak krzyżyka.
  • Podczas generowania działań kod Kotlin wygenerowany z Safe Args umieszcza teraz argumenty bez wartości domyślnych przed argumentami z wartościami domyślnymi jako parametry.
  • Podczas generowania argumentów Safe Args umieszcza teraz parametry bez wartości domyślnych przed tymi z wartościami domyślnymi.
  • Safe-Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 4.2.0. Oznacza to, że nie powinno już pojawiać się ostrzeżenie o używaniu applicationIdTextResource.

Znane problemy

  • Naprawiono w Navigation 2.5.0-alpha01: próba uzyskania dostępu do elementu ViewModel utworzonego za pomocą by navGraphViewModels() z onCreate() fragmentu zakończy się błędem IllegalStateException. (b/213504272)
  • Naprawiono w Navigation 2.5.0-alpha01: Safe Args 2.4.0 jest niezgodny z wtyczką Androida do obsługi Gradle w wersji 7.1.0 lub nowszej. (b/213086135)
  • Precyzyjne linkowanie z wieloma zagnieżdżonymi wykresami nawigacji nie tworzy prawidłowo pełnego stosu wstecznego. (b/214383060)

Wersja 2.4.0-rc01

15 grudnia 2021 roku

Publikacja androidx.navigation:navigation-*:2.4.0-rc01 Wersja 2.4.0-rc01 zawiera te zatwierdzenia.

Zmiany w zachowaniu

  • Argumenty analizowane przez NavDeepLink traktują teraz znaki funta w taki sam sposób jak znaki zapytania, czyli jako separator między argumentami. (I21309, b/180042703)

Poprawki błędów

  • Precyzyjne linki nie będą już ignorować argumentów o wartościach takich samych jak nazwa obiektu zastępczego. (If8017, b/207389470)
  • NavController nie będzie już ulegać awarii podczas usuwania zagnieżdżonego miejsca docelowego za pomocą przejść po przywróceniu NavController. (I0f7c9, b/205021623)
  • Jeśli użyjesz nieprawidłowego parametru startDestination, komunikat o błędzie będzie teraz domyślnie przekierowywać do trasy miejsca docelowego, jeśli jest dostępna. (I86b9d, b/208041894)

Poprawki błędów w Navigation Compose

  • Naprawiliśmy potencjalną awarię spowodowaną szybkim przełączaniem się między miejscem początkowym a innym miejscem docelowym za pomocą elementów dolnego menu nawigacyjnego. (Ic8976, b/208887901)
  • Po zmianach konfiguracji lub śmierci procesu miejsce docelowe okna jest teraz prawidłowo przywracane u góry ekranu. (I4c0dc, b/207386169)
  • Rozwiązaliśmy problem, który powodował, że próba pobrania ViewModel z NavBackStackEntry okna nie powiodła się, gdy okno zostało zamknięte. (I6b96d, b/206465487)
  • Rozwiązaliśmy problem, który występował podczas używania miejsc docelowych activity z NavHost w Navigation Compose i powodował nieskończone rekompozycje. (I8f64c)
  • Naprawiliśmy wyciek w Navigation Compose, który powodował, że po zmianie konfiguracji lub śmierci procesu zachowywane było odwołanie do starej aktywności. (I4efcb, b/204905432)

Poprawki błędów w Safe Args

  • SafeArgs nie ulega już awarii podczas próby przywrócenia niestandardowych tablic Parcelable po śmierci procesu. (I618e8, b/207315994)
  • Naprawiliśmy błąd w Safe Args, który uniemożliwiał tablicom wartości logicznych posiadanie wartości null. (I8c396, b/174787525)

Wersja 2.4.0-beta02

3 listopada 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-beta02 Wersja 2.4.0-beta02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Obsługa precyzyjnych linków typu explicit i implicit automatycznie dodaje teraz flagę saveState podczas przechodzenia do innego wykresu, dzięki czemu kod taki jak NavigationUI.setupWithNavController i kod korzystający z wielu stosów wstecznych działa zgodnie z oczekiwaniami. (Ic8807)

Zmiany w zachowaniu

  • Wzorce precyzyjnych linków są teraz kompilowane leniwie w klasie NavDeepLink, a nie podczas inflacji. Powinno to skrócić czas wypełniania wykresów nawigacji zawierających precyzyjne linki. (b8d257, b/184149935)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że po przejściu do Lifecycle.State.STARTED obiekty NavBackStackEntry były przenoszone do Lifecycle.State.CREATED, gdy NavHost był dodawany bezpośrednio do setContent() aktywności. (Ia5ac1, b/203536683)
  • Naprawiliśmy sytuację wyścigu, w której usunięcie miejsca docelowego DialogFragment ze stosu wstecznego przed wyświetleniem okna nie powodowało jego zamknięcia, co prowadziło do awarii, gdy użytkownik ręcznie zamykał błędne okno. (I687e5)
  • Rozwiązaliśmy problem, który powodował, że interfejs API onNavDestinationSelected na platformie NavigationUI zwracał wartość true, nawet jeśli nie wykonano operacji navigate() na tym wykresie nawigacji. Teraz używa tej samej logiki, która jest używana wewnętrznie przez setupWithNavController, aby wybrać tylko MenuItem powiązany z bieżącym miejscem docelowym za pomocą hierarchy miejsca docelowego. (I2b053)

Wersja 2.4.0-beta01

27 października 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-beta01 Wersja 2.4.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • Możesz teraz używać by navGraphViewModel z trasą zamiast identyfikatora, aby lepiej obsługiwać Navigation Kotlin DSL z fragmentami. (I901e3, b/201446416)

Zmiany w interfejsie API

  • Interfejs API visibleEntries jest teraz eksperymentalny. (I93f6f)

Poprawki błędów

  • ViewModels nie będą już niszczone, gdy przejścia zostaną przerwane przez przechodzenie tam i z powrotem między tymi samymi ekranami (Id52d8, b/200817333).
  • Argumenty NavDeepLink, które mogą mieć wartość null, nie wymagają już wartości domyślnej podczas dodawania precyzyjnych linków do obiektów NavDestination. (I5aad4, b/201320030)
  • Obiekty NavBackStackEntry z różnymi cyklami życia nie są już uważane za równe. Oznacza to, że NavHost będzie prawidłowo rekomponować wszystkie miejsca docelowe podczas nawigacji z singleTop i ponownego wybierania elementów menu dolnego. (I1b351, b/196997433)
  • Rozwiązaliśmy problem z AbstractListDetailFragment, który powodował, że atrybuty layout_width i layout_weight w panelu listy zwracanym przez onCreateListPaneView() były nieprawidłowo obsługiwane lub ignorowane. (f5fbf3)
  • Stan wizualny miejsc docelowych okna jest teraz prawidłowo synchronizowany ze stanem DialogFragmentNavigator. Oznacza to, że ręczne wywołanie asynchronicznego interfejsu API dismiss() dla DialogFragment teraz prawidłowo czyści wszystkie miejsca docelowe okna powyżej zamkniętego okna. Nie ma to wpływu na przypadki, w których do zamknięcia okna używasz funkcji popUpTo lub popBackStack(). (I77ba2)
  • AbstractAppBarOnDestinationChangedListener ma teraz bardziej przejrzyste komunikaty o błędach dotyczące onDestinationChanged(). (Ie742d)

Wersja 2.4.0-alpha10

29 września 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha10 Wersja 2.4.0-alpha10 zawiera te zatwierdzenia.

Nowe funkcje

  • NavController umożliwia teraz pobieranie listy wszystkich widocznych instancji NavBackStackEntry za pomocą visibleEntries StateFlow (Ia964e).
  • rememberNavController() przyjmuje teraz opcjonalny zestaw instancji Navigator, które zostaną dodane do zwracanego NavController, aby lepiej obsługiwać opcjonalne obiekty Navigator, takie jak te z Accompanist Navigation Material. (I4619e)

Poprawki błędów

  • Nawigacja dynamiczna nie będzie już ulegać awarii po ponownym utworzeniu aktywności. (Ifa6a3, b/197942869)
  • Rozwiązaliśmy problem z systemowym przyciskiem Wstecz, który występował tylko po powrocie do miejsca docelowego, które można utworzyć i które zawiera element NavHost. (3ed148, b/195668143)
  • SafeArgs generuje teraz argumenty dla fromBundle() i fromSavedStateHandle() we właściwej kolejności parametrów. (I824a8, b/200059831)

Wersja 2.4.0-alpha09

15 września 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha09 Wersja 2.4.0-alpha09 zawiera te zatwierdzenia.

Nowe funkcje

  • Możesz teraz użyć metody clearBackStack(), aby wyczyścić stan zapisany za pomocą popBackStack() lub popUpToSaveState. (I80a0f)
  • Możesz teraz przekazać listę argumentów lub precyzyjnych linków do kreatora zagnieżdżonego wykresu nawigacyjnego, a zostaną one automatycznie dodane do wynikowego wykresu. (I8a470, b/182545357)

Zmiany w interfejsie API

  • Funkcja navArgument Kotlin DSL jest teraz częścią navigation-common, a nie navigation-compose. Aby nadal korzystać z tej funkcji, musisz zaktualizować importy. (I1d095)

Zmiany w zachowaniu

  • Podczas generowania argumentów Safe Args umieszcza teraz parametry bez wartości domyślnych przed tymi z wartościami domyślnymi. (I89709, b/198493585)

Poprawki błędów

  • Podczas korzystania z Navigation Compose obiekty NavGraph będą DESTROYED dopiero wtedy, gdy wszystkie ich elementy podrzędne będą DESTROYED. (I86552, b/198741720)
  • Argumenty NavDeepLink, które mogą mieć wartość null, nie wymagają już wartości domyślnej. (Ia14ef, b/198689811)
  • Wywołanie setGraph() z nowym wykresem spowoduje teraz wyczyszczenie wszystkich zapisanych stosów wstecznych, a nie tylko usunięcie stosu wstecznego, jak miało to miejsce wcześniej. (I97f96)
  • Rozwiązaliśmy problem, który powodował, że podczas korzystania z launchSingleTop instancje OnDestinationChangedListener i currentBackStackEntryFlow nie były powiadamiane. (Iaaebc)

Aktualizacje zależności

Wersja 2.4.0-alpha08

1 września 2021 roku

Publikacja androidx.navigation:navigation-*:2.4.0-alpha08 Wersja 2.4.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

Zmiany w zachowaniu

  • Podczas generowania działań kod Kotlin wygenerowany z Safe Args umieszcza teraz argumenty bez wartości domyślnych przed argumentami z wartościami domyślnymi jako parametry. (Idb697, b/188855904)
  • Precyzyjne linki sprawdzają teraz, czy w Uri są obecne wszystkie wymagane argumenty (te bez wartości domyślnych). (#204, b/185527157)

Poprawki błędów

  • Użycie funkcji getBackStackEntry i previousBackStackEntry wewnątrz funkcji composable() w połączeniu z remember() nie będzie już powodować wyjątku z powodu braku miejsca docelowego na stosie wstecznym. (I75138, b/194313238)
  • Komponent Navigation Compose teraz prawidłowo przeprowadza rekompozycję po zmianie argumentów stosu wstecznego i użyciu launchSingleTop=true. (Iebd69, b/186392337)
  • Podczas wywoływania setGraph z wykresem z 13 lub 29 miejscami docelowymi nie będzie już występować błąd ArrayIndexOutOfBoundsException. (I1a9f1, b/195171984)
  • Generator SafeArgs w języku Java nie powinien już powodować ostrzeżeń linta podczas generowania klas Args. (I1a666, b/185843837)

Zewnętrzny wkład

  • Dziękujemy użytkownikowi ospixd za zapewnienie, że precyzyjne linki sprawdzają, czy wszystkie wymagane argumenty (te bez wartości domyślnych) są obecne w Uri. (#204, b/185527157)

Wersja 2.4.0-alpha07

18 sierpnia 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha07 Wersja 2.4.0-alpha07 zawiera te zatwierdzenia.

Poprawki błędów

  • Navigation Compose teraz prawidłowo zapisuje stan po zmianach konfiguracji i podczas zmiany wykresów przy użyciu funkcji wielu stosów wstecznych. (If5a3d, b/195141957)
  • Ponowne wybranie tej samej karty podczas korzystania z funkcji Navigation Compose z wieloma stosami wstecznymi nie będzie już powodować wyświetlenia pustego ekranu. (I860dc, b/194925622)
  • NavHost teraz obserwuje zmiany w Lifecycle.State NavBackStackEntry, co oznacza, że użycie NavHost we fragmencie będzie teraz prawidłowo rekomponowane w miarę zmian cyklu życia, zamiast powodować wyświetlanie pustego ekranu. (I4eb85, b/195864489)
  • Rozwiązaliśmy problem, który powodował, że po zamknięciu DialogFragment stan NavController nie był prawidłowo aktualizowany po ponownym utworzeniu aktywności (np. po zmianie konfiguracji). (Icd72b)
  • Rozwiązaliśmy problem, który powodował, że po zamknięciu miejsca docelowego okna nie aktualizowała się obsługa przycisku Wstecz przez NavController, co mogło powodować, że NavController przechwytywał przycisk Wstecz, mimo że nie miał żadnego stosu wstecznego do zamknięcia. (If3b34)
  • Safe-args automatycznie generuje teraz metodę toSavedStateHandle dla argumentów, których można używać do testowania kodu ViewModel. (If1e2d, b/193353880)

Wersja 2.4.0-alpha06

4 sierpnia 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha06 Wersja 2.4.0-alpha06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Nazwy metod requireSlidingPaneLayout() i requireDetailPaneNavHostFragment() w AbstractListDetailFragment zostały zmienione odpowiednio na getSlidingPaneLayout() i getDetailPaneNavHostFragment(). (I34a08)

Zmiany w zachowaniu

  • Podczas nawigacji z animacjami (np. Crossfade) Lifecycle nowego miejsca docelowego będzie osiągać RESUMED dopiero po zakończeniu animacji. (If0543, b/172112072, b/194301889)
  • NavHost w Navigation Compose ustawia teraz graf jako część pierwszej kompozycji. (Ieb7be)

Poprawki błędów

  • Usunięcie ostatniego miejsca docelowego z wykresu nawigacyjnego nie powoduje już błędu ClassCastException. (If0543, b/172112072, b/194301889)
  • Naprawiliśmy błąd (NullPointerException), który występował podczas dodawania precyzyjnego linku bez Uri i nawigowania za pomocą trasy lub precyzyjnego linku. (938a0c, b/193805425)
  • Rozwiązaliśmy problem w Navigation Compose, który powodował, że element NavBackStackEntry z precyzyjnym linkiem nie osiągał stanu RESUMED. (I192c5)
  • Rozwiązaliśmy problem, który powodował, że wyskakujące okno miejsca docelowego nie aktualizowało obsługi przycisku Wstecz w NavController, co mogło powodować przechwytywanie przycisku Wstecz przez NavController, mimo że nie było żadnego stosu wstecznego do wyskakującego okna. (aosp/1782668)

Wersja 2.4.0-alpha05

21 lipca 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha05 Wersja 2.4.0-alpha05 zawiera te zatwierdzenia.

Zmiany w zachowaniu

  • Funkcja NavHost w Navigation Compose zawsze używa teraz przejść podczas nawigacji między miejscami docelowymi. (I07049, b/172112072)
  • Możesz teraz wprowadzać zmiany w grafie NavHost. Wykresy z tym samym elementem startDestination i miejscami docelowymi na wykresie będą uznawane za równe i nie będą czyścić stosu wstecznego NavController. (I0b8db, b/175392262)

Poprawki błędów

  • Naprawiliśmy błąd NoSuchElementException, który występował podczas wywoływania popBackStack() z poziomu LifecycleObserver dołączonego do NavBackStackEntry i był spowodowany przez ponowne aktualizacje stanu NavController. (I64621)
  • AbstractListDetailFragment umożliwia teraz całkowite usunięcie SlidingPaneLayout z pliku APK, gdy nie używasz AbstractListDetailFragment. (I611ad)
  • Klasy NavGraph i NavDestination zastępują teraz metodę equals, dzięki czemu 2 obiekty o tych samych wartościach będą uznawane za równe. (I166eb, b/175392262)

Wersja 2.4.0-alpha04

1 lipca 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha04 Wersja 2.4.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Artefakt navigation-fragment zawiera teraz gotową implementację układu z 2 panelami za pomocą nowego elementu AbstractListDetailFragment. Ten fragment używa SlidingPaneLayout do zarządzania panelem listy (który udostępnia Twoja podklasa) i okienkiem szczegółów, które używa NavHostFragment jako implementacji, jak widać w naszej przykładowej implementacji. (Iac4be, b/191276636)
  • NavHost artefaktu navigation-compose obsługuje teraz miejsca docelowe dialog oprócz miejsc docelowych composable. Każde z tych miejsc docelowych okna będzie wyświetlane w kompozycyjnym elemencie Dialog, który będzie unosić się nad bieżącym miejscem docelowym composable. (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()
            }
        }
    }

Zmiany w interfejsie API

  • Funkcja add w NavigatorState została zmieniona na push. Wszystkie bieżące wywołania add() trzeba będzie zmienić na push(). (Ie89fc, b/172112072)
  • Niestandardowe instancje Navigator mogą teraz używać interfejsów API pushWithTransaction i popWithTransition w NavigatorState, aby asynchronicznie przesyłać lub pobierać miejsce docelowe. Pamiętaj, że te interfejsy API nie są jeszcze używane przez żadne z dołączonych narzędzi nawigacyjnych. (Ic4d7c, b/172112072)

Zmiany w zachowaniu

  • NavDeepLinkBuilder dodaje teraz PendingIntent.FLAG_IMMUTABLE do PendingIntent zwracanego przez createPendingIntent(), dzięki czemu ten interfejs API działa zgodnie z oczekiwaniami, gdy jest kierowany na Androida 12. (If8c52)

Poprawki błędów

  • Rozwiązaliśmy problem z <include-dynamic>, który powodował, że argumenty przekazywane do wykresu nie były prawidłowo przekazywane do wykresu uwzględnianego dynamicznie. (I3e115)
  • Naprawiliśmy błąd NullPointerException występujący podczas przechodzenia do miejsca docelowego za pomocą argumentu string[] z wartością domyślną @null. (I1fbe8)
  • Dodano reguły ProGuard dla @Navigator.Name, co rozwiązuje problemy podczas korzystania z trybu pełnego R8 3.1. (I2add9, b/191654433)
  • SafeArgs nie będzie już powodować błędów podczas tworzenia aplikacji za pomocą Kotlin w wersjach starszych niż 1.5.0. (Icd1ff, b/190739257)

Wersja 2.4.0-alpha03

16 czerwca 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha03 Wersja 2.4.0-alpha03 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że do przejścia do dołączonego wykresu dynamicznego potrzebne były 2 wywołania navigate(). (I7785c, b/188859835)
  • Naprawiliśmy błąd regresji wprowadzony w Nawigacji 2.4.0-alpha01, który powodował, że setupActionBarWithNavController() nie usuwał prawidłowo ikony „W górę”, gdy użytkownik znajdował się w miejscu docelowym najwyższego poziomu. (I5d443, b/189868637)
  • Naprawiliśmy błąd IllegalStateException występujący podczas wywoływania popBackStack() po wcześniejszym usunięciu wykresu głównego elementu NavController. (I2a330, b/190265699)
  • Reguły ProGuard dla by navArgs() są teraz prawidłowo stosowane podczas korzystania z navigation-common lub dowolnych artefaktów, które od niego zależą. (I68800, b/190082521)
  • OnDestinationChangedListener, który wywołuje navigate() przy pierwszym otrzymaniu wywołania zwrotnego, teraz prawidłowo otrzymuje drugie wywołanie zwrotne z miejscem docelowym, do którego nastąpiło przejście. (Ie5f9e, b/190228815)
  • Safe Args nie powoduje już awarii, gdy jest używany z modułami funkcji dynamicznych i wtyczką Androida do obsługi Gradle w wersji 7.0 lub nowszej (I69518, b/189966576).

Znany problem

  • W przypadku Gradle 6.7.0 Safe Args nie zadziała i wyświetli błąd Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’ z powodu zależności od starszej wersji Kotlina. Aby rozwiązać ten problem, zaktualizuj Gradle do wersji 7.0. (b/190739257)

Wersja 2.4.0-alpha02

2 czerwca 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha02 Wersja 2.4.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

  • Trasy są teraz obsługiwane w przypadku miejsc docelowych aktywności, fragmentów i okien dialogowych, a także w całym języku DSL DynamicNavigation w Kotlinie. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
  • W NavigationUI tymczasowo dodano eksperymentalne interfejsy API, które umożliwiają rezygnację z zapisywania stanu. Zawsze zapisywanie stanu jest prawidłowym zachowaniem, ale nadal używane są wycofane biblioteki (np.zachowane fragmenty), które nie mogą być obsługiwane podczas zapisywania stanu. Dzięki temu aplikacje mogą powoli przechodzić na nieobsługiwane interfejsy API. (Idf93c)
  • Nawigacja udostępnia teraz interfejsy API findDestination() i getHierarchy(), które mogą pomóc we wdrażaniu niestandardowego interfejsu NavigationUI. findDestination() to funkcja rozszerzenia w NavGraph, która lokalizuje miejsce docelowe na wykresie. getHierarchy() to funkcja w NavDestination, która może służyć do sprawdzania, czy dane miejsce docelowe znajduje się w hierarchii innego miejsca docelowego (I2932f, b/188183365).

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • Metody NavigationUI, które przyjmowały BottomNavigationView, zostały zaktualizowane, aby przyjmowały klasę nadrzędną wprowadzoną w Material 1.4.0, NavigationBarView. Dzięki temu będzie można używać tych metod w NavigationRailView. (Ib0b36, b/182938895)

  • Podczas rozwijania elementu <action> za pomocą kodu XML atrybuty animacji mogą używać atrybutów pobranych z motywu za pomocą składni app:enterAnim="?attr/transitionEnter". (I07bc1, b/178291654)

Zmiany w interfejsie API

  • Kreatory DSL w języku Kotlin, które używają identyfikatora, zostały wycofane i należy je zastąpić kreatorami, które używają tras (I85b42, b/188816479) (I9f58f, b/188816479).

Poprawki błędów

  • DialogFragmentNavigator używa teraz interfejsu API NavigatorState.pop(), aby informować NavController, gdy okno zostanie zamknięte przez naciśnięcie systemowego przycisku Wstecz lub kliknięcie poza nim. Dzięki temu stan NavController jest zawsze zsynchronizowany ze stanem nawigatora. (I2ead9)
  • Nawigacja nie powoduje już błędu ConcurrentModificationException podczas manipulowania listą OnDestinationChangedListeners z wywołania zwrotnego onDestinationChanged. (Ib1707, b/188860458)

  • Safe Args nie ulega już awarii podczas próby wygenerowania właściwości kierunku w Kotlin. (Id2416, b/188564435)

  • Metoda setId w NavDestination jest teraz prawidłowo oznaczona adnotacją @IdRes, więc akceptuje tylko identyfikatory zasobów. (I69b80)

  • Parametr int findNode to teraz resId zamiast resid. (I7711d)

Aktualizacja zależności

  • Safe-Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 4.2.0. Oznacza to, że nie powinno już pojawiać się ostrzeżenie o używaniu applicationIdTextResource. (I6d67b, b/172824579)

Wersja 2.4.0-alpha01

18 maja 2021 r.

Publikacja androidx.navigation:navigation-*:2.4.0-alpha01 Wersja 2.4.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Metoda currentBackStackEntryAsFlow() w NavController udostępnia Flow, który jest emitowany przy każdej zmianie bieżącego NavBackStackEntry. Ten proces może być używany jako alternatywa dla ręcznego zarządzania OnDestinationChangedListener. (I19c4a, #89, b/163947280)

Wiele stosów wstecznych

NavController odpowiada za zarządzanie stosem wstecznym miejsc docelowych, dodając miejsca docelowe do stosu wstecznego, gdy navigate() do nich, i usuwając je, gdy wywołujesz popBackStack() lub aktywujesz przycisk Wstecz systemu. Istniejąca klasa NavOptions i integracja z wpisami <action> w pliku XML wykresu nawigacyjnego zostały rozszerzone, aby obsługiwać zapisywanie i przywracanie stosu wstecznego. (b/80029773)

W ramach tej zmiany metody NavigationUI interfejsów onNavDestinationSelected(), BottomNavigationView.setupWithNavController() i NavigationView.setupWithNavController() automatycznie zapisują i przywracają stan usuniętych miejsc docelowych, co umożliwia obsługę wielu stosów wstecznych bez wprowadzania zmian w kodzie. Jeśli używasz nawigacji z fragmentami, jest to zalecany sposób integracji z wieloma stosami wstecznymi. (Ie07ca)

Podstawowe interfejsy API do zapisywania i przywracania stanu są udostępniane na kilka sposobów:

  • W pliku XML nawigacji element <action> może teraz używać atrybutów logicznych app:popUpToSaveState i app:restoreState, aby zapisywać stan wszystkich miejsc docelowych usuniętych za pomocą app:popUpTo i przywracać stan powiązany z miejscem docelowym przekazanym jako app:destination:

    <action
      android:id=”@+id/swap_stack”
      app:destination=”@id/second_stack”
      app:restoreState=”true”
      app:popUpTo=”@id/first_stack_start_destination”
      app:popUpToSaveState=”true” />
    
  • W navOptions Kotlin DSL możesz dodać właściwość logiczną restoreState i właściwość logiczną saveState w popUpTo builder:

    // Use the navigate() method that takes a navOptions DSL Builder
    navController.navigate(selectedBottomNavRoute) {
      launchSingleTop = true
      restoreState = true
      popUpTo(navController.graph.startDestinationId) {
        saveState = true
      }
    }
    
  • Podczas ręcznego tworzenia obiektu NavOptions za pomocą NavOptions.Builder możesz użyć setRestoreState() i nowego przeciążenia do setPopUpTo(), które przyjmuje dodatkowy parametr saveState.

    NavOptions navOptions = new NavOptions.Builder()
      .setLaunchSingleTop(true)
      .setRestoreState(true)
      .setPopUpTo(navController.getGraph().getStartDestinationId(),
        false, // inclusive
        true) // saveState
      .build();
    navController.navigate(selectedBottomNavId, null, navOptions);
    
  • Wywołania automatyczne do popBackStack() mogą teraz zawierać dodatkowy parametr saveState.

We wszystkich przypadkach NavController zapisze i przywróci stan każdego elementu NavBackStackEntry, w tym wszystkie instancje ViewModel o zakresie miejsca docelowego nawigacji. Interfejsy API Navigator zostały zaktualizowane, aby każdy element Navigator mógł zapisywać i przywracać swój stan.

Zarówno ComposeNavigator używany w przypadku miejsc docelowych composable w Navigation Compose, jak i FragmentNavigator oraz DynamicFragmentNavigator używane w przypadku miejsc docelowych <fragment> w Navigation z fragmentami zostały zaktualizowane, aby korzystać z nowych interfejsów API Navigator i obsługiwać zapisywanie i przywracanie stanu.

Trasy nawigacji

Trasa to String, która jednoznacznie identyfikuje miejsce docelowe. Wcześniej ta koncepcja była używana tylko w Navigation Compose, ale teraz stała się częścią podstawowych interfejsów Navigation API. Stanowi to alternatywę dla używania identyfikatorów całkowitych podczas tworzenia grafu za pomocą języka DSL nawigacji w Kotlinie. (b/172823546)

Wszystkie interfejsy API, które wcześniej przyjmowały tylko identyfikator, mają teraz przeciążenie, które przyjmuje trasę String. Obejmuje to: navigate(), popBackStack(), popUpTo() i getBackStackEntry().

Miało to pewne konsekwencje dla interfejsu API:

  • Właściwość popUpTo w Kotlin DSL została wycofana na rzecz popUpToId. (I59c73, b/172823546)
  • Interfejs API getStartDestination() został wycofany na rzecz interfejsu getStartDestinationId(). (I0887f, b/172823546)

Dla deweloperów, którzy przechodzą z poprzednich wersji Navigation Compose na Navigation Compose 2.4.0-alpha01, oznacza to, że te importy metod rozszerzeń nie są już potrzebne i należy je usunąć:

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

Argument KEY_ROUTE został zastąpiony właściwością route w NavDestination, co umożliwia bezpośrednie wywoływanie navBackStackEntry.destination.route.

Zmiany w interfejsie API

  • Wszystkie artefakty nawigacji zostały przepisane w języku Kotlin. Poprawiliśmy dopuszczalność wartości null w klasach korzystających z typów ogólnych (takich jak podklasy NavType). Wszystkie funkcje rozszerzeń Kotlina, które wcześniej były częścią artefaktów -ktx, zostały przeniesione do odpowiednich artefaktów głównych. Artefakty -ktx będą nadal publikowane, ale będą całkowicie puste. (b/184292145)
  • NavDeepLinkBuilder obsługuje teraz dodawanie wielu różnych miejsc docelowych do wygenerowanego stosu wstecznego. (I3ee0d, b/147913689)
  • Dodano funkcje fabryczne dla DynamicNavHostFragment (Icd515, b/175222619).
  • Unikalny identyfikator NavBackStackEntry jest teraz widoczny w publicznym interfejsie API. (Ie033a)
  • Pola name i argument oraz funkcje destrukturyzacji NamedNavArgument są teraz publiczne. (#174, b/181320559)
  • Wprowadziliśmy nowe rozszerzenie NavBackStackEntry#provideToCompositionLocals, które udostępnia NavBackStackEntry odpowiednim elementom CompositionLocal. (#175, b/187229439)

Safe Args

  • Safe Args generuje teraz metodę fromSavedStateHandle() dla każdej klasy NavArgs. (#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)
    }
    
  • Zaktualizowano Safe Args, aby zależało od KotlinPoet 1.8.0. (#172, b/183990444)

Zmiany w zachowaniu

  • Nawigacja zależy teraz od Lifecycle 2.3.1 i oznacza metody setGraph(), popBackStack(), navigateUp() i navigate(), które aktualizują NavBackStackEntry Lifecycle, jako @MainThread, dostosowując nawigację do wymuszania wątku głównego wprowadzonego w Lifecycle 2.3.0. (b/171125856)
  • Analizowanie argumentów typu wyliczeniowego z precyzyjnych linków nie uwzględnia już wielkości liter, co pozwala na dopasowanie precyzyjnego linku takiego jak http://www.example.com/red do precyzyjnego linku www.example.com/{color}, nawet jeśli typ wyliczeniowy ma wartość RED. (#152, b/135857840)

Zgodność z Compose

  • Komponent androidx.navigation:navigation-compose:2.4.0-alpha01 jest zgodny tylko z Compose w wersji 1.0.0-beta07 lub nowszej.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że obiekty zastępcze argumentów końcowych miały pierwszeństwo przed precyzyjnymi linkami z pasującym sufiksem. (#153, b/184072811)
  • NavHostFragment obsługuje teraz niestandardowe obiekty Navigator, które używają tego samego @Navigator.Name("dialog") co domyślny DialogFragmentNavigator. (Ib1c2c, b/175979140)
  • Ulepszyliśmy działanie metody NavigatorProvider#addNavigator, aby wielokrotne wywoływanie jej z tą samą instancją nie powodowało problemów. (#176, b/187443146)

Treści zewnętrzne

  • Dziękujemy użytkownikowi simonschiller za dodanie obsługi Safe Args generujących metodę fromSavedStateHandle() dla każdej klasy NavArgs. (#122, b/136967621)
  • Dziękujemy użytkownikowi Bradleycorn za sprawienie, że wielkość liter nie jest rozróżniana podczas analizowania argumentów Enum z precyzyjnych linków. (#152, b/135857840)
  • Dziękujemy użytkownikowi osipxd za rozwiązanie problemu, który powodował, że końcowe zmienne argumentów miały pierwszeństwo przed precyzyjnymi linkami z pasującym sufiksem. (#153, b/184072811)
  • Dziękujemy użytkownikowi tatocaster za zaktualizowanie Safe Args, aby zależało od KotlinPoet 1.8.0. (#172, b/183990444)
  • Dziękujemy użytkownikowi jossiwolf za upublicznienie pól name i argument oraz funkcji destrukturyzacji NamedNavArgument. (#174, b/181320559)
  • Dziękujemy użytkownikowi jossiwolf za wprowadzenie nowego rozszerzenia NavBackStackEntry#provideToCompositionLocals, które udostępnia NavBackStackEntry odpowiednim zmiennym lokalnym kompozycji. (#175, b/187229439)
  • Dziękujemy użytkownikowi jossiwolf za ulepszenie działania NavigatorProvider#addNavigator, dzięki czemu wielokrotne wywoływanie tej funkcji z tą samą instancją nie powoduje problemów. (#176, b/187443146)

Wersja 1.0.0-alpha10

7 kwietnia 2021 r.

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • NavHost akceptuje teraz Modifier, który jest przekazywany do kontenera funkcji kompozycyjnej, który opakowuje funkcje kompozycyjne miejsca docelowego. (I85aca, b/175125483)

Poprawki błędów

  • NavHost działa teraz nawet wtedy, gdy nie znaleziono OnBackPressedDispatcherOwner, jak w przypadku podglądu NavHost. (I7d8b4)
  • Komponent Navigation Compose zależy teraz od Navigation 2.3.5, co rozwiązuje problem z używaniem BackHandler w miejscu docelowym NavHost. (I7e63b, b/182284739)

Wersja 1.0.0-alpha09

10 marca 2021 r.

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • LocalViewModelStoreOwner.current zwraca teraz obiekt ViewModelStoreOwner, który może mieć wartość null, aby można było lepiej określić, czy obiekt ViewModelStoreOwner jest dostępny w bieżącej kompozycji. Interfejsy API, które wymagają ViewModelStoreOwner, takie jak viewModel() i NavHost, nadal zgłaszają wyjątek, jeśli nie ustawiono ViewModelStoreOwner. (Idf39a)

Poprawki błędów

  • Navigation Compose zależy teraz od Navigation 2.3.4, która zawiera poprawkę dotyczącą próby ustawienia tego samego obiektu ViewModelStore po ustawieniu wykresu. (I65c24, b/177825470)

Wersja 1.0.0-alpha08

24 lutego 2021 r.

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

  • NavHost wypełnia teraz LocalSavedStateRegistryOwner CompositionLocal wartością NavBackStackEntry tego miejsca docelowego, dzięki czemu każdy stan zapisany bezpośrednio w SavedStateRegistry zostanie zapisany i przywrócony razem z miejscem docelowym. (I435d7, b/179469431)

Wersja 1.0.0-alpha07

10 lutego 2021 r.

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zatwierdzenia.

Aktualizacje zależności

Wersja 1.0.0-alpha06

28 stycznia 2021 roku

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Dodaliśmy metodę rozszerzenia getBackStackEntry(route: String) w NavController, która zwraca powiązany obiekt NavBackStackEntry. (If8931)

Wersja 1.0.0-alpha05

13 stycznia 2021 r.

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.

Zaktualizowano zależność od Compose 1.0.0-alpha10.

Wersja 1.0.0-alpha04

16 grudnia 2020 roku

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

  • Zaktualizowano pod kątem zgodności z Compose 1.0.0-alpha09.

Wersja 1.0.0-alpha03

2 grudnia 2020 r.

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że funkcje popBackStack() i navigateUp() nie działały po zmianie konfiguracji lub po śmierci procesu i jego ponownym utworzeniu. (Icea47, b/173281473)
  • Przechodzenie do zagnieżdżonego wykresu w NavHost działa teraz prawidłowo. (I0948d, b/173647694)

Wersja 1.0.0-alpha02

11 listopada 2020 roku

Publikacja androidx.navigation:navigation-compose:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Nawigacja w Compose obsługuje teraz NavOptions na potrzeby operacji popUpTo i launchSingleTop (If96c3, b/171468994).
  • Dodaliśmy funkcję nawigacji, która zamiast identyfikatora przyjmuje trasę, co umożliwia tworzenie zagnieżdżonych wykresów w języku DSL Navigation Compose. (I1661d)
  • startDestination znajduje się teraz przed trasą na liście parametrów NavHost (Ie620e).
  • Możesz teraz utworzyć graf, używając trasy jako miejsca docelowego poza elementem kompozycyjnym NavHost. (Iceb75)

Wersja 1.0.0-alpha01

28 października 2020 r.

Publikacja android.navigation:navigation-compose:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

Artefakt navigation-compose zapewnia integrację komponentu nawigacji z Jetpack Compose. Używa funkcji @Composable jako miejsc docelowych w aplikacji.

Ta pierwsza wersja zapewnia:

  • Funkcja kompozycyjna NavHost, która umożliwia utworzenie wykresu nawigacji za pomocą Kotlin DSL.
  • Zakres cyklu życia, ViewModel i zapamiętany stan na poziomie miejsca docelowego.
  • Automatyczna integracja z systemowym przyciskiem Wstecz.
  • Obsługa przekazywania argumentów, dołączania precyzyjnych linków do miejsc docelowych i zwracania wyniku do poprzednich miejsc docelowych.
  • Utwórz określone funkcje pomocnicze w rememberNavController() i currentBackStackEntryAsState(), aby umożliwić podnoszenie stanu i łączenie NavController z komponentami kompozycyjnymi poza NavHost (np. dolnym paskiem nawigacyjnym).

Więcej informacji znajdziesz w przewodniku po nawigacji w Compose.

Wersja 2.3.5

Wersja 2.3.5

7 kwietnia 2021 r.

Publikacja androidx.navigation:navigation-*:2.3.5 Wersja 2.3.5 zawiera te zatwierdzenia.

Nowe funkcje

  • Podczas nawigacji za pomocą NavDeepLinkRequest lub Uri możesz teraz uzyskać dostęp do Uri, działania i typu MIME w miejscu docelowym, pobierając intencję z argumentów za pomocą KEY_DEEP_LINK_INTENT, co odzwierciedla funkcję dostępną już w przypadku zewnętrznych precyzyjnych linków. (I975c3, b/181521877)

Poprawki błędów

  • OnBackPressedCallbacks dodany do dyspozytora z NavBackStackEntry jako LifecycleOwner teraz prawidłowo przechwytuje przycisk Wstecz po tym, jak cykl życia aktywności jest STOPPED, a następnie STARTED (Iff94f, b/182284739)
  • Analiza domeny precyzyjnego linku nie uwzględnia już wielkości liter, dzięki czemu www.example.com pasuje zarówno do www.example.com, jak i do www.Example.com. Pamiętaj, że w nazwach parametrów zapytania nadal jest rozróżniana wielkość liter. (#144, b/153829033)
  • Naprawiliśmy błąd NullPointerException, który mógł wystąpić, gdy miejsce docelowe miało wiele argumentów domyślnych, które nie mogły mieć wartości null, a użytkownik przechodził do tego miejsca docelowego, zastępując tylko podzbiór tych argumentów. (aosp/1644827)

Aktualizacje zależności

  • Wtyczka Navigation Safe Args do obsługi Gradle zależy teraz od wtyczki Kotlin do obsługi Gradle w wersji 1.4.31. (aosp/1661058, b/181156413)

Zewnętrzny wkład

  • Dziękujemy bentrengrove za żądanie pull, dzięki któremu analiza domeny precyzyjnego linku nie uwzględnia wielkości liter. (#144, b/153829033)

Wersja 2.3.4

Wersja 2.3.4

10 marca 2021 r.

Publikacja androidx.navigation:navigation-*:2.3.4 Wersja 2.3.4 zawiera te zatwierdzenia.

Nowe funkcje

  • Argumenty ReferenceType mogą być teraz prawidłowo analizowane, gdy są wysyłane jako część identyfikatora URI precyzyjnego linku. Obsługiwane są zarówno nieprzetworzone wartości całkowite, jak i wartości szesnastkowe z prefiksami 0x. (#127, b/179166693)
  • Atrybut android:defaultValue argumentu z app:argType="float" obsługuje teraz domyślne wartości całkowite, co pozwala na używanie android:defaultValue="0" zamiast 0.0. (#117, b/173766247)

Poprawki błędów

  • Naprawiliśmy problem z zawieszaniem się instalacji podczas korzystania z obsługi funkcji dynamicznych w nawigacji. (Ib27a7, b/169636207)
  • Wywołanie funkcji setViewModelStore lub setLifecycleOwner z tym samym obiektem, który został już ustawiony, nie będzie teraz wykonywać żadnej operacji (Idf491, b/177825470).
  • Safe-Args dodaje teraz adnotacje pomijania w odpowiednich metodach, gdy używany jest język Java. (I8fbc5, b/179463137)

Treści zewnętrzne

  • Dziękujemy użytkownikowi JvmName za żądanie pull, dzięki któremu argumenty ReferenceType mogą być teraz prawidłowo analizowane, gdy są wysyłane jako część identyfikatora URI precyzyjnego linku. (#127, b/179166693)
  • Dziękujemy użytkownikowi tatocaster za przesłanie żądania pull, dzięki któremu defaultValue dla argumentu z app:argType=”float” obsługuje teraz domyślne wartości całkowite. (#117, b/173766247)

Wersja 2.3.3

Wersja 2.3.3

27 stycznia 2021 r.

Publikacja androidx.navigation:navigation-*:2.3.3 Wersja 2.3.3 zawiera te zatwierdzenia.

Poprawki błędów

  • Nie dochodzi już do awarii, gdy NavBackStackEntry jest usuwany, zanim jego Lifecycle zostanie przeniesiony do CREATED. (Ie3ba3)
  • Naprawiono regresję spowodowaną przez b/171364502, gdzie przejście do aktywności z wartością zasobu animacji 0 powodowało błąd ResourceNotFoundException. (I7aedb, b/176819931)

Wersja 2.3.2

Wersja 2.3.2

2 grudnia 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.2 Wersja 2.3.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd regresji w NavigationUI, który powodował, że użycie miejsca docelowego <activity> z onNavDestinationSelected nie powodowało przejścia do aktywności. (I22e34, b/171364502)
  • Rozwiązaliśmy problem, który powodował, że navigation-dynamic-features-fragment wielokrotnie przekierowywał do nowo zainstalowanego miejsca docelowego. (aosp/1486056, b/169636207)
  • Rozwiązaliśmy problem, który powodował, że domyślne argumenty nie były wysyłane do instancji OnDestinationChangedListener podczas korzystania z launchSingleTop. (I2c5cb)
  • Rozwiązaliśmy problem, który powodował, że przejście do zagnieżdżonego wykresu nawigacyjnego nie powodowało utworzenia nowej instancji wykresu na stosie wstecznym. (Ifc831)
  • Rozwiązaliśmy problem, który powodował, że użycie metody navigate() z obiektem popUpTo, który usuwał ostatnie miejsce docelowe z wykresu nawigacyjnego, nie powodowało natychmiastowego zniszczenia i usunięcia samego wykresu nawigacyjnego ze stosu wstecznego. (I910a3)
  • Narzędzie Navigation SafeArgs używa teraz KotlinPoet w wersji 1.7.2, która obsługuje tryb jawnego interfejsu API Kotlina. (I918b5)
  • NavHostFragment.findNavController(Fragment) sprawdza teraz również widok dekoracji głównej elementu DialogFragment, oprócz dotychczasowych kontroli hierarchii fragmentów i hierarchii widoków fragmentów. Umożliwia to testowanie fragmentów okien, które używają nawigacji z FragmentScenario i Navigation.setViewNavController(). (I69e0d)

Wersja 2.3.1

Wersja 2.3.1

14 października 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.1 Wersja 2.3.1 zawiera te zatwierdzenia.

Nowe funkcje

  • Do interfejsu nawigacji dodano domyślne zasoby Animator, które są zalecane zamiast domyślnych zasobów animacji. (b/167430145)
  • NavOptions zastępuje teraz metody hashcode i equals (b/161586466).
  • Nawigacja obejmuje teraz bieżące miejsce docelowe w wyjątku IllegalArgumentException „Brak miejsca docelowego o identyfikatorze”, co powinno ułatwić deweloperom debugowanie. (b/168311416)

Poprawki błędów

  • Safe Args nie będzie już zawijać wiersza zwracanego, nawet jeśli wygenerowana nazwa klasy argumentu ma więcej niż 100 znaków. (b/168584987)

Zmiany zależności

  • navigation-ui zależy teraz od DrawerLayout 1.1.1, dzięki czemu NavigationUI może otwierać panel nawet podczas korzystania z LOCK_MODE_LOCKED_CLOSED lub LOCK_MODE_LOCKED_OPEN. (b/162253907)
  • Safe Args zależy teraz od KotlinPoet 1.6.0 (aosp/1435911).
  • Safe Args zależy teraz od AGP 4.0.1 (aosp/1442337).

Wersja 2.3.0

Wersja 2.3.0

24 czerwca 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0 Wersja 2.3.0 zawiera te zatwierdzenia.

Najważniejsze zmiany od wersji 2.2.0

  • Integracja modułu funkcji: artefakty navigation-dynamic-features-runtime i navigation-dynamic-features-fragment umożliwiają przechodzenie do miejsc docelowych zdefiniowanych w modułach funkcji, automatycznie obsługując instalację modułów funkcji w razie potrzeby. Więcej informacji znajdziesz w artykule Nawigacja za pomocą modułów funkcji.
  • Testowanie nawigacji: artefakt navigation-testing udostępnia interfejs TestNavHostController, który umożliwia ustawienie bieżącego miejsca docelowego i sprawdzenie stosu wstecznego po operacjach nawigacji. Więcej informacji znajdziesz w artykule Testowanie nawigacji.
  • Zwracanie wyniku: obiekt NavBackStackEntry powiązany z każdym miejscem docelowym na stosie wstecznym nawigacji umożliwia teraz dostęp do obiektu SavedStateHandle, który nadaje się do przechowywania niewielkich ilości zapisanego stanu powiązanego z konkretnym wpisem na stosie wstecznym. Więcej informacji znajdziesz w sekcji Zwracanie wyniku do poprzedniego miejsca docelowego.
  • Obsługa Openable w NavigationUI: wszystkie przypadki użycia DrawerLayout w NavigationUI zostały zastąpione bardziej ogólnym interfejsem Openable dodanym w CustomView 1.1.0 i zaimplementowanym przez DrawerLayout w DrawerLayout 1.1.0.
  • Obsługa działań i typów MIME w precyzyjnych linkach: precyzyjne linki zostały rozszerzone o obsługę app:action i app:mimeType oprócz wcześniej dostępnego app:uri. NavController obsługuje teraz nawigację według dowolnej kombinacji tych pól za pomocą nowej klasy NavDeepLinkRequest. Więcej informacji znajdziesz w artykule Nawigacja za pomocą NavDeepLinkRequest.

Znane problemy

  • Obsługa działań i typów MIME precyzyjnych linków nie jest jeszcze dostępna w narzędziu do scalania plików manifestu. Dopóki nie zostanie to zrobione, wygenerowane elementy <intent-filter> z elementu <nav-graph> w pliku manifestu nie będą zawierać typu MIME w elemencie <data> ani niestandardowego elementu <action>. Musisz ręcznie dodać odpowiedni element <intent-filter> do pliku manifestu.

Wersja 2.3.0-rc01

10 czerwca 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-rc01 Wersja 2.3.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd NullPointerException, który występował podczas zastępowania instancji miejsca docelowego bez argumentów inną instancją z argumentami za pomocą singleTop. (b/158006669)
  • Wszystkie wyjątki destination is unknown zgłaszane przez NavController zawierają teraz dodatkowe informacje na potrzeby debugowania, które pomagają określić stan NavController. (b/157764916)

Wersja 2.3.0-beta01

20 maja 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-beta01 Wersja 2.3.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że po śmierci procesu Lifecycle elementu NavBackStackEntry nie był prawidłowo aktualizowany. (b/155218371)
  • Instancje OnDestinationChangedListener zarejestrowane przed wywołaniem setGraph() są teraz prawidłowo wysyłane do przywróconego miejsca docelowego po śmierci procesu. (b/155218371)
  • Podczas korzystania z singleTop argumenty NavBackStackEntry są teraz prawidłowo aktualizowane i wysyłane do wszystkich instancji OnDestinationChangeListener. (b/156545508)

Aktualizacje zależności

Wersja 2.3.0-alpha06

29 kwietnia 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-alpha06 (Wersja 2.3.0-alpha06 zawiera te zatwierdzenia).

Nowe funkcje

  • Precyzyjne linki zostały rozszerzone o obsługę app:action i app:mimeType oprócz wcześniej dostępnych app:uri. NavController obsługuje teraz nawigację za pomocą dowolnej kombinacji tych pól dzięki nowej klasie NavDeepLinkRequest. (b/136573074, b/135334841)

Zmiany w interfejsie API

  • Znacznie rozszerzyliśmy obsługę DSL w Kotlinie w przypadku miejsc docelowych nawigacji dynamicznej. (b/148969800)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że intencje precyzyjnych linków były ignorowane, gdy używane było zagnieżdżone miejsce docelowe. (b/154532067)

Wersja 2.3.0-alpha05

15 kwietnia 2020 roku

Publikacja androidx.navigation:navigation-*:2.3.0-alpha05 Wersja 2.3.0-alpha05 zawiera te zatwierdzenia.

Nowe funkcje

  • W przypadku dynamicznych dołączeń wykresu, które używają <include-dynamic>, nie musisz już określać app:graphPackage. Domyślny zostanie użyty przez dodanie sufiksu moduleName do applicationId po kropce. Jeśli musisz dostosować graphPackage, możesz teraz użyć obiektu zastępczego ${applicationId}. (b/152696768)
  • Kotlin DSL wykresu nawigacyjnego udostępnia teraz defaultArguments Map dla działań, co odzwierciedla możliwość ustawiania wartości domyślnych w elementach <action> w plikach XML nawigacji. (b/150345605)

Poprawki błędów

  • Od wersji Navigation 2.2.2: naprawiono błąd IllegalStateException występujący podczas precyzyjnego linkowania do miejsca docelowego rozpoczęcia wykresu, gdy w aktywności jest wiele instancji NavHostFragment. (b/147378752)

Aktualizacje zależności

Wersja 2.3.0-alpha04

18 marca 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-alpha04 Wersja 2.3.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaliśmy obsługę aktywności modułu funkcji i miejsc docelowych fragmentów w języku DSL nawigacji w Kotlinie. (b/148969800)

Zmiany w interfejsie API

  • Klasa DynamicExtras nie używa już wzorca konstruktora i można ją teraz tworzyć bezpośrednio. (aosp/1253671)
  • DynamicActivityNavigator przyjmuje teraz w konstruktorze Context, a nie Activity. (aosp/1250252)

Poprawki błędów

  • NavigationUI nie ignoruje już pustych etykiet (czyli miejsca docelowego z android:label=””) i prawidłowo ustawia tytuł na pusty ciąg znaków. (b/148679860)

Aktualizacje zależności

  • Artefakty funkcji dynamicznych Navigation zależą teraz od podstawowej biblioteki Play 1.6.5. (b/149556401)

Wersja 2.3.0-alpha03

4 marca 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-alpha03 Wersja 2.3.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zamiast polegać na konkretnej klasie DrawerLayout, AppBarConfiguration używa teraz interfejsu Openable wprowadzonego w CustomView 1.1.0-alpha02 (który DrawerLayout implementuje od wersji DrawerLayout 1.1.0-alpha04), co pozwala na używanie niestandardowych implementacji Openable z NavigationUI. (b/129030452)

Poprawki błędów

  • Reguły ProGuard navigation-common-ktx teraz prawidłowo zachowują tylko używane klasy NavArgs, a nie wszystkie instancje NavArgs. (b/150213558)

Zmiany zależności

  • Nawigacja nie jest już zależna od Core 1.2.0, ale od Core 1.1.0, aby nie zmuszać deweloperów do przejścia na nowszą zależność, gdy nawigacja nie jest zależna od żadnych nowych interfejsów API w Core 1.2.0.

Wersja 2.3.0-alpha02

19 lutego 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-alpha02 Wersja 2.3.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

  • NavBackStackEntry umożliwia teraz dostęp do SavedStateHandle, który nadaje się do przechowywania niewielkich ilości zapisanego stanu, który powinien być powiązany z konkretnym wpisem stosu wstecznego. Przykład zastosowania znajdziesz w sekcji Zwracanie wyniku. (b/79672220)

Zmiany w interfejsie API

  • Dodano metody ułatwiające getCurrentBackStackEntry() i getPreviousBackStackEntry(), aby ułatwić pobieranie NavBackStackEntry dla bieżącego i poprzedniego miejsca docelowego. (b/79672220)

Poprawki błędów

  • navigateUp() przekazuje teraz argumenty bieżącego miejsca docelowego i KEY_DEEP_LINK_INTENT do poprzedniego miejsca docelowego podczas uruchamiania aplikacji na własnym stosie zadań. (b/147456890)

Zmiany zależności

Wersja 2.3.0-alpha01

5 lutego 2020 r.

Publikacja androidx.navigation:navigation-*:2.3.0-alpha01 Wersja 2.3.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Nowy artefakt navigation-testing udostępnia klasę TestNavHostController. Ta klasa stanowi alternatywę dla używania makiety NavController podczas testowania nawigacji, która umożliwia ustawienie bieżącego miejsca docelowego i sprawdzenie stosu wstecznego po operacjach nawigacji. (b/140884273)
  • Nowy element navigation-dynamic-features-fragment (i jego zależność przechodnia navigation-dynamic-features-runtime) umożliwia uwzględnianie obsługiwanych miejsc docelowych lub całych wykresów nawigacyjnych (za pomocą <include-dynamic>) z modułów funkcji, co zapewnia bezproblemową instalację modułów funkcji na żądanie podczas przechodzenia do tych miejsc docelowych. Więcej informacji znajdziesz w artykule Nawigacja za pomocą modułów funkcji. (b/132170186)

Poprawki błędów

  • Nawigacja 2.2.1: precyzyjne linki bez parametrów zapytania teraz prawidłowo ignorują parametry zapytania, zamiast dołączać je do elementów końcowych {argument} lub nie dopasowywać precyzyjnego linku. (b/147447512)
  • Z Nawigacji 2.2.1: reguły ProGuard navigation-ui dla DrawerArrowDrawable zostały zaktualizowane, aby usługa android.enableJetifier=true nie była wymagana. (b/147610424)
  • Nawigacja 2.2.1: moduł navigation-common-ktx ma teraz unikalną nazwę pakietu manifestu, a nie taką samą jak navigation-runtime-ktx. (aosp/1141947)

Aktualizacje zależności

Wersja 2.2.2

Wersja 2.2.2

15 kwietnia 2020 roku

Publikacja androidx.navigation:navigation-*:2.2.2 Wersja 2.2.2 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd IllegalStateException, który występował podczas precyzyjnego linkowania do miejsca docelowego wykresu, gdy w aktywności było wiele instancji NavHostFragment. (b/147378752)
  • NavigationUI nie ignoruje już pustych etykiet (czyli miejsca docelowego z android:label=””) i prawidłowo ustawia tytuł na pusty ciąg znaków. Ta funkcja została wcześniej udostępniona w Navigation 2.3.0-alpha04. (b/148679860)
  • Reguły ProGuard navigation-common-ktx teraz prawidłowo zachowują tylko używane klasy NavArgs, a nie wszystkie instancje NavArgs. Ta funkcja została wcześniej udostępniona w Nawigacji w wersji 2.3.0-alpha03. (b/150213558

Aktualizacje zależności

Wersja 2.2.1

Wersja 2.2.1

5 lutego 2020 r.

Publikacja androidx.navigation:navigation-*:2.2.1 Wersja 2.2.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Precyzyjne linki bez parametrów zapytania teraz prawidłowo ignorują parametry zapytania, zamiast dołączać je do końcowych elementów {argument} lub nie dopasowywać precyzyjnego linku. (b/147447512)
  • Reguły ProGuard navigation-ui dla DrawerArrowDrawable zostały zaktualizowane, aby upewnić się, że android.enableJetifier=true nie jest wymagany. (b/147610424)
  • Moduł navigation-common-ktx ma teraz unikalną nazwę pakietu manifestu, a nie taką samą jak navigation-runtime-ktx. (aosp/1141947)

Aktualizacje zależności

Wersja 2.2.0

Wersja 2.2.0

22 stycznia 2020 r.

Publikacja androidx.navigation:navigation-*:2.2.0 Wersja 2.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 2.1.0

  • NavBackStackEntry: możesz teraz wywołać funkcję NavController.getBackStackEntry(), przekazując identyfikator miejsca docelowego lub wykresu nawigacyjnego na stosie wstecznym. Zwrócony obiekt NavBackStackEntry udostępnia sterowane przez nawigację obiekty LifecycleOwner, ViewModelStoreOwner (takie same jak zwracane przez NavController.getViewModelStoreOwner()) i SavedStateRegistryOwner, a także argumenty używane do uruchamiania tego miejsca docelowego.
  • Integracja SavedState z ViewModel cyklu życia: SavedStateViewModelFactory jest teraz domyślną fabryką używaną podczas korzystania z by navGraphViewModels() lub konstruktora ViewModelProvider z ViewModelStoreOwner zwracanym przez NavController.getBackStackEntry() lub NavController.getViewModelStoreOwner().
  • Obsługa parametrów zapytania w precyzyjnych linkach: precyzyjne linki z parametrami zapytania obsługują teraz parametry zapytania o zmienionej kolejności. Argumenty, które mają wartość domyślną lub mogą mieć wartość null, są teraz opcjonalne podczas dopasowywania precyzyjnych linków.
  • Ulepszona obsługa animacji: NavHostFragment używa teraz FragmentContainerView z Fragmentu 1.2.0, co rozwiązuje problemy z kolejnością animacji w osi Z i wysyłaniem wstawek okna do fragmentów.

Wersja 2.2.0-rc04

18 grudnia 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-rc04 Wersja 2.2.0-rc04 zawiera te zatwierdzenia.

Poprawki błędów

  • Dostosowaliśmy domyślne animacje zanikania używane przez navigation-ui, aby pasowały do dostosowanych animacji zanikania we Fragment 1.2.0-rc04. (b/145769814)

Wersja 2.2.0-rc03

4 grudnia 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-rc03 Wersja 2.2.0-rc03 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem z analizowaniem precyzyjnych linków, który występował, gdy używane były parametry zapytania i argument jako ostatnia część ścieżki. Uniemożliwiał on analizowanie więcej niż 1 znaku końcowego argumentu ścieżki. (b/144554689)
  • Rozwiązaliśmy problem z analizowaniem precyzyjnych linków, który powodował, że parametry opcjonalne otrzymywały wartość "@null" zamiast null. (b/141613546)
  • NavHostFragment teraz prawidłowo przywraca wykres po zmianie konfiguracji, gdy jest używany z FragmentContainerView. (b/143752103)

Zmiany zależności

  • Nawigacja zależy teraz od komponentów Lifecycle 2.2.0-rc03, Lifecycle ViewModel SavedState 1.0.0-rc03, Activity 1.1.0-rc03 i Fragment 1.2.0-rc03 (w odpowiednich przypadkach).

Wersja 2.2.0-rc02

7 listopada 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-rc02 Wersja 2.2.0-rc02 zawiera te zmiany.

Zmiany zależności

  • Nawigacja zależy teraz od androidx.lifecycle 2.2.0-rc02.

Wersja 2.2.0-rc01

23 października 2019 r.

Wersja androidx.navigation:navigation-*:2.2.0-rc01 nie zawiera żadnych zmian w porównaniu z wersją 2.2.0-beta01. Wersja 2.2.0-rc01 zawiera te zatwierdzenia.

Wersja 2.2.0-beta01

9 października 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-beta01 Wersja 2.2.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • Klasa NavDestination i jej podklasy zastępują teraz klasę toString(), aby dostarczać więcej przydatnych informacji podczas debugowania. (b/141264986)

Zmiany w zachowaniu

  • Dodatkowe parametry zapytania są teraz ignorowane podczas dopasowywania precyzyjnych linków, a nie powodują błędu dopasowania. (b/141482822)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że argumenty w ścieżce precyzyjnego linku były ignorowane, jeśli określono też parametry zapytania. (b/141505755)
  • Rozszerzenie navArgs() Kotlin w Activity wyświetla teraz lepszy komunikat o błędzie, gdy nie ma dodatków. (b/141408999)
  • Klasy Java Directions wygenerowane przez Safe Args zawierają teraz wartości domyślne. (b/141099045)
  • Klasy Java Args wygenerowane przez Safe Args zawierają teraz wartości domyślne. (b/140123727)
  • Gdy używasz Toolbar, NavigationUI nie animuje już zmiany tekstu podczas przechodzenia między 2 miejscami docelowymi najwyższego poziomu. (b/140848160)

Wersja 2.2.0-alpha03

18 września 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-alpha03 Wersja 2.2.0-alpha03 zawiera te zmiany.

Zmiany w zachowaniu

  • Wywołanie metody setViewModelStore() po wywołaniu metody setGraph powoduje teraz zwrócenie błędu IllegalStateException. Wartość ta powinna być zawsze ustawiana przez NavHost w ramach konfiguracji początkowej, aby wszystkie instancje NavBackStackEntry miały spójne miejsce na dane dla instancji ViewModel. (aosp/1111821)

Poprawki błędów

  • Naprawiliśmy błąd ConcurrentModificationException występujący podczas używania instancji ViewModel dołączonych do wielu różnych instancji ViewModelStore o zakresie grafu nawigacyjnego. (aosp/1112257)

Wersja 2.2.0-alpha02

5 września 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-alpha02 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Precyzyjne linki z parametrami zapytania obsługują teraz parametry zapytania o zmienionej kolejności. Argumenty, które mają wartość domyślną lub mogą mieć wartość null, są teraz opcjonalne podczas dopasowywania precyzyjnych linków. (b/133273839)
  • Możesz teraz wywołać funkcję NavController.getBackStackEntry(), przekazując identyfikator miejsca docelowego lub wykresu nawigacyjnego na stosie wstecznym. Zwrócony obiekt NavBackStackEntry udostępnia sterowane przez nawigację obiekty LifecycleOwner, ViewModelStoreOwner (takie same jak zwracane przez NavController.getViewModelStoreOwner()) i SavedStateRegistryOwner, a także argumenty używane do uruchamiania tego miejsca docelowego. (aosp/1101691, aosp/1101710)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że dodawanie NavHostFragment do ViewPager2 kończyło się błędem IllegalArgumentException. (b/133640271)
  • NavInflater unika teraz niepotrzebnego wywoływania getResourceName(), co skraca czas inflacji nawet o 40%. (b/139213740)

Wersja 2.2.0-alpha01

7 sierpnia 2019 r.

Publikacja androidx.navigation:navigation-*:2.2.0-alpha01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Nowe funkcje

  • SavedStateViewModelFactory jest teraz domyślną fabryką używaną podczas korzystania z by navGraphViewModels() lub konstruktora ViewModelProvider z ViewModelStoreOwner zwracanym przez NavController.getViewModelStoreOwner(). (b/135716331)

Zmiany w interfejsie API

Poprawki błędów

  • NavHostFragment używa teraz FragmentContainerView, co rozwiązuje problemy z kolejnością animacji na osi Z i wysyłaniem wstawek okna do fragmentów. (b/137310379)

Wersja 2.1.0

Wersja 2.1.0

5 września 2019 r.

Publikacja androidx.navigation:navigation-*:2.1.0 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Ważne zmiany od wersji 2.0.0

  • Określanie zakresu modeli ViewModel na potrzeby wykresu nawigacyjnego: możesz teraz tworzyć modele ViewModel, których zakres jest określany na poziomie wykresu nawigacyjnego, za pomocą właściwości by navGraphViewModels() w przypadku użytkowników Kotlina korzystających z bibliotek -ktx lub za pomocą interfejsu API getViewModelStoreOwner() dodanego do NavController. Więcej informacji znajdziesz w artykule Udostępnianie danych związanych z interfejsem między miejscami docelowymi.
  • Miejsca docelowe okien dialogowych: możesz teraz tworzyć miejsca docelowe <dialog>, które będą wyświetlać DialogFragment, gdy navigate do nich. NavHostFragment domyślnie obsługuje miejsca docelowe okna. Więcej informacji znajdziesz w artykule Tworzenie miejsca docelowego z DialogFragment.
  • Nawigacja za pomocą identyfikatora URI: możesz teraz navigate za pomocą Uri, który używa <deepLink> dodanego do miejsca docelowego, aby do niego nawigować. Więcej informacji znajdziesz w sekcji Nawigacja za pomocą identyfikatora URI.
  • NavHostController: interfejsy API używane specjalnie do tworzenia niestandardowego elementu NavHost zostały przeniesione do NavHostController, co umożliwia implementacjom łączenie elementu NavController z hostującymi elementami LifecycleOwner, OnBackPressedDispatcher i ViewModelStore.

Wersja 2.1.0-rc01

7 sierpnia 2019 r.

Publikacja androidx.navigation:navigation-*:2.1.0-rc01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Zmiany w interfejsie API

  • Wycofany interfejs API getViewModelStore() w wersji NavController wprowadzony w wersji 2.1.0-alpha02 został usunięty. (aosp/1091021)

Wersja 2.1.0-beta02

19 lipca 2019 r.

Publikacja androidx.navigation:*:2.1.0-beta02 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Usunięto niezamierzoną zależność jacoco, która została wprowadzona w wersji 2.1.0-beta01. (b/137782950)

Wersja 2.1.0-beta01

17 lipca 2019 r.

Publikacja androidx.navigation:*:2.1.0-beta01 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Nowe funkcje

  • NavigationUI animuje teraz usuwanie przycisku W górę, gdy używasz setupWithNavController() z Toolbar lub CollapsingToolbarLayout. (b/131403621)

Poprawki błędów

  • Naprawiliśmy problem z czasem występujący podczas używania wielu obiektów NavHostFragment z tym samym kontenerem za pomocą findNavController(). (b/136021571)

Wersja 2.1.0-alpha06

2 lipca 2019 r.

Publikacja androidx.navigation:*:2.1.0-alpha06 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Atrybut app:navGraph używany przez NavHostFragment został przeniesiony do artefaktu navigation-runtime. Niestandardowe nawigatory, które można dodać za pomocą kodu XML, powinny używać tego atrybutu, aby umożliwić integrację z panelem hosta edytora nawigacji. (b/133880955)

Zmiany w interfejsie API

  • Interfejs API getViewModelStore() w NavController został wycofany na rzecz nowej metody getViewModelStoreOwner(), która zwraca ViewModelStoreOwner. (aosp/987010)
  • Implementacja miejsc docelowych w pływającym oknie, takich jak miejsca docelowe <dialog>, została uogólniona w interfejsie znacznika FloatingWindow, który jest teraz implementowany przez wszystkie miejsca docelowe <dialog>. Metody NavigationUI do interakcji z górnym paskiem aplikacji ignorują teraz miejsca docelowe FloatingWindow. (b/133600763)

Zmiany w zachowaniu

  • Nawigacja prawidłowo synchronizuje teraz swój stan z tym, co jest widoczne na ekranie, gdy używasz miejsca docelowego <dialog>. W rezultacie nawigacja automatycznie usuwa miejsca docelowe <dialog>, gdy przechodzisz do miejsca docelowego, które nie jest oknem ani aktywnością, np. do miejsca docelowego <fragment>. (b/134089818)

Poprawki błędów

  • Nawigacja pomija teraz animację, która pojawia się podczas odtwarzania aktywności przy obsłudze precyzyjnego linku, co eliminuje efekt migotania. (b/130362979)
  • Naprawiliśmy błąd, który powodował, że stos wsteczny nawigacji nie był synchronizowany podczas usuwania fragmentu, gdy dodawany był fragment początkowy. (b/133832218)

Wersja 2.1.0-alpha05

5 czerwca 2019 r.

Publikacja androidx.navigation:*:2.1.0-alpha05 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Zmiany w interfejsie API

  • Interfejsy API związane z hostem w NavController zostały przemianowane i przeniesione do nowej podklasy NavController, NavHostController. (aosp/966091)
  • Metoda setHostOnBackPressedDispatcherOwner() klasy NavController została zastąpiona metodą setOnBackPressedDispatcher() klasy NavHostController i wymaga teraz wywołania metody setLifecycleOwner() przed jej wywołaniem. (aosp/965409)
  • NavHostController zawiera teraz metodę enableOnBackPressed(boolean), która zastępuje klasę NavHostOnBackPressedManager zwracaną wcześniej przez setHostOnBackPressedDispatcherOwner(). (aosp/966091)

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że stos wsteczny był nieprawidłowy po przejściu za pomocą identyfikatora URI. (b/132509387)
  • Precyzyjne linki obsługiwane automatycznie przez NavController są teraz aktywowane tylko raz. (b/132754763)

Wersja 2.1.0-alpha04

16 maja 2019 r.

Publikacja androidx.navigation:*:2.1.0-alpha04 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Poprawki błędów

  • NavHostFragment prawidłowo uwzględnia app:defaultNavHost podczas przechwytywania zdarzeń systemowego przycisku Wstecz, co naprawia regresję w Nawigacji 2.1.0-alpha03. b/132077777
  • DialogFragmentNavigator teraz prawidłowo obsługuje operacje popBackStack() i navigateUp(). b/132576764
  • Naprawiliśmy błąd w IllegalStateException: unknown destination during restore, który występował podczas wielokrotnego przechodzenia między zagnieżdżonymi wykresami. b/131733658

Wersja 2.1.0-alpha03

7 maja 2019 r.

Publikacja androidx.navigation:*:2.1.0-alpha03 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Znane problemy

  • NavHostFragment nadal przechwytuje systemowy przycisk Wstecz, mimo że używa app:defaultNavHost="false" b/132077777

Nowe funkcje

  • Możesz teraz tworzyć miejsca docelowe <dialog>, które będą wyświetlać DialogFragment, gdy będziesz navigate. NavHostFragment domyślnie obsługuje miejsca docelowe okna. b/80267254
  • Oprócz wywoływania navigate z identyfikatorem zasobu lub instancją NavDirections możesz teraz nawigować za pomocą Uri, który używa <deepLink> dodanego do miejsca docelowego, aby przejść do właściwego miejsca docelowego. b/110412864

Zmiany w zachowaniu

  • Domyślne animacje udostępniane przez NavigationUI zostały przyspieszone z 400 ms do 220 ms, aby dopasować je do domyślnej szybkości animacji aktywności i fragmentów. b/130055522

Zmiany w interfejsie API

  • Metoda createFragmentNavigator() klasy NavHostFragment została wycofana, a jej funkcje zostały przeniesione do nowej metody onCreateNavController(), aby wyraźniej wskazać, że jest to właściwy punkt wejścia do dodawania niestandardowych nawigatorów podczas tworzenia podklasy NavHostFragment. b/122802849
  • Do NavDestination dodano metodę hasDeepLink(), która pozwala sprawdzić, czy dany Uri może być obsługiwany przez to miejsce docelowe lub, w przypadku NavGraph, przez dowolne miejsce docelowe na wykresie nawigacji. b/117437718

Poprawki błędów

  • Domyślne argumenty są teraz prawidłowo przekazywane do instancji OnDestinationChangedListener. b/130630686
  • NavHostFragment przechwytuje teraz systemowe zdarzenia wstecz za pomocą OnBackPressedDispatcher, co rozwiązuje problem z nawigacją warunkową w metodach cyklu życia fragmentu po powrocie do fragmentu. b/111598096
  • W przypadku Safe Args element android:defaultValue=”@null” z nieokreślonym atrybutem app:argType jest teraz prawidłowo wnioskowany jako argument string. b/129629192

Wersja 2.1.0-alpha02

3 kwietnia 2019 r.

Publikacja androidx.navigation:*:2.1.0-alpha02 Zatwierdzenia uwzględnione w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Możesz teraz tworzyć modele ViewModels, które są ograniczone do poziomu wykresu nawigacyjnego, za pomocą właściwości by navGraphViewModels() dla użytkowników Kotlina lub interfejsu API getViewModelStore() dodanego do NavController. b/111614463

Zmiany w interfejsie API

  • Możesz teraz dodać app:targetPackage do miejsca docelowego <activity>, aby ograniczyć pasującą nazwę pakietu. Obsługuje app:targetPackage="${applicationId}", aby ograniczyć pakiet do Twojego identyfikatora aplikacji. b/110975456

Poprawki błędów

  • android:name dla miejsc docelowych <activity> nie jest już analizowany w klasie w czasie inflacji, co zapobiega występowaniu wyjątków ClassNotFoundException podczas korzystania z funkcji dynamicznych. b/124538597

Wersja 2.1.0-alpha01

19 marca 2019 r.

To jest pierwsza wersja alfa komponentu Navigation 2.1.0.

Zmiany zależności

  • Nawigacja zależy teraz od androidx.core:core:1.0.1 i androidx.fragment:fragment:1.1.0-alpha05. Ta wersja usuwa też zależność od androidx.legacy:legacy-support-core-utils:1.0.0. b/128632612

Zmiany w interfejsie API

  • Dodano nową metodę Navigation.createNavigateOnClickListener(NavDirections) jako alternatywę dla tworzenia detektora kliknięć z identyfikatorem zasobu i pakietem. b/127631752
  • FragmentNavigator.instantiateFragment jest teraz wycofany. Domyślna implementacja używa teraz FragmentFactory do tworzenia instancji fragmentów. b/119054429

Poprawki błędów

  • Nawigacja nie wysyła już wartości null Bundle, gdy do miejsca docelowego są dołączone argumenty, co rozwiązuje problem występujący podczas korzystania z android:defaultValue="@null". b/128531879
  • Wtyczka Safe Args zależy teraz od KotlinPoet 1.1.0, co rozwiązuje problem z bardzo długimi nazwami pakietów. b/123654948

Wersja 2.0.0

Wersja 2.0.0

14 marca 2019 r.

Nawigacja 2.0.0 została opublikowana bez zmian w porównaniu z wersją 2.0.0-rc02.

Wersja 2.0.0-rc02

6 marca 2019 r.

Nawigacja 2.0.0-rc02 udostępnia nowe artefakty z identyfikatorem grupy androidx.navigation i zmienia zależności na odpowiedniki AndroidX.

Działanie wersji 2.0.0-rc02 jest identyczne z działaniem wersji Navigation 1.0.0-rc02. Aby zaktualizować wersję 1.0.0-rc02, nie trzeba wprowadzać żadnych zmian w kodzie oprócz zaktualizowania zależności, aby pasowały do nowych zależności.

Aby korzystać z wersji 2.X pakietu Navigation, musisz przenieść projekt do AndroidX. Navigation 1.0 w wersji stabilnej będzie ostatnią wersją korzystającą z zależności biblioteki pomocy. Wszystkie przyszłe wersje po 1.0 będą oparte na AndroidX i będą bazować na wersji stabilnej 2.0.

Zależności sprzed AndroidX

W przypadku wersji nawigacji sprzed AndroidaX uwzględnij te zależności:

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
}

W przypadku Safe Args dodaj do pliku build.gradle najwyższego poziomu tę ścieżkę classpath:

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

Wersja 1.0.0

Wersja 1.0.0

14 marca 2019 r.

Nawigacja 1.0.0 została opublikowana bez zmian w porównaniu z wersją 1.0.0-rc02.

Wersja 1.0.0-rc02

26 lutego 2019 r.

To jest druga wersja kandydująca do publikacji stabilnej wersji 1.0.0 komponentu Navigation. Ta wersja zawiera szereg poprawek błędów.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że parametr popBackStack() był ignorowany, jeśli wykres główny nie miał identyfikatora b/126251695.
  • navigateUp() teraz prawidłowo obsługuje powrót do zadania aplikacji, gdy jest wywoływany po obsłudze precyzyjnego linku bez FLAG_ACTIVITY_NEW_TASK b/126082008
  • Rozwiązaliśmy problem z ActivityNavigator.applyPopAnimationsToPendingTransition, który powodował, że nie była stosowana prawidłowa animacja zakończenia wyskakującego okienka b/126237567
  • Kod Kotlin wygenerowany przez Safe Args teraz prawidłowo zmienia znaczenie słów kluczowych Kotlina, takich jak in i fun, w nazwie pakietu powiązanej z klasą R. b/126020455

Wersja 1.0.0-rc01

21 lutego 2019 r.

To jest wersja kandydująca do publikacji stabilnej wersji 1.0.0 komponentu Navigation. Ta wersja zawiera jedną poprawkę błędu.

Poprawki błędów

  • Rozwiązaliśmy problem występujący podczas korzystania z fragmentów i operacji nawigacyjnych singleTop b/124294805

Wersja 1.0.0-beta02

12 lutego 2019 r.

Ta wersja zawiera szereg drobnych ulepszeń i ważnych poprawek błędów.

Nowe funkcje

  • Możesz teraz używać 0 jako android:defaultValue w argumentach reference. b/124248602

Zmiany w zachowaniu

  • Precyzyjne linki z dokładnym dopasowaniem mają teraz wyższy priorytet niż precyzyjne linki z dopasowaniem argumentu .* lub argumentu. b/123969518

Poprawki błędów

  • popBackStack() i navigateUp teraz prawidłowo zwracają false podczas usuwania ostatniego miejsca docelowego ze stosu wstecznego, co naprawia regresję wprowadzoną w 1.0.0-beta01. b/123933201
  • Nawigacja prawidłowo ustawia teraz ClassLoader podczas przywracania zapisanego stanu instancji, co pozwala uniknąć problemów podczas używania klas niestandardowych w zapisanym stanie Navigator lub w argumentach wysyłanych do NavDestination. b/123893858
  • Klasy NavArgs wygenerowane przez Safe Args nie powodują już awarii podczas przywracania argumentu Parcelable[] z zapisanego stanu instancji. b/123963545
  • Safe Args teraz prawidłowo usuwa niepotrzebne wygenerowane klasy Kotlin. b/124120883

Wersja 1.0.0-beta01

4 lutego 2019 r.

To pierwsza wersja beta interfejsu Navigation API. Oczekujemy, że interfejs Navigation API pozostanie stabilny do następnej wersji, chyba że wystąpi krytyczny problem. Ta wersja zawiera poprawki błędów i zmiany w działaniu.

Zmiany w zachowaniu

  • Nawigacja zapewnia teraz, że wartości domyślne argumentów są traktowane identycznie w czasie działania i w Safe Args. W rezultacie tylko argumenty z app:argType="reference" mogą mieć wartość domyślną wskazującą na inny zasób (np. @color/colorPrimary). Próba użycia referencyjnej wartości domyślnej z innym app:argType spowoduje wyjątek podczas analizowania kodu XML nawigacji. b/123551990
  • Wtyczka Safe Args zależy teraz od wtyczki Androida do obsługi Gradle w wersji 3.3.0 aosp/888413
  • Safe Args zależy teraz od Kotlina 1.3.20 aosp/888414

Poprawki błędów

  • Wtyczki Safe Args można teraz używać w modułach bibliotek i modułach funkcji we wszystkich wersjach wtyczki Androida do obsługi Gradle. b/121304903
  • Naprawiliśmy regresję, która powodowała, że pojedyncza operacja popBackStack() usuwała wszystkie kopie miejsca docelowego z góry stosu wstecznego, a nie tylko jedno miejsce docelowe naraz. b/123552990
  • Rozwiązaliśmy problem, który powodował desynchronizację stanu FragmentNavigator ze stanem NavController, co skutkowało błędem IllegalStateException podczas próby przywrócenia stosu wstecznego. b/123803044
  • Rozwiązaliśmy problem, który powodował, że strzałka wstecz obsługiwana przez NavigationUI nie pojawiała się podczas używania ProGuard z zaciemnianiem kodu. b/123449431
  • Kod wygenerowany przez Safe Args prawidłowo obsługuje teraz użycie elementu app:argType wskazującego na statyczną klasę wewnętrzną w formacie .OuterClass$InnerClass. b/123736741
  • Kod Java wygenerowany przez Safe Args teraz prawidłowo obsługuje działania globalne i głęboko zagnieżdżone miejsca docelowe. b/123347762

Wersja 1.0.0-alpha11

23 stycznia 2019 r.

To jest poprawka do wersji 1.0.0-alpha10, która rozwiązuje problem z Safe Args.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że Safe Args nie importował klasy Directions powiązanej z działaniami globalnymi. b/123307342

Wersja 1.0.0-alpha10

23 stycznia 2019 r.

Znane problemy

  • Safe Args nie importuje klasy Directions powiązanej z działaniami globalnymi. b/123307342

Ta wersja zawiera zmiany w interfejsie API powodujące niezgodność. Zapoznaj się z sekcją Zmiany powodujące niezgodność poniżej.

Nowe funkcje

  • Użytkownicy Kotlina mogą teraz używać delegata właściwości by navArgs(), aby leniwie pobierać odwołanie do klasy NavArgs wygenerowanej przez Safe Args w obiekcie Activity lub Fragment. b/122603367
  • Safe Args umożliwia teraz generowanie kodu Kotlin przez zastosowanie wtyczki androidx.navigation.safeargs.kotlin. Kod Kotlin jest tworzony specjalnie dla modułów tylko w języku Kotlin, przy użyciu domyślnych argumentów i niezmiennych klas we wzorcu kreatora, który jest nadal dostępny w poprzedniej wtyczce androidx.navigation.safeargs. b/110263087

Zmiany w zachowaniu

  • Dopasowane precyzyjne linki są teraz faworyzowane na rzecz precyzyjnego linku, który ma najwięcej pasujących argumentów. b/118393029
  • Wywołanie setGraph() na NavController spowoduje teraz zresetowanie stosu wstecznego. b/111450672
  • Nieznane precyzyjne linki nie powodują już błędu IllegalStateException, ale są ignorowane, co rozwiązuje problemy z zagnieżdżonymi lub wieloma elementami NavHostFragment. b/121340440

Zmiany powodujące niezgodność

  • Metoda NavOptions.applyPopAnimationsToPendingTransition() stosowania animacji wyskakujących okienek do aktywności została przeniesiona do ActivityNavigator. b/122413117
  • Safe Args nie duplikuje już identycznych klas w przypadku działań bez argumentów. Zwracany typ metod bez argumentów w wygenerowanych klasach NavDirections to teraz NavDirections. b/123233147
  • Klasy Directions wygenerowane przez Safe Args nie mają już publicznego konstruktora – należy używać tylko wygenerowanych metod statycznych. b/123031660
  • Klasy NavDirections wygenerowane przez Safe Args nie mają już publicznego konstruktora – powinny być generowane tylko za pomocą metod statycznych w wygenerowanych klasach Directions. b/122963206
  • Zwrócony produkt Bundle z zamówienia getArguments() od sprzedawcy NavDirections jest teraz oznaczony jako @NonNull, a nie @Nullable. b/123243957

Poprawki błędów

  • NavDeepLinkBuilder teraz prawidłowo obsługuje wiele jednoczesnych wywołań PendingIntent do tego samego miejsca docelowego, używając przekazywanych argumentów do określenia unikalności. b/120042732
  • NavController teraz prawidłowo obsługuje operacje popBackStack(), gdy używany jest zagnieżdżony NavHostFragment lub inne fragmenty podrzędne ze stosem wstecznym. b/122770335
  • NavigationUI teraz prawidłowo ustawia opis treści przycisku W górę. b/120395362
  • Klasy Directions wygenerowane przez Safe Args prawidłowo obsługują teraz działania globalne, które mają taki sam identyfikator jak działanie w miejscu docelowym. b/122962504
  • Klasy NavDirections wygenerowane przez Safe Args mają teraz prawidłowo równe wartości hashCode(), gdy equals() zwraca wartość „true”. b/123043662
  • FragmentNavigator wyświetla teraz lepszy komunikat o błędzie, gdy próbujesz wykonać niestandardowe działanie FragmentTransactions na FragmentManager NavHostFragment. Zawsze używaj getChildFragmentManager(). b/112927148

Wersja 1.0.0-alpha09

18 grudnia 2018 r.

Ta wersja zawiera zmiany w interfejsie API powodujące niezgodność. Zapoznaj się z sekcją Zmiany powodujące niezgodność poniżej.

Zdecydowaliśmy, że nie będziemy kontynuować rozwoju artefaktu android.arch.navigation:navigation-testing. Chociaż okazało się to przydatne podczas wewnętrznych testów NavController, zdecydowanie zalecamy stosowanie alternatywnych strategii testowania, takich jak makieta instancji NavController, aby sprawdzić, czy wykonywane są prawidłowe wywołania navigate(). To podejście zostało szczegółowo omówione w prelekcji na temat pojedynczej aktywności podczas AndroidDevSummit 2018. Będziemy pracować nad dodatkową dokumentacją dotyczącą testowania z użyciem komponentu Navigation.

Nowe funkcje

  • MenuItem z menuCategory="secondary" nie będą już usuwać stosu wstecznego, gdy będą używane z metodami NavigationUI. b/120104424
  • AppBarConfiguration umożliwia teraz ustawienie instancji zastępczej OnNavigateUpListener, która zostanie wywołana, gdy navController.navigateUp() zwróci false. b/79993862 b/120690961

Zmiany powodujące niezgodność

  • Gdy używasz <argument> z argType="reference", nawigacja nie analizuje już odwołania, lecz podaje sam identyfikator zasobu niezdefiniowanego. b/111736515
  • onNavDestinationSelected() domyślnie wraca teraz do miejsca docelowego wykresu nawigacji, dzięki czemu jest zgodna z metodami setup. Dodaj menuCategory="secondary" do MenuItem, aby uniknąć wyskakiwania stosu wstecznego. aosp/852869
  • Metody fromBundle() wygenerowanych klas Args przyjmują teraz niepustą wartość Bundle zamiast wartości Bundle, która może być pusta aosp/845616

Poprawki błędów

  • Argumenty są teraz prawidłowo analizowane z precyzyjnych linków jako właściwy argType, a nie zawsze jako ciągi znaków b/110273284
  • Nawigacja prawidłowo eksportuje teraz zasoby publiczne b/121059552
  • Wtyczka Safe Args jest teraz zgodna z wtyczką Androida do obsługi Gradle w wersji 3.4 Canary 4 i nowszych b/119662045

Wersja 1.0.0-alpha08

6 grudnia 2018 r.

Ta wersja zawiera zmiany w interfejsie API powodujące niezgodność. Zapoznaj się z sekcją Zmiany powodujące niezgodność poniżej.

Nowe funkcje

  • Etykiety miejsc docelowych używane z metodami NavigationUI będą teraz automatycznie zastępować wystąpienia {argName} w android:label prawidłowym argumentem b/80267266
  • Nawigacja zależy teraz od biblioteki pomocy 28.0.0 b/120293333

Zmiany powodujące niezgodność

  • Nazwa OnNavigatedListener została zmieniona na OnDestinationChangedListener b/118670572
  • OnDestinationChangedListener przekazuje teraz również Bundle argumentów aosp/837142
  • Atrybuty app:clearTask i app:launchDocument oraz powiązane z nimi metody zostały usunięte. Użyj app:popUpTo z elementem głównym wykresu, aby usunąć wszystkie miejsca docelowe ze stosu wstecznego. b/119628354
  • ActivityNavigator.Extras używa teraz wzorca Builder i dodaje możliwość ustawiania dowolnych flag Intent.FLAG_ACTIVITY_ aosp/828140
  • Nazwa NavController.onHandleDeepLink została zmieniona na handleDeepLink aosp/836063
  • Wiele klas i metod, które nie są przeznaczone do tworzenia podklas, takich jak NavOptions, NavInflater, NavDeepLinkBuilder i AppBarConfiguration, zostało oznaczonych jako final aosp/835681
  • Usunięto wycofaną metodę NavHostFragment.setGraph() aosp/835684
  • Usunięto wycofaną metodę NavigationUI.navigateUp(DrawerLayout, NavController). aosp/835684
  • Tworzenie fragmentów zostało przeniesione do FragmentNavigator, co ułatwia przekazywanie tworzenia fragmentów do FragmentFactory. b/119054429
  • Konstruktor NavGraphNavigator nie przyjmuje już parametru Context aosp/835340
  • NavigatorProvider jest teraz klasą, a nie interfejsem. Funkcja NavigatorProvider zwracana przez getNavigatorProvider() nie zmieniła swojego działania. aosp/830660
  • Usunięto NavDestination.navigate(). Zamiast tego wywołaj navigate() na Navigator. aosp/830663
  • Znaczna refaktoryzacja Navigator, która eliminuje potrzebę stosowania OnNavigatorNavigatedListener i sprawia, że navigate zwraca NavDestination, do którego nastąpiło przejście.
  • Instancje Navigator nie mogą już wysyłać zdarzeń POP do NavController. Rozważ użycie OnBackPressedCallback, aby przechwytywać naciśnięcia przycisku Wstecz i wywoływać navController.popBackStack(). aosp/833716

Poprawki błędów

  • popUpTo działa teraz spójnie, gdy miejscem docelowym jest element <navigation> b/116831650
  • Naprawiono szereg błędów, które powodowały występowanie wyjątku IllegalArgumentException podczas korzystania z wykresów zagnieżdżonych: b/118713731, b/113611083, b/113346925, b/113305559.
  • Atrybut dataPattern miejsc docelowych <activity> będzie teraz wypełniać argumenty z argumentów innych niż ciąg znaków przez wywołanie toString() b/120161365

Safe Args

  • Safe Args obsługuje obiekty Serializable, w tym wartości Enum. Typy wyliczeniowe mogą ustawiać wartość domyślną za pomocą literału wyliczeniowego bez nazwy klasy (np. app:defaultValue="READ") b/111316353
  • Safe Args obsługuje tablice wszystkich obsługiwanych typów b/111487504
  • Safe Args ignoruje teraz podfoldery katalogów zasobów b/117893516
  • Safe Args dodaje adnotacje @Override tam, gdzie jest to odpowiednie b/117145301

Wersja 1.0.0-alpha07

29 października 2018 r.

Nowe funkcje

  • Nowa klasa AppBarConfiguration umożliwia dostosowanie miejsc docelowych, które są uważane za miejsca docelowe najwyższego poziomu. Szczegółowe informacje znajdziesz w zaktualizowanej dokumentacji. b/117333663
  • Teraz możesz przekazywać argumenty do miejsca docelowego wykresu. b/110300470
  • Precyzyjne linki obsługują teraz schematy niestandardowe z kropkami, łącznikami i znakami plusa. b/112806402

Zmiany powodujące niezgodność

  • Moduł navigation-testing-ktx został połączony z modułem navigation-testing artifact i nie będzie już publikowany.
  • Artefakt navigation-testing jest teraz zależny od biblioteki standardowej Kotlina. Interfejs API został zmieniony, aby był bardziej zgodny z konwencjami Kotlina, ale nadal możesz go używać do testów napisanych w języku Java.
  • Wykresy nawigacyjne zarejestrowane w pliku manifestu metadanych nie są już obsługiwane. b/118355937
  • Działań nie można już dołączać do miejsc docelowych <activity>. aosp/785539

Poprawki błędów

  • Precyzyjne linki prawidłowo analizują teraz parametry zapytania. b/110057514
  • Miejsca docelowe aktywności prawidłowo stosują teraz wszystkie animacje wejścia i wyjścia. b/117145284
  • Naprawiono błąd powodujący awarię po zmianach konfiguracji podczas korzystania z niestandardowych nawigatorów. b/110763345

Safe Args

  • Safe Args mają teraz stałą zależność od wtyczki Androida do obsługi Gradle w wersji 3.2.1. b/113167627
  • Teraz można generować wskazówki dojazdu do klas wewnętrznych. b/117407555
  • Rozwiązaliśmy problem z generowaniem wskazówek dojazdu do wykresu <include>. b/116542123

Wersja 1.0.0-alpha06

20 września 2018 r.

Nowe funkcje

Zmiany w interfejsie API

  • Zmiana powodująca niezgodność: metoda navigate() klasy Navigator przyjmuje teraz parametr Navigator.Extras.
  • Metoda getGraph() klasy NavController jest teraz NonNull b/112243286

Poprawki błędów

  • NavigationUI.setupWithNavController() nie powoduje już wycieku widoków, gdy jest używany z widokami z poszczególnych miejsc docelowych b/111961977
  • Nawigator onSaveState() jest teraz wywoływany tylko raz b/112627079

Safe Args

  • Klasy wskazówek dojazdu do miejsca docelowego nawigacji rozszerzają teraz klasę wskazówek dojazdu elementu nadrzędnego, jeśli istnieje (b/79871405).
  • Klasy Directions i Args mają teraz przydatną implementację toString() b/111843389

Wersja 1.0.0-alpha05

10 sierpnia 2018 r.

Poprawki błędów

  • Naprawiliśmy błąd, który powodował nieprawidłowe działanie stosu cofania. b/111907708
  • Naprawiono błąd w equals() klas Generated Args. b/111450897
  • Naprawiono błąd kompilacji w Safe Args. b/109409713
  • Naprawiono konwersję identyfikatorów zasobów na nazwy Java b/111602491
  • Naprawiono komunikaty o błędach dotyczące dopuszczalności wartości null we wtyczce Safe Args.
  • Dodaj brakujące adnotacje o możliwości przypisania wartości null.

Wersja 1.0.0-alpha04

19 lipca 2018 r.

Nawigacja 1.0.0-alpha04 i powiązana wtyczka Gradle Safe Args zawierają szereg zmian w interfejsie API, zmian w zachowaniu i poprawek błędów.

Zmiany w interfejsie API i działaniu

  • NavHostFragment zawsze ustawia bieżący fragment jako główny fragment nawigacji, dzięki czemu menedżery fragmentów podrzędnych są usuwane przed usunięciem zewnętrznego elementu NavController (b/111345778).

Safe Args

  • Zmiana powodująca niezgodność: app:type zmieniono na app:argType, aby uniknąć konfliktów z innymi bibliotekami, takimi jak ConstraintLayout 2.0.0-alpha1 b/111110548
  • Komunikaty o błędach z Safe Args można teraz klikać b/111534438
  • Klasy Args teraz potwierdzają, że atrybuty NonNull nie mają wartości null b/111451769
  • Do klas wygenerowanych przez NavDirections i Args dodano dodatkowe adnotacje NonNull b/111455455 b/111455456

Poprawki błędów

  • Rozwiązaliśmy problem z systemowym przyciskiem Wstecz po precyzyjnym linkowaniu do miejsca docelowego fragmentu (b/111515685).

Wersja 1.0.0-alpha03

12 lipca 2018 r.

Nawigacja 1.0.0-alpha03 i powiązana wtyczka Gradle Safe Args zawierają szereg zmian w interfejsie API, zmian w zachowaniu i poprawek błędów.

Zmiany w interfejsie API i działaniu

  • Dodano metodę NavigationUI.setupWithNavController dla paska narzędzi b/109868820.
  • Dodano metodę NavigationUI.setupWithNavController dla CollapsingToolbarLayout b/110887183.
  • Funkcja popBackStack() zwraca teraz wartość „false”, gdy stos wsteczny jest pusty lub gdy podany identyfikator miejsca docelowego nie znajduje się na stosie wstecznym b/110893637.
  • FragmentNavigator ignoruje teraz operacje nawigacji po zapisaniu stanu przez FragmentManager, co pozwala uniknąć wyjątków „Can not perform this action after onSaveInstanceState” (Nie można wykonać tego działania po onSaveInstanceState) b/110987825

Safe Args

  • Zmiana powodująca niezgodność: znaki niealfanumeryczne w nazwach działań i argumentów zostaną zastąpione przez camelCase w odpowiednich nazwach metod NavDirections.
    • Na przykład: DemoController.index zmieni się na setDemoControllerIndex b/79995048
    • Na przykład action_show_settings zmieni się w actionShowSettings b/79642240
  • Zmiana powodująca niezgodność: argumenty są teraz domyślnie traktowane jako niepuste. Aby zezwolić na wartości null w argumentach typu string i parcelable, dodaj app:nullable="true" b/79642307
  • Możesz teraz używać typu app:type="long" z wartościami domyślnymi w formacie „123L” b/79563966
  • Argumenty Parcelable są teraz obsługiwane przy użyciu pełnej i jednoznacznej nazwy klasy dla app:type. Jedyną obsługiwaną wartością domyślną jest "@null" b/79563966
  • Klasy Args implementują teraz equals() i hashCode() b/79642246
  • Wtyczkę Safe Args można teraz stosować w projektach bibliotek (b/80036553).
  • Wtyczkę Safe Args można teraz stosować do projektów funkcji: b/110011752.

Poprawki błędów

  • Rozwiązaliśmy problemy z nawigacją podczas metod cyklu życia fragmentu (b/109916080).
  • Rozwiązaliśmy problemy z wielokrotnym przechodzeniem przez zagnieżdżone wykresy b/110178671.
  • Rozwiązaliśmy problemy z używaniem setPopUpTo z pierwszym miejscem docelowym na wykresie b/109909461.
  • Rozwiązaliśmy problem, który powodował, że wszystkie wartości app:defaultValue były przekazywane jako ciągi znaków b/110710788.
  • Narzędzie aapt2 dołączone do wtyczki Androida do obsługi Gradle w wersji 3.2 Beta 01 dodaje teraz reguły zachowywania dla każdego atrybutu android:name w plikach XML nawigacji b/79874119.
  • Naprawiono wyciek pamięci podczas zastępowania domyślnego elementu FragmentNavigator b/110900142

Wersja 1.0.0-alpha02

7 czerwca 2018 r.

Zmiany w zachowaniu

  • FragmentNavigator korzysta teraz z setReorderingAllowed(true). b/109826220

  • Nawigacja dekoduje teraz argumenty URLDecodes przeanalizowane z adresów URL precyzyjnych linków. b/79982454

Poprawki błędów

  • Naprawiono błąd IllegalStateException występujący podczas wywoływania nawigacji z metod cyklu życia fragmentu. b/79632233

  • Nawigacja zależy teraz od biblioteki pomocy 27.1.1, aby rozwiązać problem z migotaniem podczas korzystania z animacji. b/80160903

  • Naprawiliśmy błąd IllegalArgumentException występujący podczas używania defaultNavHost="true" jako fragmentu podrzędnego. b/79656847

  • Naprawiliśmy błąd StackOverflowError występujący podczas korzystania z NavDeepLinkBuilder. b/109653065

  • Naprawiliśmy błąd IllegalArgumentException występujący podczas powrotu do zagnieżdżonego wykresu. b/80453447

  • Rozwiązaliśmy problem z nakładającymi się fragmentami podczas korzystania z launchSingleTop. b/79407969

  • Nawigacja tworzy teraz prawidłowy syntetyczny stos wsteczny dla wykresów zagnieżdżonych. b/79734195

  • NavigationUI będzie teraz wyróżniać prawidłowy element, gdy zagnieżdżony wykres będzie używany jako MenuItem. b/109675998

Zmiany w interfejsie API

  • Atrybut clearTask dla działań i powiązany interfejs API w NavOptions zostały wycofane. b/80338878

  • Atrybut launchDocument działań i powiązany interfejs API w NavOptions zostały wycofane. b/109806636

Wersja 1.0.0-alpha01

8 maja 2018 r.

Nawigacja zapewnia platformę do tworzenia nawigacji w aplikacji. Ta pierwsza wersja to 1.0.0-alpha01.