使用 Ant 打包 Android 应用

通常我们习惯用eclipse来开发Android程序，它会自动帮我们打包当前的应用程序。如果在Navigator视图下，我们可以看到以下几个文件：

在上图中，com包放置的是我们的class文件，classes.dex是class文件经过转换后的可以在dalvik上跑的精简类文件，resources.ap_是经过打包的资源文件，ant.apk就是最终的打包文件。

使用ANT来对应用打包，一般会经过以下几个步骤：

1.用aapt命令生成R.java文件

2.用aidl命令生成相应java文件

3.用javac命令编译java源文件生成class文件

4.用dx.bat将class文件转换成classes.dex文件

5.用aapt命令生成资源包文件resources.ap_

6.用apkbuilder.bat打包资源和classes.dex文件,生成unsigned.apk

7.用jarsinger命令对apk认证,生成signed.apk

为了便于理解和记忆，下面来用一张流程图来说明以上的几个过程：

以上就是整体的流程，下面我们就对其每个部分进行做出详细讲解，把每一个步骤都弄清楚了。

我们需要先熟悉一下每一个步骤所使用到的命令：

1.aapt（Android Asset Packaging Tool）命令，根据资源文件生成R.java文件

参数说明：

-f  强制覆盖已存在的文件。
-m  在-J指定的位置下自动生成相应的包的目录。
-J  指定R.java文件生成的目录。
-S  指定资源目录。
-M  指定清单文件。
-I  引入类库。

注意，我们当前所在的位置是ant项目根目录，所以必要时需要输入很多关于命令的路径，以下示例也是一样。

2.aidl（Android Interface Definition Language）命令，根据.aidl定义文件生成java文件

上面的示例所在位置为com/scott/ant下，根据包中的Person.aidl文件，在gen对应的目录中生成Person.java文件，示例中只是处理单一文件，下文中会讲述如何处理目录中的多个aidl文件。

3.javac（Java Compiler）命令，根据源文件生成对应的class文件

参数说明：

-d <目录>      指定存放生成的类文件的位置
-bootclasspath <路径>     覆盖引导类文件的位置

示例中并没有考虑到引用类路径下面的类库，复杂的情况会在稍后遇到的。

4.dx命令，将class文件转换成.dex文件

以上示例是将bin目录下的class文件转换成classes.dex文件，输出到bin目录，我们也许会用到第三方类库，等一会就会看到。

5.aapt将资源文件打包

参数说明：

-f 强制覆盖

-M 指定Manifest文件

-S 指定资源目录

-A 指定资产目录

-I 指定引入的类库

-F 指定要生成的包

6.apkbuilder命令，根据classes.dex文件和resources.ap_生成为签证的apk包

参数说明：

-rf 参照源文件的目录的结构

7.jarsigner命令，对上面生成的apk包进行签证

在签证的过程中，需要使用到证书文件，需要注意的是最后的release是证书的别名，关于如何创建证书，请看下图：

当然也可以在eclipse里使用ADT提供的图形界面完成以上步骤，选中项目，点击右键，“Android Tools=>Export Signed Application Package”，然后再其中的Keystore selection环节选择“Create new keystore”，然后按照提示填写信息就可以了。

以上是我们使用到的命令，接下来我们就该来分析一下ANT所必须的build.xml：

首先我们需要定义大量的变量属性，用来表示使用到的路径、目录等，如下：

01<projectname="ant"default="release">

02    <!-- ANT环境变量 -->

03    <propertyenvironment="env"/>

04    <!-- 应用名称 -->

05    <propertyname="appName"value="${ant.project.name}"/>

06    <!-- SDK目录(获取操作系统环境变量ANDROID_SDK_HOME的值) -->

07    <propertyname="sdk-folder"value="${env.ANDROID_SDK_HOME}"/>

08    <!-- SDK指定平台目录 -->

09    <propertyname="sdk-platform-folder"value="${sdk-folder}/platforms/android-8"/>

10    <!-- SDK中tools目录 -->

11    <propertyname="sdk-tools"value="${sdk-folder}/tools"/>

12    <!-- SDK指定平台中tools目录 -->

13    <propertyname="sdk-platform-tools"value="${sdk-platform-folder}/tools"/>

14 

15    <!-- 使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令) -->

16    <propertyname="aapt"value="${sdk-platform-tools}/aapt"/>

17    <propertyname="aidl"value="${sdk-platform-tools}/aidl"/>

18    <propertyname="dx"value="${sdk-platform-tools}/dx.bat"/>

19    <propertyname="apkbuilder"value="${sdk-tools}/apkbuilder.bat"/>

