Nawigacja
androidx.navigation
androidx.navigation.compose
androidx.navigation.dynamicfeatures
androidx.navigation.dynamicfeatures.fragment
androidx.navigation.dynamicfeatures.fragment.ui
androidx.navigation.fragment
androidx.navigation.fragment.compose
androidx.navigation.testing
androidx.navigation.ui
| 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.
Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.
Nawigacja w wersji 2.10
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.lifecycledo 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
NavHostpomija animacje, będzie teraz również uwzględniaćsizeTransformjako 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:
NavHostudostępnia teraz przeciążenie, które akceptuje parametrypredictivePopEnterTransitionipredictivePopExitTransition, aby umożliwić niestandardowe przejście podczas gestu przewidywanego przejścia wstecz.- Plik
handleDeepLinkzostał 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 metodysetPackagew 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-runtimeinavigation-testingobsługują teraz te języki:desktop,linux,macOS,iOS,javascript,WASM,watchositvos.
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łądIllegalArgumentException, 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żliwymNullPointerExceptionspowodowanym 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
compileSdkdo 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
watchositvosdodane do modułównavigation-common,navigation-runtimeinavigation-testing(I60e46) - Ustaw
DefaultNavTransitionsjako 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
NavHostudostępnia teraz przeciążenie, które akceptuje parametrypredictivePopEnterTransitionipredictivePopExitTransition, 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-runtimeinavigation:navigation-testingobsł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żliwymNullPointerExceptionspowodowanym 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
SafeArgsnie 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
SavedStateHandlew 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
SafeArgszostał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
SafeArgsnie będzie już wymagać ustawienia właściwościuseAndroidX, 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łConcurrentModificationExceptionpodczas korzystania zOnDestinationChangedListeners. (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
MissingFieldExceptionpodczas testowaniaSavedStateHandlez trasami z zabezpieczeniami wpisywania przy użyciu niestandardowegoNavTypes. (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
NavEntriesutworzone za pomocą trybu singleTop nigdy nie przekraczały stanu CREATED wLifecycle.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 wskazujeNavController, że te miejsca docelowe będą wyświetlane obok innych. Dzięki temu interfejsowi można na przykładRESUMEDwiele miejsc docelowych jednocześnie.
Compose Kotlin Multiplatform
- Nawigacja oferuje teraz nową, wspólną funkcję
NavController.handleDeepLink(), która przyjmujeNavDeepLinkRequestzamiastIntent. 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, czylicomposable<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
parseStringAsNavUrizostał 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-testingobsługuje teraz komputery, systemy Linux, macOS i iOS, a także Androida. (I2b770, b/398265336) - Funkcja
NavTypejest 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
saveStatez 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: etykietyNavDestinationpodane w kodzie XML będą analizowane przezNavType.get, aby zapewnić przestrzeganie niestandardowej logikiNavType. (I7ec2f, b/388100796) - Z Navigation
2.8.6: podczas przechodzenia do aktywności za pomocądataPatternActivityNavigatorbędzie teraz próbować zakodować wartość argumentu za pomocąNavTypeargumentu. (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
- Interfejsy API z zabezpieczeniami wpisywania, które wcześniej były dostępne tylko za pomocą metod
reified, czylicomposable<YourScreen>mają teraz wersje bez reifikacji, które bezpośrednio przyjmują instancjęKClass(Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808).
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.setStartDestinationdla 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ł, żeNavHostmógł zgłaszać wyjątek wPredictiveBackHandler, 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łądNavDestinationNullPointerExceptionpodczas aktualizowaniastartDestinationwykresu. (I99421, b/361560785)
Zewnętrzny wkład
- Nawigacja
2.8.5: zabezpieczenia wpisywania w nawigacji obsługują terazList<Enum>jako typ argumentu trasy bez konieczności używania niestandardowegoNavType. Dziękujemy, Csaba Kozák! (GH-725, b/375559962)
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 elementLifecycleObserverdołączony do elementuNavBackStackEntrywywoływał zmianę stosu wstecznego, gdy hostLifecycleOwner, 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 wskazujeNavController, że te miejsca docelowe będą wyświetlane obok innych. Dzięki temu interfejsowi można na przykładRESUMEDwiele miejsc docelowych jednocześnie. (Id5559) - Nawigacja
2.8.3: dodaliśmy nowe testy lint dla modułównavigation-common,navigation-runtimeinavigation-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ńNavGraphBuilderiNavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Z Navigation
2.8.3: dodano nowe testy Lint dla modułównavigation-common,navigation-runtimeinavigation-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ńNavGraphBuilderiNavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
Zmiany w zachowaniu
- Próba użycia
NavController, który został wcześniejDESTROYED, spowoduje teraz błądIllegalStateException. (I520da, b/369616172)
Poprawki błędów
- Zaktualizowano wyjątek „Nie znaleziono klasy Enum”, aby sugerować użycie adnotacji
@Keepw 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łądObsolete custom lint checkpodczas 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
NavDestinationpodane w pliku XML zostaną przeanalizowane przezNavType.get, aby zapewnić przestrzeganie niestandardowej logikiNavType. (Id366d, b/388100796) - Podczas przechodzenia do aktywności za pomocą
dataPatternActivityNavigatorbędzie teraz próbować zakodować wartość argumentu za pomocąNavTypeargumentu. (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
NavHostmogło zgłaszać wyjątek wPredictiveBackHandler, 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
NavDestinationNullPointerExceptionpodczas aktualizowaniastartDestinationwykresu. (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 elementLifecycleObserverdołączony do elementuNavBackStackEntrywywoływał zmianę stosu wstecznego, gdy hostLifecycleOwner, 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 niestandardowegoNavType. 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
- Nawigacja
2.9.0-alpha03: zabezpieczenia wpisywania w nawigacji obsługują teraz klasę wartości jako trasę lub jako typ argumentu trasy (I9344a, b/374347483).
Poprawki błędów
- Nawigacja
2.9.0-alpha01: próba użycia elementuNavController, który został wcześniejDESTROYED, spowoduje teraz błądIllegalStateException. (I520da, b/369616172)
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-runtimeinavigation-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ńNavGraphBuilderiNavDeepLinkBuilder. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Dodaliśmy nowe kontrole linta w modułach
navigation-common,navigation-runtimeinavigation-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ńNavGraphBuilderiNavDeepLinkBuilder. (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łądObsolete custom lint checkpodczas 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>iList<Double>?, bez konieczności używania niestandardowegoNavType. (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ćpopBackStackza pomocą interfejsów API z zabezpieczeniami wpisywania. (Ief161, b/358095343)
Poprawki błędów
- Nawigacja wymaga teraz, aby trasa przekazana do funkcji
startDestinationelementuNavGraphzawierał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
SeekableTransitionStatez 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ęComposableNavHostFragmentdlaNavHostFragment, która umożliwia dodawanie kompozycyjnych miejsc docelowych do plików XML nawigacji. Każde miejsce docelowecomposablemusi być wyrażone jako metoda najwyższego poziomu bez argumentów@Composable, której pełna i jednoznaczna nazwa jest używana jako atrybutandroid:namew 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 tabliceNavType(IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeiStringArrayType) dziedziczą teraz z tej nowej klasy. NavTypema 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 typyEnumnie wymagają już niestandardowychNavType. Pamiętaj, żeSerialNameEnummusi 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?iEnum<*>?. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237) startDestinationwNavGraphbędzie teraz używać domyślnych wartości argumentów, jeśli trasastartDestinationprzekazana doNavGraphjest dokładnie taka sama jakstartDestination.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
WrongStartDestinationTypenie 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 elementyNavGraphskorzystają z tej samej trasystartDestination. (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
SavedStateHandleFactorymoż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 życiaRESUMED. 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
CollectionNavTypema 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.serializeAsValueiserializeAsValues, 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 argumentemCollectionNavTypeo wartości null. Podczas nawigacji z wartością nullCollectionNavTypeargumentem wyjściowym będzie domyślna wartość zadeklarowana w klasie Serializable lub wartość zwracana przezemptyCollection(), 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ę
ClassCastExceptionpodczas używaniaNavBackStackEntry.toRoutez niestandardowymNavType, 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 parametrtypeMapdla niestandardowych typów argumentów. (Ie39fb, b/339026523)- Dodaliśmy testowy interfejs API do
navigation-testing, aby umożliwić tworzenieSavedStateHandlez 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
- Prace nad obsługą bezpieczeństwa typów w czasie kompilacji w przypadku Navigation Compose i użytkowników Navigation Kotlin DSL na podstawie serializacji Kotlin zostały zakończone, a interfejsy API, które wcześniej były eksperymentalne, są teraz stabilne. (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
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-composeudostępnia teraz elementLocalFragmentCompositionLocal metodom kompozycyjnym w ramachComposableFragment. (If35e5) NavTypema 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ęComposableNavHostFragmentdlaNavHostFragment, która umożliwia dodawanie miejsc docelowychcomposabledo plików XML nawigacji. Każde miejsce docelowecomposablemusi być wyrażone jako metoda najwyższego poziomu bez argumentów@Composable, której pełna i jednoznaczna nazwa jest używana jako atrybutandroid:namew 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
- Rozpoczęliśmy obsługę Safe Args w Navigation Compose przy użyciu 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. (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
Poprawki błędów
NavHostużywa terazAlignment.TopStartjako domyślnego argumentu contentAlignment. Dzięki temu jest on zgodny z domyślnym ustawieniem wAnimatedContenti 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
NavHostbę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
startDestinationNavGraphbezpośrednio w trasiestartDestinationbez korzystania zdefaultValue. Dotyczy to również zagnieżdżonych elementówNavGraphstartDestinations. (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,BoolArrayTypeiStringArrayType) są teraz typuCollectionNavType(Idcf79, b/188693139). NavTypeudostępnia teraz nowy otwarty interfejs APIvalueEquals, 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 argumentuNavTypesopartego 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 jaknavigatelubpopBackStack, mogą teraz prawidłowo dopasowywać trasy wypełnione argumentami tablicyNavTypes. (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ć
SizeTranformdla przejść w Navigation Compose, definiując je w ramach inicjowania funkcjicomposablelubnavigation. (I91062, b/296912651)
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że funkcja
NavHostw 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.savedStateHandlejest 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
DESTROYEDobiektów ViewModelNavGraph, ponieważ powiązany wpisViewModelnie był częścią zapisanego stanu. (Ib6bb7, b/317581849)
Aktualizacja zależności
- Komponent Navigation Compose zależy teraz od Compose 1.7.0-alpha03.
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
SeekableTransitionStatez 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łaniasaveStatew 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
- Nawigacja w Compose zależy teraz od Compose
1.7.0-alpha01, co rozwiązuje problem, który mógł powodować nieoczekiwaną animację skalowania. (b/297258205)
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
NavigationUIdo 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 wyciekBackStackState, w przypadku którego wielokrotne wywołaniasaveState()w jednymNavBackStackEntrypowodował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 pomocniczychNavigationUIdo 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
NavigationUIdo 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
NavGraphequals()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) NavHostbę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
setGraphzostał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,
ViewModelwpisu zostanie teraz prawidłowo wyczyszczony, jeślisaveStatema wartość false. (Idf242, b/298164648) - Naprawiliśmy błąd, który powodował, że
NavControllermógł obsługiwać ten sam precyzyjny link więcej niż raz, jeśli stos wsteczny był całkowicie pusty przed zmianą konfiguracji lub wywołaniemsetGraphtylko 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
ViewModelzagnieżdżonych fragmentów nie były czyszczone podczas wywoływaniaclearBackStack.
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 wpopBackStack. (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
DialogFragmentbędzie teraz prawidłowo przechodzić do stanuRESUMEDpo 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
visibleEntrieszawierał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 życiaRESUMED. (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ędzyrememberSaveableaNavHostw Navigation Compose, która powodowała, że stanrememberSaveablemiejsc docelowych i wszystkie instancjeSavedStateHandlenależące doViewModelnie 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
CREATEDzamiastSTARTED. (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 stanuRESUMED. (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
Scaffoldmógł pojawić się błąd związany z próbą uzyskania dostępu doLifecycle.State.DESTROYEDViewModel. (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 nie1.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
EnterTransitioniExitTransitionutworzone w ramachNavHostmogły pozostawać w pamięci nawet po usunięciuNavHostz kompozycji. (I893d0)
Znane problemy
- W Nawigacji 2.6.x występuje problem, który może powodować błąd
IllegalArgumentExceptionpodczas 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
NavHostw Navigation Compose teraz prawidłowo przechwytuje wywołania systemowe przycisku Wstecz, nawet poSTOPPEDiRESUMEDActivity. (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ąpopUpToi 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
argumentsiargumentsNavBackStackEntryprzekazywane doOnDestinationChangedListenersą 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 doargumentsani innych instancjiOnDestinationChangedListener.NavDeepLinkobsł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.NavTypezawiera teraz domyślną metodę, którą można zastąpić, aby połączyć 2 przeanalizowane wartości.- Niestandardowe podklasy
NavTypemogą 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 klasieNavType.StringTypezastępuje teraz tę metodę, aby wywołaćUri.encodew przypadku podanegoString.
Ważne zmiany w Navigation Compose od wersji 2.5.0
- Podczas wyświetlania podglądu funkcji kompozycyjnej z
NavHostdomyślnie będzie teraz wyświetlany elementstartDestinationNavGraph. 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
NavDeepLinkza pomocąnavDeepLinkKotlin 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
NavHostFragmentnie przechwytuje już systemowego przycisku Wstecz. Dzięki temu bazowy elementFragmentManagermoże obsługiwać systemowy przycisk Wstecz. Dzięki temu Fragment1.7.0-alpha01i 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 wstecznegoFragmentManager, zostanie wygenerowany wyjątekIllegalArgumentException. Fragmenty należy zawsze dodawać za pomocą interfejsu APInavigate(). - Jeśli użyjesz ciągu znaków
${applicationId}jako obiektu zastępczego w atrybutachapp:dataiapp:dataPatternw elemencie aktywności pliku XML nawigacji, obiekt zastępczy zostanie automatycznie wypełniony wartościąpackageNamekontekstu po rozwinięciu. FragmentNavigatorużywa teraz interfejsów API przejść podczas nawigacji i wyświetlaniaNavBackStackEntries. Oznacza to, żeNavBackStackEntryLifecyclebędzie teraz czekać na zakończenie efektów specjalnych fragmentu wejściowego i wyjściowego, zanim przeniesie ich ostatecznyLifecycle.State.DialogFragmentNavigatorużywa teraz interfejsów API przejść podczas nawigacji i wyświetlaniaNavBackStackEntries. Oznacza to, żeNavBackStackEntryLifecyclebędzie teraz czekać, ażDialogFragmentLifecycleprzejdzie do stanuDESTROYED, zanim sam przejdzie do stanuDESTROYED.NavHostFragmentumożliwia teraz pobranieNavController, gdy tylkoNavHostFragmentzostanie dołączony doFragmentManager, a nie dopiero poonCreate().- 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),NavigationUItraktuje 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 funkcjiisTopLevelDestinationwAppBarConfiguration. - Integracje
setupWithNavControllerwNavigationUIdo pracy z górnym paskiem aplikacji będą teraz analizować wartościR.stringargumentówReferenceTypeznalezionych wandroid:labeli przekształcać je w wartości typu String zamiast generować automatycznie liczbę całkowitą zasobu. NavigationUIudostępnia teraz logi, gdy nie uda się nawigować za pomocą wybranegoMenuItem.
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ą
popUpToi 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
popUpTow wywołaniu zwrotnym cyklu życiaonResume()powodowało błądIllegalStateException. (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
NavBackStackEntryudostę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 wstecznegoFragmentManager, zostanie wygenerowany wyjątekIllegalArgumentException. Fragmenty należy zawsze dodawać za pomocą interfejsu APInavigate(). (I6d38e) - Gdy w tej samej ramce występuje
navigate, który dodaje wpis, ipopBackStack, który go usuwa, wynikowy wpis na górze stosu wstecznego będzie teraz konsekwentnie wracać doRESUMEDLifecycle.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
NavDestinationzawiera niepustyNavArgument, trasa tego miejsca docelowego musi zawierać obiekty zastępcze dla argumentów o takiej samej nazwie jak niepustyNavArgument. (Ic62bf, b/274697949) - Nawigacja za pomocą precyzyjnych linków oparta na
Action/MimeTypebędzie teraz kończyć się niepowodzeniem, jeśli w operacji nawigacji brakuje wartościNavArgument, która nie może być pusta, a której wymagaNavDestination, do którego pasujeAction/MimeType. (Ibfa17, b/271777424) - Gdy
NavControllerustawia 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 zonLaunchSingleTopbez 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
NavHostFragmentumożliwia teraz pobranieNavController, gdy tylkoNavHostFragmentzostanie dołączony doFragmentManager, a nie dopiero poonCreate(). (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ą
popUpToużyjesz systemowego przycisku Wstecz, stanNavControllerzostanie przywrócony do prawidłowego wpisu. (I3a8ec, b/270447657) FragmentNavigatorbędzie teraz prawidłowo usuwać wpisy, gdy stos wsteczny zostanie usunięty za pomocą przycisku wstecz systemu lubpopBackStack(), niezależnie od tego, czy transakcja używa efektów dla fragmentu. (I81bdf)- Dodawanie fragmentów do
FragmentNavigatorFragmentManagerbez używania nawigacji nie będzie już powodować awarii. (b17204, b/274167493)
Aktualizacje zależności
- Nawigacja zależy teraz od cyklu życia
2.6.1. (586fe7) - Nawigacja zależy teraz od SavedState
1.2.1. (078e4e) - Nawigacja zależy teraz od ProfileInstaller
1.3.0. (512f0c)
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()zNavControllernie 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
MenuItemwBottomNavigationView. (I634f6, b/270447657) - Naprawiliśmy błąd regresji w wersji 2.6.0-alpha06, który powodował, że obiekty
NavBackStackEntrynie były przenoszone do stanu RESUMED, gdy używane były obiektyAnimation. (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
NavHostdomyślnie będzie teraz wyświetlany elementstartDestinationNavGraph. (I2b89f)
Zmiany w interfejsie API
- Wszystkie przeciążenia
NavControllernavigatesą 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
NavBackStackEntrynie osiąga stanuRESUMED, gdy używane są interfejsy APIAnimation. (b/269646882) - Jeśli podczas korzystania z nawigacji z fragmentami i nawigowania za pomocą
BottomNavigationspróbujesz przywrócić stos wsteczny z wieloma wpisami,BottomMenuItemnie zostanie prawidłowo zaktualizowany. (b/270447657) - Gdy używasz nawigacji z fragmentami, po przywróceniu stanu
NavBackStackEntryLifecyclenie otrzymujeDESTROYED, gdy jego fragment jestDESTROYED. (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)FragmentNavigatorużywa teraz interfejsów API przejść podczas nawigacji i wyświetlaniaNavBackStackEntries. Oznacza to, żeNavBackStackEntryLifecyclebędzie teraz czekać na zakończenie efektów specjalnych fragmentu wejściowego i wyjściowego, zanim przeniesie ich ostatecznyLifecycle.State. (I3cb19, b/238686802)DialogFragmentNavigatorużywa teraz interfejsów API przejść podczas nawigacji i wyświetlaniaNavBackStackEntries. Oznacza to, żeNavBackStackEntryLifecyclebędzie teraz czekać, ażDialogFragmentLifecycleprzejdzie do stanuDESTROYED, zanim sam przejdzie do stanuDESTROYED. (I53ee5, b/261213893)
Zmiany w interfejsie API
NavigatorStateudostępnia teraz interfejs APIprepareForTransition, który umożliwiaNavigatorprzenoszenieNavBackStackEntriesdo pośrednichLifecycle.State. (I42c21, b/238686802)- Teraz możesz uzyskać dostęp do stosu wstecznego powiązanego z
NavGraphNavigatorlubComposeNavigatorza pomocą właściwościbackstack.ComposeNavigatorudostępnia teraz wywołanie zwrotneonTransitionComplete(), aby oznaczyćNavBackStackEntry, który wykonał operację nawigacji lubpopBackStack, 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
launchSingleTopz zagnieżdżonymNavGraph, wszystkie miejsca docelowe od pierwotnego miejsca docelowego do jegostartDestinationzostaną prawidłowo dodane na górze stosu wstecznego. (Id4bea, b/253256629) - Nawigacja będzie teraz prawidłowo zastępować instancję
DialogFragmentpodczas nawigowania do tego samego miejsca docelowego z flagąlaunchSingleTopustawioną 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
NavTypemogą 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 klasieNavType.StringTypezastępuje teraz tę metodę, aby wywołaćUri.encodew przypadku danegoString. (Ie5213, b/247637434) NavigationUIudostępnia teraz logi, gdy nie uda się nawigować za pomocą wybranegoMenuItem. (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:NavHostnie będzie już powodować błęduNoSuchElementException, gdy nie będzie dostępnego miejsca docelowego dlaCrossfade. 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życierememberSaveable) nie był zapominany i usuwany, gdy miejsce docelowe zostało usunięte ze stosu wstecznego. (I64949)
Aktualizacje zależności
- Nawigacja zależy teraz od Fragmentu
1.5.4. (Icd424)
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),NavigationUItraktuje 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 funkcjiisTopLevelDestinationwAppBarConfiguration. (Ie936e, b/238496771)
Poprawki błędów
- Komponent
navigation:navigation-fragmentzależy teraz od wersji1.5.2biblioteki 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
setupWithNavControllerwNavigationUIdo pracy z górnym paskiem aplikacji będą teraz analizować wartościR.stringargumentówReferenceTypeznalezionych wandroid:labeli przekształcać je w wartości typu String zamiast generować automatycznie liczbę całkowitą zasobu. (I5f803, b/167959935) NavDeepLinkobsł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.NavTypezawiera 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 atrybutachapp:dataiapp:dataPatternw elemencie aktywności pliku XML nawigacji, obiekt zastępczy zostanie automatycznie wypełniony wartościąpackageNamekontekstu po rozwinięciu. (Iaabde, b/234223561) - Próba utworzenia pustego elementu
NavDeepLinkza pomocąnavDeepLinkKotlin 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 formieandroid:label="{arg}"i przekształcanie ich w ciąg znaków. Obsługuje argumentyReferenceType, analizując wartościR.stringi zamieniając je na wartości typu String. (I07d89, b/236269380)
Zmiany w zachowaniu
argumentsobiektu NavBackStackEntry iargumentsprzekazywane doOnDestinationChangedListenersą 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 doargumentsani innych instancjiOnDestinationChangedListener. (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 flagilaunchSingleTopna wartość „true”. (I5a2f1, b/237374580) - Nawigacja
2.5.2: naprawiliśmy błądIllegalStateException, 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
NavHostnie będzie już powodować błęduNoSuchElementException, gdy nie będzie dostępnego miejsca docelowego do utworzeniaCrossfade. 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
launchSingleTopna wartość true. (I5a2f1, b/237374580) - Naprawiliśmy błąd
IllegalStateExceptionspowodowany 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
- Komponent Navigation
2.5.2zależy teraz od komponentu Fragment1.5.2. (aosp/2178734)
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 Argsnie będzie już powodować ostrzeżeń o wycofaniu w wygenerowanych klasach, gdy używane są niestandardowe typy argumentów zapisane wBundle. (Id86ed, b/237725966)
Aktualizacje zależności
- Biblioteka nawigacji zależy teraz od Lifecycle
2.5.1. (Ib4451) - Biblioteka nawigacji zależy teraz od Activity
1.5.1. (I3efe8) - Biblioteka nawigacji zależy teraz od Fragmentu
1.5.1. (I56177)
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 –
Navigationmoże teraz udostępniać bezstanowyViewModelProvider.Factoryza pomocąCreationExtrasLifecycle2.5.0.
Navigation SafeArgs
- W pakiecie
Navigation Safe Argsuaktualniono zależnośćAndroid Gradle Plugin, aby korzystała z7.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
visibleEntriesnie jest już eksperymentalny i udostępnia funkcję pobierania wszystkich wpisów, których miejsce docelowe jest obecnie widoczne zgodnie zNavController.
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 SafeArgsnie będzie już ulegać awarii podczas używaniaapplicationIdSuffixi przestrzeni nazw bezapplicationIdlub gdyapplicationIdi przestrzeń nazw się różnią. (I754b1, b/233119646)NavArgumentma 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 plikunavigation.xml(Ic15a5, b/178403185).
Poprawki błędów
- Zakresy funkcji kompozycyjnych w
NavHostiDialogHostsą teraz usuwane w oczekiwanej kolejności, tzn. wewnętrzne funkcje kompozycyjne są usuwane przed zewnętrznymi. (I157e6) - Komponent SafeArgs nawigacji używa teraz
PathSensitivity.RELATIVEwArgumentsGenerationTask, 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
UnrememberedGetBackStackEntryDetectorzostała zaktualizowana, aby wywołanierememberotaczające wywołaniegetBackStackEntry()przekazywało również obiektNavBackStackEntryjako 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
DialogNavigatorużywa terazpopWithTransitionpodczas wykonywania wywołaniadismiss(). Rozwiązuje to problem z sytuacją wyścigu podczas używaniaViewModelw miejscu docelowymdialog, który powodował błądIllegalStateException, 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 zIllegalStateExceptionpodczas zagnieżdżania jednego elementuNavHostw innym elemencieNavHostna 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
visibleEntriesnie jest już funkcją eksperymentalną. (I4829f, b/225394514)
Poprawki błędów
- NavHost zależy teraz od
visibleEntrieszNavController, aby określić, które wpisy mają zostać utworzone. Oznacza to, że podczas korzystania z zagnieżdżonego elementu NavHost wewnętrzny elementNavHostpowinien teraz prawidłowo animować wyjście. (I4ba2b, b/225394514) - Wartość
visibleEntriesStateFlowpodana przezNavControllerjest teraz oparta na maksymalnym stanie cyklu życia wpisu, a nie na bieżącym stanie cyklu życia. Oznacza to, że nawet jeśli cykl życia hostanavControllerspadnie poniżej stanu STARTED, lista widocznych wpisów pozostanie taka sama. (I9e2a8, b/225394514) SavedStateViewFactoryobsługuje terazCreationExtras, nawet jeśli zainicjowano go za pomocąSavedStateRegistryOwner. Jeśli podano dodatkowe argumenty, zainicjowane argumenty są ignorowane. (I6c43b, b/224844583)NavDeepLinkmoż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 Argsnie będzie już ulegać awarii, gdy używane są przestrzenie nazw i nie maAndroidManifest.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ć
CreationExtrasdoby navGraphViewModels, aby utworzyćViewModel. (I29217, b/217618359)
Poprawki błędów
NavDeepLinksobsługuje teraz prawidłowo zakodowane znaki nowego wiersza umieszczone w identyfikatorach URI tras lub precyzyjnych linków. (I513d1, b/217815060)CreationExtrasbędzie teraz działać prawidłowo, gdy będzie używany zNavBackStackEntriesdo tworzenia obiektów ViewModel. (I69161, b/217617710)- Navigation Safe Args obsługuje teraz używanie przestrzeni nazw zdefiniowanej w
build.gradlezamiast 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:NavHostFragmentbędzie teraz prawidłowo ustawiaćOnBackPressedDispatcherpodczas 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ówNavGraphstos 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
NavBackStackEntryintegruje się teraz z ViewModel CreationExtras, wprowadzonym w ramach Lifecycle2.5.0-alpha01. (Ib9fe2, b/207012490)
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że próba uzyskania dostępu do elementu
ViewModelutworzonego za pomocąby navGraphViewModels()z elementuonCreate()fragmentu kończyła się błędemIllegalStateException. (I8a14d) NavDeepLinknie 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
- Przeniesione z Navigation
2.5.0-alpha03:NavDeepLinksprawidłowo obsługuje teraz zakodowane znaki nowego wiersza umieszczone w identyfikatorach URI tras i precyzyjnych linków. (I513d1, b/217815060) - Przeniesione z Navigation
2.5.0-alpha03: Navigation SafeArgs obsługuje teraz przestrzeń nazw zdefiniowaną wbuild.gradlezamiast pakietu w pliku AndroidManifest. (I659ef, b/217414933) - Przeniesiono z Nawigacji
2.5.0-alpha04:Navigation Safe Argsnie będzie już ulegać awarii podczas używania przestrzeni nazw, gdy nie maAndroidManifest.xml. (I17ccf, b/227229815) - Przeniesione z Nawigacji
2.5.0-alpha04: pusty ciąg znaków jest teraz uznawany za prawidłowy argument w precyzyjnych linkach. (I70a0d, b/217399862)
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
NavHostFragmentbędzie teraz prawidłowo ustawiaćOnBackPressedDispatcherpodczas używania wiązania widoku z wykresami zagnieżdżonymi. (Ifbb51, b/214577959)- Podczas precyzyjnego linkowania przez wiele zagnieżdżonych elementów
NavGraphstos 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()zonCreate()fragmentu kończył się błędemIllegalStateException. (I8a14d) - Przeniesione z Nawigacji
2.5.0-alpha01:NavDeepLinknie 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-ktxbędą nadal publikowane, ale będą całkowicie puste. - Artefakt
navigation-fragmentzawiera teraz gotową implementację układu z 2 panelami za pomocą nowego elementuAbstractListDetailFragment. Ten fragment używaSlidingPaneLayoutdo zarządzania panelem listy (który udostępnia Twoja podklasa) i okienkiem szczegółów, które używaNavHostFragmentjako implementacji, jak widać w naszej przykładowej implementacji. - Metoda
currentBackStackEntryAsFlow()wNavControllerudostępniaFlow, który jest emitowany przy każdej zmianie bieżącegoNavBackStackEntry. Ten proces może być używany jako alternatywa dla ręcznego zarządzaniaOnDestinationChangedListener. - NavController umożliwia teraz pobieranie listy wszystkich widocznych instancji
NavBackStackEntryjakoStateFlowza pomocą eksperymentalnej właściwościvisibleEntries. - 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()igetHierarchy(), które mogą pomóc we wdrażaniu niestandardowego interfejsu NavigationUI.findStartDestination()to funkcja rozszerzenia wNavGraph, która lokalizuje rzeczywiste miejsce docelowe wyświetlane po przejściu do wykresu, nawet jeślistartDestinationjest zagnieżdżonymNavGraph.getHierarchy()to funkcja wNavDestination, 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łyBottomNavigationView, zostały zaktualizowane, aby przyjmowały klasę nadrzędną wprowadzoną w Material1.4.0,NavigationBarView. Dzięki temu będzie można używać tych metod wNavigationRailView.Podczas rozwijania elementu
<action>za pomocą kodu XML atrybuty animacji mogą używać atrybutów pobranych z motywu za pomocą składniapp:enterAnim="?attr/transitionEnter".Safe Args generuje teraz metodę
fromSavedStateHandle()dla każdej klasyNavArgs. (#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ść
popUpTow języku Kotlin w DSL Kotlin została wycofana na rzeczpopUpToId. - Interfejs API
getStartDestination()został wycofany na rzecz interfejsugetStartDestinationId().
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 docelowychcomposableidialogoraz 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
Lifecycledla każdego miejsca docelowego, które można utworzyć. Każde miejsce docelowe osiąga stanRESUMEDdopiero po zakończeniu przejść wejściowych i natychmiast przechodzi w stanSTARTED, gdy rozpoczynają się przejścia wyjściowe. Pozwala to uniknąć wszystkich problemów zIllegalStateExceptioni multidotykiem, ponieważ wywołanienavigatejest wyzwalane tylko wtedy, gdyLifecyclema stanRESUMED. - Określanie zakresu
ViewModel(za pomocą interfejsu APIviewModel()biblioteki Lifecycle ViewModel Compose2.4.0lubhiltViewModel()biblioteki Hilt Navigation Compose1.0.0na 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 metodzieonCleared()obiektu ViewModel, który wskazuje na trwałe usunięcie i wyczyszczenie stanu powiązanego z tym elementemNavBackStackEntry. - Określanie zakresu stanu
rememberSaveablena 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
NavControlleroraz 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()icurrentBackStackEntryAsState(), aby umożliwić podnoszenie stanu i łączenieNavControllerz komponentami kompozycyjnymi pozaNavHost(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 logicznychapp:popUpToSaveStateiapp:restoreState, aby zapisywać stan wszystkich miejsc docelowych usuniętych za pomocąapp:popUpToi przywracać stan powiązany z miejscem docelowym przekazanym jakoapp: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
navOptionsKotlin DSL możesz dodać właściwość logicznąrestoreStatei właściwość logicznąsaveStatewpopUpTobuilder:// 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
NavOptionsza pomocąNavOptions.Buildermożesz użyćsetRestoreState()i nowego przeciążenia dosetPopUpTo(), które przyjmuje dodatkowy parametrsaveState.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 parametrsaveState.Możesz użyć metody
clearBackStack(), aby wyczyścić stan zapisany za pomocą metodypopBackStack()lubpopUpToSaveState.
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
NavDeepLinkBuilderdodaje terazPendingIntent.FLAG_IMMUTABLEdoPendingIntentzwracanego przezcreatePendingIntent(), 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.1i oznacza metodysetGraph(),popBackStack(),navigateUp()inavigate(), które aktualizująNavBackStackEntryLifecycle, jako@MainThread, dostosowując nawigację do wymuszania wątku głównego wprowadzonego w Lifecycle2.3.0. - Precyzyjne linki sprawdzają teraz, czy w
Urisą obecne wszystkie wymagane argumenty (te bez wartości domyślnych). - W argumentach analizowanych przez
NavDeepLinkznaki 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 elementuViewModelutworzonego za pomocąby navGraphViewModels()zonCreate()fragmentu zakończy się błędemIllegalStateException. (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
NavDeepLinktraktują 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)
NavControllernie będzie już ulegać awarii podczas usuwania zagnieżdżonego miejsca docelowego za pomocą przejść po przywróceniuNavController. (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
ViewModelzNavBackStackEntryokna 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
activityzNavHostw 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
SafeArgsnie 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ę
saveStatepodczas przechodzenia do innego wykresu, dzięki czemu kod taki jakNavigationUI.setupWithNavControlleri 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.STARTEDobiekty NavBackStackEntry były przenoszone doLifecycle.State.CREATED, gdyNavHostbył dodawany bezpośrednio dosetContent()aktywności. (Ia5ac1, b/203536683) - Naprawiliśmy sytuację wyścigu, w której usunięcie miejsca docelowego
DialogFragmentze 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
onNavDestinationSelectedna platformieNavigationUIzwracał wartośćtrue, nawet jeśli nie wykonano operacjinavigate()na tym wykresie nawigacji. Teraz używa tej samej logiki, która jest używana wewnętrznie przezsetupWithNavController, aby wybrać tylkoMenuItempowiązany z bieżącym miejscem docelowym za pomocąhierarchymiejsca 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 navGraphViewModelz trasą zamiast identyfikatora, aby lepiej obsługiwać Navigation Kotlin DSL z fragmentami. (I901e3, b/201446416)
Zmiany w interfejsie API
- Interfejs API
visibleEntriesjest 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ówNavDestination. (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 atrybutylayout_widthilayout_weightw panelu listy zwracanym przezonCreateListPaneView()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 APIdismiss()dlaDialogFragmentteraz 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 funkcjipopUpTolubpopBackStack(). (I77ba2) AbstractAppBarOnDestinationChangedListenerma teraz bardziej przejrzyste komunikaty o błędach dotycząceonDestinationChanged(). (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
NavBackStackEntryza pomocąvisibleEntriesStateFlow (Ia964e). rememberNavController()przyjmuje teraz opcjonalny zestaw instancjiNavigator, które zostaną dodane do zwracanegoNavController, 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()ifromSavedStateHandle()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()lubpopUpToSaveState. (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
navArgumentKotlin DSL jest teraz częściąnavigation-common, a nienavigation-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ą
DESTROYEDdopiero 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
launchSingleTopinstancjeOnDestinationChangedListenericurrentBackStackEntryFlownie były powiadamiane. (Iaaebc)
Aktualizacje zależności
- Komponent Navigation Compose zależy teraz od Activity Compose w wersji 1.3.1. (I05829)
- Komponent Navigation Compose zależy teraz od Lifecycle ViewModel Compose
2.4.0-beta01. (Ib86a3)
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
- 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. (I78440, b/196871885)
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
Urisą obecne wszystkie wymagane argumenty (te bez wartości domyślnych). (#204, b/185527157)
Poprawki błędów
- Użycie funkcji
getBackStackEntryipreviousBackStackEntrywewnątrz funkcji composable() w połączeniu zremember()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
setGraphz wykresem z 13 lub 29 miejscami docelowymi nie będzie już występować błądArrayIndexOutOfBoundsException. (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)
NavHostteraz obserwuje zmiany wLifecycle.StateNavBackStackEntry, co oznacza, że użycieNavHostwe 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
DialogFragmentstanNavControllernie 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ę
toSavedStateHandledla argumentów, których można używać do testowania koduViewModel. (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()irequireDetailPaneNavHostFragment()wAbstractListDetailFragmentzostały zmienione odpowiednio nagetSlidingPaneLayout()igetDetailPaneNavHostFragment(). (I34a08)
Zmiany w zachowaniu
- Podczas nawigacji z animacjami (np.
Crossfade)Lifecyclenowego miejsca docelowego będzie osiągaćRESUMEDdopiero po zakończeniu animacji. (If0543, b/172112072, b/194301889) NavHostw 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 bezUrii nawigowania za pomocą trasy lub precyzyjnego linku. (938a0c, b/193805425) - Rozwiązaliśmy problem w Navigation Compose, który powodował, że element
NavBackStackEntryz precyzyjnym linkiem nie osiągał stanuRESUMED. (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
NavHostw 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ływaniapopBackStack()z poziomuLifecycleObserverdołączonego doNavBackStackEntryi był spowodowany przez ponowne aktualizacje stanu NavController. (I64621) AbstractListDetailFragmentumożliwia teraz całkowite usunięcieSlidingPaneLayoutz pliku APK, gdy nie używaszAbstractListDetailFragment. (I611ad)- Klasy
NavGraphiNavDestinationzastę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-fragmentzawiera teraz gotową implementację układu z 2 panelami za pomocą nowego elementuAbstractListDetailFragment. Ten fragment używaSlidingPaneLayoutdo zarządzania panelem listy (który udostępnia Twoja podklasa) i okienkiem szczegółów, które używaNavHostFragmentjako implementacji, jak widać w naszej przykładowej implementacji. (Iac4be, b/191276636) NavHostartefaktunavigation-composeobsługuje teraz miejsca docelowedialogoprócz miejsc docelowychcomposable. Każde z tych miejsc docelowych okna będzie wyświetlane w kompozycyjnym elemencieDialog, który będzie unosić się nad bieżącym miejscem docelowymcomposable. (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
addwNavigatorStatezostała zmieniona napush. Wszystkie bieżące wywołaniaadd()trzeba będzie zmienić na push(). (Ie89fc, b/172112072) - Niestandardowe instancje
Navigatormogą teraz używać interfejsów APIpushWithTransactionipopWithTransitionwNavigatorState, 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
NavDeepLinkBuilderdodaje terazPendingIntent.FLAG_IMMUTABLEdoPendingIntentzwracanego przezcreatePendingIntent(), 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
NullPointerExceptionwystępujący podczas przechodzenia do miejsca docelowego za pomocą argumentustring[]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ą
Kotlinw 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ł, żesetupActionBarWithNavController()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
IllegalStateExceptionwystępujący podczas wywoływaniapopBackStack()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 znavigation-commonlub dowolnych artefaktów, które od niego zależą. (I68800, b/190082521) OnDestinationChangedListener, który wywołujenavigate()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.0Safe Args nie zadziała i wyświetli błądUnable 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
NavigationUItymczasowo 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()igetHierarchy(), które mogą pomóc we wdrażaniu niestandardowego interfejsu NavigationUI.findDestination()to funkcja rozszerzenia wNavGraph, która lokalizuje miejsce docelowe na wykresie.getHierarchy()to funkcja wNavDestination, 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 Material1.4.0,NavigationBarView. Dzięki temu będzie można używać tych metod wNavigationRailView. (Ib0b36, b/182938895)Podczas rozwijania elementu
<action>za pomocą kodu XML atrybuty animacji mogą używać atrybutów pobranych z motywu za pomocą składniapp: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
DialogFragmentNavigatorużywa teraz interfejsu APINavigatorState.pop(), aby informowaćNavController, gdy okno zostanie zamknięte przez naciśnięcie systemowego przycisku Wstecz lub kliknięcie poza nim. Dzięki temu stanNavControllerjest zawsze zsynchronizowany ze stanem nawigatora. (I2ead9)Nawigacja nie powoduje już błędu
ConcurrentModificationExceptionpodczas manipulowania listąOnDestinationChangedListenersz wywołania zwrotnegoonDestinationChanged. (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
findNodeto terazresIdzamiastresid. (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()wNavControllerudostępniaFlow, który jest emitowany przy każdej zmianie bieżącegoNavBackStackEntry. Ten proces może być używany jako alternatywa dla ręcznego zarządzaniaOnDestinationChangedListener. (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 logicznychapp:popUpToSaveStateiapp:restoreState, aby zapisywać stan wszystkich miejsc docelowych usuniętych za pomocąapp:popUpToi przywracać stan powiązany z miejscem docelowym przekazanym jakoapp: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
navOptionsKotlin DSL możesz dodać właściwość logicznąrestoreStatei właściwość logicznąsaveStatewpopUpTobuilder:// 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
NavOptionsza pomocąNavOptions.Buildermożesz użyćsetRestoreState()i nowego przeciążenia dosetPopUpTo(), które przyjmuje dodatkowy parametrsaveState.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 parametrsaveState.
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ść
popUpTow Kotlin DSL została wycofana na rzeczpopUpToId. (I59c73, b/172823546) - Interfejs API
getStartDestination()został wycofany na rzecz interfejsugetStartDestinationId(). (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-ktxbędą nadal publikowane, ale będą całkowicie puste. (b/184292145) NavDeepLinkBuilderobsł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
NavBackStackEntryjest teraz widoczny w publicznym interfejsie API. (Ie033a) - Pola
nameiargumentoraz funkcje destrukturyzacjiNamedNavArgumentsą teraz publiczne. (#174, b/181320559) - Wprowadziliśmy nowe rozszerzenie
NavBackStackEntry#provideToCompositionLocals, które udostępniaNavBackStackEntryodpowiednim elementom CompositionLocal. (#175, b/187229439)
Safe Args
Safe Args generuje teraz metodę
fromSavedStateHandle()dla każdej klasyNavArgs. (#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.1i oznacza metodysetGraph(),popBackStack(),navigateUp()inavigate(), które aktualizująNavBackStackEntryLifecycle, jako@MainThread, dostosowując nawigację do wymuszania wątku głównego wprowadzonego w Lifecycle2.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/reddo precyzyjnego linkuwww.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-alpha01jest zgodny tylko z Compose w wersji1.0.0-beta07lub 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)
NavHostFragmentobsługuje teraz niestandardowe obiekty Navigator, które używają tego samego@Navigator.Name("dialog")co domyślnyDialogFragmentNavigator. (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 klasyNavArgs. (#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
nameiargumentoraz funkcji destrukturyzacjiNamedNavArgument. (#174, b/181320559) - Dziękujemy użytkownikowi jossiwolf za wprowadzenie nowego rozszerzenia
NavBackStackEntry#provideToCompositionLocals, które udostępniaNavBackStackEntryodpowiednim 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)
Navigation Compose w wersji 1.0.0
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
NavHostakceptuje terazModifier, który jest przekazywany do kontenera funkcji kompozycyjnej, który opakowuje funkcje kompozycyjne miejsca docelowego. (I85aca, b/175125483)
Poprawki błędów
NavHostdziała teraz nawet wtedy, gdy nie znalezionoOnBackPressedDispatcherOwner, jak w przypadku podgląduNavHost. (I7d8b4)- Komponent Navigation Compose zależy teraz od Navigation
2.3.5, co rozwiązuje problem z używaniemBackHandlerw miejscu docelowymNavHost. (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.currentzwraca teraz obiektViewModelStoreOwner, który może mieć wartość null, aby można było lepiej określić, czy obiektViewModelStoreOwnerjest dostępny w bieżącej kompozycji. Interfejsy API, które wymagająViewModelStoreOwner, takie jakviewModel()iNavHost, nadal zgłaszają wyjątek, jeśli nie ustawionoViewModelStoreOwner. (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
NavHostwypełnia terazLocalSavedStateRegistryOwnerCompositionLocal wartościąNavBackStackEntrytego miejsca docelowego, dzięki czemu każdy stan zapisany bezpośrednio wSavedStateRegistryzostanie 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
- Komponent Navigation Compose zależy teraz od Lifecycle ViewModel Compose 1.0.0-alpha01, aby zapewnić obsługę
viewModel()w miejscach docelowychcomposable. (I7a374) NavHostużywa teraz nowego interfejsuLocalOnBackPressedDispatcherOwnerz Activity-Compose 1.3.0-alpha01, aby uzyskaćOnBackPressedDispatcherustawiony wNavController. (I65b12)
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)wNavController, która zwraca powiązany obiektNavBackStackEntry. (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()inavigateUp()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,
ViewModeli 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()icurrentBackStackEntryAsState(), aby umożliwić podnoszenie stanu i łączenieNavControllerz komponentami kompozycyjnymi pozaNavHost(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ą
NavDeepLinkRequestlubUrimożesz teraz uzyskać dostęp doUri, 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
OnBackPressedCallbacksdodany do dyspozytora zNavBackStackEntryjako LifecycleOwner teraz prawidłowo przechwytuje przycisk Wstecz po tym, jak cykl życia aktywności jestSTOPPED, a następnieSTARTED(Iff94f, b/182284739)- Analiza domeny precyzyjnego linku nie uwzględnia już wielkości liter, dzięki czemu
www.example.compasuje zarówno dowww.example.com, jak i dowww.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
bentrengroveza żą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
ReferenceTypemogą 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 prefiksami0x. (#127, b/179166693) - Atrybut
android:defaultValueargumentu zapp:argType="float"obsługuje teraz domyślne wartości całkowite, co pozwala na używanieandroid:defaultValue="0"zamiast0.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
setViewModelStorelubsetLifecycleOwnerz 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
JvmNameza żądanie pull, dzięki któremu argumentyReferenceTypemogą być teraz prawidłowo analizowane, gdy są wysyłane jako część identyfikatora URI precyzyjnego linku. (#127, b/179166693) - Dziękujemy użytkownikowi
tatocasterza przesłanie żądania pull, dzięki któremudefaultValuedla argumentu zapp: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
NavBackStackEntryjest usuwany, zanim jegoLifecyclezostanie przeniesiony doCREATED. (Ie3ba3) - Naprawiono regresję spowodowaną przez b/171364502, gdzie przejście do aktywności z wartością zasobu animacji
0powodowało błądResourceNotFoundException. (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>zonNavDestinationSelectednie powodowało przejścia do aktywności. (I22e34, b/171364502) - Rozwiązaliśmy problem, który powodował, że
navigation-dynamic-features-fragmentwielokrotnie 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
OnDestinationChangedListenerpodczas korzystania zlaunchSingleTop. (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 obiektempopUpTo, 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 zFragmentScenarioiNavigation.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-uizależy teraz od DrawerLayout 1.1.1, dzięki czemuNavigationUImoże otwierać panel nawet podczas korzystania zLOCK_MODE_LOCKED_CLOSEDlubLOCK_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-runtimeinavigation-dynamic-features-fragmentumoż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-testingudostępnia interfejsTestNavHostController, 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
NavBackStackEntrypowiązany z każdym miejscem docelowym na stosie wstecznym nawigacji umożliwia teraz dostęp do obiektuSavedStateHandle, 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
OpenablewNavigationUI: wszystkie przypadki użyciaDrawerLayoutwNavigationUIzostały zastąpione bardziej ogólnym interfejsemOpenabledodanym w CustomView1.1.0i zaimplementowanym przezDrawerLayoutw DrawerLayout1.1.0. - Obsługa działań i typów MIME w precyzyjnych linkach: precyzyjne linki zostały rozszerzone o obsługę
app:actioniapp:mimeTypeoprócz wcześniej dostępnegoapp:uri.NavControllerobsługuje teraz nawigację według dowolnej kombinacji tych pól za pomocą nowej klasyNavDeepLinkRequest. 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 unknownzgłaszane przezNavControllerzawierają teraz dodatkowe informacje na potrzeby debugowania, które pomagają określić stanNavController. (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
LifecycleelementuNavBackStackEntrynie był prawidłowo aktualizowany. (b/155218371) - Instancje
OnDestinationChangedListenerzarejestrowane przed wywołaniemsetGraph()są teraz prawidłowo wysyłane do przywróconego miejsca docelowego po śmierci procesu. (b/155218371) - Podczas korzystania z
singleTopargumentyNavBackStackEntrysą teraz prawidłowo aktualizowane i wysyłane do wszystkich instancjiOnDestinationChangeListener. (b/156545508)
Aktualizacje zależności
- Artefakt
NavigationUIzależy teraz od CustomView1.1.0-rc01i DrawerLayout1.1.0-rc01. (aosp/1309696)
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:actioniapp:mimeTypeoprócz wcześniej dostępnychapp:uri. NavController obsługuje teraz nawigację za pomocą dowolnej kombinacji tych pól dzięki nowej klasieNavDeepLinkRequest. (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 sufiksumoduleNamedoapplicationIdpo kropce. Jeśli musisz dostosowaćgraphPackage, możesz teraz użyć obiektu zastępczego${applicationId}. (b/152696768) - Kotlin DSL wykresu nawigacyjnego udostępnia teraz
defaultArgumentsMapdla 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
IllegalStateExceptionwystępujący podczas precyzyjnego linkowania do miejsca docelowego rozpoczęcia wykresu, gdy w aktywności jest wiele instancjiNavHostFragment. (b/147378752)
Aktualizacje zależności
- Nawigacja zależy teraz od Fragmentu
1.2.4. (aosp/1277325) - Nawigacja dynamiczna zależy teraz od podstawowej biblioteki Play
1.7.2. (aosp/1282257)
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
DynamicExtrasnie używa już wzorca konstruktora i można ją teraz tworzyć bezpośrednio. (aosp/1253671) DynamicActivityNavigatorprzyjmuje teraz w konstruktorzeContext, a nieActivity. (aosp/1250252)
Poprawki błędów
NavigationUInie ignoruje już pustych etykiet (czyli miejsca docelowego zandroid: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,AppBarConfigurationużywa teraz interfejsuOpenablewprowadzonego w CustomView1.1.0-alpha02(któryDrawerLayoutimplementuje od wersji DrawerLayout1.1.0-alpha04), co pozwala na używanie niestandardowych implementacjiOpenablezNavigationUI. (b/129030452)
Poprawki błędów
- Reguły ProGuard
navigation-common-ktxteraz prawidłowo zachowują tylko używane klasyNavArgs, a nie wszystkie instancjeNavArgs. (b/150213558)
Zmiany zależności
- Nawigacja nie jest już zależna od Core
1.2.0, ale od Core1.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 Core1.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
NavBackStackEntryumożliwia teraz dostęp doSavedStateHandle, 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()igetPreviousBackStackEntry(), aby ułatwić pobieranieNavBackStackEntrydla bieżącego i poprzedniego miejsca docelowego. (b/79672220)
Poprawki błędów
navigateUp()przekazuje teraz argumenty bieżącego miejsca docelowego iKEY_DEEP_LINK_INTENTdo poprzedniego miejsca docelowego podczas uruchamiania aplikacji na własnym stosie zadań. (b/147456890)
Zmiany zależności
- Nawigacja zależy teraz od Core
1.2.0.
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-testingudostępnia klasęTestNavHostController. Ta klasa stanowi alternatywę dla używania makietyNavControllerpodczas 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ść przechodnianavigation-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 ProGuardnavigation-uidlaDrawerArrowDrawablezostały zaktualizowane, aby usługaandroid.enableJetifier=truenie była wymagana. (b/147610424) - Nawigacja
2.2.1: modułnavigation-common-ktxma teraz unikalną nazwę pakietu manifestu, a nie taką samą jaknavigation-runtime-ktx. (aosp/1141947)
Aktualizacje zależności
- Z Navigation
2.2.1: Navigation2.2.1zależy teraz od Lifecycle ViewModel SavedState2.2.0i Fragment1.2.1.
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 instancjiNavHostFragment. (b/147378752) NavigationUInie ignoruje już pustych etykiet (czyli miejsca docelowego zandroid: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-ktxteraz prawidłowo zachowują tylko używane klasyNavArgs, a nie wszystkie instancjeNavArgs. Ta funkcja została wcześniej udostępniona w Nawigacji w wersji 2.3.0-alpha03. (b/150213558
Aktualizacje zależności
- Nawigacja zależy teraz od Fragmentu
1.2.4. (aosp/1277325)
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-uidlaDrawerArrowDrawablezostały zaktualizowane, aby upewnić się, żeandroid.enableJetifier=truenie jest wymagany. (b/147610424) - Moduł
navigation-common-ktxma teraz unikalną nazwę pakietu manifestu, a nie taką samą jaknavigation-runtime-ktx. (aosp/1141947)
Aktualizacje zależności
- Komponent Navigation w wersji
2.2.1zależy teraz od Lifecycle ViewModel SavedState w wersji2.2.0i Fragment w wersji1.2.1.
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 obiektNavBackStackEntryudostępnia sterowane przez nawigację obiektyLifecycleOwner,ViewModelStoreOwner(takie same jak zwracane przezNavController.getViewModelStoreOwner()) iSavedStateRegistryOwner, a także argumenty używane do uruchamiania tego miejsca docelowego. - Integracja SavedState z ViewModel cyklu życia:
SavedStateViewModelFactoryjest teraz domyślną fabryką używaną podczas korzystania zby navGraphViewModels()lub konstruktoraViewModelProviderzViewModelStoreOwnerzwracanym przezNavController.getBackStackEntry()lubNavController.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:
NavHostFragmentużywa terazFragmentContainerViewz 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 Fragment1.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"zamiastnull. (b/141613546) NavHostFragmentteraz prawidłowo przywraca wykres po zmianie konfiguracji, gdy jest używany zFragmentContainerView. (b/143752103)
Zmiany zależności
- Nawigacja zależy teraz od komponentów Lifecycle
2.2.0-rc03, Lifecycle ViewModel SavedState1.0.0-rc03, Activity1.1.0-rc03i Fragment1.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
NavDestinationi 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 wActivitywyświetla teraz lepszy komunikat o błędzie, gdy nie ma dodatków. (b/141408999) - Klasy Java
Directionswygenerowane przez Safe Args zawierają teraz wartości domyślne. (b/141099045) - Klasy Java
Argswygenerowane przez Safe Args zawierają teraz wartości domyślne. (b/140123727) - Gdy używasz
Toolbar,NavigationUInie 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 metodysetGraphpowoduje teraz zwrócenie błęduIllegalStateException. Wartość ta powinna być zawsze ustawiana przezNavHostw ramach konfiguracji początkowej, aby wszystkie instancjeNavBackStackEntrymiały spójne miejsce na dane dla instancjiViewModel. (aosp/1111821)
Poprawki błędów
- Naprawiliśmy błąd
ConcurrentModificationExceptionwystępujący podczas używania instancjiViewModeldołączonych do wielu różnych instancjiViewModelStoreo 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 obiektNavBackStackEntryudostępnia sterowane przez nawigację obiektyLifecycleOwner,ViewModelStoreOwner(takie same jak zwracane przezNavController.getViewModelStoreOwner()) iSavedStateRegistryOwner, 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
NavHostFragmentdoViewPager2kończyło się błędemIllegalArgumentException. (b/133640271) NavInflaterunika teraz niepotrzebnego wywoływaniagetResourceName(), 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
SavedStateViewModelFactoryjest teraz domyślną fabryką używaną podczas korzystania zby navGraphViewModels()lub konstruktoraViewModelProviderzViewModelStoreOwnerzwracanym przezNavController.getViewModelStoreOwner(). (b/135716331)
Zmiany w interfejsie API
- Nawigacja
2.1.0-rc01: wycofany interfejs APIgetViewModelStore()wNavControllerwprowadzony w2.1.0-alpha02został usunięty. (aosp/1091021)
Poprawki błędów
NavHostFragmentużywa terazFragmentContainerView, 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-ktxlub za pomocą interfejsu APIgetViewModelStoreOwner()dodanego doNavController. 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, gdynavigatedo nich.NavHostFragmentdomyś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
navigateza 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
NavHostzostały przeniesione doNavHostController, co umożliwia implementacjom łączenie elementuNavControllerz hostującymi elementamiLifecycleOwner,OnBackPressedDispatcheriViewModelStore.
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 wersjiNavControllerwprowadzony w wersji2.1.0-alpha02został 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
NavigationUIanimuje teraz usuwanie przycisku W górę, gdy używaszsetupWithNavController()zToolbarlubCollapsingToolbarLayout. (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:navGraphużywany przez NavHostFragment został przeniesiony do artefaktunavigation-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()wNavControllerzostał wycofany na rzecz nowej metodygetViewModelStoreOwner(), która zwracaViewModelStoreOwner. (aosp/987010) - Implementacja miejsc docelowych w pływającym oknie, takich jak miejsca docelowe
<dialog>, została uogólniona w interfejsie znacznikaFloatingWindow, który jest teraz implementowany przez wszystkie miejsca docelowe<dialog>. Metody NavigationUI do interakcji z górnym paskiem aplikacji ignorują teraz miejsca doceloweFloatingWindow. (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
NavControllerzostały przemianowane i przeniesione do nowej podklasyNavController,NavHostController. (aosp/966091) - Metoda
setHostOnBackPressedDispatcherOwner()klasyNavControllerzostała zastąpiona metodąsetOnBackPressedDispatcher()klasyNavHostControlleri wymaga teraz wywołania metodysetLifecycleOwner()przed jej wywołaniem. (aosp/965409) NavHostControllerzawiera teraz metodęenableOnBackPressed(boolean), która zastępuje klasęNavHostOnBackPressedManagerzwracaną wcześniej przezsetHostOnBackPressedDispatcherOwner(). (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
NavHostFragmentprawidłowo uwzględniaapp:defaultNavHostpodczas przechwytywania zdarzeń systemowego przycisku Wstecz, co naprawia regresję w Nawigacji2.1.0-alpha03. b/132077777DialogFragmentNavigatorteraz prawidłowo obsługuje operacjepopBackStack()inavigateUp(). 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ędziesznavigate.NavHostFragmentdomyślnie obsługuje miejsca docelowe okna. b/80267254 - Oprócz wywoływania
navigatez identyfikatorem zasobu lub instancjąNavDirectionsmoż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()klasyNavHostFragmentzostała wycofana, a jej funkcje zostały przeniesione do nowej metodyonCreateNavController(), aby wyraźniej wskazać, że jest to właściwy punkt wejścia do dodawania niestandardowych nawigatorów podczas tworzenia podklasyNavHostFragment. b/122802849 - Do
NavDestinationdodano metodęhasDeepLink(), która pozwala sprawdzić, czy danyUrimoże być obsługiwany przez to miejsce docelowe lub, w przypadkuNavGraph, 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 NavHostFragmentprzechwytuje 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 atrybutemapp:argTypejest teraz prawidłowo wnioskowany jako argumentstring. 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 APIgetViewModelStore()dodanego doNavController. b/111614463
Zmiany w interfejsie API
- Możesz teraz dodać
app:targetPackagedo miejsca docelowego<activity>, aby ograniczyć pasującą nazwę pakietu. Obsługujeapp:targetPackage="${applicationId}", aby ograniczyć pakiet do Twojego identyfikatora aplikacji. b/110975456
Poprawki błędów
android:namedla 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.1iandroidx.fragment:fragment:1.1.0-alpha05. Ta wersja usuwa też zależność odandroidx.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.instantiateFragmentjest teraz wycofany. Domyślna implementacja używa terazFragmentFactorydo 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 zandroid: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 bezFLAG_ACTIVITY_NEW_TASKb/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
inifun, 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
singleTopb/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ć
0jakoandroid:defaultValuew argumentachreference. 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()inavigateUpteraz prawidłowo zwracająfalsepodczas usuwania ostatniego miejsca docelowego ze stosu wstecznego, co naprawia regresję wprowadzoną w1.0.0-beta01. b/123933201- Nawigacja prawidłowo ustawia teraz
ClassLoaderpodczas przywracania zapisanego stanu instancji, co pozwala uniknąć problemów podczas używania klas niestandardowych w zapisanym stanieNavigatorlub w argumentach wysyłanych doNavDestination. 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 innymapp:argTypespowoduje 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
FragmentNavigatorze stanemNavController, co skutkowało błędemIllegalStateExceptionpodczas próby przywrócenia stosu wstecznego. b/123803044 - Rozwiązaliśmy problem, który powodował, że strzałka wstecz obsługiwana przez
NavigationUInie 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:argTypewskazują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 klasyNavArgswygenerowanej przez Safe Args w obiekcieActivitylubFragment. 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 wtyczceandroidx.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()naNavControllerspowoduje 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 elementamiNavHostFragment. b/121340440
Zmiany powodujące niezgodność
- Metoda
NavOptions.applyPopAnimationsToPendingTransition()stosowania animacji wyskakujących okienek do aktywności została przeniesiona doActivityNavigator. 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
NavDirectionswygenerowane 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
Bundlez zamówieniagetArguments()od sprzedawcyNavDirectionsjest teraz oznaczony jako@NonNull, a nie@Nullable. b/123243957
Poprawki błędów
NavDeepLinkBuilderteraz prawidłowo obsługuje wiele jednoczesnych wywołańPendingIntentdo tego samego miejsca docelowego, używając przekazywanych argumentów do określenia unikalności. b/120042732NavControllerteraz prawidłowo obsługuje operacjepopBackStack(), gdy używany jest zagnieżdżonyNavHostFragmentlub inne fragmenty podrzędne ze stosem wstecznym. b/122770335NavigationUIteraz 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
NavDirectionswygenerowane przez Safe Args mają teraz prawidłowo równe wartościhashCode(), gdyequals()zwraca wartość „true”. b/123043662 FragmentNavigatorwyświetla teraz lepszy komunikat o błędzie, gdy próbujesz wykonać niestandardowe działanieFragmentTransactionsnaFragmentManagerNavHostFragment. Zawsze używajgetChildFragmentManager(). 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
MenuItemzmenuCategory="secondary"nie będą już usuwać stosu wstecznego, gdy będą używane z metodamiNavigationUI. b/120104424AppBarConfigurationumożliwia teraz ustawienie instancji zastępczejOnNavigateUpListener, która zostanie wywołana, gdynavController.navigateUp()zwrócifalse. b/79993862 b/120690961
Zmiany powodujące niezgodność
- Gdy używasz
<argument>zargType="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 metodamisetup. DodajmenuCategory="secondary"doMenuItem, aby uniknąć wyskakiwania stosu wstecznego. aosp/852869- Metody
fromBundle()wygenerowanych klasArgsprzyjmują teraz niepustą wartośćBundlezamiast wartościBundle, 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
NavigationUIbędą teraz automatycznie zastępować wystąpienia{argName}wandroid:labelprawidłowym argumentem b/80267266 - Nawigacja zależy teraz od biblioteki pomocy 28.0.0 b/120293333
Zmiany powodujące niezgodność
- Nazwa
OnNavigatedListenerzostała zmieniona naOnDestinationChangedListenerb/118670572 OnDestinationChangedListenerprzekazuje teraz równieżBundleargumentów aosp/837142- Atrybuty
app:clearTaskiapp:launchDocumentoraz powiązane z nimi metody zostały usunięte. Użyjapp:popUpToz elementem głównym wykresu, aby usunąć wszystkie miejsca docelowe ze stosu wstecznego. b/119628354 ActivityNavigator.Extrasużywa teraz wzorcaBuilderi dodaje możliwość ustawiania dowolnych flagIntent.FLAG_ACTIVITY_aosp/828140- Nazwa
NavController.onHandleDeepLinkzostała zmieniona nahandleDeepLinkaosp/836063 - Wiele klas i metod, które nie są przeznaczone do tworzenia podklas, takich jak
NavOptions,NavInflater,NavDeepLinkBuilderiAppBarConfiguration, zostało oznaczonych jakofinalaosp/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 doFragmentFactory. b/119054429 - Konstruktor
NavGraphNavigatornie przyjmuje już parametruContextaosp/835340 - NavigatorProvider jest teraz klasą, a nie interfejsem. Funkcja
NavigatorProviderzwracana przezgetNavigatorProvider()nie zmieniła swojego działania. aosp/830660 - Usunięto
NavDestination.navigate(). Zamiast tego wywołajnavigate()naNavigator. aosp/830663 - Znaczna refaktoryzacja
Navigator, która eliminuje potrzebę stosowaniaOnNavigatorNavigatedListeneri sprawia, żenavigatezwracaNavDestination, do którego nastąpiło przejście. - Instancje
Navigatornie mogą już wysyłać zdarzeń POP doNavController. Rozważ użycieOnBackPressedCallback, aby przechwytywać naciśnięcia przycisku Wstecz i wywoływaćnavController.popBackStack(). aosp/833716
Poprawki błędów
popUpTodział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
IllegalArgumentExceptionpodczas korzystania z wykresów zagnieżdżonych: b/118713731, b/113611083, b/113346925, b/113305559. - Atrybut
dataPatternmiejsc docelowych<activity>będzie teraz wypełniać argumenty z argumentów innych niż ciąg znaków przez wywołanietoString()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
@Overridetam, 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-ktxzostał połączony z modułemnavigation-testing artifacti nie będzie już publikowany. - Artefakt
navigation-testingjest 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
- Przejścia elementów wspólnych dla miejsc docelowych fragmentów i aktywności są teraz obsługiwane: b/79665225. Więcej informacji znajdziesz w artykule Implementowanie nawigacji za pomocą komponentu architektury nawigacji.
- Wybranie elementu w aplikacji
NavigationViewspowoduje teraz zamknięcie wszystkich zawierających go plansz dolnych b/112158843
Zmiany w interfejsie API
- Zmiana powodująca niezgodność: metoda
navigate()klasy Navigator przyjmuje teraz parametrNavigator.Extras. - Metoda
getGraph()klasy NavController jest terazNonNullb/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:typezmieniono naapp: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
NonNullnie mają wartości null b/111451769 - Do klas wygenerowanych przez NavDirections i Args dodano dodatkowe adnotacje
NonNullb/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.indexzmieni się nasetDemoControllerIndexb/79995048 - Na przykład
action_show_settingszmieni się wactionShowSettingsb/79642240
- Na przykład:
- 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()ihashCode()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
setPopUpToz pierwszym miejscem docelowym na wykresie b/109909461. - Rozwiązaliśmy problem, który powodował, że wszystkie wartości
app:defaultValuebył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:namew 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
FragmentNavigatorkorzysta teraz zsetReorderingAllowed(true). b/109826220Nawigacja dekoduje teraz argumenty URLDecodes przeanalizowane z adresów URL precyzyjnych linków. b/79982454
Poprawki błędów
Naprawiono błąd
IllegalStateExceptionwystępujący podczas wywoływania nawigacji z metod cyklu życia fragmentu. b/79632233Nawigacja 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
IllegalArgumentExceptionwystępujący podczas używania defaultNavHost="true" jako fragmentu podrzędnego. b/79656847Naprawiliśmy błąd
StackOverflowErrorwystępujący podczas korzystania z NavDeepLinkBuilder. b/109653065Naprawiliśmy błąd
IllegalArgumentExceptionwystępujący podczas powrotu do zagnieżdżonego wykresu. b/80453447Rozwiązaliśmy problem z nakładającymi się fragmentami podczas korzystania z
launchSingleTop. b/79407969Nawigacja 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
clearTaskdla działań i powiązany interfejs API wNavOptionszostały wycofane. b/80338878Atrybut
launchDocumentdziałań i powiązany interfejs API wNavOptionszostał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.