Android Jetpack之Navigation的使用

五月份的Google I/O大会,Google推出了Android Jetpack架构组件,以帮助开发者构建更加优质的应用,Jetpack包含了以下组件

  • Navigation

用于管理APP页面跳转导航,切换fragment更加直观,可视化界面展示fragment的切换流程图

  • WorkManager

WorkManager API可以轻松指定可延迟的异步任务以及何时运行它们。 这些API允许您创建任务并将其交给WorkManager立即运行或在适当的时间运行。 例如,应用可能需要不时从网络下载新资源。 使用这些类,您可以设置任务,为其运行选择适当的环境(例如“仅在设备正在充电和在线”时),并将其交给WorkManager以在满足条件时运行。 即使您的应用程序强制退出或设备重新启动,该任务仍可保证运行。

  • LifeCycle

每个 Android 开发者都应该面对过生命周期问题,即操作系统启动、停止和销毁 Activity。这意味着开发者需要根据生命周期的不同阶段,有针对性地管理组件状态,比如用于更新用户界面的可观察对象。生命周期管理(Lifecycles)帮助开发者创建 “可感知生命周期的” 组件,让其自己管理自己的生命周期,从而减少内存泄露和崩溃的可能性。生命周期库是其他架构组件(如 LiveData)的基础。

  • Paging

简单来说,其实就是一个官方的分页加载数据框架

  • Room

Room persistence库为SQLite提供了一个抽象层,以便在利用SQLite的全部功能的同时实现更强大的数据库访问。

navigation

本篇文章主要阐述Navigation如何管理TestNavigationActivity中的FragmentA、FragmentB、FragmentC三个fragment,以及fragment之间数据传递

注意:目前jetpack架构组件需要运行在Android Studio 3.2以上

navigation导航文件

在APP的res目录下,创建一个navigation文件夹,在此文件夹下新增一个navigation
的xml文件,此处新增一个 test_navi.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"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/test_navi"
    app:startDestination="@id/fragmentA">
    <fragment
        android:id="@+id/fragmentA"
        android:name="ywq.ares.jetpacklearning.ui.main.navigation.FragmentA"
        android:label="fragmentA"
        tools:layout="@layout/fragmentA">

        <action
            android:id="@+id/action_fragmentA_to_fragmentB"
            app:destination="@id/fragmentB"
            app:exitAnim="@android:anim/slide_out_right" />
    </fragment>
    <fragment
        android:id="@+id/fragmentB"

        android:name="ywq.ares.jetpacklearning.ui.main.navigation.FragmentB"
        android:label="fragmentB"
        tools:layout="@layout/fragmentB">
        <argument android:name="title" app:type="string" android:defaultValue="test"/>
        <argument android:name="num" app:type="integer" android:defaultValue="100"/>
        <action
            android:id="@+id/action_fragmentB_to_fragmentC"
            app:destination="@id/fragmentC"
            app:exitAnim="@android:anim/slide_out_right" />
    </fragment>
    <fragment
        android:id="@+id/fragmentC"

        android:name="ywq.ares.jetpacklearning.ui.main.navigation.FragmentC"
        android:label="fragmentC"
        tools:layout="@layout/fragmentC">
        <action
            android:id="@+id/action_fragmentC_to_fragmentA"
            app:destination="@id/fragmentA"
            app:exitAnim="@android:anim/slide_out_right" />
    </fragment>
</navigation>

很明显,这是一个用于管理fragment跳转意图的文件

  • navigation根节点 startDestination 表示第一个显示的fragment
app:startDestination="@id/fragmentA"
  • fragment 节点
    • name属性表示所属的fragment类
    • action 节点 destination属性用于指定下一个目标fragment、进入退出动画等
    • argument 用于传递数据(下面会讲)

在AS中,在navigation界面点击Design标签,可以看到非常直观的fragment切换流程

image.png

创建TestNavigationActivity

提示:必须继承AppCompatActivity 或 FragmentActivity 否则会报以下异常

java.lang.RuntimeException: Unable to start activity ComponentInfo{ywq.ares.jetpacklearning/ywq.ares.jetpacklearning.ui.main.navigation.TestNavigationActivity}: android.view.InflateException: Binary XML file line #9: Binary XML file line #9: Error inflating class fragment
....
Caused by: android.app.Fragment$InstantiationException: Trying to instantiate a class androidx.navigation.fragment.NavHostFragment that is not a Fragment

