实习第十五天： Build.xml文件详解

Build.xml文件详解

<?xml version="1.0" encoding="UTF-8"?>

<!--

参考文章：
http://www.cnblogs.com/zuolongsnail/archive/2011/05/25/2058210.html http://haya.iteye.com/?show_full=true http://jojol-zhou.iteye.com/blog/729271 http://jojol-zhou.iteye.com/blog/729254 http://www.cnblogs.com/Pickuper/archive/2011/6/14.html http://www.51testing.com/?uid-213912-action-viewspace-itemid-235086 http://jimmy-duan.iteye.com/blog/1057967
命名原则：

(1)使用"."替代local.properties文件中的"-"作为文件分隔符

(2)前缀：

使用"jar"表示包

使用"tools"表示工具

使用"in"表示输入

使用"out"表示输出

使用"release"表示产品

(3)后缀：使用"dir"表示目录,"file"表示文件

(3)使用"absolute"表示绝对路径,未使用"absolute"的表示相对路径,所有路径实际使用前转换为绝对路径再使用

文件及变量使用：

(1)使用到了系统自带的proguard.cfg文件，用于配置混淆设置

(2)使用到了系统自带的local.properties文件，用于定义用户设置的本地变量，典型的文件中包含：

#SDK路径

sdk-dir=D:\\Android\\android-sdk-windows

#混淆路径

proguard=D:\\Android\\proguard\\lib\\proguard.jar

#jarsiger路径

jarsigner=D:\\Java\\jdk1.6.0_25\\bin\\jarsigner.exe

#签名文件

keystore=D:\\Android\\xxxx.keystore

keyalias=xxxxx

password=xxxxxx

#moto SecondaryTelephonyManager jar包

secondarysecondary-apis-moto-xt882-zip=secondary-apis-moto_xt882.zip

secondarysecondary-apis-moto-xt800plus-zip=secondary-apis-moto_xt800plus.zip

#QAS SDK包

appstat-jar=appstat_A1.0.0.7_20110726.jar

#资源路径

res-dir=res480x320

#Manifest文件

manifestmanifest-file=manifest/AndroidManifest.xml

#UA

UA=SamsungI569

#assets路径

assetsassets-dir=assets${UA}

#输出路径

out-release-dir=E:\\tmp

#版本号

TYSX_VER=2.1.11.2

#android版本

android_ver=AD23

#文件名

#TYSX-机型型号（UA）-版本号-厂商缩写-操作系统缩写

release-apk-file=XXXX-${UA}-${TYSX_VER}-MH-${android_ver}.apk

-->

<!--

<project>标签

每个构建文件对应一个项目。<project>标签时构建文件的根标签。它可以有多个内在属性，

就如代码中所示，其各个属性的含义分别如下。

(1) default表示默认的运行目标，这个属性是必须的。

(2) basedir表示项目的基准目录。

(3) name表示项目名。

(4) description表示项目的描述。

每个构建文件都对应于一个项目，但是大型项目经常包含大量的子项目，每一个子项目都可以有

自己的构建文件。

-->

<project name="AntTest" default="release">

<!-- 指定配置文件 -->

<property file="default.properties" />

<property file="local.properties" />

<!-- 定义工具目录 -->

<property name="sdk.dir" value="${sdk-dir}" />

<property name="android.tools.dir" value="${sdk.dir}/tools" />

<property name="android.platformtools.dir" value="${sdk.dir}/platform-tools" />

<property name="android.platforms.dir" value="${sdk.dir}/platforms/${target}" />

<property name="android.tools.absolute.dir" location="${android.tools.dir}" />

<property name="android.platformtools.absolute.dir" location="${android.platformtools.dir}" />

<property name="android.platforms.absolute.dir" location="${android.platforms.dir}" />

<!-- 定义工具

<property name="verbose" value="false" />-->

<condition property="exe" value=".exe" else="">

<os family="windows" />

</condition>

<property name="jar.proguard" value="${proguard-jar}" />

<property name="jar.android" value="${android.platforms.absolute.dir}/android.jar" />

<property name="tools.dx" value="${android.platformtools.absolute.dir}/dx.bat" />

<property name="tools.apkbuilder" value="${android.tools.absolute.dir}/apkbuilder.bat" />

<property name="tools.adb" value="${android.tools.absolute.dir}/adb${exe}" />

