Skip to content

Latest commit

 

History

History
1240 lines (937 loc) · 61.6 KB

一文读懂 Fragment 的方方面面.md

File metadata and controls

1240 lines (937 loc) · 61.6 KB

Fragment 是 Android 中历史十分悠久的一个组件,在 Android 3.0 (API 级别 11)的时候推出,时至今日已成为 Android 开发中最常用的组件之一

在一开始的时候,引入 Fragment 的目的是为了在大屏幕(如平板电脑)上能够更加动态和灵活地设计界面,被定义为一个 轻量级 Activity 而进行设计。通过 Fragment 可以将整个界面划分为多个分散的区域块,且同个 Fragment 可以被应用于多个 Activity 中,从而实现界面的模块化并提高可重用性。随着 Android 系统的逐渐升级,系统功能越来越丰富,Fragment 因此也自然而然的就被添加了很多和 Activity 完全一样的 API。例如,想要跳转到某个 Activity 并获取返回值,Activity 和 Fragment 就都加上了startActivityForResult方法;在 6.0 的时候有了运行时权限,就都加上了requestPermissions方法;在 8.0 的时候有了画中画模式,就又都加上了onPictureInPictureModeChanged方法

随着系统更迭,Fragment 逐渐变得不再轻量,繁杂的功能让其越来越复杂,也导致以前的版本中暗坑无数,framework 层中的android.app.Fragment和 support 包中的 android.support.v4.app.Fragment 如今都被废弃不再维护了,也遗留了很多个没有解决的 bug,因此 Fragment 在长久以来并不能说是一个多么让开发者喜欢的组件

而到了如今 AndroidX & Jetpack 的年代,Google 官方也终于开始重新构思 Fragment 的定位,并对 Fragment 进行了大量重构。引用官方的说法:我们希望 Fragment 成为一个真正的核心组件,它应该拥有可预测的、合理的行为,不应该出现随机错误,也不应该破坏现有的功能。我们希望挑个时间发布 Fragment 的 2.0 版,它将只包含那些新的、好用的 API。但在时机成熟之前,我们会在现有的 Fragment 中逐步加入新的并弃用旧的 API,并为旧功能提供更好的替代方案。当没人再使用已弃用的 API 时,迁移到 Fragment 2.0 就会变得很容易

本篇文章就来介绍新时代 AndroidX Fragment 的方方方面,陆陆续续写了一万多字,有基础知识也有新知识,也许就包含了一些你还没了解过的知识点,看完之后你会发现 Fragment 如今好像真的在变得越来越好用了,希望对你有所帮助 🤣🤣

本文所有示例代码基于以下版本进行讲解

dependencies {
    implementation "androidx.appcompat:appcompat:1.3.1"
    implementation "androidx.fragment:fragment:1.3.6"
    implementation "androidx.fragment:fragment-ktx:1.3.6"
}

1、如何使用

本节内容先来介绍如何将 Fragment 添加到 Activity 中

1、声明 Fragment

目前 Fragment 已支持直接在构造函数中传入 layoutId,并在 onCreateView 方法中自动完成 View 的 inflate 操作,这样子类就无需重写 onCreateView 方法了

public class Fragment implements ComponentCallbacks, View.OnCreateContextMenuListener, LifecycleOwner,
        ViewModelStoreOwner, HasDefaultViewModelProviderFactory, SavedStateRegistryOwner,
        ActivityResultCaller {

    @LayoutRes
    private int mContentLayoutId;

    @ContentView
    public Fragment(@LayoutRes int contentLayoutId) {
        this();
        mContentLayoutId = contentLayoutId;
    }

    @MainThread
    @Nullable
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        if (mContentLayoutId != 0) {
            return inflater.inflate(mContentLayoutId, container, false);
        }
        return null;
    }

}

因此,最简单的情况下我们仅需要一行代码就可以声明一个 Fragment 子类

class PlaceholderFragment : Fragment(R.layout.fragment_placeholder)

2、添加 Fragment

Fragment 一般情况下都需要和 FragmentActivity 组合使用,而我们日常使用的 AppCompatActivity 就已经直接继承于 FragmentActivity 了。此外,虽然 Fragment 可以选择任意 ViewGroup 作为其容器,但官方强烈推荐使用 FrameLayout 的子类 FragmentContainerView,因为其修复了 Fragment 在执行转场动画时的一些问题

我们可以为 FragmentContainerView 声明 name 属性,指定 Fragment 的全名路径,这样 Activity 在加载布局文件的时候就会自动完成 Fragment 的实例化和 add 操作了

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/fragmentContainerView"
        android:name="github.leavesc.fragment.PlaceholderFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

如果想要通过代码在合适的时机再来主动注入 Fragment,那么也可以不声明 name 属性,改为通过 supportFragmentManager 来主动执行 add 操作。此外,由于当发生 Configuration Change 时,系统会自动恢复重建每个 Activity 和 Fragment,因此我们需要主动判断当前 Activity 是否属于正常启动,对应savedInstanceState == null,此时才去主动添加 Fragment,否则就会造成两个 Fragment 重叠在一起

/**
 * @Author: leavesCZY
 * @Desc:
 * @公众号:字节数组
 */
class MyFragmentActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_my_fragment)
        if (savedInstanceState == null) {
            supportFragmentManager.commit {
                add(R.id.fragmentContainerView, PlaceholderFragment())
                setReorderingAllowed(true)
                addToBackStack(null)
            }
        }
    }

}

supportFragmentManager.commit方法是fragment-ktx库中提供的扩展方法,实际上也只是对 FragmentManager 和 FragmentTransaction 做了一层封装

public inline fun FragmentManager.commit(
    allowStateLoss: Boolean = false,
    body: FragmentTransaction.() -> Unit
) {
    val transaction = beginTransaction()
    transaction.body()
    if (allowStateLoss) {
        transaction.commitAllowingStateLoss()
    } else {
        transaction.commit()
    }
}

本文大部分的示例代码都不会去考虑 Activity 销毁重建的情况,但读者在实际开发中需要考虑这种情况

2、生命周期

1、初始

不管 Fragment 的直接载体是什么,最终都必须托管在 Activity 中,Fragment 包含有很多个生命周期回调方法,其生命周期会直接受宿主 Activity 生命周期的影响,但也还来源于其它方面。例如,Fragment 的直接载体可以是 Activity 或者是其它更上层的 Fragment,Fragment 会自动随着载体生命周期的变化而变化;如果直接载体是 ViewPager2 的话,切换 ViewPager2 的时候 Fragment 就会单独发生变化

关于 Fragment 的生命周期有一张比较经典的图片,直接标明了 Activity 和 Fragment 在各个生命周期状态的映射关系

Fragment 的大部分生命周期方法都和 Activity 相映射,但两者的生命周期方法有着明确的先后顺序。以一个通过 FragmentContainerView 添加到 Activity 中的 Fragment 为例,从启动 Activity 到按返回键退出页面的整个过程中,生命周期的变化是:

  • Activity 的 onCreate 方法里 调用 Fragment 的 onAttach(Context)、onAttach(Activity)、onCreate
  • Activity 的 onStart 方法里 调用 Fragment 的 onCreateView、onViewCreated、onActivityCreated、onViewStateRestored、onStart
  • Activity 的 onResume 方法后 调用 Fragment 的 onResume
  • Activity 的 onPause 方法里 调用 Fragment 的 onPause
  • Activity 的 onStop 方法里 调用 Fragment 的 onStop
  • Activity 的 onDestroy 方法里 调用 Fragment 的 onDestroyView、onDestroy、onDetach

