Android Fragment 常见问题及解决方案

Fragment(主要探讨的是support库中的Fragment)

Fragment的主要意义就是提供与Activity绑定的生命周期回调

Fragment不一定要向Activity的视图层级中添加View. 当某个模块需要获得Activity的生命周期回调的时候,就可以考虑通过Fragment来实现.

例如: DialogFragment, 调用show方法来显示一个Dialog(这个一个子Window,并不在Activity的视图层级中),当旋屏时,DialogFragment利用onDestroyView回调来dismiss Dialog,然后Activity重建之后,DialogFragment利用onStart回调再显示Dialog

当然,我们也可以创建一个完全没有UI的Fragment,比如BackgroundWorkerFragment,在onResume的时候执行一个Task,在onPause的时候暂停一个Task

Fragment 生命周期

Fragment的生命周期非常复杂,分为以下几种情况:

如果是通过XML中的

<fragment/>

标签实例化的,那么第一个收到的回调将是

onInflate

如果

setRetainInstance(true)

,那么当Activity重建时,Fragment的

onDestroy

以及Activity重建后Fragment的

onCreate

回调不会被调用.(无论是否将其添加到了返回栈)

如果当前显示的是Fragment A,然后执行

FragmentTransaction.replace()

,那么Fragment A会执行

onPause()->onStop()->onDestroyView()->onDestroy()->onDetach()

,如果执行

FragmentTransaction.replace().addToBackStack()

,那么Fragment A会执行

onPause()->onStop()->onDestroyView()

FragmentTransaction.hide(),将不会导致onPause(),而是会触发

onHiddenChanged()

FragmentTransaction.detach(),会导致

onPause()->onStop()->onDestroyView()

,注意:onDestroy()和onDetach()不会调用

FragmentTransaction

对于Fragment的操作都是通过FragmentTransaction来进行的,一个FragmentTransaction可以包含一个或者多个操作,通过commit或者commitAllowingStateLoss来提交.如果该FragmentTransaction被加入返回栈,那么出栈的时候,该Transaction中的所有操作都会被撤销

commit方法是异步的(handler post相应的message到MainLooper关联的Message queue),如果需要立刻执行Transaction的操作,可以调用

executePendingTransactions()

FragmentTransaction的commit方法以及FragmentManager的popBackStack方法都是异步的,给调用者带来了很多不便,虽然可以通过调用

executePendingTransactions()

方法来立即执行,但是为什么默认是异步的呢??(我觉得是因为:提交一个Transaction,会导致Fragment的生命周期方法的执行,甚至是多个回调的执行,如果Fragment在这些回调中又提交新的Transaction,那么可能会破坏当前Transaction的状态,比方说这是一个pop操作)

Can not perform this action after onSaveInstanceState

在使用Fragment的过程中,常常会遇到在Activity的onSaveInstanceState方法调用之后,操作commit或者popBackStack而导致的crash.

因为在onSaveInstanceState方法之后的操作状态可能会丢失,因此Android framework默认会抛出一个异常.

对于commit方法来说,单纯避免这个异常很简单,使用commitAllowingStateLoss方法即可.但是popBackStack以及popBackStackImmediate也都会检查state(checkStateLoss),特别需要注意的是Activity的onBackPressed方法

public void onBackPressed() {
if (!mFragments.popBackStackImmediate()) {//注意
supportFinishAfterTransition();
}
}

如果onBackPressed在onSavedInstanceState之后调用,那么就会crash.

onBackPressed的调用时机:

* targetSdkVersion <= 5,在onKeyDown中调用
* targetSdkVersion > 5,在onKeyUp中调用

onSavedInstanceState的调用时机(如果调用的话):

* 一定在onStop之前
* 可能在onPause之前,也可能在onPause与onStop之间

需要注意的是: onSavedInstanceState方法不一定会调用,只有在Activity因为某些原因而被Framework销毁,并且之后还需要重新创建的情况,才需要调用(例如:旋屏,或者内存不足而回收返回栈中的某些Activity)

举例:
* Activity A在前台时,屏幕逐渐变暗直至锁屏,那么A的onSavedInstanceState会被调用
* Activity A start Activity B,Activity A的onSavedInstanceState会被调用
* Activity A因为返回键或者finish调用而返回到上一个界面,那么A的onSavedInstanceState不会被调用

因此,当onBackPressed在onSavedInstanceState方法之后调用,就一定会crash.解决方法主要有两种:

重写Activity的onSavedInstanceState()方法,并且注释掉super调用.

这种方法能避免crash,但是它会导致整个Activity的状态丢失.以DialogFragment为例,正常情况下,显示的DialogFragment在旋屏Activity重新创建之后,不需要我们处理,Dialog会自动显示出来(参见DialogFragment.onStart()),但是注释掉Activity的onSavedInstanceState()方法之后,Fragment状态丢失,Activity重新创建之后,Dialog也就不会再显示出来了.

更好且通用的做法:在调用commit,popBackStack以及onBackPressed方法之前,判断onSavedInstanceState()方法是否已经执行,并且onResume方法还没有执行,如果不是,那么直接操作,否则加入到pending队列,等待onResumeFragments或者onPostResume之后再执行.

注意:不要在onResume中操作,因为这时候FragmentManager中的mStateSaved依然可能是true.(如果执行顺序是onSavedInstanceState()->onPause()->onResume() 或者 onPause()->onSavedInstanceState()->onResume())

