Il componente Navigation di Android Jetpack fornisce supporto per le applicazioni Jetpack Compose. Puoi navigare tra i componibili sfruttando l'infrastruttura e le funzionalità del componente Navigation.
Questa pagina descrive le differenze con Jetpack Navigation su Compose per Wear OS.
Configurazione
Utilizza la seguente dipendenza nel file build.gradle del modulo dell'app:
Kotlin
dependencies { def wear_compose_version = "1.7.2" implementation "androidx.wear.compose:compose-navigation:$wear_compose_version" }
Questo viene utilizzato al posto dell'artefatto androidx.navigation:navigation-compose perché fornisce implementazioni alternative specifiche per Wear OS.
Crea un controller, un host e un grafico di navigazione
La navigazione con Compose per Wear OS richiede gli stessi tre componenti necessari per le app per Wear OS: il controller di navigazione, l'host e il grafico.
Utilizza
rememberSwipeDismissableNavController()
per creare un'istanza di WearNavigator, un'implementazione di NavController
adatta alle applicazioni Wear OS:
val navController = rememberSwipeDismissableNavController()
NavController è l'API principale utilizzata per navigare nelle applicazioni Compose. Controlla la navigazione tra i composabili nell'host di navigazione che, su Wear OS, è SwipeDismissableNavHost.
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
Come il
componibile NavHost,
accetta un riferimento al controller di navigazione, al percorso per la destinazione
di partenza e al builder per il grafico di navigazione, che qui viene mostrato come
lambda finale.
La destinazione iniziale deve essere fornita nel generatore di grafici di navigazione, insieme a tutte le altre destinazioni che devono essere navigabili con il controller di navigazione.
Nell'app per Wear OS, dichiaraSwipeDismissableNavHost come contenuto di
AppScaffold per supportare componenti di primo livello come l'ora, l'indicatore di scorrimento o
posizione e l'indicatore di pagina.
Utilizza un oggetto AppScaffold sopra SwipeDismissableNavHost
e ScreenScaffold a livello di schermata per aggiungere un oggetto TimeText
alla schermata per impostazione predefinita e assicurarti che l'animazione venga eseguita correttamente durante la navigazione
tra le schermate.
Inoltre, ScreenScaffold aggiunge un PositionIndicator per i contenuti scorrevoli.
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 // ...
Mostra finestre di dialogo
Per visualizzare una finestra di dialogo utilizzando Material 3 per Compose su Wear OS, ad esempio
AlertDialog, ConfirmationDialog, OpenOnPhoneDialog
o Dialog, dichiara il composable della finestra di dialogo direttamente all'interno della destinazione
composable della schermata che lo apre. Per farlo, segui questi passaggi:
- Controlla la visibilità della finestra di dialogo utilizzando una variabile di stato booleana e passa questo stato al parametro
visibledella finestra di dialogo. UtilizzarememberSaveableo uno stato sottoposto a hoisting in unViewModel. - Nel callback
onDismissRequeste in qualsiasi altro callback di azione di conferma o chiusura, imposta la variabile di stato sufalse. In questo modo, la finestra di dialogo si chiude con un'animazione e torna alla schermata sottostante quando l'utente scorre per chiuderla o sceglie un'azione.
Per saperne di più, consulta la documentazione di riferimento delle API AlertDialog, ConfirmationDialog e OpenOnPhoneDialog.
Per scoprire di più su Jetpack Navigation, consulta Navigazione con Compose o segui il codelab Navigazione su Jetpack Compose.
Consigliati per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Esegui la migrazione di Jetpack Navigation a Navigation Compose
- Navigazione con Compose
- Spostati tra le schermate con Compose