导航

导航是指允许用户在应用中不同内容片段之间导航、进入和退出的交互。

Android Jetpack 的导航组件包括 导航库、Safe Args Gradle 插件 和工具，可帮助您实现应用导航。导航组件处理各种导航用例，从简单的按钮点击到更复杂的模式，例如应用栏和导航抽屉。

关键概念

下表概述了导航中的关键概念以及您用于实现它们的主要类型。

概念

用途

类型

宿主

包含当前导航目的地的 UI 元素。也就是说，当用户在应用中导航时，应用本质上是在导航宿主中进出目的地。

图

定义应用中所有导航目的地及其相互连接方式的数据结构。

NavGraph

控制器

管理目的地之间导航的中央协调器。控制器提供在目的地之间导航、处理深层链接、管理返回堆栈等方法。

NavController

目的地

导航图中的节点。当用户导航到此节点时，宿主将显示其内容。

NavDestination

通常在构建导航图时创建。

路由

唯一标识目的地及其所需的所有数据。

您可以使用路由进行导航。路由将带您到目的地。

任何可序列化数据类型。

优势和功能

导航组件提供了许多其他优势和功能，包括以下内容

  • 动画和过渡：提供动画和过渡的标准化资源。
  • 深层链接：实现和处理将用户直接带到目的地的深层链接。
  • UI 模式：支持导航抽屉和底部导航等模式，只需最少的额外工作。
  • 类型安全：包括使用 类型安全 在目的地之间传递数据。
  • ViewModel 支持：支持将 ViewModel 的范围限定到导航图，以便在图的目的地之间共享与 UI 相关的数据。
  • 片段事务：完全支持和处理片段事务。
  • 返回和向上：默认情况下正确处理返回和向上操作。

设置您的环境

要在您的项目中包含导航支持，请将以下依赖项添加到应用的 build.gradle 文件中

Groovy

dependencies {
  def nav_version = "2.8.4"

  // Jetpack Compose Integration
  implementation "androidx.navigation:navigation-compose:$nav_version"

  // Views/Fragments Integration
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Feature module support for Fragments
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

  // Testing Navigation
  androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

}

Kotlin

dependencies {
  val nav_version = "2.8.4"

  // Jetpack Compose integration
  implementation("androidx.navigation:navigation-compose:$nav_version")

  // Views/Fragments integration
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Feature module support for Fragments
  implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

  // Testing Navigation
  androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

}

有关将其他架构组件添加到项目的详细信息，请参阅 将组件添加到您的项目。

后续步骤

有关导航组件的更多文档和资源，请参阅以下资源。

详细指南

有关如何实现导航宿主和 NavController 以及它们如何与 Compose 和其他 UI 框架交互的详细信息，请参阅以下指南

Codelabs

视频

示例