Jetpack Navigation 3 ist stabil

Jetpack Navigation 3 Version 1.0 ist stabil 🎉. Sie können sie also ab sofort in Ihren Produktions-Apps verwenden. JetBrains verwendet es bereits in seiner KotlinConf-App.

Navigation 3 ist eine neue Navigationsbibliothek, die von Grund auf für die Verwendung von Status in Jetpack Compose entwickelt wurde. Sie haben die vollständige Kontrolle über den Back Stack, können den Navigationsstatus beibehalten und ganz einfach adaptive Layouts (z. B. Listen-Detailansicht) erstellen. Es gibt sogar eine plattformübergreifende Version von JetBrains.

Warum eine neue Bibliothek?

Die ursprüngliche Jetpack Navigation-Bibliothek (jetzt Nav2) wurde vor sieben Jahren entwickelt. Sie erfüllt zwar ihre ursprünglichen Ziele gut und wurde iterativ verbessert, aber die Art und Weise, wie Apps heute entwickelt werden, hat sich grundlegend geändert. 

Die reaktive Programmierung mit einer deklarativen Benutzeroberfläche ist heute die Norm. Nav3 folgt diesem Ansatz. NavDisplay (die Nav3-UI-Komponente, die Ihre Bildschirme anzeigt) beobachtet beispielsweise einfach eine Liste von Schlüsseln (jeder steht für einen Bildschirm), die durch den Compose-Status unterstützt werden, und aktualisiert die Benutzeroberfläche, wenn sich diese Liste ändert.

Nav2 kann es auch erschweren, eine zentrale Datenquelle für den Navigationsstatus zu haben, da es einen eigenen internen Status hat. Bei Nav3 stellen Sie Ihren eigenen Status bereit, was Ihnen die vollständige Kontrolle gibt.

Außerdem haben Sie sich mehr Flexibilität und Anpassungsmöglichkeiten gewünscht. Anstelle einer einzelnen, monolithischen API bietet Nav3 kleinere, entkoppelte APIs (oder „Bausteine“), die kombiniert werden können, um komplexe Funktionen zu erstellen. Nav3 selbst verwendet diese Bausteine, um sinnvolle Standardeinstellungen für klar definierte Navigationsanwendungsfälle bereitzustellen. 

Dieser Ansatz bietet folgende Vorteile: 

• Bildschirmanimationen global und individuell anpassen
• Gleichzeitiges Anzeigen mehrerer Bereiche und Erstellen flexibler Layouts mit der Scenes API
• Nav3-Komponenten lassen sich ganz einfach durch eigene Implementierungen ersetzen, wenn Sie benutzerdefiniertes Verhalten wünschen.

Weitere Informationen zum Design und zu den Funktionen finden Sie im Blog zur Markteinführung. 

Von Navigation 2 migrieren

Wenn Sie Nav2, insbesondere Navigation Compose, bereits verwenden, sollten Sie eine Migration zu Nav3 in Betracht ziehen. Dazu gibt es einen Migrationsleitfaden. Die wichtigsten Schritte sind: 

1. Fügen Sie die Navigation 3-Abhängigkeiten hinzu.
2. Navigationsrouten aktualisieren, um NavKey zu implementieren Ihre Routen müssen diese Schnittstelle nicht implementieren, um Nav3 zu verwenden. Wenn sie dies jedoch tun, können Sie die Funktion „rememberNavBackStack“ von Nav3 nutzen, um einen persistenten Backstack zu erstellen.
3. Erstellen Sie Klassen, um den Navigationsstatus zu speichern und zu ändern. Hier werden Ihre Backstacks gespeichert.
4. Ersetzen Sie NavController durch diese Klassen.
5. Verschieben Sie die Ziele aus dem NavGraph des NavHost in einen entryProvider.
6. Ersetzen Sie NavHost durch NavDisplay.

Mit der Migration von KI-Agenten experimentieren

Sie können auch einen KI-Agenten verwenden, um den Migrationsleitfaden zu lesen und die Schritte in Ihrem Projekt auszuführen. So probieren Sie das mit dem KI-Agentenmodus von Gemini in Android Studio aus:

• Speichern Sie diese Markdown-Version des Leitfadens in Ihrem Projekt.
• Fügen Sie diesen Prompt in den KI-Agenten ein (drücken Sie aber nicht die Eingabetaste): „Migriere dieses Projekt zu Navigation 3 mit“.
• Geben Sie @migration-guide.md ein. Dadurch wird der Leitfaden als Kontext für den Agenten bereitgestellt. 

Wie immer sollten Sie die vom KI-Agenten vorgenommenen Änderungen sorgfältig prüfen, da er Fehler machen kann. 

Wir würden uns freuen, wenn Sie uns hier Feedback dazu geben, wie Sie oder Ihr Kundenservicemitarbeiter abgeschnitten haben.

Praktische Navigationsanleitungen für häufige Szenarien

Für häufige, aber differenzierte Anwendungsfälle haben wir ein Rezept-Repository. Hier wird gezeigt, wie Sie die Nav3-APIs auf bestimmte Weise kombinieren können. Sie können das Rezept an Ihre speziellen Anforderungen anpassen. Wenn sich ein Rezept als beliebt erweist, werden wir in Erwägung ziehen, die nicht nuancierten Teile in die Nav3-Kernbibliothek oder Add-on-Bibliotheken zu übernehmen. 

Derzeit gibt es 19 Rezepte, darunter für: 

• Mehrere Backstacks
• Modularisierung und Dependency Injection
• Navigationsargumente an ViewModels übergeben (einschließlich der Verwendung von Koin)
• Ergebnisse von Bildschirmen zurückgeben nach Ereignissen und nach gemeinsamem Status

Wir arbeiten derzeit an einem Rezept für Deeplinks sowie an einer Koin-Integration und haben viele weitere geplant. Ein Entwickler von JetBrains hat auch eine Compose Multiplatform-Version der Rezepte veröffentlicht.

Wenn Sie einen häufigen Anwendungsfall haben, für den Sie ein Rezept wünschen, stellen Sie bitte einen Rezeptantrag. 

Zusammenfassung

Dokumentation und Rezepte für Nav3 Außerdem gibt es eine ganze Woche lang technische Inhalte, darunter: 

• Ein ausführliches Video zur API mit Informationen zu Modularisierung, Animationen und adaptiven Layouts.
• Eine Live-Fragerunde mit den Entwicklern, die Nav3 entwickelt haben.

Die Nav3 Spotlight Week beginnt am 1. Dezember 2025. 

Falls Probleme auftreten, können Sie sie hier melden.