创建导航控制器

导航控制器是导航中的关键概念之一。它用于存放导航图,并公开可让您的应用在导航图中的目的地之间移动的方法。

使用 Navigation 组件时,您可以使用 NavController 类创建导航控制器。NavController 是中央导航 API。它会跟踪用户访问过的目的地,并允许用户在目的地之间移动。本指南将演示如何在应用中创建 NavController

如需了解如何向 NavController 添加导航图,请参阅设计导航图NavController 提供了几种导航到其图中的目的地的不同方式。如需了解详情,请参阅导航到目的地

Compose

如需在使用 Jetpack Compose 时创建 NavController,请调用 rememberNavController()

val navController = rememberNavController()

您应在可组合项层次结构中创建较高层级的 NavController。它需要足够高,以便需要引用它的所有可组合项都能做到。

这样一来,您就可以将 NavController 用作更新屏幕外的可组合项的单一可信来源。这遵循状态提升的原则。

观看次数

如果您使用的是 View 界面框架,则可以根据上下文使用以下方法之一检索 NavController:

Kotlin

Java

通常,您需要先获取 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();

深入阅读

  • 设计导航图:这份指南详细介绍了如何向包含应用中的所有目的地的 NavController 添加导航图。
  • 导航到目的地:这份指南详细介绍了如何使用 NavController 在导航图中的目的地之间移动。