Jetpack 笔记之——Lifecycle 浅析

最近看到一个问题:活多钱少只有死工资怎么办?下面有个回答挺好的,分享给大家:1)认识到“所有的问题都是自己的问题”;2)想学习什么新技能,关键是看工作之外投入的时间,而非工作时间;3)成年之后,任何人的评价都不重要,重要的是你自己想要什么,想过什么生活,并为此付出什么努力;4)再基础的岗位工作,都可以学到东西,做到超出预期,就可以往上走;5)公司不接受没有任何经验,且看不到主动性的人6)能力不够之前,不要轻易辞职。

本文阅读大概需要 12min

Android 这些年的发展还是挺快的,不仅推出了全新的 Kotlin 语言替代 Java,还推出了一系列的 Jetpack 工具库。如果现在还不知道 Jetpack,那就说明同学你该补补课了。本笔记是 Jetpack 中 Lifecycle 的介绍与浅析,期待还有后续。(应该会有,因为学无止境啊~)

Lifecycle 是 Android Jetpack 工具包中的一个工具库,Jetpack 中的工具可以分为四个部分:架构(Architecture)、基础(Foundation)、行为(Behavior)、界面(UI)。

Jetpack 笔记之——Lifecycle 浅析
Jetpack 四大组成部分

其中,架构部分是 Jetpack 工具包的精华所在,大家耳熟能详的 DataBinding、LiveData、ViewModel等都是属于 Architecture 架构部分。Lifecycle 的地位就可想而知了。

1、背景

众所周知,Activity 是有自己的生命周期的,从 onCreate 创建一直到 onDestroy 销毁,我们会在 Activity 的各个生命周期中做相应的处理,完成业务逻辑的开发工作。 比如,某些功能组件需要在 Activity 或者 Fragment 的某些生命周期函数中做一些初始化,资源回收等等操作。久而久之,Activity 中的代码体积就会变得臃肿,功能组件也与 Activity 耦合在一起了。

为了解决这个问题,google 就开发出了 Lifecycle 这个工具库。

官方文档上有个例子,假如 Activity 中有一个定位的功能组件,如果没有使用 Lifecycle,大致的实现是这样的:

 1// code 1
2    // 1、开发自己的功能组件,实现相关功能
3    class MyLocationListener {
4        public MyLocationListener(Context context, Callback callback) {
5            // ...
6        }
7
8        void start() {
9            // 连接系统定位服务
10        }
11
12        void stop() {
13            // 断开系统定位服务
14        }
15    }
16
17    // 2、在 Activity 中调用自己开发的功能组件,并在 Activity 生命周期中进行相应操作
18    class MyActivity extends AppCompatActivity {
19        private MyLocationListener myLocationListener;
20
21        @Override
22        public void onCreate(...) {
23            // 初始化自己开发的功能组件
24            myLocationListener = new MyLocationListener(this, (location) -> {
25                // 更新 UI
26            });
27        }
28
29        @Override
30        public void onStart() {
31            super.onStart();
32            myLocationListener.start();
33            // 管理其他需要响应 activity 生命周期的组件
34        }
35
36        @Override
37        public void onStop() {
38            super.onStop();
39            myLocationListener.stop();
40            // 管理其他需要响应 activity 生命周期的组件
41        }
42    }

2、Lifecycle 的使用

引入 Lifecycle 之后,我们就可以在定位组件的内部监听到 Activity 的生命周期的变化,从而执行相应的操作。不需要在 Activity 的各个生命周期方法中调用自身的业务逻辑方法,从而实现功能组件与 Activity 的相互隔离与解耦,减少 Activity 中的代码量。

大体的思想就是一个观察者模式,具有生命周期的 Activity、Fragment 等作为被观察者;需要在不同的生命周期中执行不同的业务逻辑的功能组件作为观察者,当观察者监听到生命周期发生变化时,执行相应的业务逻辑。具有生命周期的 Activity、Fragment 等,在下文中我们用 生命周期持有者(LifecycleOwner)来称呼;我们自己开发的需要依赖于生命周期的功能组件,在下文中用 生命周期观察者(LifecycleObserver)进行称呼。

2.1 引入依赖

如果是非 AndroidX 项目,则引入:

1// code 2
2implementation "android.arch.lifecycle:extensions:1.1.1"

