第3章 AIDL接口定义语言：文件结构、生成的Java/C++桩代码工作流程

AIDL（Android Interface Definition Language）是Android系统中定义跨进程接口的标准语言。本章深入分析AIDL文件的结构要素，并说明从源文件到Java/C++桩代码的转换工作流，涵盖编译触发条件、生成器行为、桩与代理类职责。

3.1 AIDL文件结构

一个完整的AIDL文件由包声明、导入声明、接口声明和自定义数据结构组成。下面以典型电话状态监听接口为例列出各部件的语法规则：

3.2 桩代码生成工作流程

从AIDL文件到最终可运行的Java/C++桩代码，经历五个关键阶段：

1. 语法解析 — Android SDK的aidl工具读取.aidl文件，生成抽象语法树（AST）。
2. 类型校验 — 解析所有引用的Parcelable和AIDL接口，确保类型系统闭合、导入路径可解。
3. 桩代码生成 — 根据目标语言（Java/C++）生成对应的Stub（服务端基类）和Proxy（客户端代理）。
4. 接口描述符注入 — 为每个AIDL接口分配唯一DESCRIPTOR字符串，用于Binder跨进程身份识别。
5. Parcel读写骨架 — 为方法参数逐个生成writeToParcel/createFromParcel序列化代码，以及transact/onTransact路由代码。

3.3 典型AIDL示例与生成代码分析

编写一个简单的音乐播放控制接口：

// IMusicPlayer.aidl
package com.example.music;

interface IMusicPlayer {
    void play(String uri);
    void pause();
    int getCurrentPosition();
    void registerCallback(IMusicCallback cb);
    void unregisterCallback(IMusicCallback cb);
}

上述文件经过aidl工具生成Java桩代码的核心片段（服务端Stub）：

// IMusicPlayer.java (生成代码)
public interface IMusicPlayer extends android.os.IInterface {
    public static abstract class Stub extends android.os.Binder implements IMusicPlayer {
        private static final String DESCRIPTOR = "com.example.music.IMusicPlayer";
        public Stub() { attachInterface(this, DESCRIPTOR); }

        @Override
        public boolean onTransact(int code, android.os.Parcel data,
                                  android.os.Parcel reply, int flags) throws RemoteException {
            switch (code) {
                case TRANSACTION_play: {
                    data.enforceInterface(DESCRIPTOR);
                    String _arg0 = data.readString();
                    play(_arg0);
                    reply.writeNoException();
                    return true;
                }
                case TRANSACTION_pause: {
                    data.enforceInterface(DESCRIPTOR);
                    pause();
                    reply.writeNoException();
                    return true;
                }
                // 其他方法类似...
                default: return super.onTransact(code, data, reply, flags);
            }
        }
        // TRANSACTION_* 常量由工具自动生成
        private static final int TRANSACTION_play = android.os.IBinder.FIRST_CALL_TRANSACTION;
        private static final int TRANSACTION_pause = android.os.IBinder.FIRST_CALL_TRANSACTION + 1;
        // ...
    }
    // Proxy 内部类略...
}

C++侧桩代码（位于frameworks/native/libs/binder）结构类似：

// IMusicPlayer.h (简化)
class IMusicPlayer : public android::IInterface {
public:
    DECLARE_META_INTERFACE(IMusicPlayer)
    virtual android::binder::Status play(const std::string& uri) = 0;
    virtual android::binder::Status pause() = 0;
    virtual int32_t getCurrentPosition() = 0;
    // ...
};

// BnMusicPlayer.cpp (Bn端 onTransact)
android::status_t BnMusicPlayer::onTransact(uint32_t code, const Parcel& data,
                                            Parcel* reply, uint32_t flags) {
    switch (code) {
        case PLAY: {
            CHECK_INTERFACE(IMusicPlayer, data, reply);
            std::string uri = data.readCString();
            android::binder::Status status = play(uri);
            status.writeToParcel(reply);
            return NO_ERROR;
        }
        // ...
    }
}

3.4 桩代码生成流程SVG

3.5 常见错误与调试

• 类型未导入：AIDL中引用了未声明的Parcelable或接口，编译时报couldn't find import。应在文件头部使用import补齐。
• 方法签名不一致：服务端实现的方法参数或返回值与AIDL定义不匹配，导致android.os.RemoteException。检查生成的Stub中onTransact读写顺序。
• oneway方法误用：有返回值的方法不能用oneway修饰，否则客户端永远收不到响应。
• Parcelable未实现writeToParcel/createFromParcel：自定义类型必须实现Parcelable接口，且字段读写顺序与AIDL中一致。

3.6 性能优化要点