Jetpack - Navigation

原创已于 2025-08-23 22:58:42 修改 · 1k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#android jetpack

于 2021-11-29 16:33:28 首次发布

Jetpack 专栏收录该内容

16 篇文章

订阅专栏

Android Navigation组件简化了在单Activity应用中管理Fragment的切换，通过可视化编辑器设计导航图，实现更直观的App流程。它不是替代startActivity，而是替代FragmentTransaction。本文介绍了如何添加依赖、创建Navigation资源文件、在布局中配置NavHostFragment，以及如何处理跳转、传递参数和返回操作。

官方指南

点击跳转 Compose 使用方式

一、概念

“一个APP只需要一个Activity”，少用Activity多用Fragment

用来管理Fragment的切换，并且可以通过可视化的方式，看见App的交互流程。这完美的契合了Jake Wharton大神单Activity的建议。所以说它并不是用来代替 startActivity，而是用来代替 FragmentTransaction 的相关操作。

名词	释义
Navigation Graph	Navigation资源文件，用户切换到可视化界面可以查看各个界面跳转路线
NavHostFragment	当前Fragment的容器
NavController	导航的控制者

二、使用

2.1 添加依赖

2.2 创建导航图

（打开 Settings -> Experimental -> Enable Navigation Editor，没有该选项就无视）

在 res 目录右击，选择 New > Android Resource Directory，Resource type 选择 navigation。再在 navigation 文件夹上右键，选择 New > Navigation Resource File。

节点	标签	说明
<navigation>	app:startDestination	通过 @id 设置默认显示的 Fragment
<activity / fragment>	android:name	指定的 Activity/Fragment 文件的包名路径
	android:label	别名
	tools:layout	指定的 Activity/Fragment 的布局文件
<action>	android:id	代码跳转时要用到这个 ID
<action>	app:destination	要跳转到的目标 fragment ID

2.3 添加控件

android:name	固定写法，声明这是一个 NavHostFragment
app:navGraph	指定 Navigation 资源文件
app:defaultNavHost	让 Navigation 处理返回事件，而不是 finish 掉 Activity

<FragmentContainerView
    android:id="@+id/navHost"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:defaultNavHost="true"
    app:navGraph="@navigation/nav" />

2.4 跳转

通过 NavController 对象的 navigate()方法跳转，通过bundle传参。如果跳转到 Activity，可以从 intent.extras 获取到 bundle，如果是 Fragment，则从 getArguments() 获取到。

NavController

三种获取方法

NavHostFragment.findNavController(Fragment)

在Fragment中使用

Navigation.findNavController(Activity activity, int viewId)

在Activity中使用，id指向NavHostFragment

Navigation.findNavController(View view)

在Activity中使用，view是findViewById出来的NavHostFragment

Bundle bundle = new Bundle()
bundle.putString("name", "SouthernBox")
NavHostFragment.findNavController(this).navigate(R.id.action_firstFragment_to_secondFragment, bundle)

2.5 返回

navigateUp()	只能一级一级返回，底层使用的下面这个
popBackStack()	可以指定跳转

2.6 传递参数

AFragment() {
    Bundle args = new Bundle();
    args.putString("userName", "张三");
    Navigation.findNavController(getView()).navigate(R.id.action_AFragment_to_BFragment, args);
}

BFragment{
    String ueserName = getArguments().getString("userName");
}