Rocket
采用"单Activity+多Fragment"以及"多模块Activity+多Fragment"的设计模式编写的架构。一个非常轻量级又十分强大的Fragment管理框架。
| 转场动画 | 路由栈视图 | 动态权限 |
|---|---|---|
 转场动画
|
 路由栈视图
|
 动态权限
|
| 状态栏 | 崩溃处理 | 日志 |
|---|---|---|
 状态栏
|
 崩溃处理
|
 日志管理
|
一、特性
无任何第三方依赖，纯原生编写，无需担心因为版本迭代导致的维护问题
采用线性路由栈，自行管理回退以及内存回收，提供悬浮球实时查看Fragment的栈视图，降低开发难度
页面切换以及页面通讯采用原生的commit以及setArguments，性能开销极小，页面切换流畅无卡顿
支持自定义Fragment转场动画
集成动态权限管理，包含必须权限（不允许不走生命周期）以及可选权限
集成状态栏管理，可适配状态栏各种场景，包括沉浸式风格
集成日志管理，记录崩溃日志、内部日志以及外部日志，可设置日志有效期，超时自动清理
提供更加人性化的崩溃捕获页面，精准定位根源bug文件以及行数，降低查bug难度
提供View注解，仅仅300行代码支持了各种View注入和事件绑定
提供百分比布局，支持PercentRelativeLayout、PercentLinearLayout和PercentFrameLayout
二、Github地址
三、分享设计Rockt架构的思路
1、为什么要设计这个架构
Activity是一个非常重量级的设计！Activity的创建并不能由开发者自己控制，它是通过多进程远程调用并最终通过放射的方式创建的。在此期间，AMS需要做大量的工作，以至于Activity的启动过程极其缓慢。同时，Activity切换的开销也非常重量级，很容易造成卡顿，用户体验不好。另外，在宽屏设备上，如果需要多屏互动时，Activity的局限性也就表现了出来。为此Android团队在Android 3.0的时候引入了Fragment。Fragment的出现解决了上面两个问题。根据词海的翻译可以译为:碎片、片段，可以很好解决Activity间的切换不流畅。因为是轻量切换，性能更好，更加灵活。
2、如何设计Fragment的路由栈
一个好用的框架必然有一个好用的路由管理、堆栈管理的机制。Rocket的路由栈设计原则为:一个Activity对应一个线性的路由栈，所有的页面回退、内存回收以及Fragemnt生命周期管理都是内部完成，开发者只要专注跳转目标即可，并提供可视化的栈视图，极大简化开发难度。那么如何保证Fragment路由栈是线性的呢？只要能够做到所有的页面切换只有一个transfer的入口，路由栈的出栈入栈都在这里管理即可。
3、如何处理页面切换、页面通信以及内存回收
Fragment页面跳转建议用commit在队列中提交，不建议用commitNowAllowingStateLoss等在线程中提交事务。一旦有快速切换页面逻辑，线程中提交事务很容易出现因为上个事务没消耗完毕导致崩溃。
页面通讯有很多方案，包括handle、广播、接口回调、Eventbus等等，都不是最优方案。Fragment提供的setArguments方法非常的轻量级，可以完美实现页面通讯。Rocket采用的就是原生的setArguments方案。
虽然Fragment相对Activity内存开销小了很多，但是如果大量Fragment创建没有及时回收的话会造成Activity内存臃肿。Rocket尽可能优的清理无用的Fragment，及时回收，消除应用卡顿。
4、如何处理转场动画与的Fragment生命周期
当Fragment中有setCustomAnimations转场动画的时候，做页面切换、页面通讯、内存管理等与生命周期相关的就多了很多的坑。Fragment提供的onCreateAnimation方法，不管有无动画都会走这个方法,并且提供完整的动画生命周期与动画详情。Rocket中充分利用这一点，
很好的规避了转场动画导致的各类难题。同时，Rocket提供设置转场动画入口给开发者，让开发者随心所欲定制自己的转场动画。
5、如何实现沉浸式状态栏与正常状态栏的无缝切换
状态栏有两种形态，显示以及隐藏。隐藏的时候整个页面向上顶满屏幕，带来很严重的突兀感。状态栏依附的是window窗体，在Rocket框架中，因为我们的页面单位是Fragment，也就是说只要一个页面切换状态栏都会导致整个窗体一起变化。
Rocket提供一个方法，让用户自定义的标题栏可以向上或者向下偏移一个状态栏高度，在页面切换前后动态控制，避免突兀。对于沉浸风格的实现，Rocket在隐藏状态栏的情况下会动态创建一个浮在表面的新状态栏，用户可以控制颜色与透明度，达到沉浸效果。
6、如何优雅处理动态权限申请与处理
我们知道，Fragment一般依赖于Activity存活，并且生命周期跟Activity差不多，因此，我们进行权限申请的时候，可以利用透明的Fragment进行申请，在里面处理完之后，再进行相应的回调。
第一步：当我们申请权限申请的时候，先查找我们当前Activity是否存在代理fragment,不存在，进行添加，并使用代理Fragment进行申请权限
第二步：在代理 Fragment 的 onRequestPermissionsResult 方法进行相应的处理，判断是否授权成功
第三步：进行相应的回调。这些繁琐的步骤封装在空白的Fragment中，降低耦合，方便维护。
7、如何更好的进行Fragment的事务提交
Fragment的事务提交主要涉及的函数有：commit()、commitNow()、commitAllowingStateLoss()、commitNowAllowingStateLoss()以及executePendingTransactions()。下面进行比较：
1、使用commit()的时候, 一旦调用, 这个commit并不是立即执行的, 它会被发送到主线程的任务队列当中去, 当主线程准备好执行它的时候执行。但是有时候你希望你的操作是立即执行的, 之前的开发者会在commit()调用之后加上 executePendingTransactions()来保证立即执行, 即变异步为同步。
2、support library从v24.0.0开始提供了 commitNow()方法, 之前用executePendingTransactions()会将所有pending在队列中还有你新提交的transactions都执行了, 而commitNow()将只会执行你当前要提交的transaction. 所以commitNow()避免你会不小心执行了那些你可能并不想执行的transactions。
3、如果你调用的是commitAllowingStateLoss()与commitNowAllowingStateLoss()，并且是在onSaveInstanceState()之后, 就不会抛出IllegalStateException，允许你丢失状态，通常你不应该使用这个函数。
在Rocket的架构中，路由栈是串行的，主张采用commit()提交事务，保证每条事务在队列中依次执行，不争不抢，有条不紊。
四、踩坑经验之旅
1、Can not perform this action after onSaveInstanceState
onSaveInstanceState方法是在该Activity即将被销毁前调用，来保存Activity数据的，如果在保存完毕状态后 再给它添加或者隐藏Fragment就会出错。
解决方案
- 方案一：把commit()方法替换成 commitAllowingStateLoss()，不采用。
- 方案二：在Activity 回收时 onSaveInstanceState 中不缓存Fragment ,在OnCreate 中移除缓存相应Fragment数据，采用。
private static final String BUNDLE_SURPOTR_FRAGMENTS_KEY = "android:support:fragments";
private static final String BUNDLE_FRAGMENTS_KEY = "android:fragments";
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
if (outState != null) {
//重建时清除系统缓存的fragment的状态
outState.remove(BUNDLE_SURPOTR_FRAGMENTS_KEY);
outState.remove(BUNDLE_FRAGMENTS_KEY);
}
}
@Override
protected void onCreate(Bundle savedInstanceState) {
if (savedInstanceState != null) {
//重建时清除系统缓存的fragment的状态
savedInstanceState.remove(BUNDLE_FRAGMENTS_KEY);
savedInstanceState.remove(BUNDLE_SURPOTR_FRAGMENTS_KEY);
}
super.onCreate(savedInstanceState);
}
2、FragmentManager is already executing transactions
这个问题是由于在执行Fragment事务提交的时候，commitNow以及commitNowAllowingStateLoss表示立刻执行事务提交，这个时候Activity 中的 FragmentManager 的第一次任务还没有执行完毕，其他的操作又导致它需要进行第二次任务，所以发生错误。
private void ensureExecReady(boolean allowStateLoss) {
if (mExecutingActions) {
// 这正是堆栈日志中抛出的异常信息
throw new IllegalStateException("FragmentManager is already executing transactions");
}
}
解决方案
- 等待第一个任务执行完毕后再执行第二个任务
new Handler().post(() -> {
//事务的提交
});
- 采用commit()在队列中提交事务
//commit能保证在消息队列中提交事务，保证上个事务处理完毕才会执行
fragmentTransaction.commit()；
3、Fragment xxx not attached to a context.
当一个Fragment已经从Activity中remove掉的时候，执行getString()、getResources()等，就会抛出这个异常。这种情况经常出现在异步回调的场景，比如一个网络请求比较耗时，在返回之前fragment已经销毁，当尝试读取资源就会出现。
//异步获取数据，并提示
new Thread(() -> {
try {
Thread.sleep(5000);
toast(getString(R.string.app_name));
} catch (InterruptedException e) {
e.printStackTrace();
}
}).start();
//返回上个页面并且销毁
back();
解决方案
- 方案一：直接使用Activity的getString()与getResources()获取资源。
- 方案二：利用Fragment的isAdd()判断是否被移除在获取资源。
/**
* 防止在Fragment销毁的时候调用资源导致崩溃
*
* @return Resources
*/
public Resources getRoResources() {
if(isAdded()){
return requireContext().getResources();
}else{
return activity.getResources();
}
}
4、fragmentTransaction.add(fragment).commit() 没有立即生效
上文已经提到过，commit()会在队列中依次提交事务。当你提交成功并且利用fm.findFragmentByTag(targetTag)去寻找它的时候发现并不存在。但是他确实已经在队列中排队提交了。当你尝试延时几十毫秒去读的时候发现有了。
这会导致一个逻辑问题，比如你做页面切换的时候，当两次切换的时差小于单个事务提交，就会导致一个Activity中存在多个相同tag的Fragment，这不是我们想要看到的。
//当快速执行两次页面跳转，理论上应该只会添加一个，但实际上两个都会被添加
toFrag(Frag_rocket_permission.class);
toFrag(Frag_rocket_permission.class);
/**
* 页面跳转
* @param targetClass 已经注册的Fragment
*/
public void toFrag(Class targetClass) {
FragmentManager fm = activity.getSupportFragmentManager();
FragmentTransaction ft = fm.beginTransaction();
String targetTag = targetClass.getSimpleName();
RoFragment targetFragment = (RoFragment) fm.findFragmentByTag(targetTag);//找出目标Fragment
if (targetFragment == null) {//目标不存在才会添加,保证单一性
targetFragment = (RoFragment) targetClass.newInstance();
ft.add(containid, targetFragment, targetTag);//添加
}
ft.commit();
}
解决方案
- 上个页面跳转的时候加锁，直到页面跳转结束才释放锁，允许下个跳转，过快的跳转丢弃
if(!toFragEnable){//太快跳转锁住丢弃
return;
}
boolean result = toFrag();
//跳转成功先锁住
if(result){
toFragEnable = false;
}
@Override
public Animation onCreateAnimation(int transit, boolean enter, int nextAnim) {
//Fragment show and hide 都会执行这个回调，用来处理页面跳转逻辑
//成功跳转才开锁，允许下次跳转
toFragEnable = true;
}
5、请不要在Fragment转场动画没结束之前允许用户操作
你的Fragment转场动画还没结束时，如果执行了其他事务等方法，可能会导致栈内顺序错乱，同时会增加页面状态的复杂度与不可控性。
解决方案
- 动画结束再执行事务(加锁)，或者临时将该Fragment设为无动画
@Override
public Animation onCreateAnimation(int transit, boolean enter, int nextAnim) {
if(nextAnim > 0){//有转场动画的情况
Animation anim = AnimationUtils.loadAnimation(getActivity(), nextAnim);
anim.setAnimationListener(new Animation.AnimationListener() {
public void onAnimationStart(Animation animation) {
isAnimationEnd = false;//动画开始
}
public void onAnimationRepeat(Animation animation) {}
public void onAnimationEnd(Animation animation) {
isAnimationEnd = true;//动画结束了
}
});
return anim;
}
return null;
}
6、getActivity() = null导致Crash
可能你遇到过getActivity() = null，或者平时运行完好的代码，在“内存重启”之后，调用getActivity()的地方却返回null，报了空指针异常。大多数情况下的原因：你在调用了getActivity()时，当前的Fragment已经onDetach()了宿主Activity。
解决方案
- 在onAttach(Activity activity)里将Activity全局保存下来
//缓存activity
public RoActivity activity;
@Override
public void onAttach(Context context) {
super.onAttach(context);
this.activity = (RoActivity) context;
}
关于我
- Email: 123302687@qq.com
- Github: https://github.com/yinhaide
- 简书: https://www.jianshu.com/u/33c3dd2ceaa3
- CSDN: https://blog.csdn.net/yinhaide
