导航控制器是导航中的关键概念之一。它用于存放导航图,并会公开可让您的应用在导航图中的目的地之间移动的方法。
使用 Navigation 组件时,您可以使用 NavController 类创建导航控制器。NavController 是中央导航 API。它会跟踪用户访问了哪些目的地,并允许用户在目的地之间移动。本指南将演示如何在应用中创建 NavController。
如需了解如何向 NavController 添加导航图,请参阅设计导航图。NavController 提供了几种导航到其导航图中各目的地的不同方式。如需了解详情,请参阅导航到目的地。
Compose
如需在使用 Jetpack Compose 时创建 NavController,请调用 rememberNavController():
val navController = rememberNavController()
您应在可组合项层次结构中的较高层级创建 NavController。它应足够高,以便需要引用它的所有可组合项都能成功引用它。
这样一来,您便可将 NavController 用作单一可信来源以更新屏幕外的可组合项。这遵循了状态提升 (hoisting) 的原则。
View
如果您使用的是 View 界面框架,则可以根据上下文使用下列方法之一来检索 NavController:
Kotlin:
Java:
NavHostFragment.findNavController(Fragment)Navigation.findNavController(Activity, @IdRes int viewId)Navigation.findNavController(View)
通常,您需要先获取 NavHostFragment,然后从 fragment 检索 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();