A powerful library that manage Fragment for Android!
Java
Latest commit 4ded434 Jan 16, 2017 @YoKeyword Update to 0.9.5

README.md

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 App

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

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

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

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

6、提供靠谱的 Fragment转场动画 的解决方案

7、更强的兼容性, 解决多点触控、重叠等问题

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

      

TODO

  • 栈视图悬浮球
  • Activity侧滑返回:更换实现方式
  • Fragment侧滑返回:实现视觉差效果
  • replace进一步的支持
  • Fragment路由module

重大更新日志

0.9.X 来了! 详情点这里

v0.9.5: Fix showHideFragment()可能hide一个null对象的问题 v0.9.3: Fix onLazyInitView()完全兼容ViewPager

1、解决多点触控问题

2、onFragmentResult()现在在任何情况都可以被正确触发了

3、更强的兼容性,解决已知BUG

4、对于25.1.0+的 v4包,完善了SharedElement!

0.8.X 来了!

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

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

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

4、可以自定义Tag了!

5、事务提交模式默认为commitAllowingStateLoss().

如何使用

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

// appcompat v7包是必须的
compile 'me.yokeyword:fragmentation:0.9.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!