<property name="tools.zipalign" value="${android.tools.absolute.dir}/zipalign${exe}" />

<property name="tools.aapt" value="${android.platformtools.absolute.dir}/aapt${exe}" />

<property name="tools.aidl" value="${android.platformtools.absolute.dir}/aidl${exe}" />

<property name="tools.jarsigner" value="${JAVA_HOME}/bin/jarsigner${exe}" />

<!-- 定义引入工具库

<path id="android.antlibs">

<pathelement path="${sdk.dir}/tools/lib/anttasks.jar" />

<pathelement path="${sdk.dir}/tools/lib/sdklib.jar" />

<pathelement path="${sdk.dir}/tools/lib/androidprefs.jar" />

<pathelement path="${sdk.dir}/tools/lib/apkbuilder.jar" />

<pathelement path="${sdk.dir}/tools/lib/jarutils.jar" />

</path>

定义任务

<taskdef name="aaptexec" classname="com.android.ant.AaptExecLoopTask" classpathref="android.antlibs" />

<taskdef name="apkbuilder" classname="com.android.ant.ApkBuilderTask" classpathref="android.antlibs" />

<taskdef name="xpath" classname="com.android.ant.XPathTask" classpathref="android.antlibs" />

-->

<!-- 定义源代码及资源等输入目录 -->

<property name="in.source.dir" value="src" />

<property name="in.resource.dir" value="${res-dir}" />

<property name="in.asset.dir" value="${assets-dir}" />

<property name="in.source.absolute.dir" location="${in.source.dir}" />

<property name="in.resource.absolute.dir" location="${in.resource.dir}" />

<property name="in.asset.absolute.dir" location="${in.asset.dir}" />

<!-- 定义本地库/第三方工具库文件目录 -->

<property name="in.external.libs.dir" value="libs" />

<property name="in.native.libs.dir" value="libs" />

<property name="in.external.libs.absolute.dir" location="${in.external.libs.dir}" />

<property name="in.native.libs.absolute.dir" location="${in.native.libs.dir}" />

<!-- 定义输入文件 -->

<property name="in.manifest.file" value="${manifest-file}" />

<property name="in.android.aidl.file" value="${android.platforms.dir}/framework.aidl" />

<property name="in.manifest.absolute.file" location="${in.manifest.file}" />

<property name="in.android.aidl.absolute.file" location="${in.android.aidl.file}" />

<!-- 定义输出文件目录 -->

<property name="out.gen.dir" value="gen" />

<property name="out.dir" value="bin" />

<property name="out.classes.dir" value="${out.dir}/classes" />

<property name="out.gen.absolute.dir" location="${out.gen.dir}" />

<property name="out.absolute.dir" location="${out.dir}" />

<property name="out.classes.absolute.dir" location="${out.classes.dir}" />

<property name="release.absolute.dir" location="${release-dir}" />

<!-- 定义输出文件 -->

<property name="out.dex.file" value="${ant.project.name}-classes.dex" />

<property name="out.resource.package.file" value="${ant.project.name}-resource.apk" />

<property name="out.unsigned.package.file" value="${ant.project.name}-unsigned.apk" />

<property name="out.signed.package.file" value="${ant.project.name}-signed.apk" />

<property name="out.aligned.package.file" value="${ant.project.name}-aligned.apk" />

<property name="release.package.file" value="${release-apk-file}" />

<property name="out.dex.absolute.file" location="${out.dir}/${out.dex.file}" />

<property name="out.resource.package.absolute.file" location="${out.dir}/${out.resource.package.file}" />

<property name="out.unsigned.package.absolute.file" location="${out.dir}/${out.unsigned.package.file}" />

<property name="out.signed.package.absolute.file" location="${out.dir}/${out.signed.package.file}" />

<property name="out.aligned.package.absolute.file" location="${out.dir}/${out.aligned.package.file}" />

<property name="release.package.absolute.file" location="${release.absolute.dir}/${release.package.file}" />

<!--

<target>标签

一个项目标签下可以有一个或多个target标签。一个target标签可以依赖其他的target标签。例

如，有一个target用于编译程序，另一个target用于声称可执行文件。在生成可执行文件之前必

须先编译该文件，因策可执行文件的target依赖于编译程序的target。Target的所有属性如下。

