Die Navigation bezieht sich auf die Interaktionen, mit denen Nutzer zwischen den verschiedenen Inhalten in Ihrer App wechseln, sie aufrufen und wieder verlassen können.
Die Navigationskomponente von Android Jetpack umfasst die Navigationsbibliothek, das Safe Args Gradle-Plug-in und Tools, mit denen Sie die App-Navigation implementieren können. Die Navigationskomponente deckt verschiedene Navigationsanwendungsfälle ab, von einfachen Buttonklicks bis hin zu komplexeren Mustern wie App-Leisten und Navigationsleisten.
Wichtige Konzepte
Die folgende Tabelle bietet einen Überblick über die wichtigsten Konzepte der Navigation und die wichtigsten Typen, die Sie zu ihrer Implementierung verwenden.
Vorgabe |
Zweck |
Typ |
|---|---|---|
Host |
Ein UI-Element, das das aktuelle Navigationsziel enthält. Wenn ein Nutzer durch eine App navigiert, tauscht die App im Wesentlichen Ziele im Navigationshost aus. |
|
Grafik |
Eine Datenstruktur, die alle Navigationsziele innerhalb der App und ihre Verknüpfungen definiert. |
|
Controller |
Der zentrale Koordinator für die Verwaltung der Navigation zwischen Zielen. Der Controller bietet Methoden zum Navigieren zwischen Zielen, zum Verarbeiten von Deeplinks, zum Verwalten des Back Stacks und mehr. |
|
Ziel |
Ein Knoten im Navigationsgraphen. Wenn der Nutzer zu diesem Knoten navigiert, zeigt der Host seinen Inhalt an. |
Wird normalerweise beim Erstellen des Navigationsgraphen erstellt. |
Route |
Identifiziert ein Ziel und alle dafür erforderlichen Daten eindeutig. Sie können Routen für die Navigation verwenden. Routen führen Sie zu Zielen. |
Jeder serialisierbare Datentyp. |
Vorteile und Funktionen
Die Navigationskomponente bietet eine Reihe weiterer Vorteile und Funktionen, darunter:
- Animationen und Übergänge: Bietet standardisierte Ressourcen für Animationen und Übergänge.
- Deeplinks: Implementiert und verarbeitet Deeplinks, die den Nutzer direkt zu einem Ziel führen.
- UI-Muster: Unterstützt Muster wie Navigationsleisten und die untere Navigationsleiste mit minimalem zusätzlichem Aufwand.
- Typsicherheit: Unterstützt die Weitergabe von Daten zwischen Zielen mit Typsicherheit.
- ViewModel-Unterstützung: Ermöglicht die Beschränkung eines
ViewModelauf einen Navigationsgraphen, um UI-bezogene Daten zwischen den Zielen des Graphen zu teilen. - Fragment-Transaktionen: Fragment-Transaktionen werden vollständig unterstützt und verarbeitet.
- Zurück und nach oben: Die Aktionen „Zurück“ und „Nach oben“ werden standardmäßig korrekt verarbeitet.
Framework-Optionen
Die Navigationskomponente unterstützt zwei primäre Frameworks für die Implementierung des Navigationsgraphen, je nach UI-Architektur Ihrer App:
- Compose: Wenn Ihre App vollständig mit Jetpack Compose erstellt wurde, verwenden Sie Navigation Compose. Ziele in Ihrem Diagramm sind Composables.
- Fragmente: Wenn Ihre App Views oder eine Mischung aus Views und Compose verwendet, verwenden Sie die fragmentbasierte Navigationskomponente. Ziele in Ihrem Diagramm sind Fragmente, die Standardansichten, Compose-Inhalte oder eine Kombination aus beidem enthalten können.
Für Anwendungen, die von Views zu Compose migriert werden, wird empfohlen, die fragmentbasierte Navigationskomponente weiterhin zu verwenden und gleichzeitig einzelne Bildschirme zu Compose zu konvertieren. Sobald alle Fragmente durch Composables ersetzt wurden, können Sie den Navigationsgraphen zu Navigation Compose migrieren.
Umgebung einrichten
Wenn Sie die Navigationsunterstützung in Ihr Projekt einbinden möchten, fügen Sie der Datei build.gradle Ihrer App die folgenden Abhängigkeiten hinzu:
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") }
Informationen zum Hinzufügen anderer Architekturkomponenten zu Ihrem Projekt finden Sie unter Komponenten zu Ihrem Projekt hinzufügen.
Nächste Schritte
Weitere Dokumentation und Ressourcen zur Navigationskomponente finden Sie in den folgenden Ressourcen.
Detaillierte Anleitungen
Weitere Informationen zum Implementieren eines Navigationshosts und von NavController sowie zur Interaktion mit Compose und anderen UI-Frameworks finden Sie in den folgenden Leitfäden:
- Navigations-Controller erstellen: Hier wird beschrieben, wie Sie einen
NavControllererstellen. - Navigationsdiagramm erstellen: Hier wird beschrieben, wie Sie einen Navigationshost und ein Navigationsdiagramm erstellen.
- Zu einem Ziel navigieren: Hier wird gezeigt, wie Sie mit einem
NavControllerzwischen den Zielen in Ihrem Diagramm wechseln.
Codelabs
- Navigation mit Jetpack
- Fragmente und die Navigationskomponente
- Adaptive App mit dynamischer Navigation erstellen
Videos
- Navigation
- 10 Best Practices für die Umstellung auf eine einzelne Aktivität
- Single activity: Why, when, and how (Android Dev Summit '18)
- Android Jetpack: Manage UI navigation with navigation controller (Google I/O '18)