Android 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包
		secondary-apis-moto-xt882-zip=secondary-apis-moto_xt882.zip
		secondary-apis-moto-xt800plus-zip=secondary-apis-moto_xt800plus.zip
		#QAS SDK包
		appstat-jar=appstat_A1.0.0.7_20110726.jar
		#资源路径
		res-dir=res480x320
		#Manifest文件
		manifest-file=manifest/AndroidManifest.xml
		#UA
		UA=SamsungI569
		#assets路径
		assets-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>