Skip to content

Latest commit

 

History

History
201 lines (122 loc) · 5.59 KB

README-zh-CN.md

File metadata and controls

201 lines (122 loc) · 5.59 KB

HermesEventBus

HermesEventBus是一个基于EventBus的、能在进程间发送和接收event的库,在IPC或者插件开发中非常有用。它底层基于EventBus,并且和EventBus有相同API。

EventBus是Android系统上使用最广泛的简化模块之间通信的库。但它不支持进程间收发事件。

所以,我开发了HermesEventBus来支持进程间事件收发。

注意:本库基于EventBus 3.0.0。如果你之前使用的是老版本,那么必须修改你的代码,否则将无法接收event。但是修改比较简单。

之前使用“onEventXXX”名字的方法要加上注解,并且在后面附上线程模式:

@Subscribe(threadMode = ThreadMode.MAIN)
public void showText(String text) {
    textView.setText(text);
}

#原理

本库基于两个库开发:HermesEventBus

事件收发是基于EventBus,IPC通信是基于Hermes。Hermes是一个简单易用的Android IPC库。

本库首先选一个进程作为主进程,将其他进程作为子进程。

每次一个event被发送都会经过以下四步:

1、使用Hermes库将event传递给主进程。

2、主进程使用EventBus在主进程内部发送event。

3、主进程使用Hermes库将event传递给所有的子进程。

4、每个子进程使用EventBus在子进程内部发送event。

另外还使用了Concurrent-Utils库。

#用法

本库能在app内实现多进程event收发,也可以跨app实现event收发。

##单一app内的用法

如果你在单一app内进行多进程开发,那么只需要做以下三步:

###Step 1

在gradle文件中加入下面的依赖:

dependencies {
    compile 'xiaofei.library:hermes-eventbus:0.3.0'
}

如果你使用Maven,那么加入下面的依赖:

<dependency>
  <groupId>xiaofei.library</groupId>
  <artifactId>hermes-eventbus</artifactId>
  <version>0.3.0</version>
  <type>pom</type>
</dependency>

###Step 2

在Application的onCreate中加上以下语句进行初始化:

HermesEventBus.getDefault().init(this);

###Step 3

每次使用EventBus的时候,用HermesEventBus代替EventBus。

HermesEventBus.getDefault().register(this);

HermesEventBus.getDefault().post(new Event());

HermesEventBus也能够在一个进程间传递event,所以如果你已经使用了HermesEventBus,那么就不要再使用EventBus了。

###Step 4

如果进程不需要再发送和接受event,那么这个进程必须调用:

HermesEventBus.getDefault().destroy();

否则你会收到android.os.DeadObjectException和其他一些异常。这些异常会打印一些异常信息但不会导致app崩溃。

##多个app间的用法(使用DroidPlugin的时候就是这种情况)

如果你想在多个app间收发event,那么就做如下几步:

###Step 1

在每个app的gradle文件中加入依赖:

dependencies {
    compile 'xiaofei.library:hermes-eventbus:0.3.0'
}

如果使用Maven,那么就加入下面的依赖:

<dependency>
  <groupId>xiaofei.library</groupId>
  <artifactId>hermes-eventbus</artifactId>
  <version>0.3.0</version>
  <type>pom</type>
</dependency>

###Step 2

选择一个app作为主app。你可以选择任意app作为主app,但最好选择那个存活时间最长的app。

在使用DroidPlugin的时候,你可以把宿主app作为主app。

在主app的AndroidManifest.xml中加入下面的service:

<service android:name="xiaofei.library.hermes.HermesService$HermesService0"/>

你可以加上一些属性。

###Step 3

在app间收发的事件类必须有相同的包名、相同的类名和相同的方法。

务必记住在代码混淆的时候将这些类keep!!!

###Step 4

在主app的application类的onCreate方法中加入:

HermesEventBus.getDefault().init(this);

在其他app的Application类的onCreate方法中加入:

HermesEventBus.getDefault().connectApp(this, packageName);

“packageName”指的是主app的包名。

###Step 5

每次使用EventBus的时候,用HermesEventBus代替EventBus。

HermesEventBus.getDefault().register(this);

HermesEventBus.getDefault().post(new Event());

HermesEventBus也能够在一个进程间传递event,所以如果你已经使用了HermesEventBus,那么就不要再使用EventBus了。

###Step 6

如果进程不需要再发送和接受event,那么这个进程必须调用:

HermesEventBus.getDefault().destroy();

否则你会收到android.os.DeadObjectException和其他一些异常。这些异常会打印一些异常信息但不会导致app崩溃。

#友情链接

Xiaofei's GitHub: https://github.com/Xiaofei-it

Hermes是一套新颖巧妙易用的Android进程间通信IPC框架。

Shelly是一个面向业务逻辑的编程库。Shelly库提供了一种全新的编程模式,将业务对象的变化对各个模块的影响通过方法链表示出来。

AndroidDataStorage是一个简洁易用并且具有高性能的Android存储库。

ComparatorGenerator是一个易用的生成Comparator的工具类。在排序时特别有用。

#License

Copyright (C) 2016 Xiaofei, ele.me

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