JetPack之Navigation实战

Navigation 直接翻译即为导航,它是 Android Jetpack 组件之一,让单 Activity 应用成为首选架构。应用内Fragment页面的跳转则由 Navigation 来处理,开发者无需在处理 FragmentTransaction 的复杂性以及相关的转场动画。

相比之前Fragment的管理需要借助FragmentManager和FragmentTransaction,使用Navigation组件有如下一些优点:

1.可视化的页面导航图,方便我们理清页面之间的关系
2.通过destination和action完成页面间的导航
3.方便添加页面切换动画
4.页面间类型安全的参数传递
5.通过Navigation UI类,对菜单/底部导航/抽屉蓝菜单导航进行统一的管理

实战完成效果

使用Navigation

1. 引入依赖

在app的gradle.build中添加依赖:

    nav_version=2.5.0

    // Kotlin
    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
2. 了解组成
  • Navigation graph
    一个包含所有导航相关信息的 XML 资源
    xml 档,包含所有被管理的 Fragment,起始目标,换页目标,返回目标。

  • NavHostFragment
    一种特殊的Fragment,用于承载导航内容的容器

  • NavController
    用来管理 NavHost 中的导航动作,通常是写在点击事件内完成 Fragment 的切换。

findNavController().navigate(R.id.action_Fragment1_to_Fragment2)
3.开始接入

1.右键res,点击New -> Android Resource Directory
2.在出现的面板第二行Resource type 下拉列表中选择 Navigation,然后点击 OK
3.res目录下会多出一个navigation的资源目录,右键该目录,点击New -> Navigation Resource File,输入需要新建的资源文件名,这里命名nav_graph,点击ok,一个nav_graph.xml就创建好了。

新建好的nav_graph.xml切换到design模式下,点击2处的加号,选择Create new destination,即可快速创建新的Fragment。或者直接引用已有的fragment做管理。

建好后,可通过手动配置页面之间的跳转关系,点击某个页面,右边会出现一个小圆点,拖曳小圆点指向跳转的页面,这里设置跳转的关系为FragmentA -> FragmentB。

<?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/navigation_home">

    <fragment
        android:id="@+id/navigation_home"
        android:name="com.example.flowmvihilt.ui.main.MainFragment">

        <action android:id="@+id/action_to_artical"
            app:destination="@id/articalFragment"/>
    </fragment>
    <fragment
        android:id="@+id/navigation_qa"
        android:name="com.example.flowmvihilt.ui.main.MainFragment" />
    <fragment
        android:id="@+id/navigation_system"
        android:name="com.example.flowmvihilt.ui.main.MainFragment"
        android:label="MainFragment" />
    <fragment
        android:id="@+id/navigation_mine"
        android:name="com.example.flowmvihilt.mine.MeFragment"/>
    <fragment
        android:id="@+id/articalFragment"
        android:name="com.example.flowmvihilt.mine.ArticalFragment"/>
</navigation>

navigation是根标签,通过startDestination配置默认启动的第一个页面,这里配置的是FragmentA
fragment标签代表一个fragment,其实这里不仅可以配置fragment,也可以配置activity,甚至还可以自定义
action标签定义了页面跳转的行为,相当于上图中的每条线,destination定义跳转的目标页,还可以定义跳转时的动画等等
当调用到 action_FragmentA_to_FragmentB2 这个 action,会从 FragmentA -> FragmentB

在Activity的布局文件中配置NavHostFragment和BottomNavigationView
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools">

    <data>

    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".MainActivity">

        <androidx.fragment.app.FragmentContainerView
            android:id="@+id/nav_host_fragment"
            android:name="androidx.navigation.fragment.NavHostFragment"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:defaultNavHost="true"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="parent"
            app:navGraph="@navigation/nav_graph" />

        <com.google.android.material.bottomnavigation.BottomNavigationView
            android:id="@+id/nav_view"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            app:labelVisibilityMode="labeled"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            app:itemBackground="@null"
            app:menu="@menu/bottom_nav_menu" />

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

android:name指定NavHostFragment
app:navGraph指定导航视图,即建好的nav_graph.xml
app:defaultNavHost=true意思是可以拦截系统的返回键,按返回键可以回到上一个页面

menu文件:
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/navigation_home"
        android:icon="@drawable/ic_launcher_foreground"
        android:title="@string/home_page" />

    <item
        android:id="@+id/navigation_qa"
        android:icon="@drawable/ic_launcher_foreground"
        android:title="@string/q_a" />

    <item
        android:id="@+id/navigation_system"
        android:icon="@drawable/ic_launcher_foreground"
        android:title="@string/system" />

    <item
        android:id="@+id/navigation_mine"
        android:icon="@drawable/ic_launcher_foreground"
        android:title="@string/mine" />
</menu>
将Navigation与BottomNavigationView关联
        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
        navView.setupWithNavController(navHostFragment.findNavController())
通过NavController 管理fragment之间的跳转
findNavController().navigate(R.id.action_to_artical)

navigate方法传入配置的某个action来进行跳转。

跳转传递参数
            var args = Bundle()
            args.putString("params", "params")
            Navigation.findNavController(btnHome).navigate(R.id.fragment_home_to_fragment_msg, args)
目标页接收参数:
var params = arguments?.getString("params")
导航文件拆分

如果项目越来越大,页面越来越多,所有的都放在一个文件中会非常的臃肿,当Action非常复杂的时候会非常的混乱。那么可创建多个navigation.xml进行导航。

Deeplink导航

Navigation也能通过Deeplink进行跳转。如下:

findNavController().navigate(Uri.parse("schema://webview.fragment"))

参考:
https://blog.csdn.net/JMW1407/article/details/125714708
https://blog.csdn.net/lcl130/article/details/108422026

Github代码地址:

https://github.com/running-libo/MviFlowHilt/tree/master

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,902评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,037评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,978评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,867评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,763评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,104评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,565评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,236评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,379评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,313评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,363评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,034评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,637评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,719评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,952评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,371评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,948评论 2 341

推荐阅读更多精彩内容