Navigazione con Compose per Wear OS


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, dichiara SwipeDismissableNavHost 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:

  1. Controlla la visibilità della finestra di dialogo utilizzando una variabile di stato booleana e passa questo stato al parametro visible della finestra di dialogo. Utilizza rememberSaveable o uno stato sottoposto a hoisting in un ViewModel.
  2. Nel callback onDismissRequest e in qualsiasi altro callback di azione di conferma o chiusura, imposta la variabile di stato su false. 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.