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

Navigation 3 to nowa biblioteka nawigacji stworzona od podstaw z myślą o stanie Jetpack Compose. Daje Ci pełną kontrolę nad stosem wstecznym, pomaga zachować stan nawigacji i umożliwia łatwe tworzenie układów adaptacyjnych (np. listy ze szczegółami). Dostępna jest nawet wersja wieloplatformowa od JetBrains.

Dlaczego 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. Biblioteka 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ć uzyskanie jednego źródła informacji o stanie nawigacji, ponieważ ma własny stan wewnętrzny. W przypadku Nav3 dostarczasz własny stan, co daje Ci pełną kontrolę.

Na koniec wspomnę, że zależało Ci na większej elastyczności i możliwości dostosowywania. Zamiast jednego, monolitycznego interfejsu API Nav3 udostępnia mniejsze, odseparowane interfejsy API (lub „bloki konstrukcyjne”), które można łączyć ze sobą, aby tworzyć złożone funkcje. Sama biblioteka Nav3 używa tych elementów do zapewniania rozsądnych ustawień domyślnych w przypadku dobrze zdefiniowanych zastosowań nawigacji. 

Dzięki temu możesz: 

• Dostosowywanie animacji ekranu na poziomie globalnym i indywidualnym
• wyświetlać jednocześnie wiele paneli i tworzyć elastyczne układy za pomocą interfejsu Scenes API;
• W razie potrzeby możesz łatwo zastąpić komponenty Nav3 własnymi implementacjami, aby uzyskać niestandardowe działanie.

Więcej informacji o jego konstrukcji i funkcjach znajdziesz na blogu. 

Migracja z Navigation 2

Jeśli używasz już Nav2, a w szczególności Navigation Compose, rozważ przejście na Nav3. Aby Ci w tym pomóc, przygotowaliśmy przewodnik po migracji. Główne etapy: 

1. Dodaj zależności nawigacji 3.
2. Zaktualizuj trasy nawigacji, aby wdrożyć NavKey. Aby korzystać z Nav3, nie musisz implementować tego interfejsu w swoich trasach, ale jeśli to zrobisz, możesz skorzystać z funkcji rememberNavBackStack w Nav3, aby utworzyć trwałą listę wstecz.
3. Utwórz klasy, w których będziesz przechowywać i modyfikować stan nawigacji – to w nich będą przechowywane stosy wsteczne.
4. Zastąp NavController tymi klasami.
5. Przenieś miejsca docelowe z NavGraph w NavHost do entryProvider.
6. Zastąp NavHost elementem NavDisplay.

Eksperymentowanie z migracją agentów AI

Możesz wypróbować agenta AI, który przeczyta przewodnik migracji i wykona czynności w Twoim projekcie. Aby wypróbować tę funkcję w trybie agenta Gemini w Android Studio:

• Zapisz tę wersję przewodnika w formacie Markdown w projekcie.
• Wklej ten prompt do agenta (ale nie naciskaj Entera): „Migrate this project to Navigation 3 using ".
• Wpisz @migration-guide.md – przewodnik zostanie przekazany agentowi jako kontekst. 

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

Chętnie poznamy Twoją opinię o pracy naszej lub Twojego agenta. Prześlij ją tutaj.

Przepisy na nawigację w typowych scenariuszach

W przypadku typowych, ale złożonych zastosowań mamy repozytorium przepisów. Pokazuje, jak połączyć interfejsy Nav3 API 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 nieodnoszących się do konkretnych przypadków części do podstawowej biblioteki Nav3 lub bibliotek dodatkowych. 

Obecnie dostępnych jest 19 przepisów, w tym na: 

• Wiele stosów wstecznych
• Modularyzacja i wstrzykiwanie zależności
• Przekazywanie argumentów nawigacji do obiektów ViewModel (w tym za pomocą Koin)
• Zwracanie wyników z ekranów według zdarzeń i stanu udostępnionego

Obecnie pracujemy nad przepisem dotyczącym linków bezpośrednich oraz integracją z Koin. Planujemy też wiele innych rozwiązań. Inżynier z JetBrains opublikował też wersję przepisów w Compose Multiplatform.

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

Podsumowanie

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

• Film z dogłębną analizą interfejsu API, obejmujący modułowość, animacje i układy adaptacyjne.
• Sesja pytań i odpowiedzi na żywo z inżynierami, którzy stworzyli Nav3.

Tydzień wyróżnień Nav3 rozpocznie się 1 grudnia 2025 r. 

Jeśli napotkasz jakieś problemy, zgłoś je tutaj.