Jetpack Navigation 3 w wersji 1.0 jest stabilna 🎉. Możesz już dziś używać jej w swoich aplikacjach produkcyjnych. JetBrains używa jej już w swojej aplikacji KotlinConf.

Navigation 3 to nowa biblioteka nawigacji, która została zbudowana od podstaw, aby wykorzystywać stan Jetpack Compose stan. Daje Ci pełną kontrolę nad stosem wstecznym, pomaga zachować stan nawigacji i umożliwia łatwe tworzenie układów adaptacyjnych (np. 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 normą. 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 Nav3 możesz podać własny stan, co daje Ci pełną kontrolę.

Na koniec – prosiliście o większą elastyczność i możliwość dostosowywania. 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 wiele 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 elementem NavDisplay.

Eksperymentowanie z migracją agenta AI

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

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

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

Chętnie poznamy Twoją opinię o tym, jak Ty lub Twój agent poradziliście sobie z tym zadaniem. Prześlij 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 precyzyjne linki oraz integracją z Koin i planujemy wiele innych. Inżynier z JetBrains opublikował też wersję przepisów na Compose Multiplatform.

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

Podsumowanie

Aby rozpocząć korzystanie 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.