Question

在 Android Studio 项目上右键， New -> AIDL -> AIDL File 输入文件名后可以快速创建一个 AIDL 的代码结构。例如我们新建一个 IRemoteService.aidl 文件

// IRemoteService.aidl
package com.android.aidltest;

interface IRemoteService {

  void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat,
      double aDouble, String aString);
}

从生成的示例代码可以看出，AIDL 的语法类似 Java， basicTypes() 方法传递的参数只是基本类型。

如果要传递自定义类型如 User ，则需要实现 Parcelable 接口。 Parcelable 是一个与 Java Serializable 类似的序列化接口。

这样类 User 的实例就可以储存到 Parcel 中，而 Parcel 则是一个可以通过 IBinder 发送数据或对象引用的容器。

// User.java
public class User implements Parcelable {

  private int uid;
  private String name;

  // 从 Parcel 中读取数据，顺序需要和写入保持一致
  protected User(Parcel in) {
    uid = in.readInt();
    name = in.readString();
  }

  // 必须实现，用于从 Parcel 对象中生成类实例
  public static final Creator<User> CREATOR = new Creator<User>() {
    @Override
    public User createFromParcel(Parcel in) {
      return new User(in);
    }

    @Override
    public User[] newArray(int size) {
      return new User[size];
    }
  };

  // 将数据写入到 Parcel 中， 顺序需要与读取保持一致
  @Override
  public void writeToParcel(Parcel dest, int flags) {
    dest.writeInt(uid);
    dest.writeString(name);
  }
}

再向 IRemoteService.aidl 中添加一个 addUser() 方法，同时新建一个 User.aidl 文件。

// IRemoteService.aidl
package com.android.aidltest;

import com.android.aidltest.User;

interface IRemoteService {

  void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat,
      double aDouble, String aString);

  // in 表示传入数据， out 表示传出数据， inout 表示双向传递。注意含有 out 时 User 类需要实现 readFromParcel() 方法
  void addUser(in User user);
}

// User.aidl
package com.android.aidltest;
parcelable User;

运行编译后，会在 generated 文件夹中生成一个 IRemoteService.java 接口文件。这个接口中有两个内部类 Stub 和 Stub.Proxy 。注意客户端生成的 IRemoteService.java 文件和在后文服务端生成的文件内容是相同的。

客户端会从 Stub.asInterface() 得到 IRemoteService (Stub.Proxy) 的实例，这个实例就是一个通过 Binder 传递回来的 远程对象 的包装。而服务端则需要实现 IRemoteService.addUser() 方法。

// IRemoteService.java
public static org.xdty.remoteservice.IRemoteService asInterface(android.os.IBinder obj) {
  if ((obj == null)) {
    return null;
  }
  android.os.IInterface iin = obj.queryLocalInterface(DESCRIPTOR);
  if (((iin != null) && (iin instanceof org.xdty.remoteservice.IRemoteService))) {
    return ((org.xdty.remoteservice.IRemoteService) iin);
  }
  return new org.xdty.remoteservice.IRemoteService.Stub.Proxy(obj);
}