支持生命周期的组件执行操做以响应另外一个组件(例如Activity和fragment)的生命周期状态更改。这些组件可帮助您生成组织性更好,而且一般更轻量的代码,这些代码更易于维护。常见的模式是在Activity和fragment的生命周期方法中实现依赖组件的操做。
可是,这种模式致使代码的组织不良以及错误泛滥。经过使用生命周期感知组件,您能够将相关组件的代码从生命周期方法中移出并移入组件自己。htmlandroid.arch.lifecycle包提供了类和接口,可以让您构建支持生命周期的组件,这些组件可根据活动或片断的当前生命周期状态自动调整其行为
注意:要将android.arch.lifecycle导入到Android项目中,请参阅向项目添加组件。 javaAndroid框架中定义的大多数应用程序组件都附带有生命周期。生命周期由操做系统或您的流程中运行的框架代码管理。它们是Android如何工做和应用程序必须尊重它们的核心。不这样作可能会触发内存泄漏甚至应用程序崩溃。android
// 若是使用的是java 8要显示声明以下的 def lifecycle_version = "1.1.1" implementation "android.arch.lifecycle:common-java8:$lifecycle_version"
想象一下,咱们有一个在屏幕上显示设备位置的Activity。
常见的实现可能以下所示:编程
class MyLocationListener { public MyLocationListener(Context context, Callback callback) { // ... } void start() { // connect to system location service } void stop() { // disconnect from system location service } } class MyActivity extends AppCompatActivity { private MyLocationListener myLocationListener; @Override public void onCreate(...) { myLocationListener = new MyLocationListener(this, (location) -> { // update UI }); } @Override public void onStart() { super.onStart(); myLocationListener.start(); // manage other components that need to respond // to the activity lifecycle } @Override public void onStop() { super.onStop(); myLocationListener.stop(); // manage other components that need to respond // to the activity lifecycle } }
尽管这个示例看起来很好,但在实际的应用程序中,您最终会有太多的调用来管理UI和其余组件,以响应当前的生命周期状态。
管理多个组件会在生命周期方法中放置大量代码,例如onStart()和onStop(),这使得它们很难维护。网络
此外,没法保证组件在活动或片断中止以前启动。
若是咱们须要执行一个长时间运行的操做,好比onStart()中的一些配置检查,状况尤为如此。
这可能会致使onStop()方法在onStart()以前完成的争用条件,从而使组件的存活时间超过所需的时间。app
class MyActivity extends AppCompatActivity { private MyLocationListener myLocationListener; public void onCreate(...) { myLocationListener = new MyLocationListener(this, location -> { // update UI }); } @Override public void onStart() { super.onStart(); Util.checkUserStatus(result -> { // what if this callback is invoked AFTER activity is stopped? if (result) { myLocationListener.start(); } }); } @Override public void onStop() { super.onStop(); myLocationListener.stop(); } }
android.arch.lifecycle包提供的类和接口可帮助您以弹性和独立的方式解决这些问题。框架
Lifecycle是一个持有组件生命周期状态(如Activity或Fragment)的信息的类,并容许其余对象观察此状态。
Lifecycle使用两个主要枚举来跟踪其关联组件的生命周期状态:编程语言
从框架和Lifecycle类派发的生命周期事件。
这些事件映射到Activities和fragments中的回调事件。ide
由Lifecycle对象跟踪的组件的当前状态。测试
将状态视为图中的节点,将事件视为这些节点之间的边界。
一个类能够经过向其方法添加注解来监视组件的生命周期状态。
而后,您能够经过调用Lifecycle类的addObserver()方法并传递观察者的实例来添加观察者,以下例所示:
public class MyObserver implements LifecycleObserver { @OnLifecycleEvent(Lifecycle.Event.ON_RESUME) public void connectListener() { ... } @OnLifecycleEvent(Lifecycle.Event.ON_PAUSE) public void disconnectListener() { ... } } myLifecycleOwner.getLifecycle().addObserver(new MyObserver());
在上面的例子中,myLifecycleOwner对象实现了LifecycleOwner接口,这将在下一节中介绍。
LifecycleOwner是一个单一的方法接口,表示该类有一个Lifecycle。
它有一个方法getLifecycle(),它必须由class实现。
若是您试图管理整个应用程序进程的生命周期,请参阅ProcessLifecycleOwner。
该接口从各个类(如Fragment和AppCompatActivity)抽象生命周期的全部权,并容许编写与它们一块儿工做的组件。
任何自定义应用程序类均可以实现LifecycleOwner接口
实现LifecycleObserver的组件能够与实现LifecycleOwner的组件无缝协做,由于全部者能够提供生命周期,观察者能够注册观察。
对于位置跟踪示例,咱们可使MyLocationListener类实现LifecycleObserver,而后使用onCreate()方法中的活动生命周期对其进行初始化。
这容许MyLocationListener类是自给自足的,这意味着对生命周期状态变化做出反应的逻辑在MyLocationListener中声明,而不是在活动中声明。
让各个组件存储本身的逻辑使得活动和片断逻辑更容易管理。
class MyActivity extends AppCompatActivity { private MyLocationListener myLocationListener; public void onCreate(...) { myLocationListener = new MyLocationListener(this, getLifecycle(), location -> { // update UI }); Util.checkUserStatus(result -> { if (result) { myLocationListener.enable(); } }); } }
一个常见的用例就是避免在生命周期状处于很差的状态时调用某些回调。
例如,若是回调在保存活动状态后(我本身理解为onSaveInstanceState()方法执行后,也就是fragment不存在)运行fragment事务,则会触发崩溃,所以咱们毫不但愿调用该回调。
为了简化这个用例,生命周期类容许其余对象查询当前状态。
class MyLocationListener implements LifecycleObserver { private boolean enabled = false; public MyLocationListener(Context context, Lifecycle lifecycle, Callback callback) { ... } @OnLifecycleEvent(Lifecycle.Event.ON_START) void start() { if (enabled) { // connect } } public void enable() { enabled = true; if (lifecycle.getCurrentState().isAtLeast(STARTED)) { // connect if not connected } } @OnLifecycleEvent(Lifecycle.Event.ON_STOP) void stop() { // disconnect if connected } }
经过这个实现,咱们的LocationListener类彻底是生命周期感知的。
若是咱们须要使用来自其余Activity或Fragment的LocationListener,咱们只须要初始化它。
全部的启动和销毁操做都由该类自己进行管理。
若是Library提供须要与Android生命周期配合使用的类,咱们建议您使用支持生命周期的组件。
您的Library客户端能够在客户端无需手动生命周期管理便可轻松集成这些组件。
Support Library 26.1.0中的Fragment和Activity以及更高版本已经实现LifecycleOwner接口。
若是您想要建立LifecycleOwner的自定义类,则可使用LifecycleRegistry类,但须要将事件转发到该类中,如如下代码示例所示:
public class MyActivity extends Activity implements LifecycleOwner { private LifecycleRegistry mLifecycleRegistry; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mLifecycleRegistry = new LifecycleRegistry(this); mLifecycleRegistry.markState(Lifecycle.State.CREATED); } @Override public void onStart() { super.onStart(); mLifecycleRegistry.markState(Lifecycle.State.STARTED); } @NonNull @Override public Lifecycle getLifecycle() { return mLifecycleRegistry; } }
支持生命周期的组件可让您在各类状况下更容易地管理生命周期。
一些例子是:
当Lifecycle属于AppCompatActivity或Fragment时,Lifecycle的状态将更改成CREATED,并在调用AppCompatActivity或Fragment的onSaveInstanceState()时调度ON_STOP事件。
当Fragment或AppCompatActivity的状态经过onSaveInstanceState()保存时,UI被认为是不可变的,直到ON_START被调用。尝试在保存状态后修改UI界面可能会致使应用程序的导航状态不一致,这就是为何若是应用程序在状态保存后运行FragmentTransaction时FragmentManager会抛出异常。
有关详细信息,详情请参阅 commit()。
若是观察者的关联Lifecycle在STARTED以前,则LiveData经过避免调用其观察者来防止这种边缘状况出现。
在幕后,它决定调用观察者以前调用isAtLeast()。
不幸的是,AppCompatActivity的onStop()方法会在onSaveInstanceState()以后调用,这会在不容许UI状态更改但生命周期还没有移至CREATED状态的状况下留下空隙。
为了防止出现这个问题,beta2版本中的Lifecycle类将lower状态标记为CREATED而不分派事件,即便事件直到onStop()被调用也未被分派,任何检查当前状态的代码也都会得到真实值。
不幸的是,这个解决方案有两个主要问题:
注意:为了使此流程更简单,并提供与旧版本的更好兼容性,从版本1.0.0-rc1开始,在调用onSaveInstanceState()而无需等待对onStop()的调用时,将Lifecycle对象标记为CREATED,并调度onStop()方法。这不太可能影响您的代码,但您须要注意这一点,由于它与API级别26及更低级别的Activity类中的调用顺序不匹配。