Компонент 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-функции экрана, который его открывает. Для этого выполните следующие действия:
- Управляйте видимостью диалогового окна с помощью логической переменной состояния и передавайте это состояние в параметр
visibleдиалогового окна. ИспользуйтеrememberSaveableили состояние, поднятое доViewModel. - В обратном вызове
onDismissRequestи в любых других обратных вызовах для подтверждения или отклонения задайте для переменной состояния значениеfalse. Таким образом, диалоговое окно анимируется и возвращается к базовому экрану, когда пользователь проводит пальцем по экрану, чтобы закрыть его, или выбирает действие.
Дополнительную информацию можно найти в справочной документации по API AlertDialog, ConfirmationDialog и OpenOnPhoneDialog.
Чтобы узнать больше о Jetpack Navigation, ознакомьтесь со статьей Навигация с помощью Compose или пройдите практическую работу по навигации в Jetpack Compose.
Рекомендуем
- Примечание. Текст ссылки показывается, когда JavaScript отключен.
- Переход с Jetpack Navigation на Navigation Compose
- Навигация с помощью Compose
- Как переключаться между экранами с помощью Compose