Android Jetpack 组件库 -＞Jetpack Navigation （下）

已于 2025-07-26 16:32:51 修改
阅读量973 收藏 6
点赞数 26
CC 4.0 BY-SA版权
分类专栏： jetpack 文章标签： android jetpack android
于 2025-07-26 16:21:32 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wulong756273/article/details/149668626

目录

1. Navigation 简介与背景

1.1 为什么需要 Navigation？

1.2 Navigation 的优势

2. 核心概念与架构

2.1 核心组件

2.2 导航类型

3. 基础使用与实践

3.1 项目配置

3.2 基本导航操作

3.3 参数传递详解

4. 高级特性

4.1 返回栈管理

4.2 深层链接（Deep Link）

4.3 底部导航栏集成

5. 实际项目应用

5.1 单 Activity + 多 Fragment 架构

5.2 多模块化项目

5.3 动态导航

6. 最佳实践与注意事项

7. 常见问题与解决方案

7.1 Fragment 重复创建

7.2 参数丢失

7.3 返回栈异常

7.4 多 NavHost 场景

8. 总结

上一篇：

Android Jetpack 组件库 -＞Jetpack Navigation （上）_android jetpack navigation-CSDN博客

1. Navigation 简介与背景

1.1 为什么需要 Navigation？

传统导航的问题：

 

// 传统方式 - 手动管理 Fragment

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {

        super.onCreate(savedInstanceState)

        setContentView(R.layout.activity_main)

        

        // 手动添加 Fragment

        supportFragmentManager.beginTransaction()

            .add(R.id.container, HomeFragment())

            .commit()

    }

    

    fun navigateToDetail(itemId: String) {

        // 手动处理导航逻辑

        val fragment = DetailFragment.newInstance(itemId)

        supportFragmentManager.beginTransaction()

            .replace(R.id.container, fragment)

            .addToBackStack(null)

            .commit()

    }

}

问题：

  • 代码重复且容易出错
  • 难以管理返回栈
  • 参数传递不安全
  • 难以处理深层链接
  • 测试困难

1.2 Navigation 的优势

// Navigation 方式 - 声明式导航

// 在导航图中定义

<action

    android:id="@+id/action_home_to_detail"

    app:destination="@id/detailFragment" />

// 在代码中使用

findNavController().navigate(R.id.action_home_to_detail)

优势：

  • ✅ 可视化编辑导航图
  • ✅ 类型安全的参数传递
  • ✅ 自动管理返回栈
  • ✅ 支持深层链接
  • ✅ 易于测试
  • ✅ 支持动画和转场

2. 核心概念与架构

2.1 核心组件

xml

Apply

<!-- Navigation 架构图 -->

Navigation Graph (导航图)

    ↓

NavController (导航控制器)

    ↓

NavHost (导航容器)

    ↓

NavDestination (导航目标)

详细说明：

  1. Navigation Graph（导航图）
  • 定义应用的所有导航路径
  • 可视化编辑界面
  • XML 格式存储
  1. NavController（导航控制器）
  • 管理导航操作
  • 处理返回栈
  • 执行导航动作
  1. NavHost（导航容器）
  • 显示当前目标
  • FragmentContainerView 实现
  • 管理 Fragment 生命周期
  1. NavDestination（导航目标）
  • 具体的导航目标（Fragment/Activity）
  • 包含参数定义
  • 支持深层链接

2.2 导航类型

<!-- 三种导航类型 -->

<fragment android:id="@+id/fragment_dest" />

<activity android:id="@+id/activity_dest" />

<navigation android:id="@+id/nested_nav" />

3. 基础使用与实践

3.1 项目配置

步骤1：添加依赖

// build.gradle (app)

dependencies {

    def nav_version = "2.7.5"

    

    // Navigation Fragment

    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"

    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"

    

    // Navigation Testing

    androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

}

// build.gradle (project)

plugins {

    id "androidx.navigation.safeargs.kotlin" version "2.7.5"

}

步骤2：创建导航图

<!-- res/navigation/nav_graph.xml -->

<?xml version="1.0" encoding="utf-8"?>