如果是 AndroidX 项目,则引入:

1// code 3
2implementation 'androidx.appcompat:appcompat:1.2.0'

如果只需要使用 Lifecycle,不需要其他的 ViewModel、LiveData等等的话,则只需要引入 lifecycle-runtime 包即可。

2.2 实现 Lifecycle 观察者

这个 Lifecycle 观察者就是我们自己开发的功能组件,加上 LifecycleObserver 接口就可以通过注解的方式来编码各个生命周期需要执行的业务逻辑。如代码所示:

 1// code 4
2class MyLocationListener implements LifecycleObserver {
3    MyLocationListener(Activity activity, OnLocationChangedListener onLocationChangedListener) {
4        // 初始化
5        initLocationManager();
6    }
7
8    // 当 Activity 执行 onResume 方法时,自动调用该方法
9    @OnLifecycleEvent(Lifecycle.Event.ON_RESUME)
10    private void startGetLocation(){
11        Log.i(TAG, "startGetLocation() is executed");
12    }
13
14    // 当 Activity 执行 onPause 方法时,自动调用该方法
15    @OnLifecycleEvent(Lifecycle.Event.ON_PAUSE)
16    private void stopGetLocation(){
17        Log.i(TAG, "stopGetLocation() is executed");
18    }
19
20    private void initLocationManager(){
21        Log.i(TAG, "initLocationManager() is executed");
22    }
23
24    // 当位置发生变化时,通过该接口通知调用方
25    public interface OnLocationChangedListener{
26        void onChange(double latitude, double longitude);
27    }
28}

2.3 生命周期持有者添加观察者

在 Android 中具有生命周期的一般是 Activity、Fragment,先通过 getLifecycle 方法获得 Lifecycle 生命周期对象,Lifecycle 对象使用 addObserver 方法给自己添加观察者,即 MyLocationListener。这样一来,当 Lifecycle 生命周期发生变化,MyLocationListener 就会收到通知,做相应的操作。

 1// code 5
2public class MainActivity extends AppCompatActivity {
3
4    @Override
5    protected void onCreate(Bundle savedInstanceState) {
6        super.onCreate(savedInstanceState);
7        setContentView(R.layout.activity_main);
8
9        MyLocationListener myLocationListener = new MyLocationListener(this,
10                new MyLocationListener.OnLocationChangedListener() {
11            @Override
12            public void onChange(double latitude, double longitude) {
13                // 位置发生变化时,调用该方法
14            }
15        });
16
17        // 将观察者(MyLocationListener)与被观察者(MainActivity)绑定
18        getLifecycle().addObserver(myLocationListener);
19    }
20}

那么,这种观察者模式是怎样建立起来的呢?我们可以去看看 Jetpack 中 Lifecycle 相关源码。

3、Lifecycle 源码浅析

下面的源码分析是基于 lifecycle-runtime:2.1.0、lifecycle-common:2.1.0 版本。从 getLifecycle() 方法进入,发现是来到了 ComponentActivity 中,ComponentActivity 就是 Activity 的基类,代码如下:

1// code 6
2    // ComponentActivity.java 类
3    @NonNull
4    @Override
5    public Lifecycle getLifecycle() {
6        return mLifecycleRegistry;
7    }

还可以看出,其实 ComponentActivity 只是实现了 LifecycleOwner 这个接口

 1// code 7
2// LifecycleOwner.java 接口文件
3public interface LifecycleOwner {
4    /**
5     * Returns the Lifecycle of the provider.
6     *
7     * @return The lifecycle of the provider.
8     */

9    @NonNull
10    Lifecycle getLifecycle();
11}
12
13// ComponentActivity 实现了 LifecycleOwner 接口
14public class ComponentActivity extends androidx.core.app.ComponentActivity implements
15        LifecycleOwner,
16        ViewModelStoreOwner,
17        SavedStateRegistryOwner,
18        OnBackPressedDispatcherOwner 
{
19        ···
20}

回过头来再看看 ComponentActivity 中的 getLifecycle 方法,返回了一个 Lifecycle 对象,这个对象是在 ComponentActivity 中 new 出来的,并将 Activity 实例传参给了它:

1// code 8
2private final LifecycleRegistry mLifecycleRegistry = new LifecycleRegistry(this);