(1)name表示标明，这个属性是必须的。

(2)depends表示依赖的目标。

(3)if表示仅当属性设置时才执行。

(4)unless表示当属性没有设置时才执行。

(5)description表示项目的描述。

Ant的depends属性指定了target的执行顺序。Ant会依照depends属性中target出现顺序依次执行

每个target。在执行之前，首先需要执行它所依赖的target。程序中的名为run的target的

depends属性compile，而名为compile的target的depends属性是prepare，所以这几个target执

行的顺序是prepare->compile->run。

一个target只能被执行一次，即使有多个target依赖于它。如果没有if或unless属性，target总

会被执行。

-->

<target name="-clean">

<echo>Creating output directories if needed...</echo>

<delete dir="${out.absolute.dir}" />

<delete dir="${out.gen.absolute.dir}" />

</target>

<target name="-dirs" depends="-clean">

<echo>Creating output directories if needed...</echo>

<mkdir dir="${in.resource.absolute.dir}" />

<mkdir dir="${in.external.libs.absolute.dir}" />

<mkdir dir="${out.gen.absolute.dir}" />

<mkdir dir="${out.absolute.dir}" />

<mkdir dir="${out.classes.absolute.dir}" />

</target>

<!--

第一步 生成R.java类文件：

Eclipse中会自动生成R.java，ant和命令行使用android SDK提供的aapt.ext程序生成R.java。

-->

<target name="-resource-src" depends="-dirs">

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

<exec executable="${tools.aapt}" failonerror="true">

<arg value="package" />

<arg value="-m" />

<arg value="-J" />

<arg path="${out.gen.absolute.dir}" />

<arg value="-M" />

<arg path="${in.manifest.absolute.file}" />

<arg value="-S" />

<arg path="${in.resource.absolute.dir}" />

<arg value="-I" />

<arg path="${jar.android}" />

</exec>

</target>

<!--

第二步 将.aidl文件生成.java类文件：

Eclipse中自动生成，ant和命令行使用android SDK提供的aidl.exe生成.java文件。

-->

<!-- Generates java classes from .aidl files. -->

<target name="-aidl" depends="-dirs">

<echo>Compiling aidl files into Java classes...</echo>

<apply executable="${tools.aidl}" failonerror="true">

<arg value="-p${in.android.aidl.file}" />

<arg value="-I${in.source.absolute.dir}" />

<arg value="-o${out.gen.absolute.dir}" />

<fileset dir="${in.source.absolute.dir}">

<include name="**/*.aidl" />

</fileset>

</apply>

</target>

<!--

第三步 编译.java类文件生成class文件：

Eclipse中自动生成，ant和命令行使用jdk的javac编译java类文件生成class文件。

-->

<!-- Compiles this project's .java files into .class files. -->

<target name="compile" depends="-resource-src, -aidl" >

<echo>Compiles project's .java files into .class files</echo>

<javac encoding="utf-8" target="1.5" debug="true" extdirs="" srcdir="."

destdir="${out.classes.absolute.dir}" bootclasspath="${jar.android}">

<classpath>

<fileset dir="${in.external.libs.absolute.dir}" includes="*.jar" />

<fileset dir="${in.external.libs.absolute.dir}" includes="*.zip" />

</classpath>

</javac>

</target>

<!--Execute proguard class flies-->

<target name="optimize" depends="compile">

<echo>optimize classes are put to "${out.absolute.dir}" .</echo>

<jar basedir="${out.classes.absolute.dir}" destfile="${out.absolute.dir}/temp.jar"/>

<taskdef resource="proguard/ant/task.properties" classpath="${jar.proguard}" />

<proguard>

-injars ${out.absolute.dir}/temp.jar

-outjars ${out.absolute.dir}/optimized.jar

-libraryjars ${jar.android}

-optimizationpasses 5

-dontusemixedcaseclassnames

-dontskipnonpubliclibraryclasses

-dontpreverify

-verbose

