创建导航控制器

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

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