LifecycleRegistry 类是一个 Lifecycle 的实现类,Lifecycle 本身只是一个抽象类,里面定义了一些生命周期中的状态 State 以及切换生命周期的一些事件 Event,还有一些抽象方法:

 1// code 9
2public abstract class Lifecycle {
3    ...
4    // 添加生命周期观察者 抽象方法
5    @MainThread
6    public abstract void addObserver(@NonNull LifecycleObserver observer);
7    // 移除生命周期观察者 抽象方法
8    @MainThread
9    public abstract void removeObserver(@NonNull LifecycleObserver observer);
10    // 获取当前生命周期状态 抽象方法
11    @MainThread
12    @NonNull
13    public abstract State getCurrentState();
14    // 定义的事件值,对应 Activity 的各个生命周期发生事件
15    @SuppressWarnings("WeakerAccess")
16    public enum Event {
17        ON_CREATE,
18        ON_START,
19        ON_RESUME,
20        ON_PAUSE,
21        ON_STOP,
22        ON_DESTROY,
23        ON_ANY    // 可以响应任何一个事件
24    }
25    // 生命周期状态值
26    @SuppressWarnings("WeakerAccess")
27    public enum State {
28        DESTROYED,
29        INITIALIZED,
30        CREATED,
31        STARTED,
32        RESUMED;
33
34        /**
35         * Compares if this State is greater or equal to the given {@code state}.
36         *
37         * @param state State to compare with
38         * @return true if this State is greater or equal to the given {@code state}
39         */

40        public boolean isAtLeast(@NonNull State state) {
41            return compareTo(state) >= 0;
42        }
43    }
44}

再来看看 LifecycleRegistry 类具体实现了 Lifecycle 中的哪些方法。

3.1 LifecycleRegistry 类具体实现

首先,它内部是用一个类似 Map 的数据结构来存储添加的生命周期观察者的:

1// code 10
2private FastSafeIterableMap<LifecycleObserver, ObserverWithState> mObserverMap =
3            new FastSafeIterableMap<>();

Key 是将要存储的观察者,Value 是将这个观察者赋予一个 State 状态,然后存到 Value 中,看它们的命名也可以理解。这个数据结构是为了管理所有的观察者,方便添加和移除。

先看看添加观察者的 addObserver 方法在 LifecycleRegistry 类的具体实现 :

 1// code 11
2    // LifecycleRegistry.java 类
3    @Override
4    public void addObserver(@NonNull LifecycleObserver observer) {
5        // 根据 LifecycleOwner 的生命周期状态 mState 初始化一个 状态赋给 将添加的观察者
6        State initialState = mState == DESTROYED ? DESTROYED : INITIALIZED;
7        ObserverWithState statefulObserver = new ObserverWithState(observer, initialState);
8        ObserverWithState previous = mObserverMap.putIfAbsent(observer, statefulObserver);
9
10        if (previous != null) {
11            return;    // 不为空 说明 observer 之前已添加过,则返回不再处理
12        }
13        LifecycleOwner lifecycleOwner = mLifecycleOwner.get();
14        // 获取的是 LifecycleOwner 的一个弱引用,如果 为空则说明被回收了,就不往下执行了
15        if (lifecycleOwner == null) {
16            // it is null we should be destroyed. Fallback quickly
17            return;
18        }
19
20        // 是否重入 判断,如果正在添加的观察者不为0 或 正在处理 Event 事件,则发生了重入
21        boolean isReentrance = mAddingObserverCounter != 0 || mHandlingEvent;
22        State targetState = calculateTargetState(observer);    // 计算出目标状态
23        mAddingObserverCounter++;
24        // while 循环里处理的事情就是,避免 该 observer 因为添加的晚,使得一些生命周期流转分发事件
25        // 没有被分发给 该 observer。有点像 粘性广播 的意思
26        while ((statefulObserver.mState.compareTo(targetState) < 0
27                && mObserverMap.contains(observer))) {
28            pushParentState(statefulObserver.mState);
29            statefulObserver.dispatchEvent(lifecycleOwner, upEvent(statefulObserver.mState));
30            popParentState();
31            // mState / subling may have been changed recalculate
32            targetState = calculateTargetState(observer);
33        }
34
35        if (!isReentrance) {
36            // we do sync only on the top level.
37            sync();    // 同步所有观察者状态,后面会细说
38        }
39        mAddingObserverCounter--;
40    }

