如何使用Dora SDK完成Fragment流式切换和非流式切换

我想大家对Fragment都不陌生，它作为界面碎片被使用在Activity中，如果只是更换Activity中的一小部分界面，是没有必要再重新打开一个新的Activity的。有时，即使要更换完整的UI布局，也可以使用Fragment来切换界面。

何为流式切换

流式切换？不好意思，我给大家杜撰了一个词，所以大家陌生也很正常。简单的说，就是，点击下一步，下一步来按顺序更换界面的内容。你可以想象成是一个ArrayList。不过，大多数时候的Fragment界面切换都不是流式切换。比如底部的tab按钮，点击切换一个Fragment就不是流式切换。

效果演示

不管Fragment是否是流式切换，我们先看一个动画。

使用Dora SDK就可以很方便的实现这一效果，并且是不会有重叠现象的。待会我会讲解Fragment切换的标准写法。

如何使用Dora SDK的Fragment切换

// 添加以下代码到项目根目录下的build.gradle
allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}
// 添加以下代码到app模块的build.gradle
dependencies {
    implementation 'com.github.dora4:dora:1.0.106'
}

首先要添加Dora SDK的依赖，推荐使用最新版本的sdk，即1.0.106。然后继承并使用dora.BaseActivity和dora.BaseFragment。

package dora;

import dora.util.IntentUtils;

/**
 * 在Activity中切换多个Fragment时使用。
 */
public interface PageSwitcher {

    /**
     * Fragment非流式切换之显示页面。
     */
    void showPage(String key);

    /**
     * Fragment非流式切换之显示页面。
     */
    void showPage(String key, IntentUtils.Extras extras);

    /**
     * Fragment流式切换之显示下一页。
     */
    void nextPage();

    /**
     * Fragment流式切换之显示下一页。
     */
    void nextPage(IntentUtils.Extras extras);
}

里面有一个关键的接口，名叫PageSwitcher。它是专门用来切换Activity中的Fragment的。showPage表示非流式切换，而nextPage则表示流式切换。BaseActivity和BaseFragment都实现了这个接口，所以你可以在Activity或Fragment的任意地方进行流式切换和非流式切换。Fragment很简单，继承BaseFragment就可以了。Activity重点来了，继承BaseActivity后可以重写这几个方法。

getFlowFragment(String key)
getFlowFragmentContainerId()
getFlowFragmentPageKeys()

重写getFlowFragment告诉框架key和fragment的映射关系。
重写getFlowFragmentContainerId()告诉框架哪部分布局区域需要更换Fragment内容。
如果你不重写这个方法，就会走以下方法，最终拿到的就是android.R.id.content，这个布局下面就是我们自己定义的界面的根布局。

private int getDefaultFlowFragmentContainerId() {
    int defFragmentId = getFlowFragmentContainerId();
    if (defFragmentId != 0) {
        return getFlowFragmentContainerId();
    } else {
        return android.R.id.content;
    }
}

重写getFlowFragmentPageKeys()告诉框架所有key的顺序，它返回一个数组，数组中key的顺序就是fragment的排列顺序。
调用nextPage()就会按顺序，从第一个Fragment切换到最后一个Fragment，切换到最后一个为止。如果你需要更灵活的切换这些fragment，就需要使用showPage了，很简单吧。

无重叠切换Fragment的标准写法

1. initFragments

private void initFragments() {
    if (xxxFragment == null) {
        xxxFragment = XxxFragment();
        FragmentUtils.add(getSupportFragmentManager(), xxxFragment, R.id.fragmentContainer);
    }
    if (yyyFragment == null) {
        yyyFragment = YyyFragment();
        FragmentUtils.add(getSupportFragmentManager(), yyyFragment, R.id.fragmentContainer);
    }
    if (zzzFragment == null) {
        zzzFragment = ZzzFragment();
        FragmentUtils.add(getSupportFragmentManager(), zzzFragment, R.id.fragmentContainer);
    }
}

2. 隐藏activity中所有fragment
   调用BaseFragment中的hideFragments()来实现。以下为hideFragments源码。

protected void hideFragments(Collection<BaseFragment<?>> fragments) {
    if (fragments == null) {
        return;
    }
    for (BaseFragment<?> fragment : fragments) {
        FragmentUtils.hide(fragment);
    }
}

3. 显示要显示的那个fragment

private void showXxxFragment() {
    hideFragments(allFragments);
    if (xxxFragment == null) {
        xxxFragment = new XxxFragment();
        FragmentUtils.add(getSupportFragmentManager(), xxxFragment, R.id.fragmentContainer);
    }
    FragmentUtils.show(xxxFragment);
}

这里加个fragment为null的判断是为了防止你忘记initFragments。

谈谈我的开源框架系列

我的开源框架总共有三条路线，dora为核心架构，dcache数据缓存方向，dview为自定义View系列，本篇也只是介绍dora框架的冰山一角，还有更多功能等你来探索。