1.介绍
Lifecycles是Jetpack框架组件之一,使用观察者模式追踪Activity或者Fragment的生命周期,以避免在Activity或者Fragment的生命周期方法中加入太多逻辑,降低代码耦合性,去除重复代码并且防止内存泄漏。
官方介绍:
生命周期感知型组件可执行操作来响应另一个组件(如 Activity 和 Fragment)的生命周期状态的变化。这些组件有助于您写出更有条理且往往更精简的代码,这样的代码更易于维护。一种常见的模式是在 Activity 和 Fragment 的生命周期方法中实现依赖组件的操作。但是,这种模式会导致代码条理性很差而且会扩散错误。通过使用生命周期感知型组件,您可以将依赖组件的代码从生命周期方法移入组件本身中。
androidx.lifecycle 软件包提供了可用于构建生命周期感知型组件的类和接口 - 这些组件可以根据 Activity 或 Fragment 的当前生命周期状态自动调整其行为。
2.为什么要使用Lifecycles
在平时的Android开发中,我们需要注册各种组件或者使用各种Manager。在传统的MVC框架中,所有的逻辑放在Activity或者Fragment中,在OnCreate()中注册,在OnDestory()或者OnStop()中去取消注册。而有些组件在Activity的生命周期之外还需要存活,这个时候又持有Context的引用,这就会导致内存泄漏。或者多个Activity都需要注册一些组件,产生大量模板代码。当然这些问题可以通过优化代码,放在Application中或者定义一个BaseActivity解决,但是没有办法解决Activity/Fragment过重的问题。而在MVC或者MVVM架构中,这样写很显然代码耦合性比较严重。而且有时候我们会碰到一些时序问题,比如注册的过程比较耗时,而这个时候Activity的生命周期又走到OnStop()了,就会导致组件执行取消注册的时候注册还没有完成。这个时候就需要使用Lifecycle这种生命周期观察者了。
3.如何使用
3.1 导入项目
在app的build.gradle中添加
implementation "androidx.lifecycle:lifecycle-extensions:2.1.0"
3.2 不使用LifeCycle
在这里使用官方Demo代码和不使用LifeCycle的传统方式做一个对比。以下代码全部使用Kotlin,后面不再提醒
假设我们有一个在屏幕上显示设备位置的 Activity。常见的实现可能如下所示:
internal class MyLocationListener(
private val context: Context,
private val callback: (Location) -> Unit
) {
fun start() {
// connect to system location service
}
fun stop() {
// disconnect from system location service
}
}
class MyActivity : AppCompatActivity() {
private lateinit var myLocationListener: MyLocationListener
override fun onCreate(...) {
myLocationListener = MyLocationListener(this) { location ->
// update UI
}
}
public override fun onStart() {
super.onStart()
myLocationListener.start()
// manage other components that need to respond
// to the activity lifecycle
}
public override fun onStop() {
super.onStop()
myLocationListener.stop()
// manage other components that need to respond
// to the activity lifecycle
}
}
3.3 使用LifeCycle
创建生命周期观察者
class MyObserver : LifecycleObserver {
//LifecycleObserver 是一个空的接口,需要用注解来具体控制
//表示当被观察的对象生命周期到达OnResume()的时候
@OnLifecycleEvent(Lifecycle.Event.ON_RESUME)
fun connectListener() {
...
}
//表示当被观察的对象生命周期到达OnPause()的时候
@OnLifecycleEvent(Lifecycle.Event.ON_PAUSE)
fun disconnectListener() {
...
}
}
在上面的代码中我们创建了一个生命周期的观察者,这是最简单的写法,通常我们在这个观察者中需要用到被观察者的Context和LifecycleOwner成员。可以把这两个对象放在MyObserver的构造方法中
internal class MyObserver constructor(context:Context,lifeOwner:LifeOwner) :LifecycleObserver {
private var mContext:Context = context
private var mLifeOwner = lifeOwner
...
}
为什么需要LifecycleOwner对象?
官方文档中对于LifecycleOwner的介绍如下:
LifecycleOwner 是单一方法接口,表示类具有 Lifecycle。它具有一种方法(即 getLifecycle()),该方法必须由类实现。如果您尝试管理整个应用进程的生命周期,请参阅 ProcessLifecycleOwner。
此接口从各个类(如 Fragment 和 AppCompatActivity)抽象化 Lifecycle 的所有权,并允许编写与这些类搭配使用的组件。任何自定义应用类均可实现 LifecycleOwner 接口。
实现 LifecycleObserver 的组件可与实现 LifecycleOwner 的组件无缝协同工作,因为所有者可以提供生命周期,而观察者可以注册以观察生命周期。
对于位置跟踪示例,我们可以让 MyLocationListener 类实现 LifecycleObserver,然后在 onCreate() 方法中使用 Activity 的 Lifecycle 对其进行初始化。这样,MyLocationListener 类便可以“自给自足”,这意味着,对生命周期状态的变化做出响应的逻辑会在 MyLocationListener(而不是在 Activity)中进行声明。让各个组件存储自己的逻辑,可使 Activity 和 Fragment 逻辑更易于管理。
一个常见的用例是,如果 Lifecycle 现在未处于良好的状态,则应避免调用某些回调。例如,如果回调在 Activity 状态保存后运行 Fragment 事务,就会引发崩溃,因此我们绝不能调用该回调。
为简化此用例,Lifecycle 类允许其他对象查询当前状态。
internal class MyLocationListener(
private val context: Context,
private val lifecycle: Lifecycle,
private val callback: (Location) -> Unit
) {
private var enabled = false
@OnLifecycleEvent(Lifecycle.Event.ON_START)
fun start() {
if (enabled) {
// connect
}
}
fun enable() {
enabled = true
if (lifecycle.currentState.isAtLeast(Lifecycle.State.STARTED)) {
// connect if not connected
}
}
@OnLifecycleEvent(Lifecycle.Event.ON_STOP)
fun stop() {
// disconnect if connected
}
}
对于此实现,LocationListener 类可以完全感知生命周期。如果我们需要从另一个 Activity 或 Fragment 使用 LocationListener,只需对其进行初始化。所有设置和拆解操作都由类本身管理。
如果库提供了需要使用 Android 生命周期的类,我们建议您使用生命周期感知型组件。库客户端可以轻松集成这些组件,而无需在客户端进行手动生命周期管理。
Support Library 26.1.0 及更高版本中的 Fragment 和 Activity 已实现 LifecycleOwner 接口。
所以在代码中获取lifecycle可按照如下方式
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val binding: ActivityMainBinding = DataBindingUtil.setContentView(
this, R.layout.activity_main
)
mContext = this
myObserver = MyObserver(this)
mViewModel = ViewModelProviders.of(this).get(MainViewModel::class.java)
binding.lifecycleOwner = this
binding.viewModel = mViewModel
//给lifecycle对象添加之前创建的观察者
lifecycle.addObserver(myObserver)
//也可以这么写
//binding.lifecycleOwner.getLifecycle().addObserver(MyObserver())
}
4.自定义LifecycleOwner
前面说过Support Library 26.1.0 及更高版本中的 Fragment 和 Activity 已实现 。那么低版本怎么使用?或者说想在Activity和Fragment之外的组件中使用LifecycleOwner怎么办?这个时候需要自定义LifecycleOwner。
如果您有一个自定义类并希望使其成为 LifecycleOwner,您可以使用 LifecycleRegistry 类,但需要将事件转发到该类,如以下代码示例中所示:
class MyActivity : Activity(), LifecycleOwner {
private lateinit var lifecycleRegistry: LifecycleRegistry
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
lifecycleRegistry = LifecycleRegistry(this)
lifecycleRegistry.markState(Lifecycle.State.CREATED)
}
public override fun onStart() {
super.onStart()
lifecycleRegistry.markState(Lifecycle.State.STARTED)
}
override fun getLifecycle(): Lifecycle {
return lifecycleRegistry
}
}
5.用例
生命周期感知型组件可使您在各种情况下更轻松地管理生命周期。下面列举几个例子:
- 在粗粒度和细粒度位置更新之间切换。使用生命周期感知型组件可在位置应用可见时启用细粒度位置更新,并在应用位于后台时切换到粗粒度更新。借助生命周期感知型组件 LiveData,应用可以在用户使用位置发生变化时自动更新界面。
- 停止和开始视频缓冲。使用生命周期感知型组件可尽快开始视频缓冲,但会推迟播放,直到应用完全启动。此外,应用销毁后,您还可以使用生命周期感知型组件终止缓冲。
- 开始和停止网络连接。借助生命周期感知型组件,可在应用位于前台时启用网络数据的实时更新(流式传输),并在应用进入后台时自动暂停。
- 暂停和恢复动画可绘制资源。借助生命周期感知型组件,可在应用位于后台时暂停动画可绘制资源,并在应用位于前台后恢复可绘制资源。
6.OnStop()中的一些坑
官方文档中提到了onStop()中的一些坑,主要说的是onSaveInstanceState()和onStop()之间的时序问题。在执行onSaveInstanceState()的时候,此时onStop()可能还没有执行到,此时会认为视图已经不可改变了,这个时候去更改视图会导致视图重建的时候状态不一致。