Android开发接口描述

接口描述语言（AIDL）

译者署名：移动云_文斌

译者链接：/caowenbin

版本：Android 2.3 r1

原文

/guide/developing/tools/aidl.html (注意：3.0 r1 以后移到Appendix下)

使用AIDL设计远程接口(Designing a Remote Interface Using AIDL)

由于每个应用程序都运行在自己的进程空间，并且可以从应用程序UI运行另一个服务进程，而且经常会在不同的进程间传递对象。在Android平台，一个进程通常不能访问另一个进程的内存空间，所以要想对话，需要将对象分解成操作系统可以理解的基本单元，并且有序的通过进程边界。

通过代码来实现这个数据传输过程是冗长乏味的，Android提供了AIDL工具来处理这项工作。

AIDL (Android Interface Definition Language)是一种IDL 语言，用于生成可以在Android设备上两个进程之间进行进程间通信(IPC)的代码。如果在一个进程中（例如Activity）要调用另一个进程中（例如Service）对象的操作，就可以使用AIDL生成可序列化的参数。

AIDL IPC机制是面向接口的，像COM或Corba一样，但是更加轻量级。它是使用代理类在客户端和实现端传递数据。

使用AIDL实现IPC(Implementing IPC Using AIDL)使用AIDL实现IPC服务的步骤是：

1.创建.aidl文件-该文件（YourInterface.aidl）定义了客户端可用的

方法和数据的接口。

2.在makefile文件中加入.aidl文件-（Eclipse中的ADT插件提供管理

功能）Android包括名为AIDL的编译器，位于tools/文件夹。

3.实现接口-AIDL编译器从AIDL接口文件中利用Java语言创建接口，该

接口有一个继承的命名为Stub的内部抽象类（并且实现了一些IPC调用

的附加方法），要做的就是创建一个继承于YourInterface.Stub的类并

且实现在.aidl文件中声明的方法。

4.向客户端公开接口-如果是编写服务，应该继承Service并且重载

Service.onBind(Intent) 以返回实现了接口的对象实例

创建.aidl文件(Create an .aidl File)

AIDL使用简单的语法来声明接口，描述其方法以及方法的参数和返回值。这些参数和返回值可以是任何类型，甚至是其他AIDL生成的接口。重要的是必须导入所有非内置类型，哪怕是这些类型是在与接口相同的包中。下面是AIDL能支持的数据类型：

●Java编程语言的主要类型 (int, boolean等) —不需要 import 语句。

●以下的类 (不需要import 语句):

⏹String

⏹List-列表中的所有元素必须是在此列出的类型，包括其他AIDL生成

的接口和可打包类型。List可以像一般的类（例如List）

那样使用，另一边接收的具体类一般是一个ArrayList，这些方法会

使用List接口。

⏹Map - Map中的所有元素必须是在此列出的类型，包括其他AIDL生

成的接口和可打包类型。一般的maps（例如Map）

不被支持，另一边接收的具体类一般是一个HashMap，这些方法会使

用Map接口。

⏹CharSequence -该类是被TextView和其他控件对象使用的字符序

列。

●通常引引用方式传递的其他AIDL生成的接口，必须要import 语句声明

●实现了Parcelable protocol 以及按值传递的自定义类，必须要import

语句声明。

以下是基本的AIDL语法：

实现接口(Implementing the Interface)

//My AIDL file,named SomeCloss.aidl

//Note that standard comment syntax is respected.

//Comments before the import or package statements are not bubbled up

//to the generated interface,but comments above interface/method/field

//declarations are added to the generated interface.

//Include your fully-qualified package statement.

Package com.android.sample;

//See the list above for which classes need

//import statements(hint—most of them)

Import com.android.sample .IAtmService;

//Declare the interface.

iterface IBankAccountService {

//Methods can take 0 or more parameters, and

//return a value or void.

int getAccountBalance();

void setOwnerNames(in List names);

//Methods can even take other AIDL-defined parameters.

BankAccount createAccount(in String name, int startingDeposit, in IAtmService atmService);

//All non-Java primitive parameters(e.g., int, bool, etc) require;

// a directional tag indicating which way the data will go. Available

// values are in, out, inout. (Primitives are in by default, and cannot be otherwise).

// Limit the direction to what is truly needed, because marshalling parameters

// is expensive.

int getCustomerList(in String branch, out String[] customerList);

}

AIDL生成了与.aidl文件同名的接口，如果使用Eclipse插件，AIDL 会做为编译过程的一部分自动运行（不需要先运行AIDL再编译项目），如果没有插件，就要先运行AIDL。

生成的接口包含一个名为Stub的抽象的内部类，该类声明了所

有.aidl中描述的方法，Stub还定义了少量的辅助方法，尤其是asInterface()，通过它或以获得IBinder（当applicationContext.bindService()成功调用时传递到客户端的onServiceConnected()）并且返回用于调用IPC方法的接口实例，更多细节参见Calling an IPC Method。

要实现自己的接口，就从YourInterface.Stub类继承，然后实现相关的方法（可以创建.aidl文件然后实现stub方法而不用在中间编译，Android

编译过程会在.java文件之前处理.aidl文件）。

这个例子实现了对IRemoteService接口的调用，这里使用了匿名对象并且只有一个getPid()接口。

// No need to import IRemoteService if it’s in the same project.

private final IRemoteService.Stub mBinder = new IRemoteService.Stub(){ public int getPid(){

return Process.myPid();

}

}