美文网首页
Jetpack Navigation的使用

Jetpack Navigation的使用

作者: o蚂蚁上树o | 来源:发表于2019-09-27 19:16 被阅读0次

    背景


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

    相关文章

      网友评论

          本文标题:Jetpack Navigation的使用

          本文链接:https://www.haomeiwen.com/subject/pgaiuctx.html