Android Jetpack 之 LifeCycle 组件使用详解

一、LifeCycle 简介

LifeCycle 是一个可以感知宿主生命周期变化的组件。常见的宿主包括 Activity/Fragment、Service 和 Application。LifeCycle 会持有宿主的生命周期状态的信息,当宿主生命周期发生变化时,会通知监听宿主的观察者。

LifeCycle 的出现主要是为了解决: 系统组件的生命周期与普通组件之间的耦合性。

  • 系统组件指:Activity/Fragment、Service 和 Application。
  • 普通组件指:将代码按照功能或者作用封装成的组件。

哪些情况下,系统组件的生命周期会和普通组件的生命周期耦合在一起呢?

举个栗子:

在 58 部落业务中有视频播放的业务需求。我们需要在 Activity 中对视频播放组件进行初始化,在 onPause() 方法中停止视频的播放,在 onDestroy() 方法中对视频播放组件以及一些资源进行回收。这样的做法非常繁琐,会让页面与组件之间的耦合度变高。

对于这类问题,完全可以使用 LifeCycle 来解决。它不仅降低了模块之间的耦合度,还降低了内存泄露发生的可能性

二、LifeCycle 的使用

Jetpack 为我们提供了两个接口:

被观察者:LifecycleOwner

观察者:LifecycleObserver

被监听的系统组件需要去实现 LifecycleOwner 接口,观察者需要实现 LifecycleObserver 接口。

(一)使用场景1:使用 LifeCycle 解耦页面与组件

(1)解耦 Activity

第一步:添加依赖

implementation 'androidx.appcompat:appcompat:1.2.0'  


在 AndroidX 里面 ComponentActivity 已经默认实现了 LifecycleOwner 接口。如果项目没有迁移到 AndroidX,还是用的 Support 库,新版本的 SDK 也通过 SupportActivity 实现了 LifecycleOwner 接口。

在 LifecycleOwner 接口中,只有一个 getLifecycle 方法。

第二步:实现观察者

如果是想监听某个 Activity 的生命周期,需要我们做的就是自定义组件,实现 LifecycleObserver 接口即可,该接口没有接口方法,不需要任何具体的实现。

比如以刚刚的视频播放为例:

  1. 创建一个 MyVideoPlayListener 类,实现 LifecycleObserver 接口,与视频播放相关的逻辑全在这个类里面完成。对于组件里面需要在 Activity 生命周期变化时得到通知的方法,用 @OnLifecycleEvent(Lifecycle.Event.ON_XXX) 注解进行标记,这样当 Activity 生命周期发生变化时,被标记过的方法便会被自动调用。
public class MyVideoPlayListener implements LifecycleObserver {  
    private static String TAG = "MyVideoPlayListener";  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_CREATE)  
    private void initVideo(){  
        Log.d(TAG,"initVideo");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_RESUME)  
    private void startPlay(){  
        Log.d(TAG,"startPlay");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_PAUSE)  
    private void pausePlay(){  
        Log.d(TAG,"pausePlay");  
    }  
}  


2.在 MainActivity 中对 MyVideoPlayListener 进行引用即可。

public class MainActivity extends AppCompatActivity {  
  
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity\_main);  
  
        MyVideoPlayListener listener = new MyVideoPlayListener();  
        getLifecycle().addObserver(listener);  
    }  
}  


#####(2)解耦 Fragment

在新版的 SDK 中,Fragment 同样也默认实现了 LifecycleOwner 接口,因此,以上的例子同样适合于 Fragment。

####(二)使用场景2:使用 LifecycleService 解耦 Service 与组件

(1)LifecycleService 基本介绍

Android 中拥有生命周期的组件除了 Activity/Fragment ,还有一个非常重要的组件就是 Service。LifecycleService 就是用来监听和解耦 Service 组件的。

public class LifecycleService extends Service implements LifecycleOwner {  
  
    private final ServiceLifecycleDispatcher mDispatcher = new ServiceLifecycleDispatcher(this);  
  
