AIDL简单实用教程
背景:
因为最近公司项目需要有一个通过aidl传递数据给三方app使用,所以有了这次踩坑经验,写出来供大家避免深坑的同时,也给自己积累一点点知识库。
一、初识Android 接口定义语言 (AIDL)
Android 接口定义语言 (AIDL) 与您可能使用过的其他接口语言 (IDL) 类似。您可以利用它定义客户端与服务均认可的编程接口,以便二者使用进程间通信 (IPC) 进行相互通信。在 Android 中,一个进程通常无法访问另一个进程的内存。因此,为进行通信,进程需将其对象分解成可供操作系统理解的原语,并将其编组为可供您操作的对象。编写执行该编组操作的代码较为繁琐,因此 Android 会使用 AIDL 为您处理此问题。
注意:只有在需要不同应用的客户端通过 IPC 方式访问服务,并且希望在服务中进行多线程处理时,您才有必要使用 AIDL。如果您无需跨不同应用执行并发 IPC,则应通过实现 Binder 来创建接口;或者,如果您想执行 IPC,但不需要处理多线程,请使用 Messenger 来实现接口。无论如何,在实现 AIDL 之前,请您务必理解绑定服务。
在开始设计 AIDL 接口之前,请注意,AIDL 接口的调用是直接函数调用。您无需对发生调用的线程做任何假设。实际情况的差异取决于调用是来自本地进程中的线程,还是远程进程中的线程。具体而言:
- 来自本地进程的调用在发起调用的同一线程内执行。如果该线程是您的主界面线程,则其将继续在 AIDL 接口中执行。如果该线程是其他线程,则其便是在服务中执行代码的线程。因此,只有在本地线程访问服务时,您才能完全控制哪些线程在服务中执行(但若出现此情况,您根本无需使用 AIDL,而应通过实现 Binder 类来创建接口)。
- 远程进程的调用分派自线程池,且平台会在您自己的进程内部维护该线程池。您必须为来自未知线程,且多次调用同时发生的传入调用做好准备。换言之,AIDL 接口的实现必须基于完全的线程安全。如果调用来自同一远程对象上的某个线程,则该调用将依次抵达接收器端。
oneway
关键字用于修改远程调用的行为。使用此关键字后,远程调用不会屏蔽,而只是发送事务数据并立即返回。最终接收该数据时,接口的实现会将其视为来自Binder
线程池的常规调用(普通的远程调用)。如果oneway
用于本地调用,则不会有任何影响,且调用仍为同步调用。
AIDL 使用一种简单语法,允许您通过一个或多个方法(可接收参数和返回值)来声明接口。参数和返回值可为任意类型,甚至是 AIDL 生成的其他接口。
您必须使用 Java 编程语言构建 .aidl
文件。每个 .aidl
文件均须定义单个接口,并且只需要接口声明和方法签名。
默认情况下,AIDL 支持下列数据类型:
- Java 编程语言中的所有原语类型(如
int
、long
、char
、boolean
等) String
CharSequence
List
List
中的所有元素必须是以上列表中支持的数据类型,或者您所声明的由 AIDL 生成的其他接口或 Parcelable 类型。您可选择将List
用作“泛型”类(例如,List<String>
)。尽管生成的方法旨在使用List
接口,但另一方实际接收的具体类始终是ArrayList
。Map
Map
中的所有元素必须是以上列表中支持的数据类型,或者您所声明的由 AIDL 生成的其他接口或 Parcelable 类型。不支持泛型 Map(如Map<String,Integer>
形式的 Map)。尽管生成的方法旨在使用Map
接口,但另一方实际接收的具体类始终是HashMap
。
即使您在与接口相同的包内定义上方未列出的附加类型,亦须为其各自加入一条 import
语句。
接下来开始实战~
1.创建一个新的项目AidlDemo,然后创建library Module,
直接右键刚刚创建的mylibrary创建AIDL文件:
点击Finish后就会自动生成一个aidl文件了:
打开后:
// IMyAidlInterface.aidl
package com.yqw.mylibrary;
// Declare any non-default types here with import statements
interface IMyAidlInterface {
/**
* Demonstrates some basic types that you can use as parameters
* and return values in AIDL.
*/
void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat,
double aDouble, String aString);
}
这里basicTypes就是默认给了一个示例AIDL可以使用的基本数据类型,可以直接删除,然后写入自己需要的
此次示例准备写一个简单的图书馆图书管理的AIDL数据共享,图书馆需要有图书book,然后需要实现借书、还书、查阅剩余图书数量等功能方法,下面依次创建相应需要的方法:
// IMyAidlInterface.aidl
package com.yqw.mylibrary;
interface IMyAidlInterface {
int borrowBo