AIDL的基本使用

对于AIDL的一些使用:最基础使用、稍高级使用、......

基本概念

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

图片解释

[图片上传失败...(image-569908-1512305024994)]

全称与中文名

  • 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.aidl
package com.fqxyi.aidlservice.model;

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

import 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: main
Process: com.fqxyi.aidlclient, PID: 19282
java.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传送门

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335

推荐阅读更多精彩内容