    ......  
  
    @Override  
    @NonNull  
    public Lifecycle getLifecycle() {  
        return mDispatcher.getLifecycle();  
    }  
}  


(2)具体使用方法

第一步:添加相关依赖

implementation "androidx.lifecycle:lifecycle-service:2.2.0"  


第二步:创建 MyServiceObserver 类,实现 LifecycleObserver 接口。使用 @OnLifecycleEvent 标记希望在 Server 生命周期发生变化时得到同步调用的方法。

public class MyServiceObserver implements LifecycleObserver {  
    private static String TAG = "MyServiceObserver";  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_CREATE)  
    private void initVideo(){  
        Log.d(TAG,"initVideo");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_DESTROY)  
    private void pausePlay(){  
        Log.d(TAG,"stopPlay");  
    }  
}  


第三步:创建一个 MyService 的类,继承 LifecycleService。由于 LifecycleService 是 Service 的直接子类,所以使用起来与普通的 Service 没有差别。

public class MyService extends LifecycleService {  
    private MyServiceObserver myServiceObserver;  
  
    public MyService(){  
        myServiceObserver = new MyServiceObserver();  
        getLifecycle().addObserver(myServiceObserver);  
    }  
}  


#####(三)使用场景3:使用 ProcessLifecycleOwner 监听应用程序的生命周期

具有生命周期的组件除了 Activity、Fragment 和 Service 外,还有 Application。ProcessLifecycleOwner 就是用来监听整个应用程序的生命周期情况。

具体使用方法:

第一步:添加依赖项

implementation "androidx.lifecycle:lifecycle-process:2.2.0"  


第二步:定义一个 ApplicationObserver,实现 LifecycleObserver 接口。

public class ApplicationObserver implements LifecycleObserver {  
    private String TAG = this.getClass().getName();  
  
    /\*\*  
     \* 在应用程序的整个生命周期中只会被调用一次  
     \*/  
    @OnLifecycleEvent(Lifecycle.Event.ON\_CREATE)  
    public void onCreate() {  
        Log.d(TAG,"Lifecycle.Event.ON\_CREATE");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_START)  
    public void onStart() {  
        Log.d(TAG,"Lifecycle.Event.ON\_START");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_RESUME)  
    public void onResume() {  
        Log.d(TAG,"Lifecycle.Event.ON\_RESUME");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_PAUSE)  
    public void onPause() {  
        Log.d(TAG,"Lifecycle.Event.ON\_PAUSE");  
    }  
  
    @OnLifecycleEvent(Lifecycle.Event.ON\_STOP)  
    public void onStop() {  
        Log.d(TAG,"Lifecycle.Event.ON\_STOP");  
    }  
  
    /\*\*  
     \* 永远不会被调用,系统不会分发调用 ON\_DESTROY 事件  
     \*/  
    @OnLifecycleEvent(Lifecycle.Event.ON\_DESTROY)  
    public void onDestroy() {  
        Log.d(TAG,"Lifecycle.Event.ON\_DESTROY");  
    }  
}  


第三步:在 Application 中关联 ApplicationObserver。

public class App extends Application {  
    @Override  
    public void onCreate() {  
        super.onCreate();  
        ProcessLifecycleOwner.get().getLifecycle().addObserver(new ApplicationObserver());  
    }  
}  


注意事项:

  1. ProcessLifecycleOwner 是针对整个应用程序的监听,与 Activity 的数量无关。
  2. Lifecycle.Event.ON_CREATE 只会被调用一次,而 Lifecycle.Event.ON_DESTROY 永远不会被调用。
  3. Lifecycle.Event.ON_PAUSE 和 Lifecycle.Event.ON_STOP 的调用会有一定的延后,因为系统需要为“屏幕旋转,由于配置发生变化而导致的 Activity 重新创建” 的情况预留一些时间。

三、Lifecycle 的另外两种写法

