Android Jetpack의 Navigation 구성요소는 Jetpack Compose 애플리케이션을 지원합니다. Navigation 구성요소의 인프라와 기능을 활용하면서 컴포저블 간에 이동할 수 있습니다.
이 페이지에서는 Wear OS용 Compose의 Jetpack Navigation과의 차이점을 설명합니다.
설정
앱 모듈의 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와 관련된 대체 구현을 제공하기 때문입니다.
탐색 컨트롤러, 호스트, 그래프 만들기
Wear OS용 Compose로 탐색하려면 Wear OS가 아닌 앱에서 필요한 동일한 세 가지 구성요소인 탐색 컨트롤러, 호스트, 그래프가 필요합니다.
rememberSwipeDismissableNavController()를 사용하여 Wear OS 애플리케이션에 적합한 NavController의 구현인 WearNavigator의 인스턴스를 만듭니다.
val navController = rememberSwipeDismissableNavController()
NavController는 Compose 애플리케이션에서 탐색하는 데 사용되는 기본 API입니다. Wear OS에서 SwipeDismissableNavHost인 탐색 호스트의 컴포저블 간 탐색을 제어합니다.
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "message_list" ) { // TODO: build navigation graph }
NavHost 컴포저블과 마찬가지로 탐색 컨트롤러, 시작 대상의 경로, 여기서 후행 람다로 표시되는 탐색 그래프의 빌더를 참조합니다.
시작 대상은 탐색 컨트롤러로 탐색할 수 있어야 하는 다른 모든 대상과 함께 탐색 그래프 빌더에 제공되어야 합니다.
Wear OS 앱에서SwipeDismissableNavHost를 AppScaffold의 콘텐츠로 선언하여 시간, 스크롤 또는 위치 표시기, 페이지 표시기와 같은 최상위 구성요소를 지원합니다.
SwipeDismissableNavHost 위의 AppScaffold 객체와 화면 수준의 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 // ...
대화상자 표시
Wear OS에서 Compose용 Material 3을 사용하여 대화상자(예: AlertDialog, ConfirmationDialog, OpenOnPhoneDialog, Dialog)를 표시하려면 대화상자를 여는 화면 컴포저블 대상 내에서 직접 대화상자 컴포저블을 선언합니다. 이렇게 하려면 다음 단계를 완료하세요.
- 불리언 상태 변수를 사용하여 대화상자의 공개 상태를 제어하고 이 상태를 대화상자의
visible매개변수에 전달합니다.rememberSaveable또는ViewModel로 호이스팅된 상태를 사용합니다. onDismissRequest콜백과 기타 확인 또는 닫기 작업 콜백에서 상태 변수를false로 설정합니다. 이렇게 하면 사용자가 스와이프하여 대화상자를 닫거나 작업을 선택할 때 대화상자가 애니메이션으로 표시되고 기본 화면으로 돌아갑니다.
자세한 내용은 AlertDialog, ConfirmationDialog, OpenOnPhoneDialog API 참고 문서를 참조하세요.
Jetpack Navigation에 관한 자세한 내용은 Compose로 탐색을 참고하거나 Jetpack Compose Navigation Codelab을 진행하세요.
추천 서비스
- 참고: JavaScript가 사용 중지되어 있으면 링크 텍스트가 표시됩니다.
- Jetpack 탐색을 탐색 Compose로 이전
- Compose를 사용한 탐색
- Compose를 사용하여 화면 간 이동