对于AIDL的一些使用:最基础使用、稍高级使用、......
<!--more-->
基本概念
此章节可能和本文没有太大关系,了解一下即可
图片解释
全称与中文名
- 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
,若出现错误,请查看章节
3、创建继承于android.app.Service的Service类,如:AidlService.java
,并实现必须要实现的onBind方法
3.1、在AndroidManifest.xml文件中静态注册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
,若出现错误,请查看章节
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 CreatorCREATOR = new Creator () { @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
,若出现错误,请查看章节
3、创建继承于android.app.Service的Service类,如:AidlService.java
,并实现必须要实现的onBind方法
3.1、在AndroidManifest.xml文件中静态注册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
,若出现错误,请查看章节
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,