Nawigacja odnosi się do interakcji, które umożliwiają użytkownikom poruszanie się po różnych elementach treści w aplikacji, przechodzenie do nich i wychodzenie z nich.
Komponent nawigacji Android Jetpack obejmuje bibliotekę nawigacji, wtyczkę Safe Args do obsługi Gradle i narzędzia ułatwiające implementację nawigacji w aplikacji. Komponent nawigacji obsługuje różne przypadki użycia nawigacji, od prostych kliknięć przycisków po bardziej złożone wzorce, takie jak paski aplikacji i panel nawigacji.
Kluczowe pojęcia
W tabeli poniżej znajdziesz przegląd najważniejszych pojęć związanych z nawigacją oraz główne typy, których używasz do ich implementacji.
Pomysł |
Cel |
Typ |
|---|---|---|
Host |
Element interfejsu zawierający bieżące miejsce docelowe nawigacji. Oznacza to, że gdy użytkownik porusza się po aplikacji, aplikacja zasadniczo zamienia miejsca docelowe w hoście nawigacji. |
|
Wykres |
Struktura danych, która definiuje wszystkie miejsca docelowe nawigacji w aplikacji i sposób ich łączenia. |
|
Kontroler |
Centralny koordynator do zarządzania nawigacją między miejscami docelowymi. Kontroler udostępnia metody nawigacji między miejscami docelowymi, obsługi precyzyjnych linków, zarządzania stosem wstecznym i nie tylko. |
|
Miejsce docelowe |
Węzeł w grafie nawigacyjnym. Gdy użytkownik przechodzi do tego węzła, host wyświetla jego zawartość. |
Zwykle tworzony podczas tworzenia wykresu nawigacyjnego. |
Trasa |
Jednoznacznie identyfikuje miejsce docelowe i wszystkie wymagane przez nie dane. Możesz nawigować, korzystając z tras. Trasy prowadzą do miejsc docelowych. |
Dowolny typ danych, który można serializować. |
Korzyści i funkcje
Komponent nawigacji zapewnia szereg innych korzyści i funkcji, takich jak:
- Animacje i przejścia: udostępnia standardowe zasoby dotyczące animacji i przejść.
- Precyzyjne linki: wdraża i obsługuje precyzyjne linki, które kierują użytkownika bezpośrednio do miejsca docelowego.
- Wzorce interfejsu: obsługuje wzorce takie jak panele nawigacji i dolny pasek nawigacyjny przy minimalnym nakładzie pracy.
- Zabezpieczenia wpisywania: obejmuje obsługę przekazywania danych między miejscami docelowymi z zabezpieczeniami wpisywania.
- Obsługa ViewModel: umożliwia określenie zakresu
ViewModelna wykresie nawigacyjnym, aby udostępniać dane związane z interfejsem między miejscami docelowymi wykresu. - Transakcje fragmentów: pełna obsługa transakcji fragmentów.
- Wstecz i w górę: domyślnie prawidłowo obsługuje działania wstecz i w górę.
Opcje platformy
Komponent nawigacji obsługuje 2 główne platformy do implementacji wykresu nawigacyjnego, w zależności od architektury interfejsu aplikacji:
- Compose: jeśli aplikacja została utworzona w całości za pomocą Jetpack Compose, użyj Navigation Compose. Miejsca docelowe na wykresie to elementy kompozycyjne.
- Fragmenty: jeśli aplikacja używa widoków lub połączenia widoków i Compose, użyj komponentu nawigacji opartego na fragmentach. Miejsca docelowe na wykresie to fragmenty, które mogą zawierać standardowe widoki, treści Compose lub kombinację obu tych elementów.
W przypadku aplikacji, które przechodzą z widoków na Compose, zalecaną strategią jest dalsze używanie komponentu nawigacji opartego na fragmentach podczas konwertowania poszczególnych ekranów na Compose. Gdy wszystkie fragmenty zostaną zastąpione elementami kompozycyjnymi, możesz przenieść wykres nawigacyjny do Navigation Compose.
Konfigurowanie środowiska
Aby uwzględnić obsługę nawigacji w projekcie, dodaj te zależności do pliku build.gradle aplikacji:
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") }
Informacje o dodawaniu innych komponentów architektury do projektu znajdziesz w artykule Dodawanie komponentów do projektu.
Dalsze kroki
Więcej dokumentacji i materiałów związanych z komponentem nawigacji znajdziesz w tych zasobach.
Szczegółowe przewodniki
Więcej informacji o implementowaniu hosta nawigacji i NavController, a także o tym, jak współdziałają one z Compose i innymi platformami interfejsu, znajdziesz w tych przewodnikach:
- Tworzenie kontrolera nawigacji: opisuje, jak utworzyć obiekt
NavController. - Tworzenie wykresu nawigacji: szczegółowe informacje o tworzeniu hosta nawigacji i wykresu nawigacji.
- Przechodzenie do miejsca docelowego: pokazuje, jak używać
NavControllerdo przechodzenia między miejscami docelowymi na wykresie.
Codelabs
- Jetpack Navigation
- Fragmenty i komponent nawigacji
- Tworzenie aplikacji adaptacyjnej z dynamiczną nawigacją
Filmy
- Poruszanie się po nawigacji
- 10 sprawdzonych metod przechodzenia na jedną aktywność
- Single activity: Why, when, and how (Android Dev Summit '18)
- Android Jetpack: Manage UI navigation with navigation controller (Google I/O '18)