可以看到,整个生命周期以 onResume 方法作为分割线,该方法被回调意味着视图已经处于前台活跃状态了,Activity 作为 Fragment 的载体,就需要先保证其自身的 onResume 方法已经回调结束了才能去回调 Fragment 的 onResume 方法,因此两者不存在嵌套调用关系。而对于其它方法,当被回调时就意味着 Activity 处于非活跃状态或者是即将被销毁,此时就需要先回调完成 Fragment 的方法再结束自身,因此就存在嵌套调用关系


此外,如果 Activity 启动了另外一个 Activity,此时其 onSaveInstanceState 方法就会被调用,此方法一样会嵌套调用 Fragment 的相应方法,但该方法和 onStop 方法的先后顺序在不同系统版本上有着差异性。在 API 28 之前的所有版本,onSaveInstanceState()会在 onStop()方法之前被调用,API 28+ 则相反

当 Activity 从后台返回前台时,如果该 Activity 属于销毁重建的情况的话,Fragment 会重新走一遍生命周期方法,此时其 onCreate、onCreateView、onActivityCreated、onViewStateRestored 方法的参数值 Bundle 就不为 null,当中就保留了我们在 onSaveInstanceState方法中插入的值,我们可以依靠该 Bundle 来帮助页面重建


此外,目前 onAttach(Activity)onActivityCreated(Bundle) 这两个方法已经被标记为废弃了,这两个方法的初衷是为了让 Fragment 的逻辑能够和载体 Activity 之间建立联系,并得到来自于 Activity 的 onCreate 事件通知,这就导致了开发者有可能会写出和 Activity 强关联的逻辑,官方现在不鼓励这种耦合。View 相关的逻辑应该放在 onViewCreated 方法中处理,其它初始化代码应该在 onCreate 方法中处理,Fragment 的初始化逻辑不应该去依赖于这两个废弃的方法,Fragment 应该更加独立才对

如果实在需要得到 Activity 的 onCreate 事件通知,可以通过在 onAttach(Context)方法中添加 LifecycleObserver 来实现

override fun onAttach(context: Context) {
    super.onAttach(context)
    requireActivity().lifecycle.addObserver(object : DefaultLifecycleObserver {
        override fun onCreate(owner: LifecycleOwner) {
            owner.lifecycle.removeObserver(this)
            //TODO            
        }
    })
}

2、回退栈 & 事务

Fragment 的生命周期不仅仅只有以上那种线性流程那么简单,不然 Fragment 也不会总是被人吐槽状态过于复杂多变了。Fragment 生命周期的开始节点是 onAttach 方法,结束节点是 onDetach 方法,这个过程中 onCreateViewonDestroyView 之间可以被执行 N 多次,就像下图所示

onCreateViewonDestroyView 方法之间之所以可能会执行 N 多次,就在于 FragmentTransaction 可以先后执行 N 多次 **移除(remove)**或者 替换(replace)操作,即先后加载不同 Fragment。新加载的 Fragment 就会取代之前的 Fragment 切换到前台,旧的 Fragment 的视图 View 就会被销毁。如果加载新 Fragment 的操作有添加到回退栈中,那么当用户点击返回键时旧的 Fragment 就会重新呈现到前台,此时就会重新走一遍 onCreateViewonDestroyView 方法之间的流程了

这里就涉及到了关于 Fragment 回退栈 的概念了。假设 FragmentA 通过以下代码 replace 为了 FragmentB,那么当用户按返回键时,FragmentB 就会被销毁,而 FragmentA 就会重新执行 onCreateViewonDestroyView 之间的所有方法,重新回到前台

supportFragmentManager.commit {
    setReorderingAllowed(true)
    addToBackStack(null)
    replace(
        R.id.fragmentContainerView, FragmentB()
    )
}

我们可以通过点击返回键退出 FragmentB,因此直观感受上似乎就是 FragmentB 被添加到了回退栈中,但实际上被添加的并不是 Fragment,而是那些包含了 addToBackStack(String) 方法的一整个事务

这句话看着很抽象,我举一个例子来帮助读者理解

我们先 add 一个 Fragment 1,然后再 replace 为 Fragment 2,replace 事务中就调用了 addToBackStack(null) 方法,那么当点击返回键时,Fragment 2 就会被销毁,Fragment 1 重新加载到前台页面。大致代码以及运行效果:

supportFragmentManager.commit {
    setReorderingAllowed(true)
    addToBackStack(null)
    add(R.id.fragmentContainerView, Fragment1())
}

supportFragmentManager.commit {
    setReorderingAllowed(true)
    addToBackStack(null)
    replace(R.id.fragmentContainerView, Fragment2())
}

从执行 add 操作到点击返回键,两个 Fragment 的生命周期方法的调用顺序就大致如下所示,省去了部分方法

//先执行 add 操作
Fragment-1: onStart-start
Fragment-1: onResume-start

//再执行 replace 操作
Fragment-1: onPause-start
Fragment-1: onStop-start

Fragment-2: onAttach-context-start
Fragment-2: onCreate-start
Fragment-2: onResume-start

Fragment-1: onDestroyView-start

//点击返回键
Fragment-2: onPause-start
Fragment-2: onStop-start

Fragment-1: onCreateView-start
Fragment-1: onActivityCreated-start
Fragment-1: onViewStateRestored-start
Fragment-1: onStart-start
Fragment-1: onResume-start

Fragment-2: onDestroyView-start
Fragment-2: onDestroy-start
Fragment-2: onDetach-start

这整个过程的调用关系可以总结为:

  • 当执行 replace 操作时。Fragment 1 会先执行到 onStop,意味着 Fragment 1 已经被切换到后台了。然后就开始执行 Fragment 2 的生命周期直到 onResume ,意味着 Fragment 2 已经被切换到前台了。之后就会接着执行 Fragment 1 的 onDestroyView ,此时就意味着 Fragment 1 不仅被切换到了后台,其 View 也被销毁了
  • 当点击返回键时。Fragment 2 会先执行到 onStop,意味着 Fragment 2 已经被切换到后台了。Fragment 1 则会再次执行从 onCreateViewonResume 之间的所有方法,意味着重新回到了前台。之后就会接着执行 Fragment 2 的生命周期直到 onDetach ,此时 Fragment 2 就被完全销毁了,无法再次回到该实例页面

点击返回键时,由于 replace 操作调用了addToBackStack(null) 方法,意味着该事务加入到了回退栈中,因此此时响应了返回键事件的其实就是该事务,所以 replace 操作就会被撤销,FragmentManager 负责将视图恢复到 replace 之前的状态,因此 Fragment 2 整个实例被完全销毁了,Fragment 1 得以重新回到前台

所以说,FragmentTransaction 的回退栈中保留的是事务而非具体的 Fragment 实例,能响应返回事件的是我们向其中提交的事务,具体的响应结果就是将该事务撤销,恢复到之前的状态


如果以上例子觉得还不够明白,可以再举一个例子 ~~

