LiveEventBus项目核心功能与使用详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00667/article/details/148551666

LiveEventBus项目核心功能与使用详解

LiveEventBus :mailbox_with_mail:EventBus for Android，消息总线，基于LiveData，具有生命周期感知能力，支持Sticky，支持AndroidX，支持跨进程，支持跨APP 项目地址: https://gitcode.com/gh_mirrors/li/LiveEventBus

什么是LiveEventBus

LiveEventBus是一个基于Android Architecture Components中LiveData构建的事件总线框架。它继承了LiveData的生命周期感知能力，同时提供了事件总线的功能，能够帮助开发者轻松实现组件间的通信。

核心功能特点

生命周期感知：自动管理订阅者的生命周期，避免内存泄漏
线程安全：支持主线程和后台线程发送消息
Sticky事件：支持粘性事件，订阅者可接收订阅前发送的消息
跨进程通信：支持跨进程、跨应用的消息传递
类型安全：通过泛型保证事件类型安全

基本使用方法

消息订阅

LiveEventBus提供了两种订阅方式：

1. 自动生命周期管理订阅

LiveEventBus.get()
    .with("key_name", String.class)
    .observe(this, new Observer<String>() {
        @Override
        public void onChanged(@Nullable String s) {
            // 处理接收到的消息
        }
    });

这种方式会自动绑定到Activity/Fragment的生命周期，当界面销毁时会自动取消订阅，无需手动管理。

2. 手动管理订阅

Observer<String> observer = new Observer<String>() {
    @Override
    public void onChanged(@Nullable String s) {
        // 处理消息
    }
};

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

// 需要时手动取消订阅
LiveEventBus.get()
    .with("key_name", String.class)
    .removeObserver(observer);

这种方式适用于需要长期监听消息的场景，但需要开发者自行管理订阅生命周期。

消息发送

LiveEventBus提供了两种消息发送方式：

1. 主线程发送

LiveEventBus.get().with("key_name").setValue(value);

setValue必须在主线程调用，订阅者会立即收到消息。

2. 后台线程发送

LiveEventBus.get().with("key_name").postValue(value);

postValue可以在任何线程调用，消息会被切换到主线程传递给订阅者。

高级功能

跨进程通信

LiveEventBus支持跨进程消息传递：

LiveEventBus.get()
    .with(KEY_TEST_BROADCAST)
    .broadcastValue("broadcast msg");

使用此功能需要先配置支持广播模式。

Sticky模式

Sticky模式允许订阅者接收到订阅之前发送的消息：

1. 自动生命周期管理的Sticky订阅

LiveEventBus.get()
    .with("sticky_key", String.class)
    .observeSticky(this, new Observer<String>() {
        @Override
        public void onChanged(@Nullable String s){
            // 处理粘性消息
        }
    });

2. 手动管理的Sticky订阅

Observer<String> stickyObserver = new Observer<String>() {
    @Override
    public void onChanged(@Nullable String s) {
        // 处理粘性消息
    }
};

LiveEventBus.get()
    .with("sticky_key", String.class)
    .observeStickyForever(stickyObserver);

// 需要时取消订阅
LiveEventBus.get()
    .with("sticky_key", String.class)
    .removeObserver(stickyObserver);