导航控制器是导航中的关键概念之一。它用于存放导航图,并会公开可让您的应用在导航图中的目的地之间移动的方法。
使用 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();