我们先 add 一个 Fragment 1,然后再 replace 为 Fragment 2,replace 事务中不调用 addToBackStack(null) 方法,那么此时就需要点击两次返回键才能退出 Fragment 2 了,且此时 Activity 也会随着退出。大致代码以及运行效果:

supportFragmentManager.commit {
    setReorderingAllowed(true)
    addToBackStack(null)
    add(R.id.fragmentContainerView, Fragment1())
}

supportFragmentManager.commit {
    setReorderingAllowed(true)
    //addToBackStack(null)
    replace(R.id.fragmentContainerView, Fragment2())
}

从执行 add 操作到点击两次返回键,两个 Fragment 的生命周期方法的调用顺序就大致如下所示,省去了部分方法

//先执行 add 操作
Fragment-1: onStart-start
Fragment-1: onResume-start

//再执行 replace 操作
Fragment-1: onPause-start
Fragment-1: onStop-start

Fragment-2: onAttach-context-start
Fragment-2: onCreate-start
Fragment-2: onResume-start

Fragment-1: onDestroyView-start

//点击返回键
Fragment-1: onDestroy-start
Fragment-1: onDetach-start

//再次点击返回键
Fragment-2: onPause-start
Fragment-2: onStop-start
Fragment-2: onDestroyView-start
Fragment-2: onDestroy-start
Fragment-2: onDetach-start
  • 当第一次点击返回键时。由于 replace 事务并没有被添加到回退栈中,而 add 操作有,所以此时响应了返回事件的是 add 操作,点击返回键就相当于把 add 操作给撤销掉了,因此 Fragment 1 就会执行到 onDetach 方法,Fragment 2 不受影响
  • 当第二次点击返回键时,由于此时 FragmentTransaction 的回退栈为空,所以此时响应了返回事件的其实是 Activity,所以 Activity 会退出,连带着 Fragment 2 也一起被销毁了

看完这两个例子,读者应该明白了吧?在回退栈中,调用了addToBackStack(String) 方法的事务才是重点,Fragment 并不是

3、FragmentLifecycle

在最早的时候,生命周期这个词对于 Activity 和 Fragment 来说指的就是其特定的回调方法是否已经被执行了,例如 onCreateonStartonDestroy 等方法。现如今也指这两者的 Lifecycle.State 的当前值是什么

Activity 和 Fragment 都实现了 LifecycleOwner 接口,都包含了一个 Lifecycle 对象用于标记其生命周期状态,因此我们能够在这两者中以和生命周期绑定的方式对 LiveData 进行监听,就像以下代码一样,当中 textLiveData 关联的 this 即 LifecycleOwner 对象,从而保证了只有当 Fragment 处于前台活跃状态时才会收到数据回调

class PageFragment : Fragment() {

    private val pageViewModel by lazy {
        ViewModelProvider(this@PageFragment).get(PageViewModel::class.java).apply {
            textLiveData.observe(this@PageFragment, {

            })
        }
    }
    
}

Lifecycle.State 一共包含五种值,FragmentLifecycle 会在这五个值中不断流转,例如当切换为 DESTROYED 状态时,也即意味 onDestory()、onDetach() 等方法被调用了,至此 Fragment 的本次生命周期也就结束了

public enum State {
    DESTROYED,
    INITIALIZED,
    CREATED,
    STARTED,
    RESUMED;
}

4、FragmentViewLifecycle

Fragment 相对于 Activity 来说比较特殊,因为其关联的 View 对象可以在单次 FragmentLifecycle 过程中先后多次加载和销毁,因此实际上 FragmentView 的生命周期和 Fragment 并不同步

Fragment 内部也声明了九种状态值用于标记其自身的生命周期状态,当中就包含一个 VIEW_CREATED,即表示 FragmentView 已经被创建了,从这也可以看出 Fragment 内部维护的生命周期密度要比 FragmentLifecycle 小得多

static final int INITIALIZING = -1;          // Not yet attached.
static final int ATTACHED = 0;               // Attached to the host.
static final int CREATED = 1;                // Created.
static final int VIEW_CREATED = 2;           // View Created.
static final int AWAITING_EXIT_EFFECTS = 3;  // Downward state, awaiting exit effects
static final int ACTIVITY_CREATED = 4;       // Fully created, not started.
static final int STARTED = 5;                // Created and started, not resumed.
static final int AWAITING_ENTER_EFFECTS = 6; // Upward state, awaiting enter effects
static final int RESUMED = 7;                // Created started and resumed.

状态值切换到 DESTROYED,对于 FragmentLifecycle 来说意味着 onDestroy、onDetach 等方法被调用,对于 FragmentViewLifecycle 来说则意味着onDestroyView方法被调用,因此 FragmentViewLifecycle 的跨度范围要比 FragmentLifecycle 小一些。而且 FragmentLifecycle 切换到 DESTROYED 后状态值是不可逆的,无法再次更改,而 FragmentViewLifecycle 切换到 DESTROYED 后是有机会再次更改的,因为 View 对象可以先后多次加载和销毁,每次加载就意味着生命周期的重新开始

Fragment 提供了一个getViewLifecycleOwner()方法由于提供 FragmentViewLifecycle,从中可以看出该方法只能在 onCreateView()onDestroyView() 之间被调用,即只能在 FragmentView 创建了且销毁之前使用,否则将直接抛出异常

@Nullable
FragmentViewLifecycleOwner mViewLifecycleOwner;

@MainThread
@NonNull
public LifecycleOwner getViewLifecycleOwner() {
    if (mViewLifecycleOwner == null) {
        throw new IllegalStateException("Can't access the Fragment View's LifecycleOwner when "
                + "getView() is null i.e., before onCreateView() or after onDestroyView()");
    }
    return mViewLifecycleOwner;
}

FragmentViewLifecycle 非常有用,我们在日常开发中可以根据实际情况使用 FragmentViewLifecycle 来替代 FragmentLifecycle,因为 FragmentLifecycle 存在着一些并不明显的使用误区,很容易就造成 bug

举个例子。假设我们的 Fragment 需要监听 ViewModel 中某个 LiveData 值的变化,并根据监听到的值来设置界面,此时就要考虑在 Fragment 中的哪里来订阅 LiveData 了。看了以上内容后,我们已经知道 onCreateView 方法到 onDestoryView之间是可能会先后执行多次的,那么监听操作就不应该放在这里面了,否则就会造成重复订阅。此时我们想到的可能就是这两种方式了:声明全局变量 ViewModel 时顺便监听 或者是 在 onCreate 方法中进行监听

private val pageViewModel by lazy {
    ViewModelProvider(this).get(PageViewModel::class.java).apply {
        textLiveData.observe(this@PageFragment, Observer {
            //TODO
        })
    }
}
private val pageViewModel by lazy {
    ViewModelProvider(this).get(PageViewModel::class.java)
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    pageViewModel.textLiveData.observe(this@PageFragment, Observer {
        //TODO
    })
}

这两种方式都可以避免重复订阅的问题,但此时还存在另一个藏得很深的问题:假如 FragmentView 真的销毁重建了,重建后的 FragmentView 也收不到 textLiveData 已有的数据!!!

会出现该问题的本质原因还是因为 FragmentView 的生命周期和 Fragment 并不同步。如果 Fragment 已经接收过 textLiveData 的回调了,那么当 FragmentView 销毁重建后,由于 textLiveData 的值没有发生变化,和 textLiveData 绑定的 LifecycleOwner 也还一直存在着,那么重建后的 FragmentView 自然就不会收到 textLiveData 的回调了,从而导致无法根据回调来重建页面

