导航

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

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

主要概念

下表简要介绍了导航中的三个关键概念,以及用于实现这些概念的主要类型。

构思

目的

类型

主机

包含当前导航目的地的界面元素。也就是说,当用户浏览应用时,该应用实际上会在导航宿主中交换目的地。

图表

一种数据结构,用于定义应用中的所有导航目的地以及它们如何连接在一起。

NavGraph

控制器

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

NavController

优势和功能

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

  • 动画和过渡:提供关于动画和过渡的标准化资源。
  • 深层链接:实现并处理可将用户直接转到目的地的深层链接。
  • 界面模式:只需极少的额外工作,即可支持抽屉式导航栏和底部导航等模式。
  • 类型安全:包含 Safe Args Gradle 插件,可在目的地之间导航和传递数据时提供类型安全。
  • ViewModel 支持:允许将 ViewModel 的范围限定为导航图,以便在导航图的目的地之间共享与界面相关的数据。
  • fragment 事务:完全支持和处理 fragment 事务。
  • 返回和向上:默认情况下,系统会正确处理返回和向上操作。

设置您的环境

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

Groovy

dependencies {
  def nav_version = "2.7.7"

  // Java language implementation
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Kotlin
  implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
  implementation "androidx.navigation:navigation-ui-ktx:$nav_version"

  // Feature module Support
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

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

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

Kotlin

dependencies {
  val nav_version = "2.7.7"

  // Java language implementation
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Kotlin
  implementation("androidx.navigation:navigation-fragment-ktx:$nav_version")
  implementation("androidx.navigation:navigation-ui-ktx:$nav_version")

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

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

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

如需了解如何向您的项目添加其他架构组件,请参阅向项目添加组件

后续步骤

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

详细指南

如需详细了解如何实现导航宿主和 NavController,以及它们如何与 Compose 和其他界面框架进行交互,请参阅以下指南:

Codelab

视频

示例