文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

[Android AIDL系列 1] 手动编译aidl文件,生成Java、C++[android]、C++[ndk]、Rust接口

2023-08-22 22:53

关注

AIDL文件在Android系统上应用广泛,和底层的Binder机制紧密关联。
在Android源码或者Android Studio中通常是自动编译aidl文件,生成对应语言的接口文件。
做应用层Java开发,aidl和binder封装的比较“干净”,不用太多的涉及binder的调用细节,也不用太关心aidl的编译过程。
如果是做中下层开发,包括framework、native层开发,可能需要编写native service,有必要理解binder的底层机制。

先从编译aidl开始。这里只说明编译aidl生成各种类型后端接口文件的过程。生成的接口文件内容再写文章单独介绍。

以下演示是在Ubuntu系统上测试的。

1. aidl编译工具

即aidl命令,Android sdk或者Android源码中都有。

sdk中aidl,需要把路径添加到path中。
位置:~/Android/Sdk/build-tools/33.0.2/aidl

源码中aidl,设置源码编译环境后,自动添加到path中。
位置:out/soong/host/linux-x86/bin/aidl

2. 演示用的aidl文件

写2个简单的aidl文件,一个是服务接口,一个是回调接口。可用覆盖大部分的实际场景。
文件目录结构和文件内容如下。

$ tree ..└── aidl    └── com        └── my            └── pkg                ├── IMyServiceCallback.aidl                └── IMyServiceInterface.aidl

回调接口定义:

// IMyServiceCallback.aidlpackage com.my.pkg; interface IMyServiceCallback {    void onEvent(int code, String message);}

服务接口定义:

// IMyServiceInterfacepackage com.my.pkg;interface IMyServiceInterface {    int doSomething(in String str, int num);    void setCallBack(com.my.pkg.IMyServiceCallback callback);}

执行如下命令,生成Java接口文件。
说明:

  1. aidl使用说明
    aidl --lang={java|cpp|ndk} [options] input_aidl_file。
    在命令行中,aidl不带任何参数,打印使用说明。
  2. –lang={java|cpp|ndk}
    指定生成接口类型。如果不指定,默认生成Java文件。
  3. -o 指定输出目录
    Java:省略-o参数,java文件生成到aidl文件目录下。
    C++/Rust:必选参数。
    为了清除查看效果,指定到单独的目录:-o ./java
  4. -I DIR, --include=DIR
    import搜索路径,指定依赖的aidl文件所在目录。不是C++头文件目录。
    例如:IMyServiceInterface.aidl引用了IMyServiceCallback.aidl,在生成IMyServiceInterface.aidl的时候需要指定-I参数才能正常编译。
    只要是AIDL文件中有依赖,生成任何类型的接口(Java、C++、Rust)都要指定这个参数。
# 前2条命令效果相同,不指定--lang参数,默认生成Java文件$ aidl -o ./java --lang=java aidl/com/my/pkg/IMyServiceCallback.aidl $ aidl -o ./java aidl/com/my/pkg/IMyServiceCallback.aidl $ aidl -I ./aidl/ -o ./java aidl/com/my/pkg/IMyServiceInterface.aidl$ tree .├── aidl│   └── com│       └── my│           └── pkg│               ├── IMyServiceCallback.aidl│               └── IMyServiceInterface.aidl└── java    └── com        └── my            └── pkg                ├── IMyServiceCallback.java                └── IMyServiceInterface.java
  1. cpp和ndk的区别
    cpp:生成的代码是为了在Android源码中编译,代码中会调用Android源码中的native接口。
    例如,引用的头文件:

    ndk:生成的代码是为了使用ndk独立编译,调用的是ndk的接口,
    例如,引用的头文件:

  2. –lang=cpp,参数指定生成Android源码下编译的C++接口文件。

  3. -o和-h参数分别指定.cpp文件和.h文件输出的路径。可以指定不同的目录。
    1)C++接口文件比较多,一个aidl文件生成4个文件。第一步编译IMyServiceCallback.aidl后,生成文件包括:
    3个头文件:
    一个Interface头文件:IMyServiceCallback.h
    一个Bp头文件:BpMyServiceCallback.h
    一个Bn头文件:BnMyServiceCallback.h
    一个源码文件:IMyServiceCallback.cpp

$ aidl -h ./cpp_android/ -o ./cpp_android --lang=cpp aidl/com/my/pkg/IMyServiceCallback.aidl$ tree .├── aidl│   └── com│       └── my│           └── pkg│               ├── IMyServiceCallback.aidl│               └── IMyServiceInterface.aidl└── cpp_android    └── com        └── my            └── pkg                ├── BnMyServiceCallback.h                ├── BpMyServiceCallback.h                ├── IMyServiceCallback.cpp                └── IMyServiceCallback.h$ aidl -I ./aidl/ -h ./cpp_android/ -o ./cpp_android --lang=cpp aidl/com/my/pkg/IMyServiceInterface.aidl$ tree .├── aidl│   └── com│       └── my│           └── pkg│               ├── IMyServiceCallback.aidl│               └── IMyServiceInterface.aidl└── cpp_android    └── com        └── my            └── pkg                ├── BnMyServiceCallback.h                ├── BnMyServiceInterface.h                ├── BpMyServiceCallback.h                ├── BpMyServiceInterface.h                ├── IMyServiceCallback.cpp                ├── IMyServiceCallback.h                ├── IMyServiceInterface.cpp                └── IMyServiceInterface.h

除了–lang=ndk指定生成ndk后端接口,过程和结果都和cpp类似。

$ aidl -I ./aidl/ -h ./cpp_ndk -o ./cpp_ndk --lang=ndk aidl/com/my/pkg/IMyServiceInterface.aidl $ aidl -h ./cpp_ndk -o ./cpp_ndk --lang=ndk aidl/com/my/pkg/IMyServiceCallback.aidl $ tree cpp_*cpp_android└── com    └── my        └── pkg            ├── BnMyServiceCallback.h            ├── BnMyServiceInterface.h            ├── BpMyServiceCallback.h            ├── BpMyServiceInterface.h            ├── IMyServiceCallback.cpp            ├── IMyServiceCallback.h            ├── IMyServiceInterface.cpp            └── IMyServiceInterface.hcpp_ndk├── aidl│   └── com│       └── my│           └── pkg│               ├── BnMyServiceCallback.h│               ├── BnMyServiceInterface.h│               ├── BpMyServiceCallback.h│               ├── BpMyServiceInterface.h│               ├── IMyServiceCallback.h│               └── IMyServiceInterface.h└── com    └── my        └── pkg            ├── IMyServiceCallback.cpp            └── IMyServiceInterface.cpp
  1. –lang=rust指定生成rust后端接口文件。
  2. 只需通过-o参数设置输出路径即可,输出结果和Java类似,一个aidl文件对应一个.rs文件。
  3. Rust后端是比较新版本的aidl才支持的,可能是Android 12以后,可以查看aidl命令帮助确认。
$ aidl -o ./rust --lang=rust aidl/com/my/pkg/IMyServiceCallback.aidl $ aidl -I ./aidl/ -o ./rust --lang=rust aidl/com/my/pkg/IMyServiceInterface.aidl$ tree .├── aidl│   └── com│       └── my│           └── pkg│               ├── IMyServiceCallback.aidl│               └── IMyServiceInterface.aidl└── rust    └── com        └── my            └── pkg                ├── IMyServiceCallback.rs                └── IMyServiceInterface.rs

来源地址:https://blog.csdn.net/yinminsumeng/article/details/129324917

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