为了解决该问题,就需要使用到 FragmentViewLifecycle 了。由于 FragmentViewLifecycle 的生命周期在 onDestoryView的时候就结束了,此时也会自动移除 Observer,因此我们可以直接在 onViewCreated 方法中使用 viewLifecycleOwner 来监听 textLiveData,从而保证每次重建后的 FragmentView 都能收到回调

private val pageViewModel by lazy {
    ViewModelProvider(this).get(PageViewModel::class.java)
}

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    pageViewModel.textLiveData.observe(viewLifecycleOwner, Observer {
        //TODO
    })
}

在大部分情况下,我们在 Fragment 中执行的操作都是和 FragmentView 强关联的,属于视图操纵行为,此时就可以使用 FragmentViewLifecycle 来替代 FragmentLifecycle,从而保证事件一定只有在 FragmentView 存在且活跃的情况下才会被回调,且保证了每次 FragmentView 被销毁重建的时候都能够得到最新数据。而对于那些依赖于 Fragment 完整生命周期的事件,就还是只能继续使用 FragmentLifecycle 了

关于 Lifecycle 和 LiveData 的源码解析可以看这两篇文章:

5、未来的计划

从以上内容读者应该可以看出来,Fragment 的生命周期是十分复杂的,是否加入回退栈对于生命周期的影响很大,而且单个 Fragment 实例的生命周期还分为了 FragmentLifecycle 和 FragmentViewLifecycle 两种,这也是 Fragment 一直被人吐槽的最大原因之一。幸运的是,Google 官方现在也意识到了这个问题,并且有将两者进行合并简化的计划

以下内容引用至 Google 官方:

最后要说的问题,是 Fragment 的生命周期。当前 Fragment 的生命周期十分复杂,它包含了两套不同的生命周期。Fragment 自己的生命周期从它被添加到 FragmentManager 的时候开始,一直持续到它被 FragmentManager 移除并销毁为止;而 Fragment 所包含的视图,则有一个完全分离的生命周期。当您的 Fragment 进入回退栈时,视图将会被销毁。但 Fragment 则会继续存活

于是我们产生了一个大胆的想法: 将两者合二为一会怎么样?在 Fragment 视图销毁时便销毁 Fragment,想要重建视图时就直接重建 Fragment,这样的话将大大减少 Fragment 的复杂度。而诸如 FragmentFactory 和状态保存一类,以往在 onConfigrationChange、 进程的死亡和恢复时使用的方法,在这种情况下将会成为默认选项

当然,这个改动将会是十分的巨大。我们目前处理的方式,是将它作为一个可选 API 加入到了 FragmentActivity 中。使用了这个新的 API,就可以开启生命周期简化过的新世界

3、setMaxLifecycle

在以前,Fragment 往往会和 ViewPager 配套使用,由于 ViewPager 存在页面预加载的机制,相邻 Fragment 会在对用户不可见的时候就执行onResume方法,从而触发一些不必要的业务逻辑,导致多余的流量消耗和性能消耗

为了解决以上问题,实现 Fragment 懒加载的效果,我们需要在onViewCreatedonResumeonHiddenChangedsetUserVisibleHint等多个方法中添加标记位,通过组合标记位来准确得知 Fragment 当前是否真的对用户可见,且只在可见的情况下才去触发关联的业务逻辑。这种实现方式长久以来一直很流行,也完全可用,但也真的不够优雅,我们需要组合多个条件才能实现目的,且 Fragment 在不可见的时候就去回调onResume方法本身也是一种很违反常识的行为

现如今我们也有了更好的选择,setUserVisibleHint方法已经被废弃了,从注释可以看到官方现在推荐使用setMaxLifecycle 方法来更为精准地控制 Fragment 的生命周期

/**
 * @deprecated If you are manually calling this method, use
 * {@link FragmentTransaction#setMaxLifecycle(Fragment, Lifecycle.State)} instead. If
 * overriding this method, behavior implemented when passing in <code>true</code> should be
 * moved to {@link Fragment#onResume()}, and behavior implemented when passing in
 * <code>false</code> should be moved to {@link Fragment#onPause()}.
 */
@Deprecated
public void setUserVisibleHint(boolean isVisibleToUser) {
    if (!mUserVisibleHint && isVisibleToUser && mState < STARTED
            && mFragmentManager != null && isAdded() && mIsCreated) {
        mFragmentManager.performPendingDeferredStart(
                mFragmentManager.createOrGetFragmentStateManager(this));
    }
    mUserVisibleHint = isVisibleToUser;
    mDeferStart = mState < STARTED && !isVisibleToUser;
    if (mSavedFragmentState != null) {
        // Ensure that if the user visible hint is set before the Fragment has
        // restored its state that we don't lose the new value
        mSavedUserVisibleHint = isVisibleToUser;
    }
}

setMaxLifecycle方法从名字就可以看出来是用于为 Fragment 设置一个最大的生命周期状态,实际上也的确是,state 参数值我们只能选择 CREATED、STARTED、RESUMED 三者之一

@NonNull
public FragmentTransaction setMaxLifecycle(@NonNull Fragment fragment,
        @NonNull Lifecycle.State state) {
    addOp(new Op(OP_SET_MAX_LIFECYCLE, fragment, state));
    return this;
}

在正常情况下,我们在 Activity 中 add 一个 Fragment 后其生命周期流程是会直接执行到 onResume 方法的

supportFragmentManager.commit {
    val fragment = FragmentLifecycleFragment.newInstance(
        fragmentTag = (tagIndex++).toString(),
        bgColor = Color.parseColor("#0091EA")
    )
    add(
        R.id.fragmentContainerView, fragment
    )
    setReorderingAllowed(true)
    addToBackStack(null)
}
Fragment-1: onAttach
Fragment-1: onCreate
Fragment-1: onCreateView
Fragment-1: onViewCreated
Fragment-1: onActivityCreated
Fragment-1: onViewStateRestored
Fragment-1: onStart
Fragment-1: onResume

而如果设置了setMaxLifecycle(fragment, Lifecycle.State.CREATED)的话,就会发现 Fragment 只会执行到 onCreate 方法,且 Fragment 也不会显示,毕竟 FragmentView 没有被创建,自然也不会被挂载到 Activity 中

supportFragmentManager.commit {
    val fragment = FragmentLifecycleFragment.newInstance(
        fragmentTag = (tagIndex++).toString(),
        bgColor = Color.parseColor("#0091EA")
    )
    add(
        R.id.fragmentContainerView, fragment
    )
    setMaxLifecycle(fragment, Lifecycle.State.CREATED)
    setReorderingAllowed(true)
    addToBackStack(null)
}
Fragment-1: onAttach
Fragment-1: onCreate

而如果 Fragment 已经回调了 onResume 方法,此时再来为其设置 setMaxLifecycle(fragment, Lifecycle.State.STARTED) 的话,就会发现 Fragment 会回调 onPause 方法

Fragment-1: onAttach
Fragment-1: onCreate
Fragment-1: onCreateView
Fragment-1: onViewCreated
Fragment-1: onActivityCreated
Fragment-1: onViewStateRestored
Fragment-1: onStart
Fragment-1: onResume

