Android AIDL 教程 (一）—— 简单的示例

接下来让我们一起来实现一个简单功能，通过一哥 app（Clilent） 唤起另外一个 APP （Server），并进行两者之间的通讯。首先，我们先来看一下服务端的实现。

---

服务端的实现

---

服务端的实现，一般来说，需要以下步骤：

• 将请求抽象成接口，并编写 aidl 文件；

• 编写一个 Service，实现接口，处理客户端的请求，并将 binder 返回回去；

• 在 AndroidManifet 配置 Service，将我们的 Service 暴露出去。

将请求抽象成接口，编写 aidl 文件

一般来说， AIDL 文件支持以下类型

• Java 编程语言中的所有原语类型（如 int、long、char、boolean 等等）

• String

• CharSequence

• List

List 中的所有元素都必须是以上列表中支持的数据类型、其他 AIDL 生成的接口或您声明的可打包类型。 可选择将 List 用作“通用”类（例如，List）。另一端实际接收的具体类始终是 ArrayList，但生成的方法使用的是 List 接口。

• Map

Map 中的所有元素都必须是以上列表中支持的数据类型、其他 AIDL 生成的接口或您声明的可打包类型。 不支持通用 Map（如 Map<String,Integer> 形式的 Map）。 另一端实际接收的具体类始终是 HashMap，但生成的方法使用的是 Map 接口。

• 实现 Parceable 的自定义类型

注意事项

• 在 aidl 文件中，除了 Java 编程语言中的所有原语类型、String、CharSequence、List、Map,其他在 AIDL 文件中用到的类，你必须使用 import 语句导入，否则会报错。

• 当你使用实现Parceable 的自定义类型的时候，当其作为参数的时候，你必须为其制定是输入或者是输出参数。

in 表示输入参数，即服务端可以修改该类型

out 表示输出参数，即客户端可以修改该类型，客户端不行

inout 表示客户端和服务端都可以修改该类型

如

void onSuccess(int code,in MusicInfo musicInfo);

有人可能会这样想，既然 inout 表示客户端和服务端都可以修改该类型，那我们平时在写 aidl 文件的时候，直接在方法参数前面加上 inout 修饰就 OK了，省得去区分。

这样做法当然不行，既然双方都可以修改，那系统的开销肯定会比较大。就好比管道一样。

说了这么多，接下来让我们一起来看一下例子 IEasyService.aidl

package xj.musicserver.easy;

// Declare any non-default types here with import statements

interface IEasyService {

/**

• Demonstrates some basic types that you can use as parameters

• and return values in AIDL.

*/

void connect(String mes);

void disConnect(String mes);

}

这个 aidl 文件很接口，只有两个方法，connect 和 disConnect 方法。

这里我们把 aidl 文跟 Java 文件中放在一起，需要在 build.gradle 中配置

sourceSets {

main {

jniLibs.srcDirs = [‘libs’]

aidl.srcDirs = [‘src/main/java’]

}

}

关于怎样在 AndroidStudio 中引用 aidl 文件的，可以参考我的这一篇文章 AndroidStudio 引用 aidl 文件的两种方法

编写一个 Service，实现接口，处理客户端的请求，并将接口返回回去

public class EasyService extends Service
{

private static final String TAG = “EasyService”;

public EasyService() {

}

IEasyService.Stub mIBinder=new IEasyService.Stub() {

@Override

public void connect(String mes) throws RemoteException {

LogUtil.i(TAG,“connect: mes =” + mes);

}

@Override

public void disConnect(String mes) throws RemoteException {

LogUtil.i(TAG, “disConnect: mes =” +mes);

}

};

@Override

public IBinder onBind(Intent intent) {

LogUtil.i(TAG,"onBind: intent = "+intent.toString());

return mIBinder;

}

@Override

public boolean onUnbind(Intent intent) {

LogUtil.i(TAG,“onUnbind: =”);

return super.onUnbind(intent);

}

@Override

public void onDestroy() {

LogUtil.i(TAG,“onDestroy: =”);

super.onDestroy();

}

}

这个 Service 所做的动作就是当客户端连接上的时候，会启动我们的 Service，此时会调用 Service 的 onBInd 方法，在 onBinder 方法里面，我们将 mIBinder （实现了 IEasyService.Stub 接口）返回回去。他充当客户端和服务端的桥梁，通过他我们可以进行通讯。

至于这个 IEasyService.Stub 是什么呢？其实当我们在 AndroidStudio 里面编写完 aidl 文件，重新 make project 一下，就会自动生成了。

将服务端的 Service 暴露出去

在 AndroidManifest 文件下，配置 Service 的 action 及 exported 等信息。

其中 android:exported=“true” 表示别的进程可以访问，这个是必须配置的。android:process=“:remote” 表示运行在 :remote 进程，不配置的话默认运行所在的 App 进程，这个可以不配置。

<service

android:name=“.easy.EasyService”

android:enabled=“true”

android:exported=“true”

android:process=“:remote”>

---

客户端的实现

---

• 将服务端的 aidl 文件 copy 过来，注意要放在同一个包下。

• 通过服务端 Service 的 Action 启动， 当启动 Service 成功的时候，将服务端返回的 Binder 保存下来并转化成相应的实例。

• 之后如果想与服务端通讯，通过保存下来的 Binder，即可调用服务端的方法。

第一步：将服务端的 aidl 文件 copy 过来，注意要放在同一个包下

• 第二步，通过服务端 Service 的 Action 启动， 当启动 Service 成功的时候，将服务端返回的 Binder 保存下来并转化成相应的实例

当我们点击按钮的时候，我们通过 Action 去启动远程 servic。

case R.id.btn_start_service:

LogUtil.i(TAG,“onButtonClick: btn_start_service=”);

Intent intent = new Intent(ACTION);

// 注意在 Android 5.0以后，不能通过隐式 Intent 启动 service，必须制定包名

intent.setPackage(XJ_MUSICSERVER);

bindService(intent,mServiceConnection, Context.BIND_AUTO_CREATE);

private static final String ACTION = “xj.musicserver.easy.IEasyService”;

private IEasyService mIEasyService;

ServiceConnection mServiceConnection=new ServiceConnection() {

@Override

public void onServiceConnected(ComponentName name, IBinder service) {

mIEasyService = IEasyService.Stub.asInterface(service);

}

@Override

public void onServiceDisconnected(ComponentName name) {

mIEasyService=null;

}

};

测试将会启动远程 Service，及服务端的 EasyService，并调用 onBind 方法，打印出相应信息。

xj.musicserver:remote I/MusicInterface: EasyService :onBind: intent = Intent { act=xj.musicserver.easy.IEasyService pkg=xj.musicserver }