创建导航控制器

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

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

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

Compose

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

val navController = rememberNavController()

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

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

View

如果您使用的是 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 在导航图中的目的地之间移动。