AIDL的基本使用

对于AIDL的一些使用：最基础使用、稍高级使用、……

基本概念

此章节可能和本文没有太大关系，了解一下即可

图片解释

全称与中文名

• IPC：Inter-Process Communication（进程间通信）
• Ashmem：Anonymous Shared Memory（匿名共享内存）
• Binder：Binder（进程间通信机制）
• AIDL：Android Interface Definition Language（android接口定义语言）
• Intent：Intent（意图）

基本概念

• IPC：一种概念，即进程间通信
• Ashmem：作用之一是通过Binder进程间通信机制来实现进程间的内存共享
• Binder：对IPC的具体实行，是IPC的一种具体实现
• AIDL：Binder机制向外提供的接口，目的是为了方便调用Binder
• Intent：最高层级的封装，实质上封装了对Binder的使用

注意

基本开发流程：先开发Service端，后开发Client端

使用AndroidStudio创建AidlDemo工程后，再在里面创建Service Module和Client Module，不用管默认的app Module

开发流程-最基础使用

分支：feature/aidl_base

Service端

包名：com.fqxyi.aidlservice

1、创建aidl文件，如：IAidlBinder.aidl，新增接口，如：String getInfo();

2、检查build/generated/source/aidl/debug下是否存在对应的java文件，若无则Rebuild Project，若出现错误，请查看#FAQ章节

3、创建继承于android.app.Service的Service类，如：AidlService.java，并实现必须要实现的onBind方法

3.1、在AndroidManifest.xml文件中静态注册Service，详细注册代码如下：

<!-- exported表示是否支持其它应用调用当前组件 --><!-- process表示将组建运行到单独的进程中 --><!-- action用于用于过滤识别其他的Intent --><service android:name=".AidlService"  android:exported="true"  android:process=":Remote">  <intent-filter>      <action android:name="com.fqxyi.aidlservice.remote"/>  </intent-filter></service>

4、接着我们回到AidlService.java文件，onBind方法需要我们返回一个IBinder对象。显然，到目前为止能够得到IBinder对象的类只有通过IAidlBinder.aidl自动生成的IAidlBinder.java类。

由于默认代码格式很乱，所以为了方便查看，我们可以使用快捷键格式化一下代码：Ctrl(Command)+Alt(Option)+L

仔细阅读代码发现，我们想要得到的IBinder对象是通过asBinder()方法返回的，所以接下来我们只需要返回一个IAidlBinder.Stub的对象就可以了。

5、实例化IAidlBinder.Stub的对象之后，我们可以处理我们自定义的方法getInfo()，比如最简单的就是返回一串字符串：return "I'm a Server";

Client端

包名：com.fqxyi.aidlclient

1、将Service端的aidl文件，拷贝到main文件夹下，需要注意的是aidl文件的包名还是Service端的包名，具体目录结构如下：

aidlclient    |--src        |--main            |--aidl                |--com.fqxyi.aidlservice // Service端的包名                    |--IAidlBinder.aidl

2、检查build/generated/source/aidl/debug下是否存在对应的java文件，若无则Rebuild Project，若出现错误，请查看#FAQ章节

3、创建Intent对象并实例化，接着配置在Service端配置的action，实现Service的绑定，具体代码如下所以：

Intent intent = new Intent();intent.setAction("com.fqxyi.aidlservice.remote");intent.setPackage("com.fqxyi.aidlservice");bindService(intent, conn, Context.BIND_AUTO_CREATE);

4、上述代码因不存在ServiceConnection而报错，所以很简单，我们需要创建一个ServiceConnection对象并实例化，接着在必须要实现的onServiceConnected(ComponentName name, IBinder service)方法中初始化IAidlBinder，在onServiceDisconnected(ComponentName name)方法中将IAidlBinder置为null。