代码注释的比较清楚了。这里补充说明下 calculateTargetState 方法是如何计算出新添加的 LifecycleObserver 的目标状态 State 的,可以看一下它的代码

 1// code 12
2    private State calculateTargetState(LifecycleObserver observer{
3        // 首先获取 前一个添加的观察者 previous
4        Entry<LifecycleObserver, ObserverWithState> previous = mObserverMap.ceil(observer);
5        // previous 不为空时,获得 previous 的状态值赋给 siblingState
6        State siblingState = previous != null ? previous.getValue().mState : null;
7        // mParentStates 列表不为空时,将最近添加的 state 值赋给 parentState
8        State parentState = !mParentStates.isEmpty() ? mParentStates.get(mParentStates.size() - 1)
9                : null;
10        return min(min(mState, siblingState), parentState);
11    }

它是取 mState、parentState、siblingState 中的最小值作为自己的 targetState。然后需要将自己的状态一步步切换到 targetState,如何进行的,后面会细说。

再来看看 LifecycleRegistry 类的实例化。new 一个 LifecycleRegistry 类时,会将 LifecycleOwner 的弱引用传进去,并将 state 初始化为 INITIALIZED。

1// code 13
2public LifecycleRegistry(@NonNull LifecycleOwner provider) {
3        mLifecycleOwner = new WeakReference<>(provider);
4        mState = INITIALIZED;
5    }

因为 LifecycleOwner 一般是 Activity、Fragment,所以用弱引用持有它们可以防止内存泄漏。

从 Lifecycle 抽象类中定义的状态枚举类型和事件枚举类型就可以看出,生命周期状态的流转,都是通过执行这些事件 Event 串起来的。比如说,ON_CREATE 事件发生后,生命周期状态就会从 INITIALIZED 流转到 CREATED 状态。生命周期状态的流转是通过 handleLifecycleEvent 这个方法实现的。

1// code 14
2// 处理生命周期转换事件
3public void handleLifecycleEvent(@NonNull Lifecycle.Event event{
4        State next = getStateAfter(event);    // 首先求出 执行 event 事件之后的生命周期 状态值 state
5        moveToState(next);    // 然后将 state 设置为 新的生命周期状态
6}

在 getStateAfter 方法中,求出在执行了 event 事件之后,生命周期的状态。具体的代码很简单:

 1// code 15
2static State getStateAfter(Event event{
3        switch (event) {
4            case ON_CREATE:
5            case ON_STOP:
6                return CREATED;
7            case ON_START:
8            case ON_PAUSE:
9                return STARTED;
10            case ON_RESUME:
11                return RESUMED;
12            case ON_DESTROY:
13                return DESTROYED;
14            case ON_ANY:
15                break;
16        }
17        throw new IllegalArgumentException("Unexpected event value " + event);
18    }

看代码可能会觉得纳闷,为啥 ON_STOP 事件之后进入 CREATED 状态?我理解的是官方考虑到 CREATED 和 停止状态(STOPPED)可以合并为同一个状态,CREATED 状态其实就是 STARTED 状态前的一种状态,也就是 停止状态(STOPPED)。可以参考官方文档的这张图帮助理解: 

Jetpack 笔记之——Lifecycle 浅析
图1 构成生命周期的状态和事件

所以,一个完整的生命周期过程是:从 Initialized 开始,到 Resumed;再从 Resumed 到 Destroyed 结束。在图上就是从左到右,再从右到左。

拿到下一个状态值后,再调用 moveToState 方法将生命周期持有者的状态切换到新的状态值。

 1// code 16
2private void moveToState(State next) {
3        if (mState == next) {    // 如果已接切换完成,则跳过
4            return;
5        }
6        mState = next;    // 状态重置为新的值
7        if (mHandlingEvent || mAddingObserverCounter != 0) {
8            // 如果上一次状态切换还未完成(mHandlingEvent = true),或者存在正在添加中的观察者
9            mNewEventOccurred = true;    // 出现新的状态值
10            // we will figure out what to do on upper level.
11            return;
12        }
13        mHandlingEvent = true;    // 正在处理状态切换 标记位
14        sync();    // 将新的生命周期状态同步给所有的观察者
15        mHandlingEvent = false;
16    }


将自身的生命周期状态更新后,还得将新的状态同步给所有的观察者,这就是 sync 方法需要处理的。

 1// code 17
2    // 同步生命周期状态方法
3    private void sync() {
4        LifecycleOwner lifecycleOwner = mLifecycleOwner.get();
5        // 由于之前为了防止内存泄漏,将 LifecycleOwner 包装成了一个弱引用,所以这里需要检查一下是否被回收了
6        if (lifecycleOwner == null) {
7            throw new IllegalStateException("LifecycleOwner of this LifecycleRegistry is already"
8                    + "garbage collected. It is too late to change lifecycle state.");
9        }
10        while (!isSynced()) {
11            mNewEventOccurred = false;
12            // no need to check eldest for nullability, because isSynced does it for us.
13            if (mState.compareTo(mObserverMap.eldest().getValue().mState) < 0) {
14                backwardPass(lifecycleOwner);
15            }
16            Entry<LifecycleObserver, ObserverWithState> newest = mObserverMap.newest();
17            if (!mNewEventOccurred && newest != null
18                    && mState.compareTo(newest.getValue().mState) > 0) {
19                forwardPass(lifecycleOwner);
20            }
21        }
22        mNewEventOccurred = false;
23    }
24
25    ...
26    // 判断是否已经同步完成
27    private boolean isSynced() {
28        // 如果没有生命周期观察者了,那肯定就不用同步了
29        if (mObserverMap.size() == 0) {
30            return true;
31        }
32        State eldestObserverState = mObserverMap.eldest().getValue().mState;
33        State newestObserverState = mObserverMap.newest().getValue().mState;
34        return eldestObserverState == newestObserverState && mState == newestObserverState;
35    }

先来看看它是怎么判断已经同步完成的。在 isSynced 方法中,获取所有观察者中最先添加和最近添加的观察者的生命周期状态值,当这两者的状态值都与当前生命周期持有者的状态值(mState)相同,就说明同步完成了。

再来看看 sync 同步方法,有一个 while 循环,当还未同步完成时,会先判断当前状态是否在最先添加的观察者的状态值的前面(mState < eldest().getValue().mState),如果是,则调用 backwardPass 方法。

 1// code 18
2    private void backwardPass(LifecycleOwner lifecycleOwner{
3        Iterator<Entry<LifecycleObserver, ObserverWithState>> descendingIterator =
4                mObserverMap.descendingIterator();
5        while (descendingIterator.hasNext() && !mNewEventOccurred) {
6            Entry<LifecycleObserver, ObserverWithState> entry = descendingIterator.next();
7            ObserverWithState observer = entry.getValue();
8            while ((observer.mState.compareTo(mState) > 0 && !mNewEventOccurred
9                    && mObserverMap.contains(entry.getKey()))) {
10                Event event = downEvent(observer.mState);
11                pushParentState(getStateAfter(event));
12                observer.dispatchEvent(lifecycleOwner, event);
13                popParentState();
14            }
15        }
16    }

在 backwardPass 方法中,首先初始化了一个 递减迭代器,即这个迭代器是从最近添加的观察者开始遍历,一直遍历到最初添加的观察者(之所以这样的遍历顺序是递减迭代器,是因为越在前面添加的观察者,它的 state 越小,这里的递减是指 state 是递减的顺序),要完成所有观察者的状态的更改,这是第一层的 while 循环。如果这个时候又有新的 Event 事件发生,则中止同步过程,节省系统资源,因为这个时候可能会产生新的状态值。

第二层循环开始前,再次确认观察者状态值比当前状态值要大,且没有新的 Event 出现,以及该观察者没有被移除。然后调用 downEvent 方法根据观察者现在的状态,得到 Event 事件:

 1// code 19
2    // 降低 state 值的方法
3    private static Event downEvent(State state) {
4        switch (state) {
5            case INITIALIZED:
6                throw new IllegalArgumentException();
7            case CREATED:
8                return ON_DESTROY;
9            case STARTED:
10                return ON_STOP;
11            case RESUMED:
12                return ON_PAUSE;
13            case DESTROYED:
14                throw new IllegalArgumentException();
15        }
16        throw new IllegalArgumentException("Unexpected state value " + state);
17    }

仔细看 downEvent 方法中的每个状态对应的返回事件,结合之前的状态事件流程图图1,可以发现 downEvent 方法处理的是 state 状态后接下来发生的 event,对应图1 中从右向左的过程,不考虑向左的事件流程。这样做就可以将观察者的 state 逐渐减小,直至与当前生命周期持有者的状态值(mState)相同。如图2所示:

Jetpack 笔记之——Lifecycle 浅析
图2 downEvent 方法减小 state 值示意图

对应地,还有个 upEvent 方法,这个方法会不会就是处理图1 中从左到右的过程呢?查看代码,果然如此:

 1// code 20
2    // 升高 state 值的方法
3    private static Event upEvent(State state) {
4        switch (state) {
5            case INITIALIZED:
6            case DESTROYED:
7                return ON_CREATE;
8            case CREATED:
9                return ON_START;
10            case STARTED:
11                return ON_RESUME;
12            case RESUMED:
13                throw new IllegalArgumentException();
14        }
15        throw new IllegalArgumentException("Unexpected state value " + state);
16    }

例如 CREATED 状态向右的 Event 就是 ON_START,而 RESUMED 没有向右的事件,所以就向外抛出异常。

再来看 downEvent 方法之后,调用了 pushParentState 方法,这个方法就是记录了该观察者下一个状态,等到观察者分发了 Event 事件之后,再把这个状态记录删除掉,也就是后面的 popParentState 方法。重点就是中间的这个 dispatchEvent 分发事件的方法。这个方法是由该观察者调用的,将之前调用 downEvent 方法得到的 event 事件分发出去,具体的代码如下:

1// code 21
2        void dispatchEvent(LifecycleOwner owner, Event event{
3            State newState = getStateAfter(event);
4            mState = min(mState, newState);
5            mLifecycleObserver.onStateChanged(owner, event);
6            mState = newState;
7        }

这个方法是属于观察者内部类,里面的 mState 并不是生命周期持有者的当前状态,而是这个观察者的当前状态,所以方法的最后把这个值更新为新的状态值了。在更新之前还调用了 onStateChanged 方法,这个方法是 LifecycleEventObserver 接口中的方法,而 LifecycleEventObserver 是继承自 LifecycleObserver,在 LifecycleEventObserver 的注释中有这样一句:

If a class implements this interface and in the same time uses {@link OnLifecycleEvent}, then annotations will be ignored.

翻译过来就是,如果一个类实现了这个接口,同时也使用了{@link OnLifecycleEvent}(即使用 @OnLifecycleEvent(Lifecycle.Event.ON_RESUME)),那么后者的 annotation 注解的方法就不会被执行。也就是说,各个生命周期中执行的相应操作,都是在这里的 onStateChanged 方法中执行的。接口方法具体的实现交给了开发者,也就是被 @OnLifecycleEvent(Lifecycle.Event.ON_RESUME) 等等标记的方法。

到这里终于可以总结一下生命周期持有者 LifecycleOwner 是如何处理生命周期事件的了。LifecycleOwner 通过执行 handleLifecycleEvent 方法,处理收到的生命周期事件 Event。首先,根据 Event 得到下一个生命周期状态,将自身状态更新;然后,将状态的变动同步给所有观察它的观察者;观察者们用自己的状态与 LifecycleOwner 的状态做比对,逐步算出要达到与 LifecycleOwner 状态一致所需的 event 事件,并逐步将这些 event 分发出去;这样,观察者内部就可以接收到这些 event,并可以根据不同的 event 做不同的业务操作了。

回头再看一下 sync 方法,在 backwardPass 方法执行完后,接下来会获取最近添加的观察者。当 LifecycleOwner 的当前状态比最近添加的观察者的状态值要大,那么就会调用 forwardPass 方法:

 1// code 22
2    private void forwardPass(LifecycleOwner lifecycleOwner) {
3        Iterator<Entry<LifecycleObserver, ObserverWithState>> ascendingIterator =
4                mObserverMap.iteratorWithAdditions();
5        while (ascendingIterator.hasNext() && !mNewEventOccurred) {
6            Entry<LifecycleObserver, ObserverWithState> entry = ascendingIterator.next();
7            ObserverWithState observer = entry.getValue();
8            while ((observer.mState.compareTo(mState) < 0 && !mNewEventOccurred
9                    && mObserverMap.contains(entry.getKey()))) {
10                pushParentState(observer.mState);
11                observer.dispatchEvent(lifecycleOwner, upEvent(observer.mState));
12                popParentState();
13            }
14        }
15    }

与 backwardPass 方法相反,forwardPass 方法是通过一个递增迭代器,从最初添加的观察者开始一直遍历到最近添加的观察者,依次更改所有观察者的状态。第一层 while 循环就是遍历所有的观察者;第二层 while 循环里就是将每个观察者的状态逐步地更新成与 LifecycleOwner 的状态 mState 一样,并将 event 事件分发。

3.2 ReportFragment 类简述

前文终于弄清楚了生命周期状态的更新与分发过程。再来看一看是在哪里调用 handleLifecycleEvent 方法开始处理生命周期事件的,如下图所示。

Jetpack 笔记之——Lifecycle 浅析
图3 handleLifecycleEvent 调用方汇总
  • Fragment 有自己的生命周期,所以它里面肯定会调用 handleLifecycleEvent 方法。

  • FragmentActivity 里面调用 handleLifecycleEvent 方法的对象,并不是 Activity 的 Lifecycle 对象,而是 Fragment 的 Lifecycle 对象,管理的是 Fragment 生命周期流转,从命名 mFragmentLifecycleRegistry 也可以看出来。

  • FragmentViewLifecycleOwner 是单独用来管理 Fragment 中 onCreateView 和 onDestroyView 的生命周期的管理类。所以,我们也可以自己扩展新的生命周期。

  • ProcessLifecycleOwner 管理整个 Application 的生命周期,需要另外引入 androidx.lifecycle:lifecycle-process 库。借助这个库,我们可以直接获取到应用前后台切换的状态,以及应用的整个生命周期。需要注意的是,Lifecycle.Event.ON_CREATE 只会分发一次,Lifecycle.Event.ON_DESTROY 不会被分发。

  • ReportFragment 是 Activity 中真正管理各种生命周期分发的类。

  • ServiceLifecycleDispatcher 管理 Service 生命周期分发的帮助类。如果需要在 Service 中使用 Lifecycle,需要自己的 Service 继承自 LifecycleService,并且加入 androidx.lifecycle:lifecycle-service 依赖。

ReportFragment,专门用来分发生命周期 Event 事件的 Fragment,没有可视化界面。最初见于 ComponentActivity 的 onCreate 方法中:

1// code 23
2    protected void onCreate(@Nullable Bundle savedInstanceState) {
3        super.onCreate(savedInstanceState);
4        mSavedStateRegistryController.performRestore(savedInstanceState);
5        ReportFragment.injectIfNeededIn(this);    // ReportFragment 初始化
6        if (mContentLayoutId != 0) {
7            setContentView(mContentLayoutId);
8        }
9    }

在 injectIfNeededIn 方法里初始化了这个 Fragment,用的还是 framework 里的 Fragment,原因注释里也说的很清楚,因为考虑到有些 Activity 并不是继承自 FragmentActivity。在 ProcessLifecycleOwner 中也是用到这个方法初始化 ReportFragment,而 ProcessLifecycleOwner 是 Application 的生命周期持有者。

 1// code 24
2    public static void injectIfNeededIn(Activity activity{
3        // ProcessLifecycleOwner should always correctly work and some activities may not extend
4        // FragmentActivity from support lib, so we use framework fragments for activities
5        android.app.FragmentManager manager = activity.getFragmentManager();
6        if (manager.findFragmentByTag(REPORT_FRAGMENT_TAG) == null) {
7            manager.beginTransaction().add(new ReportFragment(), REPORT_FRAGMENT_TAG).commit();
8            // Hopefully, we are the first to make a transaction.
9            manager.executePendingTransactions();
10        }
11    }

可以看到,在这个 Fragment 生命周期方法中,都是调用 dispatch 方法分发Event 事件的。由于 ReportFragment 是挂靠在 ComponentActivity 上的,所以 ComponentActivity 的生命周期与 ReportFragment 的生命周期是关联在一起的。所以,ReportFragment 就可以准确分发 ComponentActivity 的生命周期事件。在 dispatch 方法中,就是调用的上面所说的 LifecycleRegistry 类的 handleLifecycleEvent 方法。

 1// code 25
2    ···
3    @Override
4    public void onActivityCreated(Bundle savedInstanceState) {
5        super.onActivityCreated(savedInstanceState);
6        dispatchCreate(mProcessListener);
7        dispatch(Lifecycle.Event.ON_CREATE);
8    }
9
10    @Override
11    public void onStart() {
12        super.onStart();
13        dispatchStart(mProcessListener);
14        dispatch(Lifecycle.Event.ON_START);
15    }
16
17    @Override
18    public void onResume() {
19        super.onResume();
20        dispatchResume(mProcessListener);
21        dispatch(Lifecycle.Event.ON_RESUME);
22    }
23
24    @Override
25    public void onPause() {
26        super.onPause();
27        dispatch(Lifecycle.Event.ON_PAUSE);
28    }
29    ···
30    // 分发 Lifecycle.Event 的方法
31    private void dispatch(Lifecycle.Event event) {
32        Activity activity = getActivity();
33        if (activity instanceof LifecycleRegistryOwner) { // LifecycleRegistryOwner 已废弃,这一段可以不看
34            ((LifecycleRegistryOwner) activity).getLifecycle().handleLifecycleEvent(event);
35            return;
36        }
37
38        if (activity instanceof LifecycleOwner) {
39            Lifecycle lifecycle = ((LifecycleOwner) activity).getLifecycle();
40            if (lifecycle instanceof LifecycleRegistry) {
41                // 最终还是调用的 LifecycleRegistry 中的 handleLifecycleEvent 方法
42                ((LifecycleRegistry) lifecycle).handleLifecycleEvent(event);
43            }
44        }
45    }

除此之外,ReportFragment 还负责了 Application 的生命周期的事件分发:

 1// code 26
2    // ReportFragment 中的部分代码    注:仅节选了相关的代码
3    private ActivityInitializationListener mProcessListener;
4
5    void setProcessListener(ActivityInitializationListener processListener) {
6        mProcessListener = processListener;
7    }
8
9    interface ActivityInitializationListener {
10        void onCreate();
11
12        void onStart();
13
14        void onResume();
15    }
16
17    // ProcessLifecycleOwner.java    Application 的生命周期持有者
18    void attach(Context context) {
19        mHandler = new Handler();
20        mRegistry.handleLifecycleEvent(Lifecycle.Event.ON_CREATE);
21        Application app = (Application) context.getApplicationContext();
22        app.registerActivityLifecycleCallbacks(new EmptyActivityLifecycleCallbacks() {
23            @Override
24            public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
25                ReportFragment.get(activity).setProcessListener(mInitializationListener);
26            }
27
28            @Override
29            public void onActivityPaused(Activity activity) {
30                activityPaused();
31            }
32
33            @Override
34            public void onActivityStopped(Activity activity) {
35                activityStopped();
36            }
37        });
38    }

这里不再展开了,只需要知道,Application 的生命周期持有者 ProcessLifecycleOwner 也是使用 ReportFragment 进行生命周期状态分布就可以了。

综上,可以看出,ReportFragment 和 LifecycleRegistry 是 Lifecycle 最重要的两个类。理解了它们,Lifecycle 的整体流程和思想就比较清楚了。其实 Lifecycle 内容远不止这些,代码也在不断地迭代中,本文只是起到抛砖引玉作用,更多内容可查看源码~

还没看够?来我的公众号看看。搜索:俢之竹 ,或者下方扫描二维码关注

Jetpack 笔记之——Lifecycle 浅析
欢迎关注我的公号~

也欢迎知乎搜索 俢之竹~

ps. 一个简单的 Demo:https://gitee.com/xiuzhizhu/LifeCycleDemo

参考文献

1、Android Lifecycle 官方文档  https://developer.android.google.cn/topic/libraries/architecture/lifecycle?hl=zh_cn。
2、胡飞洋;
《“终于懂了“系列:Jetpack AAC完整解析(一)Lifecycle 完全掌握!》    https://juejin.cn/post/6893870636733890574#heading-13。
3、devlei;
《Lifecycle深度实践与解析》 https://juejin.cn/post/6850418115931537416。

pps. 赠人玫瑰,手留余香。欢迎转发分享加关注,你的认可是我继续创作的精神源泉。


原文始发于微信公众号(修之竹):Jetpack 笔记之——Lifecycle 浅析

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由半码博客整理,本文链接:https://www.bmabk.com/index.php/post/100614.html

(0)

相关推荐

发表回复

登录后才能评论
半码博客——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!