Stabilna wersja Jetpack Navigation 3 1.0 🎉. Możesz już jej używać w aplikacjach produkcyjnych. JetBrains używa jej już w aplikacji KotlinConf.

Navigation 3 to nowa biblioteka nawigacji, która została stworzona od podstaw, aby wykorzystywać stan Jetpack Compose state. Daje Ci pełną kontrolę nad stosem wstecznym, pomaga zachować stan nawigacji i umożliwia łatwe tworzenie układów adaptacyjnych (np. typu szczegółowa lista). JetBrains udostępnia nawet wersję na wielu platformach.

Dlaczego potrzebna jest nowa biblioteka?

Pierwotna biblioteka Jetpack Navigation (obecnie Nav2) została zaprojektowana 7 lat temu. Chociaż dobrze spełnia swoje pierwotne cele i była stopniowo ulepszana, sposób tworzenia aplikacji uległ zasadniczej zmianie.

Programowanie reaktywne z deklaratywnym interfejsem użytkownika jest obecnie standardem. Nav3 wykorzystuje to podejście. Na przykład NavDisplay (komponent interfejsu Nav3, który wyświetla ekrany) po prostu obserwuje listę kluczy (każdy z nich reprezentuje ekran) obsługiwaną przez stan Compose i aktualizuje swój interfejs, gdy ta lista się zmienia.

Nav2 może też utrudniać korzystanie z jednego źródła informacji o stanie nawigacji, ponieważ ma własny stan wewnętrzny. W przypadku Nav3 podajesz własny stan, co daje Ci pełną kontrolę.

Na koniec – prosiliście o większą elastyczność i możliwość dostosowania. Zamiast jednego monolitycznego interfejsu API Nav3 udostępnia mniejsze, niezależne interfejsy API (lub „bloki konstrukcyjne”), które można łączyć, aby tworzyć złożone funkcje. Sama Nav3 używa tych bloków konstrukcyjnych, aby zapewnić rozsądne ustawienia domyślne w dobrze zdefiniowanych przypadkach użycia nawigacji. 

Dzięki temu podejściu możesz: 

• dostosowywać animacje ekranu na poziomie globalnym i indywidualnym;
• wyświetlać jednocześnie kilka paneli i tworzyć elastyczne układy za pomocą interfejsu Scenes API
• łatwo zastępować komponenty Nav3 własnymi implementacjami, jeśli chcesz uzyskać niestandardowe działanie.

Więcej informacji o projekcie i funkcjach znajdziesz na blogu z okazji premiery. 

Migracja z Navigation 2

Jeśli używasz już Nav2, a konkretnie Navigation Compose, rozważ migrację do Nav3. Aby Ci w tym pomóc, przygotowaliśmy przewodnik po migracji. Główne kroki: 

1. Dodaj zależności Navigation 3.
2. Zaktualizuj trasy nawigacji, aby zaimplementować NavKey. Aby używać Nav3, trasy nie muszą implementować tego interfejsu, ale jeśli to zrobią, możesz skorzystać z funkcji rememberNavBackStack Nav3, aby utworzyć trwały stos wsteczny.
3. Utwórz klasy do przechowywania i modyfikowania stanu nawigacji – to tutaj będą przechowywane stosy wsteczne.
4. Zastąp NavController tymi klasami.
5. Przenieś miejsca docelowe z NavGraph NavHost do entryProvider.
6. Zastąp NavHost komponentem NavDisplay.

Eksperymentowanie z migracją agenta AI

Możesz poeksperymentować z użyciem agenta AI, aby przeczytać przewodnik po migracji i wykonać kroki w projekcie. Aby wypróbować to w trybie agenta Gemini w Android Studio:

• Zapisz tę wersję przewodnika w formacie Markdown w projekcie.
• Wklej do agenta ten prompt (ale nie naciskaj Enter): „Migrate this project to Navigation 3 using”.
• Wpisz @migration-guide.md – spowoduje to przekazanie agentowi przewodnika jako kontekstu. 

Jak zawsze, dokładnie sprawdź zmiany wprowadzone przez agenta AI – może on popełniać błędy.

Chętnie poznamy Twoją opinię na temat tego, jak Ty lub Twój agent sobie poradziliście. Prosimy przesłać ją tutaj.

Przepisy na nawigację w typowych scenariuszach

W przypadku typowych, ale złożonych przypadków użycia mamy repozytorium przepisów. Pokazuje ono, jak łączyć interfejsy API Nav3 w określony sposób, co pozwala wybrać lub zmodyfikować przepis zgodnie z konkretnymi potrzebami. Jeśli przepis okaże się popularny, rozważymy „przeniesienie” jego prostych części do podstawowej biblioteki Nav3 lub bibliotek dodatkowych. 

Obecnie mamy 19 przepisów, w tym na: 

• wiele stosów wstecznych;
• modularyzację i wstrzykiwanie zależności;
• przekazywanie argumentów nawigacji do ViewModeli (w tym za pomocą Koin)
• zwracanie wyników z ekranów za pomocą zdarzeń i stanu udostępnionego.

Pracujemy obecnie nad przepisem na linki bezpośrednie oraz integracją z Koin i planujemy wiele innych. Inżynier z JetBrains opublikował też wersję przepisów dla Compose Multiplatform.

Jeśli masz typowy przypadek użycia, dla którego chcesz zobaczyć przepis, proszę prześlij prośbę o przepis. 

Podsumowanie

Aby zacząć korzystać z Nav3, zapoznaj się z dokumentacją i przepisami. Ponadto przez cały tydzień będziemy publikować treści techniczne, w tym: 

• szczegółowy film o interfejsie API, obejmujący modularyzację, animacje i układy adaptacyjne;
• sesję pytań i odpowiedzi na żywo z inżynierami, którzy stworzyli Nav3.

Tydzień z Nav3 rozpocznie się 1 grudnia 2025 r. 

Jak zawsze, jeśli znajdziesz jakieś problemy, proszę zgłoś je tutaj.