Lifecycle 有三种实现方法:

  1. LifecycleObserver 配合注解
  2. FullLifecyclerObserver 拥有宿主所有生命周期事件
  3. LifecycleEventObserver宿主生命周期事件封装成 Lifecycle.Event

在上一节使用介绍中,我们用的是第一种方式:LifecycleObserver 配合注解。

这种方式使用比较简单,但是注意最好添加 lifecycle-compiler 这个注解处理器,否者在运行时会使用反射的形式回调到对应的方法上:

annotationProcessor "androidx.lifecycle:lifecycle-compiler:2.2.0"  


加上这个注解处理器后,用 @OnLifecycleEvent 标记的方法就不能再声明成 private ,否者会报如下的错误:

method marked with OnLifecycleEvent annotation can not be private  


下面介绍一下另外两种实现方式:

(一)FullLifecyclerObserver 拥有宿主所有生命周期事件
//该接口中定义好了生命周期方法,我们只需要实现 FullLifecycleObserver 接口,重写对应的  
//生命周期方法即可。不过目前 FullLifecycleObserver 这个接口未开放给开发者使用。  
interface FullLifecycleObserver extends LifecycleObserver {  
  
    void onCreate(LifecycleOwner owner);  
  
    void onStart(LifecycleOwner owner);  
  
    void onResume(LifecycleOwner owner);  
  
    void onPause(LifecycleOwner owner);  
  
    void onStop(LifecycleOwner owner);  
  
    void onDestroy(LifecycleOwner owner);  
}  


(二)LifecycleEventObserver 宿主生命周期事件封装成 Lifecycle.Event
//通过实现 LifecycleEventObserver 接口,重写 onStateChanged 方法,在该方法内部  
//通过判断 Lifecycle.Event 来实现具体的业务逻辑  
public class MyVideoPlayObserver implements LifecycleEventObserver {  
    private static String TAG = "MyVideoPlayObserver";  
  
    @Override  
    public void onStateChanged(@NonNull LifecycleOwner source, @NonNull Lifecycle.Event event) {  
        switch (event){  
            case ON\_CREATE:  
                Log.d(TAG,"initVideo");  
                break;  
            case ON\_START:  
                Log.d(TAG,"startPlay");  
                break;  
            case ON\_RESUME:  
                Log.d(TAG,"resumePlay");  
                break;  
            default:  
                 break;  
        }  
    }  
}  


四、总结

LifeCycle 组件存在的主要意义是帮助我们解耦,让自己定义的组件也能够感受到生命周期的变化。

五、补充

截止本文发布时,lifecycle_version 最新版本是 2.2.0,如需获取最新版本请查看官网:

注:lifecycle-extensions 中的 API 已弃用,需要使用到 Lifecycle 下的某个工具时,添加对应的依赖即可:

    dependencies {  
        def lifecycle\_version = "2.2.0"  
        def arch\_version = "2.1.0"  
  
        // ViewModel  
        implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle\_version"  
        // LiveData  
        implementation "androidx.lifecycle:lifecycle-livedata:$lifecycle\_version"  
        // Lifecycles only (without ViewModel or LiveData)  
        implementation "androidx.lifecycle:lifecycle-runtime:$lifecycle\_version"  
  
        // Saved state module for ViewModel  
        implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle\_version"  
  
        // Annotation processor  
        annotationProcessor "androidx.lifecycle:lifecycle-compiler:$lifecycle\_version"  
        // alternately - if using Java8, use the following instead of lifecycle-compiler  
        implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle\_version"  
  
        // optional - helpers for implementing LifecycleOwner in a Service  
        implementation "androidx.lifecycle:lifecycle-service:$lifecycle\_version"  
  
        // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process  
        implementation "androidx.lifecycle:lifecycle-process:$lifecycle\_version"  
  
        // optional - ReactiveStreams support for LiveData  
        implementation "androidx.lifecycle:lifecycle-reactivestreams:$lifecycle\_version"  
  
        // optional - Test helpers for LiveData  
        testImplementation "androidx.arch.core:core-testing:$arch\_version"  
    }  
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容