Fragment-1: onPause

怎么理解以上三种情况的差异呢?

其实,setMaxLifecycle 控制的是 FragmentLifecycle,同个 FragmentLifecycle 状态值对应的可能是不同的生命周期方法,就像以下图片所示。onResume方法对应的是 RESUMED,此时我们要求 FragmentLifecycle 的最大值是 STARTED,那么 Fragment 只能执行onPause 方法将状态值切换到 STARTED。而如果我们一开始就设置了最大值是 STARTED 的话,Fragment 就只会从 onAttach 执行到 onStart 方法,此时 FragmentLifecycle 一样是 STARTED

所以说,setMaxLifecycle 方法会根据 Fragment 的现有状态来加大或者回退当前的 FragmentLifecycle,选择合适的回调路线来进行状态切换

setMaxLifecycle 方法目前已经应用于 ViewPager2 中的 FragmentStateAdapter 了。当 Fragment 被切出时,就将其最大状态设置为 STARTED,当 Fragment 被切入时,就将其最大状态设置为 RESUMED,从而使得只有当前可见的 Fragment 才会被回调 onResume 方法,被切出的 Fragment 则会回调 onPause 方法,保证了每个 Fragment 都能处于正确的生命周期状态

void updateFragmentMaxLifecycle(boolean dataSetChanged) {
    ···
    Fragment toResume = null;
    for (int ix = 0; ix < mFragments.size(); ix++) {
        long itemId = mFragments.keyAt(ix);
        Fragment fragment = mFragments.valueAt(ix);

        if (!fragment.isAdded()) {
            continue;
        }

        if (itemId != mPrimaryItemId) {
            //重点
            transaction.setMaxLifecycle(fragment, STARTED);
        } else {
            toResume = fragment; // itemId map key, so only one can match the predicate
        }
        fragment.setMenuVisibility(itemId == mPrimaryItemId);
    }
    if (toResume != null) { // in case the Fragment wasn't added yet
        //重点
        transaction.setMaxLifecycle(toResume, RESUMED);
    }

    if (!transaction.isEmpty()) {
        transaction.commitNow();
    }
}

4、FragmentFactory

在以前,Fragment 要求开发者必须为每个子类均声明一个无参构造函数,因为当系统发生 Configuration Change 时,系统需要恢复重建每个 Fragment,如果 Fragment 包含一个或者多个有参构造函数的话,系统不知道应该调用哪个构造函数,而且也无法自动生成构造参数,因此只能选择通过反射无参构造函数的方式来完成实例化,这就要求每个子类都必须拥有一个无参构造函数了

为了解决该问题,按以往的方式我们都是通过声明一个静态工厂方法来提供实例化的入口,并通过 Bundle 来传递请求参数。当系统在恢复重建 Fragment 时也会自动将重建前的 Bundle 注入到新的实例中,从而保证请求参数不会缺失

class FragmentFactoryFragment : BaseFragment(R.layout.fragment_fragment_factory) {

    companion object {

        private const val KEY_BG_COLOR = "keyBgColor"

        fun newInstance(bgColor: Int): FragmentFactoryFragment {
            return FragmentFactoryFragment().apply {
                arguments = Bundle().apply {
                    putInt(KEY_BG_COLOR, bgColor)
                }
            }
        }

    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val bgColor = arguments?.getInt(KEY_BG_COLOR) ?: throw IllegalArgumentException()
        val flRoot = view.findViewById<View>(R.id.flRoot)
        flRoot.setBackgroundColor(bgColor)
    }

}

通过反射无参构造函数来实例化 Fragment 并注入 arguments 的过程,就对应 Fragment 中的 instantiate 方法

public static Fragment instantiate(@NonNull Context context, @NonNull String fname,
        @Nullable Bundle args) {
    try {
        Class<? extends Fragment> clazz = FragmentFactory.loadFragmentClass(
                context.getClassLoader(), fname);
        //反射无参构造函数
        Fragment f = clazz.getConstructor().newInstance();
        if (args != null) {
            args.setClassLoader(f.getClass().getClassLoader());
            //注入 Bundle
            f.setArguments(args);
        }
        return f;
    } catch (java.lang.InstantiationException e) {
        throw new InstantiationException("Unable to instantiate fragment " + fname
                + ": make sure class name exists, is public, and has an"
                + " empty constructor that is public", e);
    } catch (IllegalAccessException e) {
        throw new InstantiationException("Unable to instantiate fragment " + fname
                + ": make sure class name exists, is public, and has an"
                + " empty constructor that is public", e);
    } catch (NoSuchMethodException e) {
        throw new InstantiationException("Unable to instantiate fragment " + fname
                + ": could not find Fragment constructor", e);
    } catch (InvocationTargetException e) {
        throw new InstantiationException("Unable to instantiate fragment " + fname
                + ": calling Fragment constructor caused an exception", e);
    }
}

为了解决无法自由定义有参构造函数的问题,Fragment 如今也提供了 FragmentFactory 来参与实例化 Fragment 的过程

首先,假设 Fragment 的构造函数需要一个 int 类型的构造参数

class FragmentFactoryFragment(private val bgColor: Int) :
    BaseFragment(R.layout.fragment_fragment_factory) {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val flRoot = view.findViewById<View>(R.id.flRoot)
        flRoot.setBackgroundColor(bgColor)
    }

}

继承 FragmentFactory,在 instantiate方法中判断当前要实例化的是哪一个 Fragment,在此根据 bgColor 实例化 Fragment 并返回

class MyFragmentFactory(private val bgColor: Int) : FragmentFactory() {

    override fun instantiate(classLoader: ClassLoader, className: String): Fragment {
        val clazz = loadFragmentClass(classLoader, className)
        if (clazz == FragmentFactoryFragment::class.java) {
            return FragmentFactoryFragment(bgColor)
        }
        return super.instantiate(classLoader, className)
    }

}

之后我们在代码中仅需要向 supportFragmentManager 声明需要注入的 Fragment Class 即可,无需显式实例化,实例化过程交由 MyFragmentFactory 来完成

class FragmentFactoryActivity : BaseActivity() {

    override val bind by getBind<ActivityFragmentFactoryBinding>()

    override fun onCreate(savedInstanceState: Bundle?) {
        //需要在 super.onCreate 之前调用,因为 Activity 需要依靠 FragmentFactory 来完成 Fragment 的恢复重建
        supportFragmentManager.fragmentFactory = MyFragmentFactory(Color.parseColor("#00BCD4"))
        super.onCreate(savedInstanceState)
        supportFragmentManager.commit {
            add(R.id.fragmentContainerView, FragmentFactoryFragment::class.java, null)
            setReorderingAllowed(true)
            disallowAddToBackStack()
        }
    }

}

FragmentFactory 的好处有:

  • 将本应该直接传递给 Fragment 的构造参数转交给了 FragmentFactory,这样系统在恢复重建时就能统一通过 instantiate 方法来重新实例化 Fragment,而无需关心 Fragment 的构造函数
  • 只要 FragmentFactory 包含了所有 Fragment 均需要的构造参数,那么同个 FragmentFactory 就可以用于实例化多种不同的 Fragment,从而解决了需要为每个 Fragment 均声明静态工厂方法的问题,Fragment 也省去了向 Bundle 赋值取值的操作,减少了开发者的工作量

