FragmentStack

Introduction: A simple and easy to use a single Activity hosting multiple Fragment Library
More: Author   ReportBugs   
Tags:

一个封装了启动模式的 Fragment 便捷使用库,方便构建单 Activity+多 Fragment 轻量级框架。

一 为什么要写这个库

1.Fragment 创建速度完胜 Activity,在长期的开发实践中,明显感觉到 Fragment 响应速度,内存占用等方面拥有巨大的优势,将页面 fragment 化有助于提升 app 流畅度;

2.fragment 创建和使用相比 Activity 更加麻烦,其中,回退栈管理,动画,关闭,隐藏等不便于使用,需要进一步封装提升效率;

3.fragment 缺少启动模式,使得管理起来很有难度,很多在 Activity 上很常见的需求在 Fragment 使用需要更多更复杂的技巧,不利于快速开发;

二 它能为你做什么

1.替代传统的 Activity 页面,轻量化页面;

2.开启,关闭,动画,回退栈,生命周期回调等操作更加方便,一行代码即可搞定;

3.自带 Activity 四种启动模式,接管了系统的回退栈,很常见的场景,如 用户中心--->注册用户--->注册成功--->返回原来的用户中心,就可以设置启动模式为 singleTask,注册成功后退出当前任务栈,或者设置用户中心 singleInstance,直接 new 创建后再 onNewInstance()方法中更新数据即可,框架自动 remove 上层 fragment;

三 配置和开始使用

对于如何导入,也是相当的简单,android studio 的用户,直接:

project build.gradle 加入 jitpack

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

项目的 build.gradle 加入
compile 'com.github.Mr-wangyong:FragmentStack:v1.0.2'

然后,在你的项目中,MainActivity 继承 RootActivity

public class MainActivity extends RootActivity {

    @Override
    protected RootFragment getRootFragment() {
        return new HomeFragment();
    }

    @Override
    public void onCreateNow(Bundle savedInstanceState) {
        setAnim(R.anim.next_in, R.anim.next_out, R.anim.quit_in, R.anim.quit_out);
    }
}

Fragment 继承 RootFragment

public class HomeFragment extends RootFragment{

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {

    }
}

接下来,可以自由方便的使用 Fragment 了;

四 API 说明

1.打开一个新的 Fragment;

常规方式

open(new Fragment());

带参形式

open(new Fragment());
在新 Fragment 中用 Bundle bundle = getArguments();获取

带启动模式形式,支持四种启动模式(实际项目中以 singleTask 最为实用);

open(new Fragment1(), null, StackManager.STANDARD);
open(new Fragment1(), null, StackManager.SINGLE_TOP);
open(new Fragment1(), null, StackManager.SINGLE_TASK);
open(new Fragment1(), null, StackManager.SINGLE_INSTANCE);

关闭当前的 fragment

close()

关闭指定的 Fragment

close(fragment)

设置页面切换动画

setAnim(R.anim.next_in, R.anim.next_out, R.anim.quit_in, R.anim.quit_out);

进入下一个页面,两个页面的回调,只需重写

private void onNowHidden() {

}

private void onNextShow() {

}

Fragment 获取依赖的 Activity

RootActivity root = getRoot();

singleTop,fragment 被重复创建的回调

@Override
public void onNewIntent() {
}

若需要监听按键事件,只需设置 setKeyCallBack

setKeyCallBack(new KeyCallBack() {
        @Override
        public boolean onKeyDown(int keyCode, KeyEvent event) {
            return false;
        }
    });

使用效果:

Pull Requests 与 Issues

欢迎大家发现问题与共同维护该项目,喜欢就 Star 吧,后面会扩展更多实用功能

Author

Mr.wang

感谢

[钟白兔]建立一个属于自己的框架

[Harlber] Github

此框架已在本公司商业项目使用:

南瓜电影http://www.wandoujia.com/apps/cn.vcinema.cinema

Support Me
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea