탐색 컨트롤러는 탐색의 주요 개념 중 하나입니다. 탐색 그래프를 보유하고 앱이 그래프의 대상 간에 이동할 수 있는 메서드를 노출합니다.
탐색 구성요소를 사용할 때는 NavController 클래스를 사용하여 탐색 컨트롤러를 만듭니다. NavController는 핵심 탐색 API입니다. 사용자가 방문한 대상을 추적하고 사용자가 목적지 간에 이동할 수 있도록 허용합니다. 이 가이드에서는 앱에서 NavController를 만드는 방법을 보여줍니다.
NavController에 탐색 그래프를 추가하는 방법에 관한 자세한 내용은 탐색 그래프 설계를 참고하세요. NavController는 그래프의 대상으로 이동하는 몇 가지 방법을 제공합니다. 자세한 내용은 대상으로 이동을 참고하세요.
Compose
Jetpack Compose를 사용할 때 NavController를 만들려면 rememberNavController()를 호출합니다.
val navController = rememberNavController()
컴포저블 계층 구조에서 높은 수준의 NavController를 만들어야 합니다. 이 값은 이를 참조해야 하는 모든 컴포저블이 할 수 있을 만큼 충분히 높아야 합니다.
이렇게 하면 NavController를 화면 외부에서 컴포저블을 업데이트하기 위한 단일 정보 소스로 사용할 수 있습니다. 이는 상태 호이스팅의 원칙을 따릅니다.
뷰
뷰 UI 프레임워크를 사용하는 경우 컨텍스트에 따라 다음 메서드 중 하나를 사용하여 NavController를 검색할 수 있습니다.
Kotlin:
자바:
NavHostFragment.findNavController(Fragment)Navigation.findNavController(Activity, @IdRes int viewId)Navigation.findNavController(View)
일반적으로 먼저 NavHostFragment를 가져온 다음 프래그먼트에서 NavController를 검색합니다. 다음 스니펫은 이 작업을 보여줍니다.
Kotlin
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController
Java
NavHostFragment navHostFragment =
(NavHostFragment) getSupportFragmentManager().findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();