导航

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

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

关键概念

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

概念

目的

类型

主机

包含当前导航目标的 UI 元素。也就是说,当用户在应用中导航时,应用实质上是在导航主机中来回切换目标。

定义应用中所有导航目标以及它们如何相互连接的数据结构。

NavGraph

控制器

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

NavController

目标

导航图中的一个节点。当用户导航到此节点时,主机将显示其内容。

NavDestination

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

路由

唯一标识目标及其所需的任何数据。

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

任何可序列化的数据类型。

优势和功能

导航组件还提供了许多其他优势和功能,包括:

  • 动画和过渡:提供用于动画和过渡的标准化资源。
  • 深层链接:实现并处理将用户直接带到目标的深层链接。
  • UI 模式:以最少额外工作量支持导航抽屉和底部导航等模式。
  • 类型安全:支持以类型安全的方式在目标之间传递数据。
  • ViewModel 支持:允许将 ViewModel 作用域限定到导航图,以在图的目标之间共享与 UI 相关的数据。
  • Fragment 事务:完全支持和处理 Fragment 事务。
  • 后退和向上:默认情况下正确处理后退和向上操作。

设置您的环境

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

Groovy

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21'
}
  
dependencies {
  def nav_version = "2.9.0"

  // 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"

  // JSON serialization library, works with the Kotlin serialization plugin.
  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3"
}

Kotlin

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  kotlin("plugin.serialization") version "2.0.21"
}

dependencies {
  val nav_version = "2.9.0"

  // 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")

  // JSON serialization library, works with the Kotlin serialization plugin
  implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

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

后续步骤

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

详细指南

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

Codelab

视频

示例