LiveEventBus的使用

一、前言：

LiveEventBus是一款Android消息总线，基于LiveData，具有生命周期感知能力，支持Sticky，支持AndroidX，支持跨进程，支持跨APP。

为什么要用LiveEventBus?

1、生命周期感知

• 消息随时订阅，自动取消订阅
• 告别消息总线造成的内存泄漏
• 告别生命周期造成的崩溃

2、范围全覆盖的消息总线解决方案

• 进程内消息发送
• App内，跨进程消息发送
• App之间的消息发送

3、 更多特性支持

• 免配置直接使用，懒人最爱
• 支持Sticky粘性消息
• 支持AndroidX
• 支持延迟发送
• 观察者的多种接收模式（全生命周期/激活状态可接受消息）

4、 常用消息总线对比

消息总线	延迟发送	有序接收消息	Sticky	生命周期感知	跨进程/APP	线程分发
EventBus	❌	✅	✅	❌	❌	✅
RxBus	❌	❌	✅	❌	❌	✅
LiveEventBus	✅	✅	✅	✅	✅	❌

想了解更多？请点击：全面了解Android消息总线

demo下载：https://github.com/JeremyLiao/LiveEventBus.git

二、使用：

1、依赖：

Via Gradle:

implementation 'com.jeremyliao:live-event-bus:1.7.2'

For AndroidX:

implementation 'com.jeremyliao:live-event-bus-x:1.7.2'

2、订阅消息

• 以生命周期感知模式订阅消息

LiveEventBus
    .get("some_key", String.class)
    .observe(this, new Observer() {
        @Override
        public void onChanged(@Nullable String s) {
        }
    });

• 以Forever模式订阅消息

LiveEventBus
    .get("some_key", String.class)
    .observeForever(observer);

3、发送消息

• 不定义消息直接发送

LiveEventBus
    .get("some_key")
    .post(some_value);

• 先定义消息，再发送消息

//定义类型
public class DemoEvent implements LiveEvent {
    public final String content;

    public DemoEvent(String content) {
        this.content = content;
    }
}
//发送消息
LiveEventBus
        .get(DemoEvent.class)
        .post(new DemoEvent("Hello world"));

4、在Application.onCreate方法中配置：

  LiveEventBus
             .config()
             .autoClear(true)
             .lifecycleObserverAlwaysActive(true);

• lifecycleObserverAlwaysActive
  配置LifecycleObserver（如Activity）接收消息的模式（默认值true）：
  true：整个生命周期（从onCreate到onDestroy）都可以实时收到消息
  false：激活状态（Started）可以实时收到消息，非激活状态（Stoped）无法实时收到消息，需等到Activity重新变成激活状态，方可收到消息

• autoClear
  配置在没有Observer关联的时候是否自动清除LiveEvent以释放内存（默认值false）

• setJsonConverter
  配置JsonConverter（默认使用gson）

• setLogger
  配置Logger（默认使用DefaultLogger）

• enableLogger
  配置是否打印日志（默认打印日志）

• setContext
  如果广播模式有问题，请手动传入Context，需要在application onCreate中配置

三、详细使用文档

1、 获取Observable

• 通过name获取Observable

Observable get(@NonNull String key, @NonNull Class type)

Observable