仔细阅读IAidlBinder.java代码发现，我们想要得到的IAidlBinder对象是通过asInterface(android.os.IBinder obj)方法返回的，需要传入一个IBinder对象，所以接下来就很简单了，只需要如下代码即可：

IAidlBinder.Stub.asInterface(service);

5、最后我们只需要通过第4步得到的IAidlBinder对象，调用getInfo()方法，就可以得到内容。

开发流程-稍高级使用

分支：feature/aidl_advanced

此处文档说明基于#开发流程-最基础使用章节，通过列出不同点进行说明。

Service端

包名：com.fqxyi.aidlservice

1、创建aidl文件，如：IAidlBinder.aidl，新增接口，如：String getInfo();和Student getStudentInfo();

需要注意的是Student是我们自己定义的一个实现了Parcelable接口的Model类，在aidl文件中定义接口，需要我们手动import语句，添加引用。

2、创建Student类，具体代码如下所示：

package com.fqxyi.aidlservice.model;import android.os.Parcel;import android.os.Parcelable;/** * Created by qingfeng on 2017/7/27. */public class Student implements Parcelable {    private String name;    private int age;    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }    public int getAge() {        return age;    }    public void setAge(int age) {        this.age = age;    }    protected Student(Parcel in) {        this.name = in.readString();        this.age = in.readInt();    }    public static final Creator<Student> CREATOR = new Creator<Student>() {        @Override        public Student createFromParcel(Parcel in) {            return new Student(in);        }        @Override        public Student[] newArray(int size) {            return new Student[size];        }    };    @Override    public int describeContents() {        return 0;    }    @Override    public void writeToParcel(Parcel dest, int flags) {        dest.writeString(name);        dest.writeInt(age);    }}

大家如果不深究、只考虑使用的话，不用担心自己会不会写这些代码，因为主要代码是自动生成的。

我们只需要定义一个name和age属性，然后执行以下两部操作就行了：

• 在构造函数中读取Parcel中的值并赋值给成员变量
• 在writeToParcel方法中写入值到Parcel中

3、创建Student.aidl文件，声明Student实现了Parcelable接口，具体代码如下所示：

// Student.aidlpackage com.fqxyi.aidlservice.model;// Declare any non-default types here with import statementsimport com.fqxyi.aidlservice.model.Student;parcelable Student;

4、检查build/generated/source/aidl/debug下是否存在对应的java文件，若无则Rebuild Project，若出现错误，请查看#FAQ章节

3、创建继承于android.app.Service的Service类，如：AidlService.java，并实现必须要实现的onBind方法

3.1、在AndroidManifest.xml文件中静态注册Service，详细注册代码如下：

<!-- exported表示是否支持其它应用调用当前组件 --><!-- process表示将组建运行到单独的进程中 --><!-- action用于用于过滤识别其他的Intent --><service android:name=".AidlService"  android:exported="true"  android:process=":Remote">  <intent-filter>      <action android:name="com.fqxyi.aidlservice.remote"/>  </intent-filter></service>

4、接着我们回到AidlService.java文件，onBind方法需要我们返回一个IBinder对象。显然，到目前为止能够得到IBinder对象的类只有通过IAidlBinder.aidl自动生成的IAidlBinder.java类。

由于默认代码格式很乱，所以为了方便查看，我们可以使用快捷键格式化一下代码：Ctrl(Command)+Alt(Option)+L

仔细阅读代码发现，我们想要得到的IBinder对象是通过asBinder()方法返回的，所以接下来我们只需要返回一个IAidlBinder.Stub的对象就可以了。

5、实例化IAidlBinder.Stub的对象之后，我们可以处理我们自定义的方法getInfo()，比如最简单的就是返回一串字符串：return "I'm a Server";

如果我们想要处理getStudentInfo()方法的话，可以在onCreate()方法中进行初始化赋值操作，然后在getStudentInfo()方法中直接return即可。

Client端

包名：com.fqxyi.aidlclient

