Nawigacja

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.

NavGraph

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.

NavController

Miejsce docelowe

Węzeł w grafie nawigacyjnym. Gdy użytkownik przechodzi do tego węzła, host wyświetla jego zawartość.

NavDestination

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 ViewModel na 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:

Codelabs

Filmy

Przykłady