背景

Navigation组件是Android X 依赖库中的一个导航组件，它能接替管理多Fragment之间的关系及跳转行为，提供一个清晰可见的视图管理界面来管理整个视图树

功能组成

• Navigation Graph 【导航图定义】
  • 作用：用来定义各个Fragment之间的跳转行为，
    • image.png
    • 上图表示每个Fragment均有自己的ID，同时通过红色箭头表示各个Fragment之间的跳转关系，让开发者清楚知道各个页面之间的关系，开发过程中可以通过Fragment的ID进行跳转
• NavHostFragment 【导航承载容器】
  • 作用：NavHostFragment持有一个FrameLayout，接下来Navigation Graph中的所有Fragment之间的切换都是在该容器内完成的
• NavController 【导航跳转控制器】
  • 作用：NavHostFragment在管理页面时，将页面之间的控制行为转交给NavConroller进行处理，比如控制页面相互跳转，或者参数传递，页面返回处理等

功能准备阶段

• 导航视图的申明[Navigation Graph]

  • 创建视图文件至指定目录下：app/src/main/res/navigation/xxx_navigation.xml
  • 创建视图根节点<navigation，通过app:startDestination="@+id/home_dest"指定默认显示的根布局
  • 创建视图子节点<fragment
    • 通过视图子节点的 <action节点，定义下一个需要跳转的页面，配置页面跳转时的动画
    • 通过视图子节点的<argument节点，定义当前父节点<fragment所需要的参数类型，可以定义多个<argument节点
    • 通过视图子节点的<deeplink节点，申明外部可以通过deeplink协议直接跳转到当前<fragment上，不需要额外过多的处理
  • 导航视图的整体节点图

    <navigation
       <fragment
            <action
            <argument
            <deeplink
    

• 导航承载容器的申明[NavHostFragment]

  • 在Activity的布局中，申明NavHostFragment，并关联 Navgation Graph，该视图树默认显示的页面是<navgation节点中的app:startDestination="@+id/home_dest"对应的fragment

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

基本功能

页面跳转 - 两种方式

• 通过 destinationId的方式跳转
  • 定义

           <fragment
                 android:id="@+id/flow_step_one_dest"  
                 android:name="com.example.android.codelabs.navigation.FlowStepFragment"
                 tools:layout="@layout/flow_step_one_fragment"/>
    

  • 跳转逻辑

        findNavController().navigate(R.id.flow_step_one_dest)
    

• 通过 actionid的方式跳转
  • 定义

           <fragment
              <action
                    android:id="@+id/next_action"
                    app:destination="@+id/flow_step_one_dest"
                    app:enterAnim="@anim/slide_in_right"
                    app:exitAnim="@anim/slide_out_left"
                    app:popEnterAnim="@anim/slide_in_left"
                    app:popExitAnim="@anim/slide_out_right" />
          </fragment>
    

  • 跳转逻辑 这时候会找到action对应的destinationid，然后再进行跳转

           view.findViewById<Button>(R.id.navigate_action_button)?.setOnClickListener(
                   Navigation.createNavigateOnClickListener(R.id.next_action, null) 
           )
    

参数传递 - 两种方式

• 代码传递

  •     val bundle = Bundle()
        bundle.putString("name", "netease")
        findNavController().navigate(R.id.flow_step_one_dest, bundle)
    

• 通过布局文件的argument节点传递数据
  • 布局文件

        <navigation 
            <fragment android:id="@+id/flow_step_two_dest">        
                   <argument
                          android:name="name"
                          android:defaultValue="defaultName"
                          app:argType="string" />
            </fragment>
    

  • 代码传递

       val args = FlowStepFragmentArgs("netease")
       findNavController().navigate(R.id.flow_step_two_dest, args.toBundle())
    

参数保存

• 通过ViewModel来保存数据
• 在Fragment.onDestoryView中，将数据保存至Arguments中

进阶使用

• deeplink打开指定页面，指定回退的页面
• 和ToolBar的联合使用

存在的坑

• 在进行页面切换时，需要保证切换前后的两个页面都在Navigation Graph中，否者无法获取NavController对象，导致页面切换失败
• fragment切换的实现是通过replace来完成的，也就是说会销毁视图，这里就需要我们自己手动对数据进行保存

参考文献

Android官方架构组件Navigation
官方文档