Android 生命周期组件 Lifecycle 使用详解
前言
2018 年的 Google I/O 大会上,Google 发布了 Android Jetpack,并称其为下一代的 Android 组件,旨在帮助开发者加快应用开发速度。准确来讲,Jetpack 是一系列 Android 软件组件的集合,它包括基础组件、架构组件、行为组件、界面组件。其中的 Android Architecture Components 指的就是这里的 “架构组件”。
Android Architecture Components 是 Google 推荐的一个构建 APP 的应用架构,它包含了一些列架构相关组件。而本篇文章我们要介绍的 Lifecycle 就是其中的一个与生命周期相关的库,同时,Lifecycle 也跟 LiveData 和 ViewModel 两个库紧密联系,想要搞懂后两者,就必须先搞懂它。
具体各组件之间的关系,以及各自在 Jetpack 中的地位,可以参见下面两幅来源于官网的图片。
Lifecycle 的作用
Lifecycle 是具有生命周期感知能力的组件,也就是说,我们能在 Activity 或者 Fragment 的生命周期发生变化的时候得到通知。我们往往会在 Activity 的各种生命中周期方法里执行特定的方法,比如,进行广播的注册和解绑、Eventbus 的注册和解绑等:
public class TestActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_test); } @Override protected void onStart() { super.onStart(); EventBus.getDefault().register(this); } @Override protected void onDestroy() { EventBus.getDefault().unregister(this); super.onDestroy(); } }
如果我们把很多这种需要跟生命周期相关的逻辑代码都直接放在 Activity 的生命周期方法中,Activity 将会变得难以维护。通过 Lifecycle,我们就能通过把这些逻辑抽离出来,进而避免这种问题。因为本质上我们需要的只是 Activity 或者 Fragment 的生命周期发生改变的时候能通知到我们,以便我们在对应生命周期中执行对应的方法。
Lifecycle 的基本使用
2.0、 导入 Lifecycle 依赖
Lifecycle 被包含在 support library 26.1.0 及之后的依赖包中,如果我们的项目依赖的支持库版本在 26.1.0及以上,那么不需要额外导入 Lifecycle 库,本篇例子中使用的支持库是 28.0.0 :
implementation 'com.android.support:appcompat-v7:28.0.0'
如果支持库版本小于 26.1.0 ,就需要单独导入 Lifecycle 库 :
implementation "android.arch.lifecycle:runtime:1.1.1"
当然,如果项目已经迁移到了 AndroidX,可以使用下面的方式引入 :
implementation "androidx.lifecycle:lifecycle-runtime:2.0.0"
还是建议大家尝试尽快把项目迁移为 AndroidX,因为很多更新,会最先在 AndroidX 中发布,逐渐摆脱传统的support包。比如这里要讲的 Lifecycle 在 AndroidX 中已经升级到了 2.x 版本,而支持库中还是 1.x 版本。
鉴于支持库一般都在 26.1.0 以上,并且尚有大部分用户未迁移到AndroidX,在本篇文章中,我们使用 support library 28.0.0
中默认包含的 Lifecycle 库。我们在项目的 app 目录下的 build.gradle
文件中添加以下依赖:
implementation 'com.android.support:appcompat-v7:28.0.0'
以 support library 版本在 26.1.0 及以上为前提,这里我们分两种情况来讲。一种是我们创建的Activity 继承自 AppCompatActivity(以Activity 为例,Fragment类似),另一种是创建的 Activity 继承自普通的 Activity,而非 AppCompatActivity。
这里要先说一点, Lifecycle 的实现机制是观察者模式,意识到这点,再讲它的使用过程及原理就比较容易理解了。
整体流程:
- 构建一个 Lifecycle 对象(通过一个实现了 LifecycleOwner 接口的对象的
getLifecycle()
方法返回),这个对象就是一个被观察者,具有生命周期感知能力 - 构建一个 LifecycleObserver 对象,它对指定的 Lifecycle 对象进行监听
- 通过将 Lifecycle 对象的 addObserver(...) 方法,将 Lifecycle 对象和 LifecycleObserver 对象进行绑定
2.1、 方式一:继承自 AppCompatActivity
首先,我们创建一个 MyObserver.java 类,让它实现 LifecycleObserver 接口( LifecycleObserver 接口是一个空接口,主要是给注解处理器使用),如下:
public class MyObserver implements LifecycleObserver { private static final String TAG = "MyObserver"; // 使用注解 @OnLifecycleEvent 来表明该方法需要监听指定的生命周期事件 @OnLifecycleEvent(Lifecycle.Event.ON_RESUME) public void connectListener() { // ... Log.d(TAG, "connectListener: -------- onResume" ); } @OnLifecycleEvent(Lifecycle.Event.ON_PAUSE) public void disconnectListener() { // ... Log.d(TAG, "disconnectListener: ------- onPause"); } }
可以看到,我们通过在方法上使用@OnLifecycleEvent
注解使得该方法具有了生命周期感知能力。括号里面的参数,表明需要监听的是什么生命周期事件。Lifecycle 主要就是通过 Event
和 State
这两个枚举类来跟踪所关联组件的生命周期状态。具体的 Event 和 State 之间的转换关系,可以参照下图:
接下来,让我们的 Activity 继承自 AppCompatActivity,然后在 onCreate(...) 方法中通过getLifecycle().addObserver(new MyObserver())
完成 Lifecycle 和LifecycleObserver 的绑定。
public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // 就只需要这一行代码,简洁吧 getLifecycle().addObserver(new MyObserver()); } }
然后我们就可以运行下程序,跑起来之后按 Home 键或者按返回键进行操作。能看到,随着生命周期的变化,MyObserver() 中定义的方法在控制台中也被正确地打印了出来。
是不是觉得特别简单。
但之所以毫不费力,是因为有人替你“负重前行”。在 support library 26.1.0
及以后的支持库中,AppCompatActivity 的祖先类 SupportActivity
已经默认实现了 LifecycleOwner
接口,通过其 getLifecycle()
方法可以直接返回一个 Lifecycle
对象。之后我们就可以通过该对象的 addObserver(...) 方法将 Lifecycle 跟指定的 LifecycleObserver 进行绑定。
2.2、 方式二:继承自普通的 Activity
首先,我们仍然需要像上面的方式,来创建一个MyObserver
对象。
这次我们创建一个继承自普通的 Activity 的 Activity ,那自然无法直接使用 getLifecycle() 方法来获取 Lifecycle 。无法直接使用,那我们能否模仿 AppCompatActivity
的实现,来自己创建 Lifecycle 对象呢?当然可以。这时候,我们就需要自己实现LifecycleOwner
接口,并在具体的生命周期下通过 LifecycleRegistry
的 markState(...)
方法来主动进行事件的分发。请看下面改造过的 MainActivity.java
代码 :
public class MainActivity extends Activity implements LifecycleOwner { private LifecycleRegistry mLifecycleRegistry; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mLifecycleRegistry = new LifecycleRegistry(this); getLifecycle().addObserver(new MyObserver()); mLifecycleRegistry.markState(Lifecycle.State.CREATED); } @Override protected void onResume() { super.onResume(); mLifecycleRegistry.markState(Lifecycle.State.RESUMED); } @Override protected void onPause() { super.onPause(); mLifecycleRegistry.markState(Lifecycle.State.STARTED); } @NonNull @Override public Lifecycle getLifecycle() { return mLifecycleRegistry; } }
然后运行代码,发现结果和上面的完全一样。
可以看到,MainActivity
实现了LifecycleOwner
接口(实现该接口的对象,即是 Lifecycle 的持有者),并在其 getLifecycle( ) 方法中返回了一个 LifecycleRegistry
对象,而 LifecycleRegistry 是 Lifecycle 的实现类,能处理多个 Observer,我们自定义 LifecycleOwner的时候就可以直接使用它。其他使用方式,则完全相同。
为了让使用更加方便灵活,Lifecycle 还提供了查询当前组件所处的生命周期状态的方法:
lifecycle.getCurrentState().isAtLeast(STARTED)
总结
- 实现了 LifecycleObserver 接口的类可以和实现了 LifecycleOwner 接口的类无缝工作,因为 LifecycleOwner 可以提供一个 Lifecycle 对象,而 LifecycleObserver 就正需要对这个 Lifecycle 对象进行监听呢。
- LifecycleOwner 是从特定的类(比如 Activity 或者 Fragment 等)中抽象出来的Lifecycle 的持有者。
- LifecycleRegistry 是 Lifecycle 的实现类,用于注册和反注册那些需要监听当前组件生命周期的 LifecycleObserver
注意
从 1.0.0-rc1 版本的 Lifecycle 包开始,当 Activity 的 onSaveInstanceState()
方法调用结束之后,Lifecycle 将立刻被标记为 CREATED
和 ON_STOP
,而不是等 onStop()
方法调用结束。这点和 API level 26 或者更低版本上 Activity 的生命周期的调用顺序并不匹配,需要稍加注意。有具体需求的可以进一步查阅相关文档。
更多最新消息,欢迎关注我的公众号获取: