Jetpack Navigation的使用

背景

---

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
  • 创建视图根节点，通过app:startDestination="@+id/home_dest"指定默认显示的根布局
  • 创建视图子节点
    • 通过视图子节点的 节点，定义下一个需要跳转的页面，配置页面跳转时的动画
    • 通过视图子节点的节点，定义当前父节点所需要的参数类型，可以定义多个节点
    • 通过视图子节点的节点，申明外部可以通过deeplink协议直接跳转到当前上，不需要额外过多的处理
  • 导航视图的整体节点图

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

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

基本功能

页面跳转 - 两种方式

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

  • 跳转逻辑

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

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

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

           view.findViewById(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节点传递数据
  • 布局文件

  • 代码传递

       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
官方文档