-optimizations !code/simplification/arithmetic,!field/*,!class/merging/*

-include proguard.cfg

</proguard>

<delete file="${out.absolute.dir}/temp.jar"/>

<delete dir="${out.classes.dir}" failonerror="false" />

<mkdir dir="${out.classes.dir}"/>

<unzip src="${out.absolute.dir}/optimized.jar" dest="${out.classes.absolute.dir}"/>

<delete file="${out.absolute.dir}/optimized.jar"/>

</target>

<!--

第四步 将class文件打包生成classes.dex文件：

Eclipse中自动生成,ant和命令行使用android SDK提供的dx.bat命令行脚本生成classes.dex文件。

-->

<target name="dex" depends="optimize">

<echo>Converting compiled files and external libraries into ${out.absolute.dir}/${out.dex.file} ...</echo>

<apply executable="${tools.dx}" failonerror="true" parallel="true">

<arg value="--dex" />

<arg value="--output=${out.dex.absolute.file}" />

<arg path="${out.classes.absolute.dir}" />

<fileset dir="${in.external.libs.absolute.dir}" includes="*.jar"/>

</apply>

<delete dir="${out.classes.absolute.dir}"/>

</target>

<!--

第五步 打包资源文件（包括res、assets、androidmanifest.xml等）：

Eclipse中自动生成,ant和命令行使用Android SDK提供的aapt.exe生成资源包文件。

-->

<target name="package-resource">

<echo>Packaging resources and assets ${out.resource.package.absolute.file} ...</echo>

<exec executable="${tools.aapt}" failonerror="true">

<arg value="package" />

<arg value="-f" />

<arg value="-M" />

<arg value="${in.manifest.file}" />

<arg value="-S" />

<arg value="${in.resource.absolute.dir}" />

<arg value="-A" />

<arg value="${in.asset.absolute.dir}" />

<arg value="-I" />

<arg value="${jar.android}" />

<arg value="-F" />

<arg value="${out.resource.package.absolute.file}" />

</exec>

</target>

<!--

第六步 生成未签名的apk安装文件：

Eclipse中自动生成debug签名文件存放在bin目录中，ant和命令行使用android SDK提供的apkbuilder.bat命令脚本生成未签名的apk安装文件。

-->

<!-- Package the application without signing it. This allows for the application to be signed later with an official publishing key. -->

<target name="package" depends="dex, package-resource">

<echo>Packaging ${out.unsigned.package.absolute.file} for release...</echo>

<exec executable="${tools.apkbuilder}" failonerror="true">

<arg value="${out.unsigned.package.absolute.file}" />

<arg value="-u" />

<arg value="-z" />

<arg value="${out.resource.package.absolute.file}" />

<arg value="-f" />

<arg value="${out.dex.absolute.file}" />

<arg value="-rf" />

<arg value="${in.source.absolute.dir}" />

<arg value="-rj" />

<arg value="${in.external.libs.absolute.dir}" />

</exec>

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

<delete file="${out.resource.package.absolute.file}" />

<delete file="${out.dex.absolute.file}" />

</target>

<!--

第七步 对未签名的apk进行签名生成签名后的android文件：

-->

<!-- Package the application without signing it. This allows for the application to be signed later with an official publishing key. -->

<target name="jarsigner" depends="package">

<echo>Packaging ${out.unsigned.package.absolute.file} for release...</echo>

<exec executable="${tools.jarsigner}" failonerror="true">

<arg value="-keystore" />

<arg value="${keystore}" />

<arg value="-storepass" />

<arg value="${password}" />

<arg value="-keypass" />

<arg value="${password}" />

<arg value="-signedjar" />

<arg value="${out.signed.package.absolute.file}" />

<arg value="${out.unsigned.package.absolute.file}" />

<arg value="${keyalias}" />

</exec>

<delete file="${out.unsigned.package.absolute.file}" />

</target>

<!--

第七步 签名的文件进行字节对齐；

-->

<target name="zipalign" depends="jarsigner">

<echo>Zipalign ${out.aligned.package.absolute.file} for release...</echo>

<exec executable="${tools.zipalign}">

<arg value="-f" />

<arg value="-v" />

<arg value="4" />

<arg value="${out.signed.package.absolute.file}" />

<arg value="${out.aligned.package.absolute.file}" />

</exec>

<delete file="${out.signed.package.absolute.file}" />

</target>

<!--

第八步 签名的文件进行字节对齐；

-->

<target name="release" depends="zipalign">

<copy tofile="${release.package.absolute.file}">

<fileset dir="${out.absolute.dir}" includes="${out.aligned.package.file}"/>

</copy>

<delete file="${out.aligned.package.absolute.file}" />

</target>

</project>