1、将Service端的aidl文件、和需要调用的文件，如：Student.java，拷贝到main文件夹下，需要注意的是这些文件的包名还是Service端的包名，具体目录结构如下：

aidlclient    |--src        |--main            |--aidl                |--com.fqxyi.aidlservice // Service端的包名                    |--model                        |--Student.aidl                    |--IAidlBinder.aidl            |--java                |--com.fqxyi.aidlservice // Service端的包名                   |--model                       |--Student.java

2、检查build/generated/source/aidl/debug下是否存在对应的java文件，若无则Rebuild Project，若出现错误，请查看#FAQ章节

3、创建Intent对象并实例化，接着配置在Service端配置的action，实现Service的绑定，具体代码如下所以：

Intent intent = new Intent();intent.setAction("com.fqxyi.aidlservice.remote");intent.setPackage("com.fqxyi.aidlservice");bindService(intent, conn, Context.BIND_AUTO_CREATE);

4、上述代码因不存在ServiceConnection而报错，所以很简单，我们需要创建一个ServiceConnection对象并实例化，接着在必须要实现的onServiceConnected(ComponentName name, IBinder service)方法中初始化IAidlBinder，在onServiceDisconnected(ComponentName name)方法中将IAidlBinder置为null。

仔细阅读IAidlBinder.java代码发现，我们想要得到的IAidlBinder对象是通过asInterface(android.os.IBinder obj)方法返回的，需要传入一个IBinder对象，所以接下来就很简单了，只需要如下代码即可：

IAidlBinder.Stub.asInterface(service);

5、最后我们只需要通过第4步得到的IAidlBinder对象，调用getInfo()方法，就可以得到内容，也可以调用getStudentInfo()方法，获得Student对象。

FAQ

Service

ProcessException: Error while executing process aidl with arguments …

Error:Execution failed for task ':aidlservice:compileDebugAidl'.> java.lang.RuntimeException: com.android.ide.common.process.ProcessException: Error while executing process /qingfeng/work/sdk/build-tools/25.0.2/aidl with arguments {-p/qingfeng/work/sdk/platforms/android-25/framework.aidl -o/qingfeng/data/openSource/AidlDemo/aidlservice/build/generated/source/aidl/debug -I/qingfeng/data/openSource/AidlDemo/aidlservice/src/main/aidl -I/qingfeng/data/openSource/AidlDemo/aidlservice/src/debug/aidl -I/Users/qingfeng/.android/build-cache/92fb7eb4401d63eb124015b36c2a8a534302f1c9/output/aidl -d/var/folders/tq/f6kngw516g15xs24gdh80qvh0000gn/T/aidl1446680322459273337.d /qingfeng/data/openSource/AidlDemo/aidlservice/src/main/aidl/com/fqxyi/aidlservice/IAidlBinder.aidl}

出现此类问题，其实是因为你的aidl文件编写错误，请仔细检查：

• 包名是否导入，是否正确导入
• 其他原因…

Client

IllegalArgumentException: Service Intent must be explicit

FATAL EXCEPTION: mainProcess: com.fqxyi.aidlclient, PID: 19282java.lang.IllegalArgumentException: Service Intent must be explicit: Intent { act=com.fqxyi.aidlservice.remote }  at android.app.ContextImpl.validateServiceIntent(ContextImpl.java:1219)  at android.app.ContextImpl.bindServiceCommon(ContextImpl.java:1318)  at android.app.ContextImpl.bindService(ContextImpl.java:1296)  ...

如果你使用的Android设备的版本大于5.0，则需要在bindService的时候，为你的intent添加以下语句：

intent.setPackage("com.fqxyi.aidlservice");

其他问题待收录…

总结

什么？

代码太多？

作者写的太烂？看的头昏脑涨…

没关系，直接去看源码就行了，记住：

最基础使用分支：feature/aidl_base，传送门

稍高级使用分支：feature/aidl_advanced，传送门