<navigation xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:id="@+id/nav_graph"

    app:startDestination="@id/homeFragment">

    <!-- 首页 -->

    <fragment

        android:id="@+id/homeFragment"

        android:name="com.example.app.HomeFragment"

        android:label="首页">

        

        <action

            android:id="@+id/action_home_to_detail"

            app:destination="@id/detailFragment"

            app:enterAnim="@anim/slide_in_right"

            app:exitAnim="@anim/slide_out_left" />

            

        <action

            android:id="@+id/action_home_to_profile"

            app:destination="@id/profileFragment" />

    </fragment>

    <!-- 详情页 -->

    <fragment

        android:id="@+id/detailFragment"

        android:name="com.example.app.DetailFragment"

        android:label="详情">

        

        <argument

            android:name="itemId"

            app:argType="string"

            app:nullable="false"

            app:defaultValue="0" />

            

        <argument

            android:name="itemName"

            app:argType="string"

            app:nullable="true" />

            

        <argument

            android:name="itemPrice"

            app:argType="float"

            app:nullable="true" />

    </fragment>

    <!-- 个人资料页 -->

    <fragment

        android:id="@+id/profileFragment"

        android:name="com.example.app.ProfileFragment"

        android:label="个人资料" />

</navigation>

步骤3：设置 NavHost

<!-- activity_main.xml -->

<androidx.constraintlayout.widget.ConstraintLayout 

    xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

    <androidx.fragment.app.FragmentContainerView

        android:id="@+id/nav_host_fragment"

        android:name="androidx.navigation.fragment.NavHostFragment"

        android:layout_width="0dp"

        android:layout_height="0dp"

        app:defaultNavHost="true"

        app:layout_constraintLeft_toLeftOf="parent"

        app:layout_constraintRight_toRightOf="parent"

        app:layout_constraintTop_toTopOf="parent"

        app:layout_constraintBottom_toBottomOf="parent"

        app:navGraph="@navigation/nav_graph" />

</androidx.constraintlayout.widget.ConstraintLayout>

3.2 基本导航操作

获取 NavController：

// 在 Fragment 中

class HomeFragment : Fragment() {

    private lateinit var navController: NavController

    

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {

        super.onViewCreated(view, savedInstanceState)

        

        // 方法1：通过 findNavController()

        navController = findNavController()

        

        // 方法2：通过 NavHostFragment

        navController = NavHostFragment.findNavController(this)

        

        // 方法3：通过 Activity

        navController = (activity as MainActivity).findNavController(R.id.nav_host_fragment)

    }

}

基本导航：

// 简单导航

navController.navigate(R.id.detailFragment)

// 带参数导航

val bundle = Bundle().apply {

    putString("itemId", "123")

    putString("itemName", "测试商品")

}

navController.navigate(R.id.detailFragment, bundle)

// 使用 Safe Args（推荐）

val action = HomeFragmentDirections.actionHomeToDetail(

    itemId = "123",

    itemName = "测试商品",

    itemPrice = 99.99f

)

navController.navigate(action)

3.3 参数传递详解

参数类型：

<!-- 支持的数据类型 -->

<argument android:name="stringArg" app:argType="string" />

<argument android:name="intArg" app:argType="integer" />

<argument android:name="floatArg" app:argType="float" />

<argument android:name="boolArg" app:argType="boolean" />

<argument android:name="longArg" app:argType="long" />

<argument android:name="arrayArg" app:argType="string[]" />

<argument android:name="parcelableArg" app:argType="com.example.User" />

<argument android:name="enumArg" app:argType="com.example.UserType" />

接收参数：

class DetailFragment : Fragment() {

    

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {

        super.onViewCreated(view, savedInstanceState)

        

        // 方法1：通过 arguments

        val itemId = arguments?.getString("itemId")

        val itemName = arguments?.getString("itemName")

        

        // 方法2：使用 Safe Args（推荐）

        val args = DetailFragmentArgs.fromBundle(arguments!!)

        val itemId = args.itemId

        val itemName = args.itemName

        val itemPrice = args.itemPrice

        

        // 使用参数

        updateUI(itemId, itemName, itemPrice)

    }

    

    private fun updateUI(itemId: String, itemName: String?, itemPrice: Float?) {

        // 更新界面

    }

}

4. 高级特性

4.1 返回栈管理

// 基本返回

navController.popBackStack()

// 返回到指定目标

navController.popBackStack(R.id.homeFragment, false)

// 清除返回栈并导航

navController.navigate(R.id.detailFragment) {

    popUpTo(R.id.homeFragment) { inclusive = true }

}

// 设置返回栈行为

<action

    android:id="@+id/action_home_to_detail"

    app:destination="@id/detailFragment"

    app:popUpTo="@id/homeFragment"

    app:popUpToInclusive="false" />

4.2 深层链接（Deep Link）

应用内深层链接：

<fragment

    android:id="@+id/detailFragment"

    android:name="com.example.app.DetailFragment">

    

    <deepLink

        android:id="@+id/deepLink"

        app:uri="myapp://detail/{itemId}" />

        

    <argument

        android:name="itemId"

        app:argType="string" />

</fragment>

