Based on repository activity, growth velocity and community engagement.
42
Growth11/30
Activity5/25
Popularity14/25
Trust13/20
1,615
Stars
High
Sentiment
Votes
1,615
README.md
HermesEventBus
HermesEventBus is a library for using EventBus between processes, useful in the IPC or plugin
development. It provides the same APIs as EventBus and is easy to use.
EventBus is one of the most widely-used libraries which
simplifies communication between different components in Android. However, it does not support event
posting between processes.
Therefore, HermesEventBus is composed to support event posting between processes.
Note that HermesEventBus is based on EventBus 3.0.0 and if you are using the earlier version, you should
modify your code. Otherwise you will not receive any event!!!
It is useless to name the method receiving events "onEventXXX". Instead, you should add an @Subscribe
annotation on the method:
@Subscribe(threadMode = ThreadMode.MAIN)
public void showText(String text) {
textView.setText(text);
}
#Principle
This library is based on two libraries: Hermes and
EventBus.
The event posting is based on EventBus. And the IPC is based on Hermes, a smart, novel and easy-to-use
framework for Android Inter-Process Communication (IPC).
This library will choose a process as the main process, and regard the other processes as the
sub-processes.
Each time an event is posted, the library does the following:
Use the Hermes library to send the event to the main process.
The main process uses EventBus to post the event within the main process.
The main process uses the Hermes library to send the event to all of the sub-processes.
Each sub-process uses EventBus to post the event within itself.
Furthermore, HermesEventBus uses the Concurrent-Utils
library to solve the subtle problems with respect to concurrency, which are caused by dead locks and race
conditions.
#Usage
This library can be used to post events not only within a single app which has more than one process,
but also between distinct apps.
##Within a single app
If you only need to post and receive events within a single app which has more than one process,
then do the following three steps:
HermesEventBus can also post and receive event within a process, so do not use EventBus any more if
you have already being using HermesEventBus.
###Step 4
If a process no longer need to post and receive any event, the process should call the following:
HermesEventBus.getDefault().destroy();
Otherwise you will have got a android.os.DeadObjectException or some other exceptions. However, these exceptions will print some exception messages but will not crash your app.
##Between apps
If you want to post and receive events between apps, then do the following:
###Step 1
Add the following into the gradle file of each app:
HermesEventBus can also post and receive event within a process, so do not use EventBus any more if
you have already being using HermesEventBus.
###Step 6
If a process no longer need to post and receive any event, the process should call the following:
HermesEventBus.getDefault().destroy();
Otherwise you will have got a android.os.DeadObjectException or some other exceptions. However, these exceptions will print some exception messages but will not crash your app.
Hermes is a smart, novel and easy-to-use framework for
Android Inter-Process Communication (IPC).
Shelly is a library for business-logic-oriented programming,
providing a novel pattern which uses a method chain to illustrate how each component varies with a
business object.
AndroidDataStorage is an easy-to-use and
high-performance library for storing data in the Android system.
ComparatorGenerator is an easy-to-use helper
class for generating a comparator for a specified class, useful when sorting the instances of the
specified class.