Android aidl命令用法

之前写过一篇文章“[Android]使用命令行打APK包 ”，里面没有涉及到aidl，现Sodino补充aidl的使用方法。

aidl的使用帮助如下：

[java] view plain copy print ?

1. C:/DocumentsandSettings/Administrator>aidl
2. INPUTrequired
3. usage:aidlOPTIONSINPUT[OUTPUT]
4. aidl--preprocessOUTPUTINPUT...
5. OPTIONS:
6. -I<DIR>searchpathforimportstatements.
7. -d<FILE>generatedependencyfile.
8. -p<FILE>filecreatedby--preprocesstoimport.
9. -o<FOLDER>baseoutputfolderforgeneratedfiles.
10. -bfailwhentryingtocompileaparcelable.
11. INPUT:
12. Anaidlinterfacefile.
13. OUTPUT:
14. Thegeneratedinterfacefiles.
15. Ifomittedandthe-ooptionisnotused,theinputfilenameisused,withth
16. e.aidlextensionchangedtoa.javaextension.
17. Ifthe-ooptionisused,thegeneratedfileswillbeplacedinthebaseoutp
18. utfolder,undertheirpackagefolder

C:/Documents and Settings/Administrator>aidl INPUT required usage: aidl OPTIONS INPUT [OUTPUT] aidl --preprocess OUTPUT INPUT... OPTIONS: -I<DIR> search path for import statements. -d<FILE> generate dependency file. -p<FILE> file created by --preprocess to import. -o<FOLDER> base output folder for generated files. -b fail when trying to compile a parcelable. INPUT: An aidl interface file. OUTPUT: The generated interface files. If omitted and the -o option is not used, the input filename is used, with th e .aidl extension changed to a .java extension. If the -o option is used, the generated files will be placed in the base outp ut folder, under their package folder

这些信息太少了，还不能让人明白如何使用。帮助信息首句就是“INPUT required”，其实只有"INPUT"仍是不够的，OPTIONS中“-I”是必选而非可选，否则会提示：

[java] view plain copy print ?

1. D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl:19:couldn'tfindimportforclasscom.example.android.apis.app.IRemoteServiceCallback

D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl:19: couldn't find import for class com.example.android.apis.app.IRemoteServiceCallback

以SDK自带的ApiDemos为实践对象，该工程存储路径为:"D:/JavaTest/ApiDemos/"，有三个aidl文件分别为：
com/example/android/apis/app/IRemoteService.aidl
com/example/android/apis/app/IRemoteServiceCallback.aidl
com/example/android/apis/app/ISecondary.aidl

要生成对应的.java文件命令行如下：

[java] view plain copy print ?

1. aidl-ID:/JavaTest/ApiDemos/srcD:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

aidl -ID:/JavaTest/ApiDemos/src D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

对，你没看错，"-I"与"D:/JavaTest/***"之间是没有空格的。XX，看来Google里也有相当混蛋的程序员。
执行此条命令后，生成的.java会与.aidl文件在同一目录下。

如果想指定aidl的生成路径，则可以按照aidl的提示信息使用"-o"选项：

[java] view plain copy print ?

1. aidl-ID:/JavaTest/ApiDemos/src-oD:/JavaTestD:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

aidl -ID:/JavaTest/ApiDemos/src -oD:/JavaTest D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

对，你还是没看错，"-o"与"D:/JavaTest/**"中间还是没有空格，再次咒骂设计了aidl工具的那个混蛋。
执行此命令后，则生成的aidl文件存于"D:/JavaTest/"路径下了。

在ApiDemos中，IRemoteService.aidl与IRemoteServiceCallback.aidl是互相依赖的，在编译IRemoteService.aidl时，通过使用"-d"可以将其依赖的相关类输出到自定义的文件中.

[java] view plain copy print ?

1. aidl-ID:/JavaTest/ApiDemos/src-oD:/JavaTest-dD:/JavaTest/aidl_dependency.txtD:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

aidl -ID:/JavaTest/ApiDemos/src -oD:/JavaTest -dD:/JavaTest/aidl_dependency.txt D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

生成的aidl_dependenry.txt内容如下：

[java] view plain copy print ?

1. :/
2. D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl/
3. D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteServiceCallback.aidl

: / D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl / D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteServiceCallback.aidl

可选项中"-b"的用法不详，帮助信息中的那句“fail when trying to compile a parcelable.”就感觉少说了些内容，"fail"然后干嘛，XX，第三次咒骂设计了aidl工具的那个混蛋。
帮助信息中还有“aidl --preprocess OUTPUT INPUT...”，作用是根据要编译的.aidl生成预处理文件，但具体预处理有啥用，有知道的告诉我下啊。

仍以ApiDemos为例，生成预处理文件为aidl.preprocess：

[java] view plain copy print ?

1. aidl--preprocessD:/JavaTest/aidl.preprocessD:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidlD:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteServiceCallback.aidlD:/JavaTest/ApiDemos/src/com/example/android/apis/app/ISecondary.aidl

aidl --preprocess D:/JavaTest/aidl.preprocess D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteServiceCallback.aidl D:/JavaTest/ApiDemos/src/com/example/android/apis/app/ISecondary.aidl

生成的aidl.preprocess内容如下：

[java] view plain copy print ?

1. interfacecom.example.android.apis.app.IRemoteService;
2. interfacecom.example.android.apis.app.IRemoteServiceCallback;
3. interfacecom.example.android.apis.app.ISecondary;

interface com.example.android.apis.app.IRemoteService; interface com.example.android.apis.app.IRemoteServiceCallback; interface com.example.android.apis.app.ISecondary;

SDK自带了预处理文件为<sdk_path>/platforms/android-<level>/framework.aidl。

“-p”表示编译aidl时以预处理文件为参去生成.java，命令方法如下：

[java] view plain copy print ?

1. aidl-ID:/JavaTest/ApiDemos/src-pE:/SoftSetup/AndroidSDK/android_sdk_r08_windows/platforms/android-3/framework.aidlD:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

aidl -ID:/JavaTest/ApiDemos/src -pE:/SoftSetup/AndroidSDK/android_sdk_r08_windows/platforms/android-3/framework.aidl D:/JavaTest/ApiDemos/src/com/example/android/apis/app/IRemoteService.aidl

而通过查看adt的源码可以发现，adt编译aidl使用的正是系统自带的预处理文件framewrok.aidl。
adt源码处理aidl的文件为：<OpenSourceProjectPath>/sdk/eclipse/plugins /com.android.ide.eclipse.adt/src/com/android/ide/eclipse/adt/internal /build/PreCompilerBuilder.java，其中的handleAidl()即为编译aidl的执行方法。

本文内容归优快云博客博主Sodino 所有

转载请注明出处: http://blog.youkuaiyun.com/sodino/archive/2011/05/14/6419498.aspx