Web 深层链接：

<fragment

    android:id="@+id/detailFragment"

    android:name="com.example.app.DetailFragment">

    

    <deepLink

        app:uri="https://myapp.com/detail/{itemId}" />

        

    <argument

        android:name="itemId"

        app:argType="string" />

</fragment>

处理深层链接：

// 在 Activity 中处理

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {

        super.onCreate(savedInstanceState)

        setContentView(R.layout.activity_main)

        

        val navController = findNavController(R.id.nav_host_fragment)

        

        // 处理深层链接

        navController.handleDeepLink(intent)

    }

}

4.3 底部导航栏集成

创建底部导航菜单：

<!-- res/menu/bottom_nav_menu.xml -->

<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item

        android:id="@+id/homeFragment"

        android:icon="@drawable/ic_home"

        android:title="首页" />

    <item

        android:id="@+id/categoryFragment"

        android:icon="@drawable/ic_category"

        android:title="分类" />

    <item

        android:id="@+id/profileFragment"

        android:icon="@drawable/ic_profile"

        android:title="我的" />

</menu>

集成底部导航：

<!-- activity_main.xml -->

<androidx.constraintlayout.widget.ConstraintLayout 

    xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

    <androidx.fragment.app.FragmentContainerView

        android:id="@+id/nav_host_fragment"

        android:name="androidx.navigation.fragment.NavHostFragment"

        android:layout_width="0dp"

        android:layout_height="0dp"

        app:defaultNavHost="true"

        app:layout_constraintLeft_toLeftOf="parent"

        app:layout_constraintRight_toRightOf="parent"

        app:layout_constraintTop_toTopOf="parent"

        app:layout_constraintBottom_toTopOf="@id/bottom_navigation"

        app:navGraph="@navigation/nav_graph" />

    <com.google.android.material.bottomnavigation.BottomNavigationView

        android:id="@+id/bottom_navigation"

        android:layout_width="0dp"

        android:layout_height="wrap_content"

        app:layout_constraintLeft_toLeftOf="parent"

        app:layout_constraintRight_toRightOf="parent"

        app:layout_constraintBottom_toBottomOf="parent"

        app:menu="@menu/bottom_nav_menu" />

</androidx.constraintlayout.widget.ConstraintLayout>

在 Activity 中设置：

        // 监听导航变化

        navController.addOnDestinationChangedListener { _, destination, _ ->

            when (destination.id) {

                R.id.homeFragment -> {

                    // 进入首页

                }

                R.id.categoryFragment -> {

                    // 进入分类页

                }

                R.id.profileFragment -> {

                    // 进入个人资料页

                }

            }

        }

    }

}

5. 实际项目应用

5.1 单 Activity + 多 Fragment 架构

  • Navigation 最适合单 Activity 架构，所有页面用 Fragment 实现，统一由 NavController 管理。
  • 例如：主界面、详情页、个人中心等都作为 Fragment，Activity 只负责承载 NavHost。

5.2 多模块化项目

  • Navigation 支持 navigation graph 嵌套，可以将不同业务模块的导航图拆分，主导航图通过 <include> 标签引入子导航图，便于团队协作和模块解耦。
<!-- 主导航图 -->

<navigation ...>

    <include app:graph="@navigation/feature_a_nav" />

    <include app:graph="@navigation/feature_b_nav" />

</navigation>

5.3 动态导航

  • 可以根据业务逻辑动态决定导航目标，例如登录后跳转到不同页面。
 

if (user.isLoggedIn) {

    navController.navigate(R.id.action_to_home)

} else {

    navController.navigate(R.id.action_to_login)

}

6. 最佳实践与注意事项

  1. 优先使用 Safe Args
  • 避免 Bundle 传参出错，提升类型安全。
  1. 合理设计导航图结构
  • 避免过深嵌套，保持导航图清晰。
  1. 处理返回栈
  • 善用 popUpTo 和 inclusive，避免页面堆积。
  1. 深层链接支持
  • 方便外部唤起和 App 内跳转。
  1. 动画与转场
  • 提升用户体验，使用自定义动画资源。
  1. 测试导航逻辑
  • 使用 Navigation Testing 库进行单元测试和 UI 测试。

7. 常见问题与解决方案

7.1 Fragment 重复创建

  • 避免在导航时重复 navigate 到同一个目标，可以先判断当前 destination。

7.2 参数丢失

  • 使用 Safe Args，避免 Bundle 传参遗漏或类型错误。

7.3 返回栈异常

  • 检查导航图中 popUpTo 配置，确保返回栈符合预期。

7.4 多 NavHost 场景

  • 多 NavHost 时要分别管理各自的 NavController，避免混淆。

