Die Navigationskomponente in Android Jetpack bietet Unterstützung für Jetpack Compose-Anwendungen. Sie können zwischen den Komponenten wechseln und dabei die Infrastruktur und Funktionen der Navigationskomponente nutzen.
Auf dieser Seite werden die Unterschiede zu Jetpack Navigation in Compose for Wear OS beschrieben.
Einrichten
Verwenden Sie in der build.gradle-Datei Ihres App-Moduls die folgende Abhängigkeit:
Kotlin
dependencies { def wear_compose_version = "1.4.1" implementation "androidx.wear.compose:compose-navigation:$wear_compose_version" }
Es wird anstelle des androidx.navigation:navigation-compose
-Artefakts verwendet, da es Wear OS-spezifische alternative Implementierungen bietet.
Navigationscontroller, Host und Grafik erstellen
Für die Navigation mit Compose für Wear OS sind dieselben drei Komponenten erforderlich wie für Nicht-Wear OS-Apps: Navigationscontroller, Host und Graph.
Verwenden Sie rememberSwipeDismissableNavController()
, um eine Instanz von WearNavigator
zu erstellen, einer für Wear OS-Anwendungen geeigneten Implementierung von NavController
:
Kotlin
val navController = rememberSwipeDismissableNavController()
Die NavController
ist die primäre API, die zum Navigieren in Compose-Anwendungen verwendet wird. Damit wird die Navigation zwischen den Komponenten im Navigationshost gesteuert, der in Wear OS SwipeDismissableNavHost
ist.
Kotlin
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
Wie das NavHost
-Kompositelement nimmt es eine Referenz auf den Navigationscontroller, die Route für das Startziel und den Builder für den Navigationsgraphen an, der hier als abschließendes Lambda dargestellt wird.
Das Startziel muss im Navigationsgraphen-Builder zusammen mit allen anderen Zielen angegeben werden, die mit dem Navigationscontroller erreichbar sein sollen.
Deklarieren Sie in Ihrer Wear OS-AppSwipeDismissableNavHost
als Inhalt des AppScaffold
, um Komponenten der obersten Ebene wie Uhrzeit, Scroll-/Positionsanzeige und Seitenanzeige zu unterstützen.
Verwenden Sie ein AppScaffold
-Objekt über dem SwipeDismissableNavHost
und dem ScreenScaffold
auf Bildschirmebene, um dem Bildschirm standardmäßig ein TimeText
-Objekt hinzuzufügen und dafür zu sorgen, dass es beim Wechseln zwischen Bildschirmen richtig animiert wird.
Außerdem wird durch ScreenScaffold
ein PositionIndicator
für scrollbare Inhalte hinzugefügt.
AppScaffold { val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { composable("message_list") { MessageList(onMessageClick = { id -> navController.navigate("message_detail/$id") }) } composable("message_detail/{id}") { MessageDetail(id = it.arguments?.getString("id")!!) } } } } // Implementation of one of the screens in the navigation @Composable fun MessageDetail(id: String) { // .. Screen level content goes here val scrollState = rememberTransformingLazyColumnState() val padding = rememberResponsiveColumnPadding( first = ColumnItemType.BodyText ) ScreenScaffold( scrollState = scrollState, contentPadding = padding ) { // Screen content goes here
Weitere Informationen zu Jetpack Navigation finden Sie unter Mit Compose navigieren oder im Codelab zur Navigation mit Jetpack Compose.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Jetpack Navigation zu Navigation Compose migrieren
- Navigation mit Compose
- Mit Compose zwischen Bildschirmen wechseln