activity布局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"> 
    <fragment
        android:id="@+id/fragment_first2"
        app:navGraph="@navigation/test_navi"
        android:name="androidx.navigation.fragment.NavHostFragment"
        app:defaultNavHost="true"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</LinearLayout>

其中fragment必须设置id,否则会报错

Caused by: java.lang.IllegalArgumentException: Binary XML file line #9: Must specify unique android:id, android:tag, or have a parent with an id for androidx.navigation.fragment.NavHostFragment

navGraph 用来指定上面的导航意图文件 test_navi.xml

 app:navGraph="@navigation/test_navi"

name 必须指定为以下值,表示这是一个可以切换fragment的控件

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

假如你指定了其他fragment,会报以下错误

Caused by: java.lang.IllegalStateException: Fragment FirstFragment{b0bdbe5 #0 id=0x7f08004e} does not have a NavController set

defaultNavHost 表示是否拦截返回键,默认为false, 假如页面处于第二个fragment,这是按下返回键,会退出当前activity而不是回到上一个fragment。true则反之

app:defaultNavHost="true"

切换fragment

从FragmentA切换到FragmentB,以前的方式

getSupportFragmentManager().beginTransaction().show(fragmentB).hide(fragmentA).commit();

通过Navigation的方式

//在fragmentA中调用
NavHostFragment.findNavController(fragmentA).navigate(R.id.action_fragmentA_to_fragmentB)
//假如是通过点击某个按钮进行切换的话,也可以通过以下方式,id为目标fragment的id
jumpBtn.setOnClickListener(Navigation.createNavigateOnClickListener(R.id.fragment_third));

数据传递

那么fragmentA如何传递数据到fragmentB呢?

  1. 传统方式

//fragmentA传递
var bundle = Bundle()
bundle.putString("title","xixi")
bundle.putInt("num",200)
NavHostFragment.findNavController(fragmentA).navigate(R.id.action_fragmentA_to_fragmentB,bundle)
//fragmentB接收 
val title = arguments?.getString("title")
val num = arguments?.getString("num")
 

以上方式存在一个弊端,就是接收方必须知道对应的key才能正确接收对应的值,这在团队协作上是极其不方便的。

  1. Navigation组件提供的方式,安装插件,编译自动生成参数对象

项目根目录的builde.gradle文件

dependencies {
      ...
      classpath 'android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0-alpha02'
        ...
}

app目录的build.gradle文件

apply plugin: 'androidx.navigation.safeargs'

在文章开头,navigation导航文件中可以设置fragment所接收的参数

<fragment
    android:id="@+id/fragmentB"

    android:name="ywq.ares.jetpacklearning.ui.main.navigation.FragmentB"
    android:label="fragmentB"
    tools:layout="@layout/fragmentB">

<argument android:name="title" app:type="string" android:defaultValue="test"/>
<argument android:name="num" app:type="integer" android:defaultValue="100"/>
</fragment>

rebuild项目,会自动生成对应的参数类(规则:fragment的类名+Args),上面那个fragment生成的参数类为FragmentBArgs

//fragmentA传递
val arg = FragmentBArgs.Builder()
arg.title = "haha"
arg.num = 100
NavHostFragment.findNavController(this).navigate(R.id.action_fragment1_to_fragment2,arg.build().toBundle())
//fragmentB接收
val args = SecondFragmentArgs.fromBundle(arguments)
val title = args.title
val num = args.num

相对于传递方式,这种方式能够非常清晰明了fragment所有需要接收的参数类型,不用担心字符串拼错而导致传递无法接收的问题

遗留问题

尽管通过Navigation方式管理Fragment的代码简洁而且直观,但是有一个非常致命的问题,就是同一个Fragment会被重复创建,这样会导致每次切换fragment的时候都会重新去请求数据,非常浪费系统资源,而且降低了APP的用户体验,目前还找不到解决方案,大概以后官方会解决这个问题吧~

下一篇,我们来讲一讲Jetpack架构组件中的WorkManager的用法