Навигация с помощью Compose для Wear OS


Компонент Navigation в Android Jetpack поддерживает приложения Jetpack Compose. Вы можете перемещаться между composable-функциями, используя инфраструктуру и функции компонента Navigation.

На этой странице описаны различия с Jetpack Navigation в Compose для Wear OS.

Настроить

Используйте следующую зависимость в файле build.gradle модуля приложения:

Kotlin

dependencies {
    def wear_compose_version = "1.7.2"
    implementation "androidx.wear.compose:compose-navigation:$wear_compose_version"
}

Он используется вместо артефакта androidx.navigation:navigation-compose, поскольку предоставляет альтернативные реализации, предназначенные для Wear OS.

Создание контроллера навигации, хоста и графа

Для навигации с помощью Compose для Wear OS требуются те же три компонента, что и для приложений, не предназначенных для Wear OS: контроллер навигации, хост и граф.

Чтобы создать экземпляр WearNavigator, используйте rememberSwipeDismissableNavController(). Это реализация NavController, подходящая для приложений Wear OS.

val navController = rememberSwipeDismissableNavController()

NavController – это основной API, используемый для навигации в приложениях Compose. Он управляет навигацией между composable-функциями в хосте навигации, который в Wear OS называется SwipeDismissableNavHost.

val navController = rememberSwipeDismissableNavController()
SwipeDismissableNavHost(
    navController = navController,
    startDestination = "message_list"
) {
    // TODO: build navigation graph
}

Как и composable-функция NavHost, она принимает ссылку на контроллер навигации, маршрут для начального пункта назначения и конструктор для графа навигации, который показан здесь как завершающее лямбда-выражение.

Начальный пункт назначения должен быть указан в построителе графа навигации вместе со всеми другими пунктами назначения, по которым можно перемещаться с помощью контроллера навигации.

В приложении для Wear OS объявите SwipeDismissableNavHost как контент AppScaffold, чтобы поддерживать компоненты верхнего уровня, такие как время, индикатор прокрутки или положения и индикатор страницы. Используйте объект AppScaffold над SwipeDismissableNavHost и ScreenScaffold на уровне экрана, чтобы добавить объект TimeText на экран по умолчанию и убедиться, что он правильно анимируется при навигации между экранами. Кроме того, ScreenScaffold добавляет PositionIndicator для прокручиваемого контента.
    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
        // ...

Показывать диалоговые окна

Чтобы показать диалоговое окно с помощью Material 3 для Compose в Wear OS, например AlertDialog, ConfirmationDialog, OpenOnPhoneDialog или Dialog, объявите composable-функцию диалогового окна непосредственно в composable-функции экрана, который его открывает. Для этого выполните следующие действия:

  1. Управляйте видимостью диалогового окна с помощью логической переменной состояния и передавайте это состояние в параметр visible диалогового окна. Используйте rememberSaveable или состояние, поднятое до ViewModel.
  2. В обратном вызове onDismissRequest и в любых других обратных вызовах для подтверждения или отклонения задайте для переменной состояния значение false. Таким образом, диалоговое окно анимируется и возвращается к базовому экрану, когда пользователь проводит пальцем по экрану, чтобы закрыть его, или выбирает действие.

Дополнительную информацию можно найти в справочной документации по API AlertDialog, ConfirmationDialog и OpenOnPhoneDialog.

Чтобы узнать больше о Jetpack Navigation, ознакомьтесь со статьей Навигация с помощью Compose или пройдите практическую работу по навигации в Jetpack Compose.