TinyBus 开源项目教程

TinyBus 开源项目教程

tinybusSimple, lightweight and fast event bus tailored for Android项目地址:https://gitcode.com/gh_mirrors/ti/tinybus

项目介绍

TinyBus 是一个专为 Android 设计的简单、轻量且快速的事件总线库。它基于 Otto 事件总线实现，并添加了一些额外的功能。TinyBus 的特点包括：

• 体积小（约 26K jar）
• 启动和事件分发优化
• 基于注解（不需要特定的方法名，不需要实现接口）
• 超过 90 个 JUnit 测试

TinyBus 支持在主线程和后台线程中处理事件，并且可以自定义事件队列。此外，它还支持粘性事件（sticky events）。

项目快速启动

添加依赖

在 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'de.halfbit:tinybus:3.0.2'
}

初始化 TinyBus

在你的 Activity 或 Application 类中初始化 TinyBus：

import de.halfbit.tinybus.TinyBus;

public class MyApplication extends Application {
    private TinyBus mBus;

    @Override
    public void onCreate() {
        super.onCreate();
        mBus = TinyBus.from(this);
    }
}

注册和注销

在你的 Activity 或 Fragment 中注册和注销 TinyBus：

public class MainActivity extends Activity {
    private TinyBus mBus;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mBus = TinyBus.from(this);
    }

    @Override
    protected void onStart() {
        super.onStart();
        mBus.register(this);
    }

    @Override
    protected void onStop() {
        mBus.unregister(this);
        super.onStop();
    }
}

处理事件

使用 @Subscribe 注解处理事件：

import de.halfbit.tinybus.Subscribe;

public class MainActivity extends Activity {
    // ...

    @Subscribe
    public void onEvent(MyEvent event) {
        // 处理事件
    }
}

发送事件

使用 post 方法发送事件：

mBus.post(new MyEvent());

应用案例和最佳实践

使用多个事件队列

TinyBus 支持多个事件队列，可以用于不同类型的事件处理：

@Subscribe(mode = Mode.Background, queue = "web")
public void onWebEvent(WebEvent event) {
    // 处理 Web 事件
}

使用粘性事件

粘性事件可以在注册后立即接收最近发送的事件：

@Produce
public MyEvent produceEvent() {
    return new MyEvent();
}

典型生态项目

TinyBus 可以与其他 Android 库和框架结合使用，例如：

• RxJava：用于更复杂的事件驱动编程模型
• Dagger：用于依赖注入
• Retrofit：用于网络请求

通过结合这些库，可以构建更强大和灵活的 Android 应用。

---

以上是 TinyBus 开源项目的教程，涵盖了项目介绍、快速启动、应用案例和最佳实践以及典型生态项目。希望这些内容能帮助你更好地理解和使用 TinyBus。

tinybusSimple, lightweight and fast event bus tailored for Android项目地址:https://gitcode.com/gh_mirrors/ti/tinybus