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

鲍珍博Quinn

于 2025-06-10 09:16:06 发布

阅读量397

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00423/article/details/148551681

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("event_key", 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("event_key", String.class)
    .observeForever(observer);

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

这种方式需要开发者自行管理订阅者的生命周期，适用于Service等没有明确生命周期的组件。

消息发送

LiveEventBus支持两种消息发送方式：

1. 主线程发送

LiveEventBus.get().with("event_key").setValue("主线程消息");

setValue方法必须在主线程调用，消息会立即传递给订阅者。

2. 后台线程发送

LiveEventBus.get().with("event_key").postValue("后台线程消息");

postValue方法可以在任何线程调用，消息会先被缓存，然后在主线程传递给订阅者。

高级功能

跨进程通信

LiveEventBus支持跨进程通信，使用方式如下：

首先需要启用广播支持
发送跨进程消息：

LiveEventBus.get()
    .with("cross_process_key")
    .broadcastValue("跨进程消息");

粘性事件(Sticky Event)

粘性事件允许订阅者接收到订阅之前发送的消息，适用于某些需要获取历史状态的场景。

订阅粘性事件

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

同样也有需要手动管理的版本：

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

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