ANT自动化构建

Android应用的自动化构建，目前有Ant和Gradle两种方式，本文主要记录自己学习ANT自动化构建Android应用的入门实践。借鉴http://www.oschina.net/question/54100_30501。

一、Android应用打包流程

步骤	说明	工具
1	生成R.java文件	aapt
2	生成AIDL对应的java源文件	aidl
3	编译java源文件生成class文件	javac
4	class文件转换为Android虚拟机能执行的dex文件	dx
5	打包资源为resources.ap_文件	aapt
6	生成未签名的apk文件	apkbuilder
7	签名apk文件	jarsigner
8	通过字节码对齐工具优化apk	zipalign

二、项目结构

测试Demo项目结构如下：

在原有项目结构的基础上，加入了一个build.xml文件，两个签名文件，以及两个bat文件，通过执行bat文件，可以自动化构建对应的debug包或release包。
debug_build.bat :

@echo off
call ant -buildfile "build.xml" debug
echo done
pause
exit

release_build.bat :

@echo off
call ant -buildfile "build.xml" release
echo done
pause
exit

三、build.xml文件

build.xml是整个构建中最重要的一环，其中包含了各模块的编译信息以及调用情况，这里需要注意的是，不同的开发平台路径有所不同，需要根据自己的路径调整（根据adt版本不同，apkbuilder需要自行下载）。具体内容如下：

1. 定义常量

<!-- ANT环境变量 -->
<property environment="env" />
<!-- 应用名称 -->
<property name="appName" value="${ant.project.name}"/>
<!-- SDK目录(获取操作系统环境变量ANDROID_SDK_HOME的值) -->
<property name="sdk-folder" value="${env.ANDROID_SDK_HOME}" />
<!-- SDK指定平台目录 -->
<property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-8"/>
<!-- SDK中tools目录 -->
<property name="sdk-tools" value="${sdk-folder}/tools" />
<!-- SDK指定平台中tools目录 -->
<property name="sdk-platform-tools" value="${sdk-folder}/build-tools/android-4.4W" />
<!-- 使用到的命令 -->
<property name="aapt" value="${sdk-platform-tools}/aapt" />
<property name="aidl" value="${sdk-platform-tools}/aidl" />
<property name="dx" value="${sdk-platform-tools}/dx.bat" />
<property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />
<property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />
<!-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar -->
<property name="android-jar" value="${sdk-platform-folder}/android.jar" />
<property name="android-maps-jar" value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/>
<!-- 编译aidl文件所需的预处理框架文件framework.aidl -->
<property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" />
<!-- 生成R文件的相对目录 -->
<property name="outdir-gen" value="gen" />
<!-- 编译后的文件放置目录 -->
<property name="outdir-bin" value="bin" />
<!-- 清单文件 -->
<property name="manifest-xml" value="AndroidManifest.xml" />
<!-- 源文件目录 -->
<property name="resource-dir" value="res" />
<property name="asset-dir" value="assets" />
<!-- java源文件目录 -->
<property name="srcdir" value="src" />
<property name="srcdir-ospath" value="${basedir}/${srcdir}" />
<!-- 外部类库所在目录 -->
<property name="external-lib" value="libs" />
<property name="external-lib-ospath" value="${basedir}/${external-lib}" />
<!-- 生成class目录 -->
<property name="outdir-classes" value="${outdir-bin}" />
<property name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" />
<!-- classes.dex相关变量 -->
<property name="dex-file" value="classes.dex" />
<property name="dex-path" value="${outdir-bin}/${dex-file}" />
<property name="dex-ospath" value="${basedir}/${dex-path}" />
<!-- 经过aapt生成的资源包文件 -->
<property name="resources-package" value="${outdir-bin}/resources.ap_" />
<property name="resources-package-ospath" value="${basedir}/${resources-package}" />
<!-- 未认证apk包 -->
<property name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" />
<property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />
<!-- 正式签名文件 -->
<property name="keystore-file-release" value="${basedir}/release_keystore" />
<!-- 测试签名文件 -->
<property name="keystore-file-debug" value="${basedir}/debug_keystore" />
<!-- 正式签名apk包 -->
<property name="out-signed-package-release" value="${appName}-release.apk" />
<property name="out-signed-package-ospath-release" value="${basedir}/${out-signed-package-release}" />
<!-- 测试签名apk包 -->
<property name="out-signed-package-debug" value="${appName}-debug.apk" />
<property name="out-signed-package-ospath-debug" value="${basedir}/${out-signed-package-debug}" /> 

2. 清理资源，初始化文件路径

<!-- 初始化 -->
<target name="init">
    <echo>Initializing all output directories...</echo>
    <delete dir="${outdir-bin}" />
    <mkdir dir="${outdir-bin}" />
    <mkdir dir="${outdir-classes}" />
</target>

3. 通过aapt工具生成R.java文件