FragmentFactory 也存在着局限性:

  • 由于需要考虑 Fragment 恢复重建的场景,因此我们在 super.onCreate 之前就需要先初始化 supportFragmentManager.fragmentFactory,这样 Activity 在恢复重建的时候才能根据已有参数来重新实例化 Fragment,这就要求我们必须在一开始的时候就确定 FragmentFactory 的构造参数,也即 Fragment 的构造参数,而这在日常开发中并非总是能够做到的,因为 Fragment 的构造参数可能是需要动态生成的

5、Activity Result API

Activity 和 Fragment 中有两组历史悠久的 API 如今都已经被废弃了:

  • startActivityForResult()onActivityResult()
  • requestPermissions()onRequestPermissionsResult()

虽然这两组 API 所执行的操作并不一样,但都属于发起请求并等待回调结果的操作类型,官方建议使用新增的 registerForActivityResult 方法来实现这类需求,因为通过 Activity Result API 实现的代码更有复用性,减少了模板代码且易于测试

看个小例子。假设存在一个 ActivityResultApiFragment 和一个 ActivityResultApiTestActivity。Fragment 用于输入用户名,在拿到用户名后需要将值传递给 Activity,由其负责查询用户所在地,查到后再将值回传给 Fragment

按照需求,userName 和 location 都需要保存在 Intent 中,以便在两者之间实现数据交换,保存 userName 和取出 location 的过程都由 ActivityResultContract 来实现,对应 GetLocation

  • GetLocation 的两个泛型声明就分别对应着请求参数的数据类型以及返回参数的数据类型
  • createIntent方法用于保存请求参数 userName,并指定要启动的是 ActivityResultApiTestActivity
  • parseResult 方法会拿到 ActivityResultApiTestActivity 返回的 Intent 对象,如果判断为成功状态的话则直接取出 location 并返回
class GetLocation : ActivityResultContract<String, String>() {

    companion object {

        private const val KEY_REQ_LOCATION = "keyReqLocation"

        private const val KEY_RES_LOCATION = "keyResLocation"

        fun getUserName(intent: Intent): String {
            return intent.getStringExtra(KEY_REQ_LOCATION)
                ?: throw RuntimeException("userName must not be null")
        }

        fun putResultOk(location: String): Intent {
            return Intent().apply {
                putExtra(KEY_RES_LOCATION, location)
            }
        }

    }

    override fun createIntent(context: Context, input: String): Intent {
        val intent = Intent(context, ActivityResultApiTestActivity::class.java)
        intent.putExtra(KEY_REQ_LOCATION, input)
        return intent
    }

    override fun parseResult(resultCode: Int, intent: Intent?): String? {
        if (resultCode == Activity.RESULT_OK) {
            return intent?.getStringExtra(KEY_RES_LOCATION)
        }
        return null
    }

}

ActivityResultApiTestActivity 按照我们惯常的方式获取到请求参数,返回 RESULT_OK 状态码和结果值

class ActivityResultApiTestActivity : BaseActivity() {

    override val bind by getBind<ActivityActivityResultApiTestBinding>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        bind.btnFinish.setOnClickListener {
            val userName = GetLocation.getUserName(intent)
            setResult(Activity.RESULT_OK, GetLocation.putResultOk("$userName-广州"))
            finish()
        }
    }

}

ActivityResultApiFragment 通过 registerForActivityResult 方法来注册 GetLocation,需要的时候再通过getLocation.launch("业志陈")来传入用户名并启动 GetLocation,最终在 onActivityResult 方法中获取到请求结果

class ActivityResultApiFragment :
    Fragment(R.layout.fragment_activity_result_api) {

    private val getLocation: ActivityResultLauncher<String> =
        registerForActivityResult(
            GetLocation(),
            object : ActivityResultCallback<String> {
                override fun onActivityResult(result: String) {
                    Toast.makeText(activity, result, Toast.LENGTH_SHORT).show()
                }
            })

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val btnStartActivity = view.findViewById<Button>(R.id.btnStartActivity)
        btnStartActivity.setOnClickListener {
            getLocation.launch("业志陈")
        }
    }

}

类似地,官方也提供了一个用于请求权限的 ActivityResultContract 实现类:RequestMultiplePermissions,通过该 Contract 我们也能以很简单的方式完成以前割裂且麻烦的申请操作

class ActivityResultApiFragment :
    Fragment(R.layout.fragment_activity_result_api) {

    private val requestPermissions: ActivityResultLauncher<Array<String>> =
        registerForActivityResult(
            ActivityResultContracts.RequestMultiplePermissions(),
            object : ActivityResultCallback<Map<String, Boolean>> {
                override fun onActivityResult(result: Map<String, Boolean>) {
                    for (entry in result) {
                        Toast.makeText(activity, entry.key + " " + entry.value, Toast.LENGTH_SHORT)
                            .show()
                    }
                }
            })

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val btnRequestPermissions = view.findViewById<Button>(R.id.btnRequestPermissions)
        btnRequestPermissions.setOnClickListener {
            requestPermissions.launch(
                arrayOf(
                    Manifest.permission.ACCESS_NETWORK_STATE,
                    Manifest.permission.ACCESS_FINE_LOCATION
                )
            )
        }
    }

}

使用 Activity Result API 的好处有:

  • 完全隔绝了请求的发起者和处理者之间的引用关系,发起者直接面向于 ActivityResultContract,无需知道请求最终是交由谁处理,这样开发者就可以随时替换 ActivityResultContract 的具体实现逻辑了,避免耦合且易于测试
  • 请求的发起逻辑和处理逻辑都能够得到复用,减少了重复代码
  • 统一了 startActivityForResultrequestPermissions的请求方式,并提供了更加简洁方便的回调方法,避免了以前申请逻辑和回调逻辑是完全割裂开的情况

6、Fragment Result API

Activity Result API 适用于 Fragment 和非载体 Activity 之间进行数据通信的场景,如果是多个 Fragment 之间或者是 Fragment 和载体 Activity 之间要进行数据通信的话,我们可以选择的实现方法有很多种:

  • Fragment 通过 FragmentManager 拿到另一个 Fragment 的实例对象,通过直接调用对方的方法来实现多个 Fragment 之间的数据通信
  • Fragment 和 Activity 之间相互注册回调接口,以此来实现 Fragment 和载体 Activity 之间的数据通信
  • Fragment 以 Activity 作为中转站将事件转交给其它 Fragment,以此来实现多个 Fragment 之间的数据通信
  • Fragment 和 Activity 同时持有相同一个 Activity 级别的 ViewModel 实例,以此来实现多个 Fragment 之间、Fragment 和载体 Activity 之间的数据通信

以上四种方法都可以实现需求,但也存在着一些问题:

  • 前三种方法造成了 Fragment 之间、Fragment 和 Activity 之间存在强耦合,且由于并不清楚对方处于什么生命周期状态,一不小心就可能导致 NPE
  • 最后一种方法对于生命周期安全有保障,但如果只是简单的数据通信场景的话,使用 ViewModel 就有点大材小用了,ViewModel 比较适用于数据量稍大的业务场景

如今 Fragment 也有了一种新的选择:FragmentResult。使用 FragmentResult 进行数据通信不需要持有任何 Fragment 或者 Activity 的引用,仅需要使用 FragmentManager 就可以实现

