原来的库做了升级 需要了解的可以参考新的介绍文章
源码地址 github:https://github.com/codyer/LiveEventBus
LiveEventBus
基于LiveData,实现eventBus,事件统一管理,动态APT生成,生命周期管理
特点
- 整个生命周期(从onCreate到onDestroy)都可以实时收到消息
- 激活状态(Started)可以实时收到消息,非激活状态(Stoped)无法实时收到消息,需等到Activity重新变成激活状态,方可收到消息
- 支持AndroidX
- 支持设置LifecycleObserver(如Activity)接收消息的模式:
关于分支
master
核心代码实现 + demo
demo
通过依赖方式引用master生成的库
combine
通过本地方式依赖master代码
项目依赖
目前只提供 AndroidX工程:(如果项目是新项目,建议升级)
implementation 'com.github.codyer.LiveEventBus:core:1.0.0'
使用注解生成事件管理接口
annotationProcessor 'com.github.codyer.LiveEventBus:compiler:1.0.0'
- 升级方式--Refactor->Migrate to AndroidX
- 项目降级--请自行降级 Refactor->Migrate App to AppCompat
使用介绍
事件定义
- 支持配置以区域为单位的事件开关
- 统一事件管理
- 根据实际情况开启关闭事件定义
- 事件分领域(scope),不同领域同名事件互不干扰
@EventScope(name = "demo",active = true)
public enum AppDemo {
@Event(description = "定义一个测试事件",data = String.class)testString,
@Event(description = "定义一个测试事件测试对象",data = TestBean.class)testBean,
}
订阅消息
- observe
【1】生命周期感知,不需要手动取消订阅,以下方式只会收到注册后发生的事件
LiveEventBus.begin()
.inScope(Scope$demo.class)// Scope$***为自动生成的事件接口
.withEvent$testBean()
.observe(this, new ObserverWrapper<TestBean>() {
@Override
public void onChanged(TestBean testBean) {
}
});
- observeAny
【2】以下方式注册事件可以接收到注册前发生的事件(最后一次事件)
LiveEventBus.begin()
.inScope(Scope$demo.class)
.withEvent$testBean()
.observeAny(this, new ObserverWrapper<TestBean>() {
@Override
public void onChanged(@Nullable TestBean testBean) {
}
});
- observeForever
【3】需要手动取消订阅
LiveEventBus.begin()
.inScope(Scope$demo.class)
.withEvent$testBean()
.observeForever(new ObserverWrapper<TestBean>() {
@Override
public void onChanged(@Nullable TestBean testBean) {
}
});
取消订阅
LiveEventBus.begin()
.inScope(Scope$demo.class)
.withEvent$testBean().
.removeObserver(observer);
【4】取消生命周期相关的所有监听
LiveEventBus.begin()
.inScope(Scope$demo.class)
.withEvent$testBean()
.removeObservers(this);
发送消息
- setValue(Object o)
在主线程发送消息
LiveEventBus.begin()
.inScope(Scope$demo.class)
.withEvent$testBean()
.setValue(value);
- postValue(Obeject o)
在后台线程发送消息,订阅者会在主线程收到消息
LiveEventBus.begin()
.inScope(Scope$demo.class)
.withEvent$testBean()
.postValue(value);
混淆规则
暂无
core代码配置
compileSdkVersion 28
defaultConfig {
minSdkVersion 19
targetSdkVersion 28
versionCode 1
versionName 1.0.0
}
版本
版本 | 功能 |
---|---|
1.0.0 | 初版,支持基本功能 |
主要功能提交记录
- 主要功能完成(Apr. 3, 2019)
其他
- 欢迎提Issue与作者交流
- 欢迎提Pull request,帮助 fix bug,增加新的feature,让LiveEventBus变得更强大、更好用
感谢如下作者提供新的思路,因为不想用反射,所以基于原作者做了重构,具体实现原理以及原文链接参见如下
源码地址 github:https://github.com/codyer/LiveEventBus
实现原理
- LiveEventBus的实现原理可参见作者在美团技术博客上的博文: Android消息总线的演进之路:用LiveDataBus替代RxBus、EventBus
- 该博文是初版LiveEventBus的实现原理,与当前版本的实现可能不一致,仅供参考
- invoking-message 消息总线框架,基于LiveEventBus实现。它颠覆了传统消息总线定义和使用的方式,通过链式的方法调用发送和接收消息,使用更简单