导航

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

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

关键概念

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

概念

目的

类型

主机

包含当前导航目标的 UI 元素。也就是说，当用户在应用中导航时，应用实际上是在导航主机中进出目标。

图形

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

NavGraph

控制器

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

NavController

目标

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

NavDestination

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

路线

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

您可以使用路线进行导航。路线会带您到目标。

任何可序列化数据类型。

优点和功能

导航组件提供了一些其他优点和功能，包括以下内容

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

设置您的环境

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

Groovy

dependencies {
  def nav_version = "2.8.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"

}

Kotlin

dependencies {
  val nav_version = "2.8.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")

}

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

下一步

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

详细指南

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

Codelabs

视频

示例