Navigazione

La navigazione si riferisce alle interazioni che consentono agli utenti di spostarsi tra i diversi contenuti della tua app, di accedervi e di uscirne.

Il componente Navigation di Android Jetpack include la libreria Navigation, il plug-in Gradle Safe Args e gli strumenti per aiutarti a implementare la navigazione nell'app. Il componente Navigation gestisce diversi casi d'uso della navigazione, dai semplici clic sui pulsanti a pattern più complessi, come le barre delle app e il riquadro di navigazione a scomparsa.

Concetti fondamentali

La tabella seguente fornisce una panoramica dei concetti chiave della navigazione e dei tipi principali che utilizzi per implementarli.

Concetto

Finalità

Tipo

Host

Un elemento UI che contiene la destinazione di navigazione corrente. In altre parole, quando un utente naviga in un'app, l'app scambia essenzialmente le destinazioni all'interno e all'esterno dell'host di navigazione.

Grafico

Una struttura di dati che definisce tutte le destinazioni di navigazione all'interno dell'app e il modo in cui sono collegate tra loro.

NavGraph

Controller

Il coordinatore centrale per la gestione della navigazione tra le destinazioni. Il controller offre metodi per spostarsi tra le destinazioni, gestire i deep link, gestire il back stack e altro ancora.

NavController

Destinazione

Un nodo nel grafico di navigazione. Quando l'utente accede a questo nodo, l'host ne visualizza i contenuti.

NavDestination

In genere vengono create durante la creazione del grafico di navigazione.

Inoltra

Identifica in modo univoco una destinazione e tutti i dati richiesti.

Puoi navigare utilizzando i percorsi. I percorsi ti portano alle destinazioni.

Qualsiasi tipo di dati serializzabile.

Vantaggi e funzionalità

Il componente Navigation offre una serie di altri vantaggi e funzionalità, tra cui:

  • Animazioni e transizioni: fornisce risorse standardizzate per animazioni e transizioni.
  • Deep linking: implementa e gestisce i deep link che indirizzano l'utente direttamente a una destinazione.
  • Pattern UI: supporta pattern come i riquadri di navigazione a scomparsa e la barra di navigazione in basso con un lavoro aggiuntivo minimo.
  • Sicurezza dei tipi: include il supporto per il passaggio di dati tra destinazioni con sicurezza dei tipi.
  • Supporto di ViewModel: consente di definire l'ambito di un ViewModel in un grafico di navigazione per condividere i dati relativi alla UI tra le destinazioni del grafico.
  • Transazioni di frammenti: supporta e gestisce completamente le transazioni di frammenti.
  • Indietro e Su: gestisce correttamente le azioni Indietro e Su per impostazione predefinita.

Opzioni del framework

Il componente Navigation supporta due framework principali per l'implementazione del grafico di navigazione, a seconda dell'architettura della UI dell'app:

  • Compose: se la tua app è creata interamente con Jetpack Compose, utilizza Navigation Compose. Le destinazioni nel grafico sono componibili.
  • Frammenti: se la tua app utilizza le visualizzazioni o una combinazione di visualizzazioni e Compose, utilizza il componente di navigazione basato su frammenti. Le destinazioni nel grafico sono frammenti che possono ospitare visualizzazioni standard, contenuti di Compose o una combinazione di entrambi.

Per le applicazioni di cui viene eseguita la migrazione da View a Compose, la strategia consigliata è continuare a utilizzare il componente di navigazione basato su frammenti durante la conversione delle singole schermate in Compose. Una volta sostituiti tutti i frammenti con i componibili, puoi eseguire la migrazione del grafico di navigazione a Navigation Compose.

Configura l'ambiente

Per includere il supporto della navigazione nel tuo progetto, aggiungi le seguenti dipendenze al file build.gradle della tua app:

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")
}

Per informazioni sull'aggiunta di altri componenti dell'architettura al tuo progetto, consulta Aggiungi componenti al progetto.

Passaggi successivi

Per ulteriore documentazione e risorse relative al componente Navigation, consulta le seguenti risorse.

Guide dettagliate

Per saperne di più su come implementare un host di navigazione e NavController, nonché su come interagiscono con Compose e altri framework UI, consulta le seguenti guide:

Codelab

Video

Esempi