EventBus

EventBus ======== [EventBus](https://greenrobot.org/eventbus/) is a publish/subscribe event bus for Android and Java.
EventBus... * simplifies the communication between components * decouples event senders and receivers * performs well with Activities, Fragments, and background threads * avoids complex and error-prone dependencies and life cycle issues * makes your code simpler * is fast * is tiny (~60k jar) * is proven in practice by apps with 1,000,000,000+ installs * has advanced features like delivery threads, subscriber priorities, etc. EventBus in 3 steps ------------------- 1. Define events: ```java public static class MessageEvent { /* Additional fields if needed */ } ``` 2. Prepare subscribers: Declare and annotate your subscribing method, optionally specify a [thread mode](https://greenrobot.org/eventbus/documentation/delivery-threads-threadmode/): ```java @Subscribe(threadMode = ThreadMode.MAIN) public void onMessageEvent(MessageEvent event) { // Do something } ``` Register and unregister your subscriber. For example on Android, activities and fragments should usually register according to their life cycle: ```java @Override public void onStart() { super.onStart(); EventBus.getDefault().register(this); } @Override public void onStop() { super.onStop(); EventBus.getDefault().unregister(this); } ``` 3. Post events: ```java EventBus.getDefault().post(new MessageEvent()); ``` Read the full [getting started guide](https://greenrobot.org/eventbus/documentation/how-to-get-started/). There are also some [examples](https://github.com/greenrobot-team/greenrobot-examples). **Note:** we highly recommend the [EventBus annotation processor with its subscriber index](https://greenrobot.org/eventbus/documentation/subscriber-index/). This will avoid some reflection related problems seen in the wild. Add EventBus to your project ---------------------------- Available on Maven Central. Android projects: ```groovy implementation("org.greenrobot:eventbus:3.3.1") ``` Java projects: ```groovy implementation("org.greenrobot:eventbus-java:3.3.1") ``` ```xml org.greenrobot eventbus-java 3.3.1 ``` R8, ProGuard ------------ If your project uses R8 or ProGuard this library ships [with embedded rules](/eventbus-android/consumer-rules.pro). Homepage, Documentation, Links ------------------------------ For more details please check the [EventBus website](https://greenrobot.org/eventbus). Here are some direct links you may find useful: [Features](https://greenrobot.org/eventbus/features/) [Documentation](https://greenrobot.org/eventbus/documentation/) [Changelog](https://github.com/greenrobot/EventBus/releases) [FAQ](https://greenrobot.org/eventbus/documentation/faq/) License ------- Copyright (C) 2012-2021 Markus Junginger, greenrobot (https://greenrobot.org) EventBus binaries and source code can be used according to the [Apache License, Version 2.0](LICENSE). Other projects by greenrobot ============================ [__ObjectBox__](https://objectbox.io/) ([GitHub](https://github.com/objectbox/objectbox-java)) is a new superfast object-oriented database. [__Essentials__](https://github.com/greenrobot/essentials) is a set of utility classes and hash functions for Android & Java projects.