20    <propertyname="jarsigner"value="${env.JAVA_HOME}/bin/jarsigner"/>

21     

22    <!-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar -->

23    <propertyname="android-jar"value="${sdk-platform-folder}/android.jar"/>

24    <propertyname="android-maps-jar"value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/>

25     

26    <!-- 编译aidl文件所需的预处理框架文件framework.aidl -->

27    <propertyname="framework-aidl"value="${sdk-platform-folder}/framework.aidl"/>

28 

29    <!-- 生成R文件的相对目录 -->

30    <propertyname="outdir-gen"value="gen"/>

31    <!-- 编译后的文件放置目录 -->

32    <propertyname="outdir-bin"value="bin"/>

33     

34    <!-- 清单文件 -->

35    <propertyname="manifest-xml"value="AndroidManifest.xml"/>

36    <!-- 源文件目录 -->

37    <propertyname="resource-dir"value="res"/>

38    <propertyname="asset-dir"value="assets"/>

39    <!-- java源文件目录 -->

40    <propertyname="srcdir"value="src"/>

41    <propertyname="srcdir-ospath"value="${basedir}/${srcdir}"/>

42    <!-- 外部类库所在目录 -->

43    <propertyname="external-lib"value="lib"/>

44    <propertyname="external-lib-ospath"value="${basedir}/${external-lib}"/>

45 

46    <!-- 生成class目录 -->

47    <propertyname="outdir-classes"value="${outdir-bin}"/>

48    <propertyname="outdir-classes-ospath"value="${basedir}/${outdir-classes}"/>

49 

50    <!-- classes.dex相关变量 -->

51    <propertyname="dex-file"value="classes.dex"/>

52    <propertyname="dex-path"value="${outdir-bin}/${dex-file}"/>

53    <propertyname="dex-ospath"value="${basedir}/${dex-path}"/>

54 

55    <!-- 经过aapt生成的资源包文件 -->

56    <propertyname="resources-package"value="${outdir-bin}/resources.ap_"/>

57    <propertyname="resources-package-ospath"value="${basedir}/${resources-package}"/>

58     

59    <!-- 未认证apk包 -->

60    <propertyname="out-unsigned-package"value="${outdir-bin}/${appName}-unsigned.apk"/>

61    <propertyname="out-unsigned-package-ospath"value="${basedir}/${out-unsigned-package}"/>

62     

63    <!-- 证书文件 -->

64    <propertyname="keystore-file"value="${basedir}/release.keystore"/>

65     

66    <!-- 已认证apk包 -->

67    <propertyname="out-signed-package"value="${outdir-bin}/${appName}.apk"/>

68    <propertyname="out-signed-package-ospath"value="${basedir}/${out-signed-package}"/>

69        ...

70</project>

然后，我们分步骤来进行，首先是初始化：

1<!-- 初始化工作 -->

2    <targetname="init">

3        <echo>Initializing all output directories...</echo>

4        <deletedir="${outdir-bin}"/>

5        <mkdirdir="${outdir-bin}"/>

6        <mkdirdir="${outdir-classes}"/>

7    </target>

其次是生成R.java文件：

01<!-- 根据工程中的资源文件生成R.java文件  -->

02    <targetname="gen-R"depends="init">

03        <echo>Generating R.java from the resources...</echo>

04        <execexecutable="${aapt}"failonerror="true">

05            <argvalue="package"/>

06            <argvalue="-f"/>

07            <argvalue="-m"/>

08            <argvalue="-J"/>

09            <argvalue="${outdir-gen}"/>

10            <argvalue="-S"/>

11            <argvalue="${resource-dir}"/>

12            <argvalue="-M"/>

13            <argvalue="${manifest-xml}"/>

14            <argvalue="-I"/>

15            <argvalue="${android-jar}"/>

16        </exec>

17    </target>

接着是aidl生成java源文件：

01<!-- 编译aidl文件 -->

02    <targetname="aidl"depends="gen-R">

03        <echo>Compiling .aidl into java files...</echo>

04        <applyexecutable="${aidl}"failonerror="true">

05            <!-- 指定预处理文件 -->

06            <argvalue="-p${framework-aidl}"/>

07            <!-- aidl声明的目录 -->

08            <argvalue="-I${srcdir}"/>

09            <!-- 目标文件目录 -->

10            <argvalue="-o${outdir-gen}"/>

11            <!-- 指定哪些文件需要编译 -->

12            <filesetdir="${srcdir}">

13                <includename="**/*.aidl"/>

14            </fileset>

15        </apply>

16    </target>

我们指定了一个framework.aidl，里面定义了很多android内置对象，然后我们指定了aidl所在目录和输出目录，组后指定编译后缀为aidl的文件。

