Skip to content

Latest commit

 

History

History
229 lines (150 loc) · 5.77 KB

README.md

File metadata and controls

229 lines (150 loc) · 5.77 KB

FragmentNav - Start and manage fragment simpler

FragmentNav可以让你像启动activity一样方便启动的fragment,基于Task的管理方式让你可以方便的按需求来一次性启动/结束多个fragment。

功能

  • 基于Task的管理方式
  • 支持批量启动/结束fragments
  • 支持BringToFront操作
  • 自动保存在Activity.onSaveInstanceState之后执行的commit操作以及当App还原时自动执行相应操作
  • 支持startFragmentForResult操作

准备

1、添加依赖

compile 'ray.easydev.fragmentnav:fragmentnav:0.1.2'

2、创建一个Activity继承FnFragmentActivity或FnAppCompatActivity,以继承FnFragmentActivity为例:

MainActivity.java
public class MainActivity extends FnFragmentActivity {
    static {
        //Configure the default fragment animations
        FragmentIntent.getDefault().setAnim(
          R.anim.page_start, //animation for start a fragment
          R.anim.page_finish, //animation for finish a fragment
          R.anim.page_show, //animation for show the previous fragment when finish a fragment
          R.anim.page_hide //animation for hide the fragment when start a new fragment
        );
    }

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public int getFragmentContainerId() {
      	//The id of ViewGroup that contains fragments
        return R.id.fragment_container;
    }

    @NonNull
    @Override
    public FragmentIntent[] getStartIntents() {
      	//Configure the enter fragments
        return new FragmentIntent[]{
                new FragmentIntent(FmEnter.class)
                  //Disable the start animation to avoid the conflict with the activity's start animation
                  .addFlag(FragmentIntent.FLAG_NO_START_ANIMATION)
        };
    }
}

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
             android:id="@+id/fragment_container"
             android:layout_width="match_parent"
             android:layout_height="match_parent"/>

或者,你可以实现你自己的Activity,例如:

public class MyActivity extends FragmentActivity implements FnActivity {
    private FragmentNav mFragmentNav;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        //FragmentNav must be created before super.onCreate
        mFragmentNav = FragmentNavHelper.createBeforeSuperOnCreate(this, R.id.fragment_container, savedInstanceState);

        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if(savedInstanceState == null){
            //If this app is not in recovery, start a new fragment
            mFragmentNav.startFragment(null, new FragmentIntent(FmEnter.class)
                    .addFlag(FragmentIntent.FLAG_NO_START_ANIMATION));
        }
    }

    @NonNull
    @Override
    public FragmentNav getFragmentNav() {
        return mFragmentNav;
    }

    @Override
    public void onBackPressed() {
        //Pass back pressed event to FragmentNav
        FragmentNavHelper.onBackPressed(getFragmentNav());
    }
}

3、继承FnFragment实现自己的Fragment

class FmEnter extends FnFragment {
  
}

开始愉快的使用FragmentNav吧😀

用法

启动一个fragment

 //Create a fragment intent with a string extra
 FragmentIntent fragmentIntent = new FragmentIntent(Fm01.class).
                     putExtra(KEY_STRING, "StringExtra");
      //Start the fragment
      startFragment(fragmentIntent);
 

结束单个fragment

//类似结束activity,调用finish方法即可结束当前fragment
finish();

批量启动fragment

//Create a intent to start fragment11 in new task
FragmentIntent intent11 = new FragmentIntent(Fm11.class)
  	.addFlag(FragmentIntent.FLAG_NEW_TASK);
//This fragment will be started in the same task with fragment11
FragmentIntent intent12 = new FragmentIntent(Fm12.class);

//This intent describe fragment21 will be started in another new task
FragmentIntent intent21 = new FragmentIntent(Fm21.class)
     .addFlag(FragmentIntent.FLAG_NEW_TASK);

//Start fragments, only fragment21's start animation will be played
startFragment(intent11, intent12, intent21);

###结束fragment task

//Finish the task current fragment belongs
finishTask();

//Finish the tasks by task id. You can get task id by FragmentNav.taskIds() or FragmentNav.getTaskId()
getFragmentNav().finishTasks(0, 1, 2)

BringToFront

//Bring fragment02 to front if it exists in tasks, else start a new one
startFragment(new FragmentIntent(Fm02.class).addFlag(FragmentIntent.FLAG_BRING_TO_FRONT));

单元测试

目前已经对主要实现逻辑进行了单元测试,结果如下,没有测试到的主要是一些Exception处理分支和一些暂未开放的功能,后续会尽量补上。

test_coverage

兼容性测试结果如下:

Android Sdk Version Android Support Version
4.2.2, 4.4.4, 5.1, 6.0.1, 7.0 24.2.1, 25.3.0, 26.1.0

Todo

  • Activity.onSaveInstanceState后commit的操作持久化到本地以支持App还原时执行

  • 支持NO_HISTORY方式启动

  • More (you tell me😀)...

Versions

Version 0.1.2 18012601
  • Add FnFragment.getTaskId() method
  • Add FragmentNav.findFragment(Class<? extends FnFragment> cls, int directionFlags) method
  • Improve unit test and sample app
Version 0.1.1 18011801
  • startFragmentForResult support start multiple fragments at once
Version 0.1.0 17121901
  • first working prototype