뒤로 탐색 예측 설정

뒤로 탐색 예측 및 시스템 애니메이션은 기본적으로 사용 설정되어 있습니다. 앱이 뒤로 이벤트를 가로채고 뒤로 탐색 예측으로 이전하지 않은 경우 지원되는 뒤로 탐색 API를 사용하도록 앱을 업데이트하세요.

기본 시스템 애니메이션 사용 설정

홈으로 돌아가기, 교차 활동, 교차 작업 시스템 애니메이션은 지원되는 뒤로 핸들링 API로 이전한 앱의 경우 Android 15 이상 기기에서 사용할 수 있습니다.

• 홈으로 돌아가기: 사용자를 홈 화면으로 되돌립니다.
• 교차 활동: 앱 내 활동 간 전환입니다.
• 교차 작업: 작업 간 전환

이러한 애니메이션은 Android 15 이상에서 기본적으로 사용 설정됩니다. Android 13 또는 14를 실행하는 기기에서 사용자는 개발자 옵션을 통해 이를 사용 설정할 수 있습니다.

시스템 애니메이션을 가져오려면 AndroidX Activity 종속 항목을 1.6.0 이상으로 업데이트하세요.

탐색 Compose로 뒤로 탐색 예측 사용 설정

Navigation Compose에서 뒤로 탐색 예측을 사용하려면 navigation-compose 2.8.0 라이브러리 이상을 사용해야 합니다.

사용자가 뒤로 스와이프하면 탐색 Compose가 화면 간에 자동으로 크로스페이드됩니다.

탐색할 때 popEnterTransition 및 popExitTransition를 사용하여 맞춤 전환을 만들 수 있습니다. NavHost에 적용하면 이러한 수정자를 통해 진입 및 종료 화면의 애니메이션 방식을 정의할 수 있습니다. 이를 사용하여 크기 조절, 페이드, 슬라이드 등 다양한 효과를 만들 수 있습니다.

이 예시에서는 사용자가 뒤로 탐색할 때 종료되는 화면을 축소하기 위해 scaleOut이 popExitTransition 내에서 사용됩니다. 또한 transformOrigin 매개변수는 크기 조정 애니메이션이 발생하는 지점을 결정합니다. 기본적으로 화면의 중앙 (0.5f, 0.5f)입니다. 다른 지점에서 크기 조정이 발생하도록 하려면 이 값을 조정하면 됩니다.

NavHost(
    navController = navController,
    startDestination = Home,
    popExitTransition = {
        scaleOut(
            targetScale = 0.9f,
            transformOrigin = TransformOrigin(pivotFractionX = 0.5f, pivotFractionY = 0.5f)
        )
    },
    popEnterTransition = {
        EnterTransition.None
    },
    modifier = modifier,
)
PredictiveBackSnippets.kt

이 코드는 다음 결과를 생성합니다.

popEnterTransition와 popExitTransition는 특히 뒤로 동작으로 백 스택을 팝할 때 애니메이션을 제어합니다. enterTransition 및 exitTransition를 사용하여 예측 뒤로뿐만 아니라 일반적으로 컴포저블의 진입 및 종료 애니메이션을 정의할 수도 있습니다. enterTransition 및 exitTransition만 설정하면 일반 탐색과 뒤로 스택 팝에 모두 사용됩니다. 하지만 popEnterTransition 및 popExitTransition을 사용하면 뒤로 탐색을 위한 별도의 애니메이션을 만들 수 있습니다.

공유 요소 전환과 통합

공유 요소 전환은 공유 콘텐츠가 있는 컴포저블 간에 부드러운 시각적 연결을 제공하며, 탐색에 자주 사용됩니다.

탐색 Compose에서 공유 요소를 사용하려면 공유 요소를 사용한 뒤로 탐색 예측을 참고하세요.

Material Compose 구성요소로 뒤로 탐색 예측 지원

Material Compose 라이브러리의 많은 구성요소는 뒤로 탐색 예측 동작과 원활하게 작동하도록 설계되었습니다. 이러한 구성요소에서 뒤로 탐색 예측 애니메이션을 사용 설정하려면 프로젝트에 최신 Material3 종속 항목 (androidx.compose.material3:material3-*:1.3.0 이상)을 포함하세요.

뒤로 탐색 예측 애니메이션을 지원하는 Material 구성요소는 다음과 같습니다.

• SearchBar
• ModalBottomSheet
• ModalDrawerSheet/DismissibleDrawerSheet
• ModalNavigationDrawer/DismissibleNavigationDrawer

SearchBar 및 ModalBottomSheet은 뒤로 탐색 예측 동작으로 자동으로 애니메이션됩니다. ModalNavigationDrawer, ModalDrawerSheet, DismissibleDrawerSheet, DismissibleNavigationDrawer의 경우 drawerState을 각 시트 콘텐츠 컴포저블에 전달해야 합니다.

뒤로 탐색 예측 동작 애니메이션 테스트

Android 13 또는 Android 14를 계속 사용하는 경우 홈으로 돌아가기 애니메이션을 테스트할 수 있습니다.

이 애니메이션을 테스트하려면 다음 단계를 따르세요.

1. 기기에서 설정 > 시스템 > 개발자 옵션으로 이동합니다.
2. 뒤로 탐색 예측 애니메이션을 선택합니다.
3. 업데이트된 앱을 실행하고, 뒤로 동작을 사용하여 실제 작동하는 모습을 확인합니다.

Android 15 이상에서는 이 기능이 기본적으로 사용 설정되어 있습니다.

추가 리소스

• 뒤로 탐색 예측 애니메이션 추가 Codelab
• Compose의 고급 레이아웃 애니메이션 동영상