navigation3
Najnowsza aktualizacja | Wersja stabilna | Wersja kandydująca do publikacji | Wersja Beta | Wersja alfa |
---|---|---|---|---|
27 sierpnia 2025 roku | - | - | - | 1.0.0-alpha08 |
Deklarowanie zależności
Aby dodać zależność od navigation3, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven Google.
Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle
aplikacji lub modułu:
Groovy
dependencies { implementation "androidx.navigation3:navigation3-runtime:1.0.0-alpha08" implementation "androidx.navigation3:navigation3-ui:1.0.0-alpha08" }
Kotlin
dependencies { implementation("androidx.navigation3:navigation3-runtime:1.0.0-alpha08") implementation("androidx.navigation3:navigation3-ui:1.0.0-alpha08") }
Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.
Opinia
Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, 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.
Brak informacji o wersji tego artefaktu.
Wersja 1.0
Wersja 1.0.0-alpha08
27 sierpnia 2025 roku
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha08
Wersja 1.0.0-alpha08 zawiera te zmiany.
Nowe funkcje
- Dodano nowe platformy Kotlin MultiPlatform (KMP) do artefaktów
Navigation3 Runtime
.Navigation3 Runtime
obsługuje teraz te platformy: JVM (Android i komputery), Native (Linux, iOS, watchOS, macOS, MinGW) i Web (JavaScript, WasmJS). (I55078, b/424410398, b/419294028, b/419046226). Uwaga: nie podaje to docelowych wartości KMP dla artefaktuNavigation3 UI
. Na innych platformach musisz wdrożyć własny niestandardowy kodNavDisplay
. Jeśli chcesz, aby ta funkcja była obsługiwana, zagłosuj na problem w Jetbrains tutaj i śledź postępy w zakresie dodatkowej pomocy. - Obiekt
NavDisplayInfo
jest teraz publiczny i można go używać do pobierania listy widocznych wpisów zNavDisplayInfo
.NavDisplay
(Ibc91f)
Zmiany w interfejsie API
- Dodaliśmy nowy element
NavBackStackSerializer
, który będzie używany w połączeniu z elementemrememberNavBackStack
do przywracania stanu.rememberNavBackStack()
przyjmuje teraz teżSavedStateConfiguration
, którego można użyć do podania własnej konfiguracji. (I2f4d2, I4cd58, b/420443609)
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że podczas nawigacji wywoływane były nieprawidłowe zdarzenia cyklu życia. (I8bf6d, b/425901162, b/434109022)
Znane problemy
- W wersji I8bf6d pojawił się błąd, który powodował, że cykle życia były oparte na scenach, a nie na poszczególnych wpisach. Spowodowało to nieprawidłowe działanie cykli życia w przypadku scen z wieloma ekranami. Błąd ten został naprawiony w kolejnej wersji. (b/440145700)
Wersja 1.0.0-alpha07
13 sierpnia 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha07
Wersja 1.0.0-alpha07 zawiera te zmiany.
MinSdk Update
- Domyślny minSdk dla AndroidX został przeniesiony z API 21 na API 23 (Ibdfca, b/380448311, b/435705964, b/435705223).
Zmiany w interfejsie API
SavedStateNavEntryDecorator
używa terazSaveableStateRegistry
wbudowanego wSaveableStateProvider
do zapisywania i przywracania stanów. (If8d9a)predictivePopTransitionSpec
jest teraz przekazywany jako parametr, co pozwala dostosować przejście w zależności od tego, od której krawędzi użytkownik rozpoczął gest powrotu predykcyjnego. (I753a8)
Poprawki błędów
- Rozwiązaliśmy problem, który powodował, że sceny niestandardowe były nieskończenie przeliczane, ponieważ nie była zapamiętywana najnowsza scena. (I7ba84, b/418153031)
Aktualizacja zależności
- Nawigacja 3 zależy teraz od zdarzenia nawigacji.
1.0.0-alpha06
Wersja 1.0.0-alpha06
30 lipca 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha06
Wersja 1.0.0-alpha06 zawiera te zmiany.
Aktualizacja zależności
- Nawigacja 3 zależy teraz od zdarzenia nawigacji.
1.0.0-alpha05
Wersja 1.0.0-alpha05
2 lipca 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha05
Wersja 1.0.0-alpha05 zawiera te zmiany.
Zmiany w zachowaniu
- Stan
NavEntry
jest teraz ściśle oparty na bieżącej liście dekoratorów przekazywanych doNavDisplay
. Oznacza to, że w przypadku wielu stosów wstecznych dekoratory powinny być zamieniane w stosach wstecznych, aby zachować stan obiektów NavEntry w stosie wstecznym. W przeciwnym razie stany zostaną wyczyszczone tak, jakby wpisy zostały usunięte (zamiast zamienione). (I7a759, b/428033667)
Wersja 1.0.0-alpha04
18 czerwca 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha04
Wersja 1.0.0-alpha04 zawiera te zmiany.
Zmiany w interfejsie API
NavEntry.content
jest teraz prywatny. Aby wywołać treściNavEntry
, wywołaj nowy interfejs APINavEntry.Content()
, który nie wymaga już parametrukey
. (Icd0fd, b/420991203)- Pole
NavEntry.key
jest teraz prywatne.NavEntry
i jego odpowiednie stany powinny być identyfikowane przez nowe polecontentKey
, które jest generowane przez nową lambdęcontentKeyFactory
i domyślnie przyjmuje wartość skrótu, który można zapisać i który jest generowany na podstawieNavEntry.key
(I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812).
Zmiany zależności
- Biblioteka Navigation3 zależy teraz od nowego artefaktu
androidx.navigationevent.compose
.
Wersja 1.0.0-alpha03
4 czerwca 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha03
Wersja 1.0.0-alpha03 zawiera te zmiany.
Poprawki błędów
Navigation3
nie będzie już czyścić stanów dekoratora dla elementówbackStacks
, które zostały zamienione i zastąpione inną instancjąbackStack
. (I28a42, b/415076044)
Wersja 1.0.0-alpha02
23 maja 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha02
Wersja 1.0.0-alpha02 zawiera te zmiany.
Poprawki błędów
- Naprawiliśmy problem z funkcją
SavedStateNavEntryDecorator
, który powodował kolizje różnych klas danych o tych samych wartościach właściwości. (b/418070648, Iff4775) - Rozwiązaliśmy problem z brakującą klasą, który powodował awarie podczas uruchamiania bez deklarowania jawnych zależności. (b/419049149, I4b4ed)
Wersja 1.0.0-alpha01
20 maja 2025 r.
Publikacja androidx.navigation3:navigation3-*:1.0.0-alpha01
Wersja 1.0.0-alpha01 zawiera te zmiany.
Nowe funkcje
Navigation3 to nowa biblioteka nawigacji stworzona specjalnie do obsługi nawigacji w aplikacji Jetpack Compose. Artefakt androidx.navigation3.runtime
zapewnia elementy składowe, a artefakt androidx.navigation3.ui
udostępnia warstwę interfejsu użytkownika za pomocą interfejsu NavDisplay
API. Deweloperzy mogą przekazywać własny stan bezpośrednio do funkcji kompozycyjnej NavDisplay
, która zmienia treść na podstawie zmian stanu dewelopera.
@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey
val backStack = rememberNavBackStack(Home)
NavDisplay(backStack, entryProvider = entryProvider {
entry<Home> {
Column {
Text(“Home”)
Button(onClick = { backStack.add(Chat) } ) {
Text(“Go to Chat”)
}
}
}
entry<Chat> { /* My Composable Content */ }
})
Więcej informacji znajdziesz w przewodniku po Navigation3.