다음 섹션에서는 백 스택을 저장하고 백 스택의 항목과 연결된 상태를 저장하는 전략을 설명합니다.
백 스택 저장
구성 변경 및 프로세스 종료를 비롯한 다양한 수명 주기 이벤트에서 앱의 탐색 상태를 유지하는 것은 우수한 사용자 환경을 위해 매우 중요합니다. Navigation 3에서는 백 스택을 소유하므로 백 스택을 만들거나 저장하는 방법에 관한 엄격한 가이드라인이 없습니다. 하지만 Navigation 3는 저장 가능한 백 스택을 제공하는 편의 메서드인 rememberNavBackStack를 제공합니다.
rememberNavBackStack 사용
rememberNavBackStack 구성 가능한 함수는 구성 변경 및 프로세스 종료 전반에 걸쳐 유지되는 백 스택을 만들도록 설계되었습니다.
rememberNavBackStack가 올바르게 작동하려면 백 스택의 각 키가 특정 요구사항을 준수해야 합니다.
NavKey인터페이스 구현: 백 스택의 모든 키는NavKey인터페이스를 구현해야 합니다. 이는 키를 저장할 수 있음을 라이브러리에 알리는 마커 인터페이스 역할을 합니다.@Serializable주석이 있음:NavKey를 구현하는 것 외에도 키 클래스와 객체는@Serializable주석으로 표시되어야 합니다.
다음 스니펫은 rememberNavBackStack의 올바른 구현을 보여줍니다.
@Serializable data object Home : NavKey @Composable fun NavBackStack() { val backStack = rememberNavBackStack(Home) }
NavKey의 하위유형이 있는 백 스택 기억
구성 가능한 함수 rememberNavBackStack는 NavBackStack<NavKey>를 반환합니다.
앱이 모든 키가 상속되는 자체 NavKey 하위유형을 정의하는 경우 다음과 같이 맞춤 기억 함수를 구현하여 이 입력을 보존할 수 있습니다.
@Serializable sealed interface MyAppNavKey : NavKey @Serializable data object ScreenA: MyAppNavKey @Serializable data class ScreenB(val id: String): MyAppNavKey @Composable fun rememberMyAppNavBackStack(vararg elements: MyAppNavKey): NavBackStack<MyAppNavKey> { return rememberSerializable(serializer = serializer()) { NavBackStack(*elements) } } @Composable fun MyApp() { // defaultNavBackStack is NavBackStack<NavKey> val defaultNavBackStack = rememberNavBackStack(ScreenA) // myAppNavBackStack is NavBackStack<MyAppNavKey> val myAppNavBackStack = rememberMyAppNavBackStack(ScreenA) }
개방형 다형성을 처리하는 방법을 비롯한 더 많은 예시는 NavBackStackSamples를 참고하세요.
대안: ViewModel에 저장
백 스택을 관리하는 또 다른 방법은 ViewModel에 저장하는 것입니다.
ViewModel 또는 다른 맞춤 저장소를 사용할 때 프로세스 종료를 통해 지속성을 유지하려면 다음을 실행해야 합니다.
- 키를 직렬화할 수 있는지 확인:
rememberNavBackStack와 마찬가지로 탐색 키를 직렬화할 수 있어야 합니다. - 수동으로 직렬화 및 역직렬화 처리: 앱이 백그라운드로 전환되거나 복원될 때 각 키의 직렬화된 표현을 영구 스토리지 (예:
SharedPreferences, 데이터베이스 또는 파일)에 수동으로 저장하고 역직렬화해야 합니다.
ViewModel 인스턴스의 범위를 NavEntry 객체로 지정
ViewModels는 화면 회전과 같은 구성 변경 시 UI 관련 상태를 유지하는 데 사용됩니다. 기본적으로 ViewModels는 가장 가까운 ViewModelStoreOwner(일반적으로 Activity 또는 Fragment)로 범위가 지정됩니다.
하지만 전체 Activity가 아닌 백 스택의 특정 NavEntry (즉, 특정 화면 또는 대상)으로 ViewModel의 범위를 지정하는 것이 좋습니다. 이렇게 하면 특정 NavEntry가 백 스택의 일부인 동안에만 ViewModel의 상태가 유지되고 NavEntry가 표시되면 삭제됩니다.
androidx.lifecycle:lifecycle-viewmodel-navigation3 부가기능 라이브러리는 이를 용이하게 하는 NavEntryDecorator를 제공합니다. 이 데코레이터는 각 NavEntry에 ViewModelStoreOwner를 제공합니다. NavEntry의 콘텐츠 내에 ViewModel를 만들면 (예: Compose에서 viewModel() 사용) 백 스택에 있는 특정 NavEntry의 키로 범위가 자동으로 지정됩니다. 즉, NavEntry가 백 스택에 추가될 때 ViewModel가 생성되고 삭제될 때 삭제됩니다.
NavEntryDecorator를 사용하여 ViewModel를 NavEntry로 범위 지정하려면 다음 단계를 따르세요.
androidx.lifecycle:lifecycle-viewmodel-navigation3종속 항목을app/build.gradle.kts파일에 추가합니다.NavDisplay를 구성할 때 기본rememberSaveableStateHolderNavEntryDecorator()를entryDecorators목록에 추가합니다.entryDecorators목록에rememberViewModelStoreNavEntryDecorator()를 추가합니다.
NavDisplay( entryDecorators = listOf( // Add the default decorators for managing scenes and saving state rememberSaveableStateHolderNavEntryDecorator(), // Then add the view model store decorator rememberViewModelStoreNavEntryDecorator() ), backStack = backStack, entryProvider = entryProvider { }, )