8. 总结

Jetpack Navigation 组件极大简化了 Android 应用的导航开发，提升了代码的可维护性和安全性。

  • 推荐在新项目中优先采用 Navigation 组件，配合单 Activity 架构和 Safe Args 使用。
  • 合理设计导航图，充分利用深层链接、动画、返回栈等高级特性，打造高质量的用户体验。
Android 启动优化：Jetpack App Startup 库详解
移动开发前沿的博客
04-22 683
在 Android 应用开发中，启动时间是一个关键的性能指标。应用的启动速度直接影响用户体验，快速启动的应用能吸引更多用户并提高用户留存率。许多 Android 应用在启动时需要初始化大量的组件和库，这些初始化操作可能会导致启动时间过长。Jetpack App Startup 库就是为了解决这个问题而设计的，它提供了一种高效、灵活的方式来管理应用组件的初始化过程，从而优化应用的启动性能。
Android Jetpack组件库(第四部分）---Navigation
工宗浩生财指南针
06-03 1172
Android Jetpack 是 Google 推出的一整套帮助 Android 应用程序开发的库、工具包和架构指南，旨在为 Android 应用程序提供更快，更轻松，更稳定的开发体验。自推出以来已经发展成了一个庞大的技术生态系统，包括了许多使用方便、功能强大的库，以下是其中一些新特性、新组件：Paging: 分页库增加了对后端和前端数据的分页处理；Room: 数据库库 Room 的升级增加了对数据库的全面支持和更好的一致性；
Jetpack是一套由Google推出的库、工具和指南的集合，旨在帮助开发者构建高质量的Android应用程序
BLOG域名:programb.blog.csdn.net
04-26 790
首先，Jetpack提供了一系列的支持库，例如Lifecycle和LiveData，它们可以帮助管理应用的生命周期和数据，确保应用在不同情况下都能正确地保存和恢复状态。使用Jetpack的好处包括遵循最佳实践、减少样板代码、提高代码的一致性和可维护性，以及利用Android团队推荐的架构设计和编程模式来避免常见的开发陷阱和错误。最后，基础组件如ViewModel和Room也是Jetpack的一部分，它们分别用于管理UI相关的数据和简化数据库操作，进一步提升了开发效率和应用的性能。
Jetpack 库 说明
u013999263的专栏
07-12 281
jetpack
Jetpack架构组件库
wang_yong_hui_1234的博客
02-28 7225
Jetpack是众多优秀组件的集合。是谷歌推出的一套引领Android开发者逐渐统一开发规范的架构。
Jetpack架构组件库-Jetpack入门介绍
qxf865618770的博客
11-17 3469
一，初认JetpackJetpack 是 Android 软件组件的集合，使您可以更轻松地开发出色的 Android 应用。这些组件可帮助您遵循最佳做法、让您摆脱编写样板代码的工作并简化复...
Android JetPack学习系列-Navigation demo
01-02
在Android开发领域，JetPack是谷歌推出的一套组件库，旨在简化应用开发，提高代码质量，使其更加可维护和测试。本系列将聚焦于JetPack中的Navigation组件，它是一个导航解决方案，帮助开发者管理应用程序中的屏幕间...
【Android开发】基于Jetpack组件的高效开发指南：核心组件解析与实战演练Android Jetpack组件
最新发布
07-01
内容概要：本文详细介绍了Android Jetpack，阐述了其作为Google推出的组件库和工具集的重要性和优势。Jetpack涵盖多个核心组件，如Lifecycle、ViewModel、LiveData、Room、Navigation、Compose和WorkManager等，旨在...
Navigation-Component-Android:此仓库是在这里学习和练习Android Jetpack的导航组件
03-21
在本项目"Navigation-Component-Android"中，开发者可以深入理解和实践如何使用这个组件。以下将详细介绍该组件的主要功能、使用场景以及核心概念。 1. **导航组件的基本概念** - **NavController**: 负责应用程序...
Android Jetpack四大组件
huaqianzkh的专栏
08-24 1822
Android Jetpack组件共分为四大类，Foundation、Architecture、Behavior和UI。
android开发之jetpack库（1.架构组件）
变
10-09 479
题记 最近由搞framework又转到应用跟中间件来了，在写了几个小型工具型应用之后，逐渐从技术方面思考，对Android开发来说，什么样的应用才能算是高质量的应用，一个高质量的应用应该具有哪些特点？ 目前我所想到的有以下几点： 拥有适合业务方向的开发框架 高度解耦的模块 漂亮的coding风格 符合开闭原则 运行稳定 上述特点除第6之外，其余均属于在软件设计阶段就需要完成的工作；而运行稳定则是我们在开发过程中需要考虑的事情，影响一个Android应用稳定的因素有很多，常见的如oom导致系统应用cras
常用Jetpack库简析
彬_小彬的博客
07-24 928
Jetpack是一组Android软件组件库，旨在帮助开发者更轻松地构建健壮、高效且易于维护的Android应用程序。
【安卓开发系列 -- APP】JetPack -- 组件库简介
CopperSun 技术博客
09-11 1262
【安卓开发系列 -- APP】JetPack -- 组件库简介 【1】JetPack 概念 Jetpack 与 AndroidX Jetpack 是众多组件库的统称，AndroidX 是这些组件的统一包名Jetpack 的优势 Jetpack 拥有基于生命周期感知的能力，可以减少 NPE(空指针异常) 崩溃、内存泄漏，为开发出健壮且流畅的程序提供强力保障； Jetpack 可以消除大量重复样板式的代码，可以加速 Android 的开发进程，组件可搭配工作，也可单独使用，同时配合 Kotlin 语言特性能
Jetpack常用库的简单使用（一）
科科然的博客
03-12 4575
写在前面 我们经常被面试官问到，你的项目用的什么架构模式呀，MVC、MVP、MVVM ? 其实这些都是我们开发者自己设计的架构模式，非谷歌官方解决方案，我们有时候也很难把控最佳架构模式。 出于这个原因，Google官方给我们提供了Jetpack。 初识Jetpack Jetpack是一个由多个库组成的套件，可帮助开发者遵循最佳做法，减少样板代码，并编写可在各种 Android 版本和设备中一致运行的代码，让开发者集中精力编写重要的业务代码。说白了就是谷歌官方给我们开发者提供了一套解决方案，让我们的代
JetPack
T3119205的专栏
06-20 2155
最近闲来无事，写个blog吧，写什么呢，想了想还是写使用了有很长一段时间的JetPack吧，我个人还是很喜欢这套框架的，编码量少，减少样板代码，数据变化动态更新ui，管理生命周期，减少内存溢出，巴拉巴拉等等，哈哈 Jetpack是一系列库、工具、架构组成的，帮助开发人员快速方便的构建Anroid App。 Jetpack的全家福 Architecture： 设计稳健，可测试，易维护 ...
【Android-Jetpack进阶】1、JetPack 库是什么、用 LifeCycle 库管理 Activity、Fragment、Service 和 Application 的生命周期
呆呆的猫的博客
09-25 1001
Jetpack 是一个由多个库组成的套件，可帮助开发者遵循最佳做法、减少样板代码并编写可在各种 Android 版本和设备中一致运行的代码，让开发者可将精力集中于真正重要的编码工作。Jetpack 的构成，如下图所示： Jetpact 库由如下4个方面构成：Jetpack 库的 import 路径都是 androidx.xxx，例如下例的appcompact、recyclerview等库： 用 Android Studio 新建项目时，默认就会使用 Jetpack 库。可以在项目的 gradle.prope
Android Jetpack 组件最新变化，全面解析（附源码）
老皮的博客
05-27 610
前言 今年的 I/O 大会既是谷歌各种新产品发布会，同时也是谷歌开发者们的技术交流会。不少 Android 开发者希望通过本次 I/O 了解到有关 Jetpack 的最新动态。 Jetpack 早已成为我们日常开发中的必备工具，根据本次大会上发布的数据，目前 GooglePlay 排名前 1000 的应用中，使用至少两个以上 Jetpack 库的占比从 79% 提升到 90%。 ​​Android Jetpack​​ 作为 ​​Android 开发​​的关键支柱，目前它已经包含了 100 多个库、工具和指
Jetpack 介绍
ZLGSPACE的博客
01-19 1091
Jetpack是一个由多个库组成的套件，可帮助开发者遵循最佳实践、减少样板代码并编写可在各种Android版本和设备中一致运行的代码，让开发者可将精力集中于真正重要的编码工作。
Android Jetpack 系列全解析 -- 简介
话唠扇贝的博客
02-19 3558
Jetpack 是一个由多个库组成的套件，可帮助开发者遵循最佳实践、减少样板代码并编写可在各种 Android 版本和设备中一致运行的代码，让开发者可将精力集中于真正重要的编码工作。
掌握Android Jetpack 导航组件的实践仓库
在Android Jetpack Navigation中，导航库还提供了导航按钮的处理机制。开发者可以轻松地为导航栏（Navigation Bar）和抽屉式导航栏（Drawer Layout）添加动作，并且这些动作可以与NavController无缝配合。 对于使用...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值