导航是指允许用户在应用内不同内容之间进行导航、进入和退出的交互。
Android Jetpack 的导航组件包含导航库、Safe Args Gradle 插件和工具,可帮助您实现应用导航。导航组件可处理各种导航用例,从简单的按钮点击到更复杂的模式,例如应用栏和导航抽屉。
关键概念
下表概述了导航中的关键概念以及用于实现它们的主要类型。
概念 |
目的 |
类型 |
---|---|---|
主机 |
包含当前导航目标的 UI 元素。也就是说,当用户在应用中导航时,应用实质上是在导航主机中来回切换目标。 |
|
图 |
定义应用中所有导航目标以及它们如何相互连接的数据结构。 |
|
控制器 |
用于管理目标之间导航的中央协调器。该控制器提供在目标之间导航、处理深层链接、管理返回堆栈等方法。 |
|
目标 |
导航图中的一个节点。当用户导航到此节点时,主机将显示其内容。 |
通常在构建导航图时创建。 |
路由 |
唯一标识目标及其所需的任何数据。 您可以使用路由进行导航。路由将您带到目标。 |
任何可序列化的数据类型。 |
优势和功能
导航组件还提供了许多其他优势和功能,包括:
- 动画和过渡:提供用于动画和过渡的标准化资源。
- 深层链接:实现并处理将用户直接带到目标的深层链接。
- 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
视频
- 导航解析
- 迁移到单 Activity 的 10 个最佳实践
- 单 Activity:为什么、何时以及如何 (Android 开发者峰会 '18)
- Android Jetpack:使用导航控制器管理 UI 导航 (Google I/O '18)