Skip to content

Latest commit

 

History

History
128 lines (89 loc) · 5.96 KB

README_CN.md

File metadata and controls

128 lines (89 loc) · 5.96 KB

Android Arsenal Build Status Download Hex.pm

注意:该项目不再维护

FragmentationX

A powerful library that manage Fragment for Android!

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

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

Fragment全解析系列(一):那些年踩过的坑

Fragment全解析系列(二):正确的使用姿势

Demo演示:

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

特性

1、悬浮球/摇一摇实时查看Fragment的栈视图,降低开发难度

2、内部队列机制 解决Fragment多点触控、事务高频次提交异常等问题

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

4、类Android事件分发机制的Fragment BACK键机制:onBackPressedSupport()

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

6、提供 Fragment转场动画 系列解决方案,动态改变动画

7、提供Activity作用域的EventBus辅助类,Fragment通信更简单、独立(需要使用EventBusActivityScope库)

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

     

如何使用

注意:以下为androidx的使用方式,如果使用的是android.support包,点击这里master分支

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

// 以下为androidx的使用方式,如果使用的是android.support包,fragmentationx -> fragmentation 即可
implementation 'me.yokeyword:fragmentationx:1.0.2'

// 如果不想继承SupportActivity/Fragment,自己定制Support,可仅依赖:
// implementation 'me.yokeyword:fragmentationx-core:1.0.2'

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

// Activity作用域的EventBus,通信更安全
implementation 'me.yokeyword:eventbus-activity-scope:1.1.0'
// Your EventBus's version
implementation 'org.greenrobot:eventbus:{version}'

2. Activity extends SupportActivity或者 implements ISupportActivity:(实现方式可参考MySupportActivity)

// 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 extends SupportFragment或者 implements ISupportFragment:(实现方式可参考MySupportFragment):

// 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
    }
}

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.