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>