看个小例子。声明一个 Activity 和两个 Fragment,分别向对方正在监听的 requestKey 下发数据,数据通过 Bundle 来进行传递,Activity 和 Fragment 只需要面向特定的 requestKey 来发送数据或者监听数据即可,无需关心数据的来源和去向

  • setFragmentResult 方法表示的是向 requestKey 下发数据
  • setFragmentResultListener 表示的是对 requestKey 进行监听
const val requestKeyToActivity = "requestKeyToActivity"

private const val requestKeyFirst = "requestKeyFirst"

private const val requestKeySecond = "requestKeySecond"

class FragmentResultApiAFragment : Fragment(R.layout.fragment_fragment_result_api_a) {

    private val requestKeyFirst = "requestKeyFirst"

    private val requestKeySecond = "requestKeySecond"

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val btnSend = view.findViewById<Button>(R.id.btnSend)
        val btnSendMsgToActivity = view.findViewById<Button>(R.id.btnSendMsgToActivity)
        val tvMessage = view.findViewById<TextView>(R.id.tvMessage)
        btnSend.setOnClickListener {
            val bundle = Bundle()
            bundle.putString("fromFragmentResultApiAFragment", Random.nextInt().toString())
            //向对 requestKeyFirst 进行监听的 Fragment 传递数据
            parentFragmentManager.setFragmentResult(requestKeyFirst, bundle)
        }
        btnSendMsgToActivity.setOnClickListener {
            val bundle = Bundle()
            bundle.putString("fromFragmentResultApiAFragment", Random.nextInt().toString())
            //向对 requestKeyToActivity 进行监听的 Activity 传递数据
            parentFragmentManager.setFragmentResult(requestKeyToActivity, bundle)
        }
        //对 requestKeySecond 进行监听
        parentFragmentManager.setFragmentResultListener(
            requestKeySecond,
            this,
            { requestKey, result ->
                tvMessage.text = "requestKey: $requestKey \n result: $result"
            })
    }

}

class FragmentResultApiBFragment : Fragment(R.layout.fragment_fragment_result_api_b) {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val btnSend = view.findViewById<Button>(R.id.btnSend)
        val tvMessage = view.findViewById<TextView>(R.id.tvMessage)
        btnSend.setOnClickListener {
            val bundle = Bundle()
            bundle.putString("fromFragmentResultApiBFragment", Random.nextInt().toString())
            //向对 requestKeySecond 进行监听的 Fragment 传递数据
            parentFragmentManager.setFragmentResult(requestKeySecond, bundle)
        }
        //对 requestKeyFirst 进行监听
        parentFragmentManager.setFragmentResultListener(
            requestKeyFirst,
            this,
            { requestKey, result ->
                tvMessage.text = "requestKey: $requestKey \n result: $result"
            })
    }

}

class FragmentResultApiActivity : BaseActivity() {

    override val bind by getBind<ActivityFragmentResultApiBinding>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        supportFragmentManager.setFragmentResultListener(
            requestKeyToActivity,
            this,
            { requestKey, result ->
                bind.tvMessage.text = "requestKey: $requestKey \n result: $result"
            })
    }

}

使用 Fragment Result API 的好处有:

  • Fragment Result API 并不局限于 Fragment 之间,只要 Activity 也持有和 Fragment 相同的 FragmentManager 实例,也可以用以上方式在 Activity 和 Fragment 之间实现数据通信。但需要注意,一个 requestKey 所属的数据只能被一个消费者得到,后注册的 FragmentResultListener 会把先注册的给覆盖掉
  • Fragment Result API 也可以用于在父 Fragment 和子 Fragment 之间传递数据,但前提是两者持有的是相同的 FragmentManager 实例。例如,如果要将数据从子 Fragment 传递给父 Fragment,父 Fragment 应通过getChildFragmentManager() 来调用setFragmentResultListener(),而不是getParentFragmentManager()
  • 数据的发送者只负责下发数据,不关心也不知道有多少个接收者,也不知道数据是否有被消费。数据的接收者只负责接收数据,不关心也不知道有多少个数据源。避免了 Activity 和 Fragment 之间存在引用关系,使得每个个体之间更加独立
  • 只有当 Activity 和 Fragment 至少处于 STARTED 状态,即只有处于活跃状态时才会接收到数据回调,非活跃状态下连续传值也只会保留最新值,当切换到 DESTROYED 状态时也会自动移除监听,从而保证了生命周期的安全性

每一个载体(Activity 或者 Fragment)都包含一个和自身同等级的 FragmentManager 用于管理子 Fragment,对应 Activity 的 supportFragmentManager 和 Fragment 的 childFragmentManager;每一个 子 Fragment 也都包含一个来自于载体的 FragmentManager,对应 Fragment 的 parentFragmentManager

7、OnBackPressed

Activity 包含有一个 onBackPressed方法用于响应用户点击返回键的操作,可用来控制是否允许用户退出当前页面,但 Fragment 并不包含类似方法。如果想要让 Fragment 也可以拦截用户的返回操作的话,按照以往的方法就需要通过在 Activity 和 Fragment 之间建立回调来进行拦截,这无疑也造成了两者之间存在耦合

如今开发者有了更好的实现方式:通过 OnBackPressedDispatcher 使得任意可以访问 Activity 的代码逻辑都可以拦截 onBackPressed方法

我们可以在 Fragment 中向 Activity 添加一个 OnBackPressedCallback 回调,传递的值 true 即代表该 Fragment 会拦截用户的每一次返回操作并进行回调,我们需要根据业务逻辑在合适的时候将其置为 false,从而放开对onBackPressed的控制权。此外,addCallback 方法的第一个参数是 LifecycleOwner 类型,也即当前的 Fragment 对象,该参数确保了仅在 Fragment 的生命周期至少处于 ON_START 状态时才进行回调,并在 ON_DESTROY 时自动移除监听,从而保证了生命周期的安全性

class PlaceholderFragment(private val sectionNumber: Int) :
    Fragment(R.layout.fragment_placeholder) {

    private val onBackPressedCallback = object : OnBackPressedCallback(true) {
        override fun handleOnBackPressed() {
            //TODO       
        }
    }

    override fun onAttach(context: Context) {
        super.onAttach(context)
        requireActivity().onBackPressedDispatcher.addCallback(this, onBackPressedCallback)
    }
    
}

8、Fragment 妙用

1、监听生命周期

我们在使用 Fragment 时往往都会为其指定布局文件,从而显示特定视图。但 Fragment 也可以不加载任何布局文件,此时 Fragment 就是完全无 UI 界面的,但只要该 Fragment 也挂载到了 Activity 或者父 Fragment 上,一样可以收到相应的生命周期回调,此时就可以通过对上层完全无感知的形式来间接获得载体的生命周期回调通知了

根据 Fragment 的这个特性实现的比较出名的组件和开源库有:Jetpack Lifecycle 和 Glide

Jetpack Lifecycle

熟悉 Jetpack 的同学应该都知道,我们是通过 Lifecycle 来收到 Activity 生命周期状态变化的通知的,而 Lifecycle 就是通过向 Activity 注入一个无 UI 界面的 Fragment 得知 Activity 生命周期状态变化的

现在我们在日常开发中使用的 AppCompatActivity 最终会继承于 ComponentActivity,ComponentActivity 的 onCreate 方法是这样的:

@SuppressLint("RestrictedApi")
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ReportFragment.injectIfNeededIn(this);
}

ReportFragment 的 injectIfNeededIn() 是一个静态方法,以 android.app.Activity 对象作为入参参数,此方法内部就会向 Activity 添加一个无 UI 界面的 ReportFragment

 public static void injectIfNeededIn(Activity activity) {
    if (Build.VERSION.SDK_INT >= 29) {
        // On API 29+, we can register for the correct Lifecycle callbacks directly
        activity.registerActivityLifecycleCallbacks(
                new LifecycleCallbacks());
    }
    //向 activity 添加一个不可见的 framework 中的 fragment,以此来取得 Activity 生命周期事件的回调
    android.app.FragmentManager manager = activity.getFragmentManager();
    if (manager.findFragmentByTag(REPORT_FRAGMENT_TAG) == null) {
        manager.beginTransaction().add(new ReportFragment(), REPORT_FRAGMENT_TAG).commit();
        // Hopefully, we are the first to make a transaction.
        manager.executePendingTransactions();
    }
}

ReportFragment 就通过自身的各个回调方法来间接获得 Activity 生命周期事件的回调通知

@Override
public void onActivityCreated(Bundle savedInstanceState) {
    super.onActivityCreated(savedInstanceState);
    ···
    dispatch(Lifecycle.Event.ON_CREATE);
}

@Override
public void onStart() {
    super.onStart();
    ···
    dispatch(Lifecycle.Event.ON_START);
}

@Override
public void onDestroy() {
    super.onDestroy();
    dispatch(Lifecycle.Event.ON_DESTROY);
    ···
}

更多细节看这篇文章:从源码看 Jetpack(1)-Lifecycle 源码详解

Glide

我们加载的图片通常是要显示在 ImageView 中的,而 ImageView 是会挂载在 Activity 或者 Fragment 等容器上的,当容器处于后台或者已经被 finish 时,此时加载图片的操作就应该被取消或者停止,否则也是在浪费宝贵的系统资源和网络资源,甚至可能发生内存泄露或者 NPE。那么,显而易见的一个问题就是,Glide 是如何判断容器是否还处于活跃状态的呢?

类似于 Jetpack 组件中的 Lifecycle 的实现思路,Glide 也是通过一个无 UI 界面的 Fragment 来间接获取容器的生命周期状态的

首先,Glide 包含一个 LifecycleListener,定义了三种事件通知回调,用于通知容器的活跃状态:是处于前台、后台、还是已经退出了。具体的实现类是 ActivityFragmentLifecycle

public interface LifecycleListener {
  void onStart();
  void onStop();
  void onDestroy();
}

ActivityFragmentLifecycle 用于 SupportRequestManagerFragment 这个 Fragment 中来使用(省略了部分代码)。可以看到,在 Fragment 的三个生命周期回调事件中,都会相应通知 ActivityFragmentLifecycle。那么,不管 ImageView 的载体是 Activity 还是 Fragment,我们都可以向其注入一个无 UI 界面的 SupportRequestManagerFragment,以此来监听载体在整个生命周期内活跃状态的变化

public class SupportRequestManagerFragment extends Fragment {
    
  private static final String TAG = "SupportRMFragment";
    
  private final ActivityFragmentLifecycle lifecycle;

  public SupportRequestManagerFragment() {
    this(new ActivityFragmentLifecycle());
  }

  @VisibleForTesting
  @SuppressLint("ValidFragment")
  public SupportRequestManagerFragment(@NonNull ActivityFragmentLifecycle lifecycle) {
    this.lifecycle = lifecycle;
  }

  @NonNull
  ActivityFragmentLifecycle getGlideLifecycle() {
    return lifecycle;
  }

  @Override
  public void onStart() {
    super.onStart();
    lifecycle.onStart();
  }

  @Override
  public void onStop() {
    super.onStop();
    lifecycle.onStop();
  }

  @Override
  public void onDestroy() {
    super.onDestroy();
    lifecycle.onDestroy();
    unregisterFragmentWithRoot();
  }

  @Override
  public String toString() {
    return super.toString() + "{parent=" + getParentFragmentUsingHint() + "}";
  }
    
}

更多细节看这篇文章:三方库源码笔记(9)-Glide 源码详解

2、方法代理

Fragment 还有一种特殊的用法。我们平时是通过 requestPermissions()onRequestPermissionsResult() 等方法来申请权限的,在一个地方发起权限申请操作,在另一个特定方法里拿到申请结果,整个流程是异步且割裂开的。而 Fragment 包含了很多个和 Activity 完全一样的 API,其中就包括这两个权限申请方法,因此我们可以通过自动向载体挂载一个无 UI 界面的 Fragment,让 Fragment 来代理整个权限申请流程,使得载体可以用流式申请的方式来完成整个操作

这里提供一个简单的小例子,代码很简单,就不再过多讲解了

/**
 * @Author: leavesCZY
 * @Desc:
 * @公众号:字节数组
 */
class RequestPermissionsFragment : Fragment() {

    companion object {

        private const val EXTRA_PERMISSIONS = "github.leavesC.extra.PERMISSIONS"

        private const val REQUEST_CODE = 100

        fun request(
            activity: FragmentActivity,
            permissions: Array<String>,
            onRequestResult: ((Array<String>, IntArray) -> Unit)
        ) {
            val bundle = Bundle()
            bundle.putStringArray(EXTRA_PERMISSIONS, permissions)
            val requestPermissionsFragment = RequestPermissionsFragment()
            requestPermissionsFragment.arguments = bundle
            requestPermissionsFragment.onRequestResult = onRequestResult
            activity.supportFragmentManager.commit {
                setReorderingAllowed(true)
                addToBackStack(null)
                add(requestPermissionsFragment, null)
            }
        }

    }

    private val permissions by lazy {
        requireArguments().getStringArray(EXTRA_PERMISSIONS) ?: throw IllegalArgumentException()
    }

    private var onRequestResult: ((Array<String>, IntArray) -> Unit)? =
        null

    override fun onAttach(context: Context) {
        super.onAttach(context)
        requestPermissions(permissions, REQUEST_CODE)
    }

    override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<String>,
        grantResults: IntArray
    ) {
        onRequestResult?.invoke(permissions, grantResults)
        parentFragmentManager.popBackStack()
    }

    override fun onDestroyView() {
        super.onDestroyView()
        onRequestResult = null
    }

}

之后在 FragmentActivity 或者 Fragment 中就可以通过以下方式来完成整个权限申请操作了,直接在回调里拿到申请结果

RequestPermissionsFragment.request(
    fragmentActivity,
    arrayOf(
        Manifest.permission.ACCESS_FINE_LOCATION,
        Manifest.permission.CAMERA
    )
) { permissions: Array<String>,
    grantResults: IntArray ->
    permissions.forEachIndexed { index, s ->
        showToast("permission:" + s + " grantResult:" + grantResults[index])
    }
}

9、结尾

自我感觉本篇文章已经讲清楚了 Fragment 大部分的知识点了,陆陆续续写了一万多字,有基础知识也有新知识,也许也包含了一些你还没了解过的知识点,看完之后你有觉得 Fragment 如今真的在变得越来越好用了吗 🤣🤣 有遗漏的知识点欢迎补充

最后当然也少不了本文的全部示例代码了:AndroidOpenSourceDemo