EventBus is a publish/subscribe event bus optimized for Android.

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 (~50k jar)
• is proven in practice by apps with 100,000,000+ installs
• has advanced features like delivery threads, subscriber priorities, etc.

1. Define events:

   publicstaticclassMessageEvent{/* Additional fields if needed */ }

2. Prepare subscribers: Declare and annotate your subscribing method, optionally specify a thread mode:

   @Subscribe(threadMode = ThreadMode.MAIN) publicvoidonMessageEvent(MessageEventevent){/* Do something */};

   Register and unregister your subscriber. For example on Android, activities and fragments should usually register according to their life cycle:

   @OverridepublicvoidonStart(){super.onStart(); EventBus.getDefault().register(this)} @OverridepublicvoidonStop(){super.onStop(); EventBus.getDefault().unregister(this)}

3. Post events:

   EventBus.getDefault().post(newMessageEvent());

Read the full getting started guide.

Please ensure that you are using the latest version by checking here

Gradle:

compile 'org.greenrobot:eventbus:3.0.0'

Maven:

<dependency> <groupId>org.greenrobot</groupId> <artifactId>eventbus</artifactId> <version>3.0.0</version> </dependency>

Or download EventBus from Maven Central

For more details on EventBus please check EventBus' website. Here are some direct links you may find useful:

Features

Documentation

Changelog

FAQ

How does EventBus compare to other solutions, like Otto from Square? Check this comparison.

Copyright (C) 2012-2016 Markus Junginger, greenrobot (http://greenrobot.org)

EventBus binaries and source code can be used according to the Apache License, Version 2.0.

greenrobot-common is a set of utility classes and hash functions for Android & Java projects.

greenDAO is an ORM optimized for Android: it maps database tables to Java objects and uses code generation for optimal speed.

Follow us on Google+ or check our homepage to stay up to date.