<!-- 生成R文件 -->
<target name="gen-R" depends="init">
    <echo>Generating R.java from the resources...</echo>
    <exec executable="${aapt}" failonerror="true">
        <arg value="package" />
        <arg value="-f" />
        <arg value="-m" />
        <arg value="-J" />
        <arg value="${outdir-gen}" />
        <arg value="-S" />
        <arg value="${resource-dir}" />
        <arg value="-M" />
        <arg value="${manifest-xml}" />
        <arg value="-I" />
        <arg value="${android-jar}" />
    </exec>
</target>

4. 通过aidl生成相关的java源文件

<!-- 生成AIDL java源文件 -->
<target name="aidl" depends="gen-R">
    <echo>Compiling .aidl into java files...</echo>
    <apply executable="${aidl}" failonerror="true">
        <!-- 指定预处理文件 -->
        <arg value="-p${framework-aidl}"/>
        <!-- aidl声明的目录 -->
        <arg value="-I${srcdir}"/>
        <!-- 目标文件目录 -->
        <arg value="-o${outdir-gen}"/>
        <!-- 指定哪些文件需要编译 -->
        <fileset dir="${srcdir}">
            <include name="**/*.aidl"/>
        </fileset>
    </apply>
</target>

5. 编译java源文件

<!-- 编译java源文件 -->
<target name="compile" depends="aidl">
    <echo>Compiling java source code...</echo>
    <javac encoding="utf-8" target="1.5" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}">
        <classpath>
            <fileset dir="${external-lib}" includes="*.jar"/>
            <filelist>
                <file name="${android-maps-jar}"/>
            </filelist>
        </classpath>
    </javac>
</target>

6. 生成dex文件

<!-- 生成dex文件 -->
<target name="dex" depends="compile">
    <echo>Converting compiled files and external libraries into a .dex file...</echo>
    <exec executable="${dx}" failonerror="true">
        <arg value="--dex" />
        <!-- 输出文件 -->
        <arg value="--output=${dex-ospath}" />
        <!-- 要生成.dex文件的源classes和libraries -->
        <arg value="${outdir-classes-ospath}" />
        <arg value="${external-lib-ospath}"/>
    </exec>
</target>

7. 资源文件打包

<!-- 资源文件打包 -->
<target name="package-res-and-assets">
    <echo>Packaging resources and assets...</echo>
    <exec executable="${aapt}" failonerror="true">
        <arg value="package" />
        <arg value="-f" />
        <arg value="-M" />
        <arg value="${manifest-xml}" />
        <arg value="-S" />
        <arg value="${resource-dir}" />
        <arg value="-A" />
        <arg value="${asset-dir}" />
        <arg value="-I" />
        <arg value="${android-jar}" />
        <arg value="-F" />
        <arg value="${resources-package}" />
    </exec>
</target>

8. 生成未签名的APK

<!-- 生成未签名APK -->
<target name="package" depends="dex, package-res-and-assets">
    <echo>Packaging unsigned apk for release...</echo>
    <exec executable="${apkbuilder}" failonerror="true">
        <arg value="${out-unsigned-package-ospath}" />
        <arg value="-u" />
        <arg value="-z" />
        <arg value="${resources-package-ospath}" />
        <arg value="-f" />
        <arg value="${dex-ospath}" />
        <arg value="-rf" />
        <arg value="${srcdir-ospath}" />
    </exec>
    <echo>It will need to be signed with jarsigner before being published.</echo>
</target>

9. 生成测试签名APK

<!-- 生成测试签名APK -->
<target name="jarsigner_debug" depends="package">
    <echo>Packaging signed apk for debug...</echo>
    <exec executable="${jarsigner}" failonerror="true">
        <arg value="-keystore" />
        <arg value="${keystore-file-debug}" />
        <arg value="-storepass" />
        <arg value="签名密码" />
        <arg value="-keypass" />
        <arg value="签名密码" />
        <arg value="-signedjar" />
        <arg value="${out-signed-package-ospath-debug}" />
        <arg value="${out-unsigned-package-ospath}"/>
        <arg value="证书别名"/>
    </exec>
</target>

10. 生成正式签名APK

<!-- 生成正式签名APK -->
<target name="jarsigner_release" depends="package">
    <echo>Packaging signed apk for release...</echo>
    <exec executable="${jarsigner}" failonerror="true">
        <arg value="-keystore" />
        <arg value="${keystore-file-release}" />
        <arg value="-storepass" />
        <arg value="签名密码" />
        <arg value="-keypass" />
        <arg value="签名密码" />
        <arg value="-signedjar" />
        <arg value="${out-signed-package-ospath-release}" />
        <arg value="${out-unsigned-package-ospath}"/>
        <!-- 不要忘了证书的别名 -->
        <arg value="证书别名"/>
    </exec>
</target>

11. 生成正式签名包

<!-- 生成正式签名包 -->
<target name="release" depends="jarsigner_release">
    <!-- 删除未签名 apk -->
    <delete file="${out-unsigned-package-ospath}"/>
    <echo>build release apk success...</echo>
</target>

12. 生成测试签名包

<!-- 生成测试签名包 -->
<target name="debug" depends="jarsigner_debug">
    <!-- 删除未签名 apk -->
    <delete file="${out-unsigned-package-ospath}"/>
    <echo>build debug apk success...</echo>
</target>