# Fragmentation

**Repository Path**: zhaomiyin/Fragmentation

## Basic Information

- **Project Name**: Fragmentation
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-01-17
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fragmentation
A powerful library that manage Fragment for Android!

## [English README](https://github.com/YoKeyword/Fragmentation/blob/master/README_EN.md)

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

![](/gif/logo.png)


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

[Fragment全解析系列（一）：那些年踩过的坑](http://www.jianshu.com/p/d9143a92ad94)

[Fragment全解析系列（二）：正确的使用姿势](http://www.jianshu.com/p/fd71d65f0ec6)


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

<img src="/gif/demo.gif" width="280px"/>&emsp;<img src="/gif/wechat.gif" width="280px"/>
&emsp;<img src="/gif/nested.gif" width="280px"/>

# 特性

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](https://github.com/YoKeyword/Fragmentation/blob/master/fragmentation_swipeback/README.md))**

<img src="/gif/log.png" width="400px"/>&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;<img src="/gif/SwipeBack.jpg" width="150px"/>

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

# 重大更新日志
### 0.9.X 来了！ [详情点这里](https://github.com/YoKeyword/Fragmentation/wiki/Home)

**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中依赖：**
````gradle
// appcompat v7包是必须的
compile 'me.yokeyword:fragmentation:0.9.5'
// 如果想使用SwipeBack 滑动边缘退出Fragment/Activity功能，请再添加下面的库
// compile 'me.yokeyword:fragmentation-swipeback:0.7.9'
````

**2. Activity继承SupportActivity：**
````java
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：**
````java
public class HomeFragment extends SupportFragment {

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

### [进一步使用，查看wiki](https://github.com/YoKeyword/Fragmentation/wiki)

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