Die Navigationskomponente in Android Jetpack bietet Unterstützung für Jetpack Compose-Anwendungen. Sie können zwischen Composables wechseln und dabei die Infrastruktur und Funktionen der Navigationskomponente nutzen.
Auf dieser Seite werden die Unterschiede zur Jetpack-Navigation in Compose für Wear OS beschrieben.
Einrichtung
Verwenden Sie die folgende Abhängigkeit in der build.gradle-Datei Ihres App-Moduls:
Kotlin
dependencies { def wear_compose_version = "1.7.2" implementation "androidx.wear.compose:compose-navigation:$wear_compose_version" }
Es wird anstelle des Artefakts androidx.navigation:navigation-compose verwendet, da es alternative Implementierungen speziell für Wear OS bietet.
Navigationscontroller, Host und Grafik erstellen
Für die Navigation mit Compose für Wear OS sind dieselben drei Komponenten erforderlich wie für Apps, die nicht für Wear OS entwickelt wurden: der Navigations-Controller, der Host und der Graph.
Verwenden Sie rememberSwipeDismissableNavController(), um eine Instanz von WearNavigator zu erstellen, einer Implementierung von NavController, die für Wear OS-Anwendungen geeignet ist:
val navController = rememberSwipeDismissableNavController()
Die NavController ist die primäre API, die für die Navigation in Compose-Anwendungen verwendet wird. Er steuert die Navigation zwischen Composables im Navigationshost, der unter Wear OS SwipeDismissableNavHost ist.
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
Wie die NavHost-komponierbare Funktion, nimmt sie einen Verweis auf den Navigationscontroller, die Route für das Startziel und den Builder für den Navigationsgraphen, der hier als nachgestelltes Lambda dargestellt wird.
Das Startziel muss im Navigation Graph Builder zusammen mit allen anderen Zielen angegeben werden, die mit dem Navigationscontroller navigierbar sein sollen.
Deklariere in deiner Wear OS-AppSwipeDismissableNavHost als Inhalt von AppScaffold, um Komponenten auf oberster Ebene wie Zeit, Scroll- oder Positionsanzeige und Seitenanzeige zu unterstützen.
Verwende 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 Wechsel zwischen Bildschirmen korrekt animiert wird.
Außerdem fügt ScreenScaffold einen PositionIndicator für scrollbare Inhalte hinzu.
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 transformationSpec = rememberTransformationSpec() ScreenScaffold( scrollState = scrollState, ) { contentPadding -> // Screen content goes here // ...
Dialogfelder anzeigen
Wenn du ein Dialogfeld mit Material 3 für Compose unter Wear OS anzeigen möchtest, z. B. AlertDialog, ConfirmationDialog, OpenOnPhoneDialog oder Dialog, deklariere das Dialogfeld-Composable direkt im Bildschirm-Composable-Ziel, über das es geöffnet wird. Führen Sie dazu die folgenden Schritte aus:
- Steuern Sie die Sichtbarkeit des Dialogfelds mit einer booleschen Statusvariablen und übergeben Sie diesen Status an den Parameter
visibledes Dialogfelds. Verwenden Sie entwederrememberSaveableoder einen Status, der auf einViewModelhochgezogen wird. - Setze im Callback
onDismissRequestund in allen anderen Callbacks für Bestätigungs- oder Ablehnungsaktionen die Statusvariable auffalse. Auf diese Weise wird das Dialogfeld animiert und kehrt zum zugrunde liegenden Bildschirm zurück, wenn der Nutzer wischt, um es zu schließen, oder eine Aktion auswählt.
Weitere Informationen finden Sie in der API-Referenzdokumentation zu AlertDialog, ConfirmationDialog und OpenOnPhoneDialog.
Weitere Informationen zur Jetpack-Navigation finden Sie unter Mit Compose navigieren oder im Codelab zur Jetpack Compose-Navigation.
Empfehlungen für Sie
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Jetpack Navigation zu Navigation Compose migrieren
- Navigation mit kombinierbarer Funktion
- Mit Compose zwischen Bildschirmen wechseln