README_CN.md

Fragmentation

A powerful library that manage Fragment for Android!

为"单Activity ＋ 多Fragment","多模块Activity + 多Fragment"架构而生，简化开发，轻松解决动画、嵌套、事务相关等问题。

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

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

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

Demo演示：

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

下载APK

   

特性

1、可以快速开发出各种嵌套设计的Fragment App

2、悬浮球／摇一摇实时查看Fragment的栈视图Dialog，降低开发难度

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

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

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

6、提供 Fragment转场动画 系列解决方案，动态更换动画

7、支持SwipeBack滑动边缘退出(需要使用Fragment｀ation_SwipeBack库,详情README)

     

如何使用

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

// appcompat-v7包是必须的
compile 'me.yokeyword:fragmentation:1.1.0'

// 如果不想继承SupportActivity/Fragment，自己定制Support，可仅依赖:
// compile 'me.yokeyword:fragmentation-core:1.1.0'

// 如果想使用SwipeBack 滑动边缘退出Fragment/Activity功能，完整的添加规则如下：
compile 'me.yokeyword:fragmentation:1.1.0'
// swipeback基于fragmentation, 如果是自定制SupportActivity/Fragment，则参照SwipeBackActivity/Fragment实现即可
compile 'me.yokeyword:fragmentation-swipeback:1.1.0'

2. Activity继承SupportActivity：

// v1.0.0开始，不强制继承SupportActivity，可使用接口＋委托形式来实现自己的SupportActivity
public class MainActivity extends SupportActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(...);
        // 建议在Application里初始化
        Fragmentation.builder()
             // 显示悬浮球 ; 其他Mode:SHAKE: 摇一摇唤出   NONE：隐藏
             .stackViewMode(Fragmentation.BUBBLE)
             .debug(BuildConfig.DEBUG)
             ... // 更多查看wiki或demo
             .install();

        if (findFragment(HomeFragment.class) == null) {
            loadRootFragment(R.id.fl_container, HomeFragment.newInstance());  // 加载根Fragment
        }
    }

3. Fragment继承SupportFragment：

// v1.0.0开始，不强制继承SupportFragment，可使用接口＋委托形式来实现自己的SupportFragment
public class HomeFragment extends SupportFragment {

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

4. 在不需要多点触控的页面上，通过theme(或其他方式)关闭多点触控

<item name="android:splitMotionEvents">false</item>

进一步使用、ChangeLog，查看wiki

混淆规则

v1.0.4及以下，需要添加混淆规则，v1.0.4+ 可不添加

-keep class * extends android.support.v4.app.FragmentManager{ *; }

LICENSE

Copyright 2016 YoKey

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.