例如:
public void onDataReceived() {
if(isStateSaved()) {//isStateSaved()由BaseActivity提供
addPendingFragmentOperation(new Runnable() {
@Override
public void run() {
getSupportFragmentManager().popBackStackImmediate();
}
});
} else {
getSupportFragmentManager().popBackStackImmediate();
}
}

@Override
protected void onPostResume() {
super.onPostResume();
if(pendingFragmentOperation != null && !pendingFragmentOperation.isEmpty()) {
for(Runnable operation : pendingFragmentOperation) {
operation.run();
}
pendingFragmentOperation.clear();
}
}

startActivityForResult

requestCode

的可用区间:

Activity: [Integer.MIN_VALUE, Integer.MAX_VALUE]

当requestCode取值在[Integer.MIN_VALUE, -1]区间中,效果和startActivity()一样,不会收到onActivityResult()回调

内置的Fragment可用requestCode的区间和Activity相同

support库: Fragment,以及FragmentActivity:[-1, 65535]

requestCode == -1,效果和startActivity()一样,不会收到onActivityResult()回调

requestCode 在 [Integer.MIN_VALUE, -2]或者[65536, Integer.MAX_VALUE]之间,会抛出异常(requestCode只能使用低16比特)

建议:

requestCode

的取值统一限制在[-1, 65535]之间

嵌套Fragment

首先要说的是尽量不要使用嵌套Fragment.

当在嵌套Fragment中使用startActivityForResult()时,会遇到的问题:

所有的Fragment都收不到onActivityResult()

某个level 1 的Fragment收到了onActivityResult()

总之那个发起startActivityForResult()的嵌套Fragment是一定不会收到onActivityResult()回调的.

原因如下:(可参考上面说的requestCode)

FragmentActivity.startActivityFromFragment()会改动requestCode,用高16比特存储Fragment在FragmentManager中的index,而低16比特作为Fragment可用的requestCode.在FragmentActivity.onActivityResult()中,根据高16比特,从FragmentManager中找到对应的Fragment,然后将低16比特的值作为requestCode,调用Fragment.onActivityResult().

那么requestCode中只能存储一个index,即root FragmentManager中的Fragment index.因此就会出现上面所列出的情形:

当嵌套Fragment在childFragmentManager中的index,大于rootFragmentManager中的所有index时, rootFragmentManager将找不到与此index对应的Fragment,所以没有Fragment能收到onActivityResult()

当嵌套Fragment在childFragmentManager中的index,小于等于rootFragmentManager中的所有index时,那么隶属于rootFragmentManager的一个Fragment将会收到onActivityResult()

总之即使能有Fragment能收到onActivityResult(),那也是顶层的某个Fragment,而不是发起请求的嵌套Fragment

解决方案:

不使用嵌套Fragment :)

依然利用requestCode,将其低16位拆分,其中的高8位用来存储childFragmentManager中的index,低8位留给ChildFragment使用.(如果嵌套层级不深,那么此方案还是不错的,如果层级较深,那么留给Fragment的requestCode的可用值区间将非常局限)

Android 4.2(Api 17)以后,可以使用内置的Fragment,以及ChildFragmentManager,内置Fragment不再需要借助requestCode的高16比特来记录它的index.而是由Framework收到Fragment.startActivityForResult()时,记录该Fragment的标识(

android:fragment:${parentIndex}:${myIndex}

),派发result时,就根据这个标识找到那个Fragment.因此就不会出现ChildFragment收不到onActivityResult()回调的问题了.

可以参考Activity.dispatchActivityResult()

Tips

开发的时候,可以打开Fragment相关的调试信息

FragmentManager.enableDebugLogging(BuildConfig.DEBUG);

Activity的onResume被调用时,Fragment的onResume还未被调用.

protected void onPostResume() {
super.onPostResume();
mHandler.removeMessages(MSG_RESUME_PENDING);
onResumeFragments();
mFragments.execPendingActions();
}
protected void onResumeFragments() {
mFragments.dispatchResume();
}

如果需要在Fragment的onResume都执行完后再执行某个操作,可以重写onPostResume()方法,一定要调用

super.onPostResume()

IllegalStateException(Fragment not attached to Activity)的问题

这个异常通常的发生情况是:在Fragment中启动一个异步任务,然后在回调中执行和resource相关的操作(getString(...)),或者startActivity(...)之类的操作.但是这个时候Fragment可能已经被detach了,所以它的

mHost==null

,因此在执行这些操作之前,需要先判断一下

isAdded()

.

注意: 这里不要使用

isDetached()

来判断,因为Fragment被detach之后,它的

isDetached()

方法依然可能返回

false

如果Fragment A是因为被replace而detach的,那么它的

isDetached()

将返回

false

如果Fragment A对应的FragmentTransaction被加入到返回栈中,因为出栈而detach,那么它的

isDetached()

将返回

true

final public Resources getResources() {
if (mHost == null) {
throw new IllegalStateException("Fragment " + this + " not attached to Activity");
}
return mHost.getContext().getResources();
}
public void startActivity(Intent intent, @Nullable Bundle options) {
if (mHost == null) {
throw new IllegalStateException("Fragment " + this + " not attached to Activity");
}
mHost.onStartActivityFromFragment(this /*fragment*/, intent, -1, options);
}