接下来是将源文件编译成class文件：

01<!-- 将工程中的java源文件编译成class文件 -->

02    <targetname="compile"depends="aidl">

03        <echo>Compiling java source code...</echo>

04        <javacencoding="utf-8"target="1.5"srcdir="."destdir="${outdir-classes}"bootclasspath="${android-jar}">

05            <classpath>

06                <filesetdir="${external-lib}"includes="*.jar"/>

07                <filelist>

08                    <filename="${android-maps-jar}"/>

09                </filelist>

10            </classpath>

11        </javac>

12    </target>

如果使用到了第三方类库，我们可以在classpath标签下配置。

接着是将class文件转换成classes.dex：

01<!-- 将.class文件转化成.dex文件 -->

02    <targetname="dex"depends="compile">

03        <echo>Converting compiled files and external libraries into a .dex file...</echo>

04        <execexecutable="${dx}"failonerror="true">

05            <argvalue="--dex"/>

06            <!-- 输出文件 -->

07            <argvalue="--output=${dex-ospath}"/>

08            <!-- 要生成.dex文件的源classes和libraries -->

09            <argvalue="${outdir-classes-ospath}"/>

10            <argvalue="${external-lib-ospath}"/>

11        </exec>

12    </target>

就像上面的代码一样，如果使用到第三方类库，可以在最后一参数的形式追加进去。

然后是将资源文件打包：

01<!-- 将资源文件放进输出目录 -->

02    <targetname="package-res-and-assets">

03        <echo>Packaging resources and assets...</echo>

04        <execexecutable="${aapt}"failonerror="true">

05            <argvalue="package"/>

06            <argvalue="-f"/>

07            <argvalue="-M"/>

08            <argvalue="${manifest-xml}"/>

09            <argvalue="-S"/>

10            <argvalue="${resource-dir}"/>

11            <argvalue="-A"/>

12            <argvalue="${asset-dir}"/>

13            <argvalue="-I"/>

14            <argvalue="${android-jar}"/>

15            <argvalue="-F"/>

16            <argvalue="${resources-package}"/>

17        </exec>

18    </target>

接着是打包成未签证的apk包：

01<!-- 打包成未签证的apk -->

02    <targetname="package"depends="dex, package-res-and-assets">

03        <echo>Packaging unsigned apk for release...</echo>

04        <execexecutable="${apkbuilder}"failonerror="true">

05            <argvalue="${out-unsigned-package-ospath}"/>

06            <argvalue="-u"/>

07            <argvalue="-z"/>

08            <argvalue="${resources-package-ospath}"/>

09            <argvalue="-f"/>

10            <argvalue="${dex-ospath}"/>

11            <argvalue="-rf"/>

12            <argvalue="${srcdir-ospath}"/>

13        </exec>

14        <echo>It will need to be signed with jarsigner before being published.</echo>

15    </target>

然后是对apk签证：

01<!-- 对apk进行签证 -->

02    <targetname="jarsigner"depends="package">

03        <echo>Packaging signed apk for release...</echo>

04        <execexecutable="${jarsigner}"failonerror="true">

05            <argvalue="-keystore"/>

06            <argvalue="${keystore-file}"/>

07            <argvalue="-storepass"/>

08            <argvalue="123456"/>

09            <argvalue="-keypass"/>

10            <argvalue="123456"/>

11            <argvalue="-signedjar"/>

12            <argvalue="${out-signed-package-ospath}"/>

13            <argvalue="${out-unsigned-package-ospath}"/>

14            <!-- 不要忘了证书的别名 -->

15            <argvalue="release"/>

16        </exec>

17    </target>

最后发布：

1<!-- 发布 -->

2    <targetname="release"depends="jarsigner">

3        <!-- 删除未签证apk -->

4        <deletefile="${out-unsigned-package-ospath}"/>

5        <echo>APK is released. path:${out-signed-package-ospath}</echo>

6    </target>

这样就完成了build.xml的编辑，eclipse继承了ANT，所以我们可以在eclipse中直接运行，也可以在代码中调用。

首先我们需要下载ANT，然后配置相应的环境变量信息，最后我们这样调用：

1Process p = Runtime.getRuntime().exec("ant.bat -buildfile d:/workspace/ant/build.xml");

2InputStream is = p.getInputStream();

3BufferedReader br = newBufferedReader(new InputStreamReader(is));

4String line = null;

5while ((line = br.readLine()) !=null) {

6    System.out.println(line);

7}

8System.out.println("SUCCESS.");

全文完！

原文出处：http://blog.csdn.net/liuhe688/article/details/6679879