导入
在Android中,组件的管理组件的生命周期一直是一个比较麻烦的东西,而自Google推出Android Jetpack组件包以来,这个问题得到的比较妥善的解决,Lifecycle组件后来也成为Android Jetpack的核心。以AndroidX为例(如何迁移请看迁移到AndroidX),使用Lifecycle组件,先在模块的build.gradle文件中添加依赖:
api 'androidx.lifecycle:lifecycle-extensions:2.1.0-alpha02'
由于Lifecycle组件由多个包够成,使用api导入时即可将其依赖的包全部导入该模块,包括common,livedata,process,runtime,viewmodel,service等。
如果要使用lifecycle中的注解,你还需要添加如下注解处理器,以便在编译时,完成对相应注解的处理。
annotationProcessor 'androidx.lifecycle:lifecycle-compiler:2.0.0'
开始使用
对于一个App来说,使用Lifecycle组件是没有任何侵入性的,因为他已经天然的融合到Google的appcompat库中了,而如今无论是什么应用程序都几乎离不开appcompat,可以说集成Lifecycle只是启用了之前没用过的功能罢了。
LifecycleOwner是Lifecycle组件包中最重要的一个接口,所有需要管理生命周期的类型都必须实现这个接口。
public interface LifecycleOwner
{
/**
* Returns the Lifecycle of the provider.
*
* @return The lifecycle of the provider.
*/
@NonNull
Lifecycle getLifecycle();
}
其实很多时候我们根本无需关心LifecycleOwner的存在。在Android中, Fragment、Activity、Service都是具有生命周期的组件,但是Google已经让他们都实现了LifecycleOwner这个接口,分别是androdx.fragment.app.Fragment、AppCompatActivity、androidx.lifecycle.LifecycleService,在项目中,只要继承这些类型,可以轻松的通过getLifecycle获取到Lifecycle实例。
而Lifecycle这个类最重要的只有两个方法:
@MainThread
public abstract void removeObserver(@NonNull LifecycleObserver observer);
@MainThread
@NonNull
public abstract State getCurrentState();
@MainThread
public abstract void addObserver(@NonNull LifecycleObserver observer);
1.getCurrentState()可以返回当前该LifecycleOwner的生命周期状态,该状态与LifecycleOwner上的某些回调事件相关,只会出现以下几种状态,在Java中以一个枚举类抽象出来定义在Lifecycle类中。
public enum State
{
DESTROYED,
INITIALIZED,
CREATED,
STARTED,
RESUMED;
}
1.DESTROYED,在组件的onDestroy调用前夕,会变成该状态,变成此状态后将不会再出现任何状态改变,也不会发送任何生命周期事件
2.INITIALIZED,构造函数执行完成后但onCreate未执行时为此状态,是最开始时的状态
3.CREATED,在onCreate调用之后,以及onStop调用前夕会变成此状态
4.STARTED,在onStart调用之后,以及onPause调用前夕会变成此状态
5.RESUMED,再onResume调用之后会变成此状态
2.addObserver,此方法可以给LifecycleOwner添加一个观察者,来接收LifecycleOwner上的回调事件。回调事件也是一个枚举,定义在Lifecycle类中:
public enum Event
{
/**
* Constant for onCreate event of the {@link LifecycleOwner}.
*/
ON_CREATE,
/**
* Constant for onStart event of the {@link LifecycleOwner}.
*/
ON_START,
/**
* Constant for onResume event of the {@link LifecycleOwner}.
*/
ON_RESUME,
/**
* Constant for onPause event of the {@link LifecycleOwner}.
*/
ON_PAUSE,
/**
* Constant for onStop event of the {@link LifecycleOwner}.
*/
ON_STOP,
/**
* Constant for onDestroy event of the {@link LifecycleOwner}.
*/
ON_DESTROY,
/**
* An {@link Event Event} constant that can be used to match all events.
*/
ON_ANY
}
每种事件都对应着Fragment/Activity中的事件。
至于LifecycleObserver,查看源码得知,他就是一个空接口,不包含任何实现,但是若我们想使用,还是得继承此接口。
public interface LifecycleObserver
{
}
继承LifecycleObserver,后使用@OnLifecycleEvent注解(这时之前申明得注解处理器派上了用场),并设置需要监听的生命周期回调事件。
@OnLifecycleEvent(Lifecycle.Event.ON_PAUSE)
public void test()
{
///TODO...
}
然后在Activity/Fragment中:
getLifecycle().addObserver(yourLifecycleObserver);
即可在运行时收到相应的的回调事件,但是注意添加@OnLifecycleEvent注解的方法应该是包内访问权限或是public的,否则可能在编译时会报错,或者收不到回调。
若想在运行时移除LifecycleObserver,同样也还有Lifecycle#removeObserver方法。