Fragmentation

A powerful library that manage Fragment for Android!

English README

为"单Activity ＋ 多Fragment","多模块Activity + 多Fragment"架构而生，帮你大大简化使用过程，轻松解决各种复杂嵌套等问题，修复了官方Fragment库中存在的一些BUG。

为了更好的使用和了解该库，推荐阅读下面的文章:

Fragment全解析系列（一）：那些年踩过的坑

Fragment全解析系列（二）：正确的使用姿势

Demo演示：

均为单Activity + 多Fragment，第一个为简单流式demo，第二个为仿微信交互的demo(全页面支持滑动退出)，第三个为仿知乎交互的复杂嵌套demo

   

特性

1、有效解决各种复杂嵌套、同级等Fragment重叠问题

2、实时查看Fragment的(包括嵌套Fragment)栈视图的对话框和Log，方便调试

3、增加启动模式、startForResult等类似Activity方法

4、类似Android事件分发机制的Fragment回退方法：onBackPressedSupport()，轻松为每个Fragment实现Back按键事件

5、New！！！ 提供onSupportVisible()等生命周期方法，简化嵌套Fragment的开发过程； 提供统一的onLazyInitView()懒加载方法

6、提供可轻松 设定Fragment转场动画 的解决方案

7、修复官方库里pop(tag/id)出栈多个Fragment时的一些BUG

8、支持SwipeBack滑动边缘退出(需要使用Fragmentation_SwipeBack库,详情README)

      

重大更新日志

0.8.X 来了！ 详情点这里

0.8.5更新日志：

• Fix 同时点击操作 不同栈层级的Fragment事务时，可能导致的防抖动失效问题

0.8.4更新日志：

• Fix点击Back键过快时，同一onBackPressedSupport()重复调用的问题；
• 为提升特殊情况下的稳定性，库中事务commit模式改为commitAllowingStateLoss()； 同时对于正常情况下的使用错误，会以警告形式提示:Can not perform this action after onSaveInstanceState!

1、提供onSupportVisible(),onSupportInvisible()等生命周期方法，简化嵌套Fragment的开发过程；

2、提供统一的onLazyInitView()懒加载方法；

3、SupportActivity提供registerFragmentLifecycleCallbacks()来监控其下所有Fragment的生命周期；

4、可以自定义Tag了！

5、start()方法可以指定commit的方式了：commitAllowingStateLoss(),commitImmediate()

---

0.7.X

1、2个新demo: 仿知乎交互 ＋ 仿微信交互的新Demo，展示复杂嵌套Fragment的交互场景

2、支持同级Fragment的处理

3、全新的类似Android事件分发机制的onBackPressedSupport()

如何使用

1. 项目下app的build.gradle中依赖：

// appcompat v7包是必须的
compile 'me.yokeyword:fragmentation:0.8.5'
// 如果想使用SwipeBack 滑动边缘退出Fragment/Activity功能，请再添加下面的库
// compile 'me.yokeyword:fragmentation-swipeback:0.7.9'

2. Activity继承SupportActivity：

public class MainActivity extends SupportActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(...);
        if (savedInstanceState == null) {
            loadRootFragment(R.id.fl_container, HomeFragment.newInstance());  
        }
    }

3. Fragment继承SupportFragment：

public class HomeFragment extends SupportFragment {

    private void xxx() {
        // 启动新的Fragment, 另外还有start(fragment,SINGTASK)、startForResult、startWithPop等启动方法
        start(DetailFragment.newInstance(HomeBean));
        // ... 其他pop, find, 设置动画等等API, 请自行查看WIKI
    }
}

进一步使用，查看wiki

最后

有任何问题欢迎提issue或发邮件一起探讨，欢迎Star，Fork，PR！