通过ant脚本编译打包android工程

通过ant脚本，编译打包android工程

1.Android程序编译、打包、签名、发布的三种方式： 
方式一：命令行手动编译打包 
方式二：使用ant自动编译打包 
方式三：使用eclipse+ADT编译打包 

2.Android编译、打包的步骤： 
2.1第一步 生成R.java类文件： 
Eclipse中会自动生成R.java，ant和命令行使用android SDK提供的aapt.ext程序生成R.java。 

2.2第二步 将.aidl文件生成.java类文件： 
Eclipse中自动生成，ant和命令行使用android SDK提供的aidl.exe生成.java文件。 

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

2.4第四步 将class文件打包生成classes.dex文件： 
Eclipse中自动生成,ant和命令行使用android SDK提供的dx.bat命令行脚本生成classes.dex文件。 

2.5第五步 打包资源文件（包括res、assets、androidmanifest.xml等）： 
Eclipse中自动生成,ant和命令行使用Android SDK提供的aapt.exe生成资源包文件。 

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

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

Eclipse中使用Android Tools进行签名，ant和命令行使用jdk的jarsigner对未签名的包进行apk签名。 

这个ant脚本只能编译打包一个单独的android工程或依赖一个library 的android工程

首先配置ant的环境变量，这个我就不多少了，自己查。

ant脚本，生成build.xml

[plain]  view plain copy

1. <span style="font-size:18px">H:\install\eclipse-SDK-3.7.2-win32\eclipse\android_sdk\tools\android.bat update project -n BuiltDemo -t android-8 -p H:\workspace\prac_a3\BuiltDemo</span>  

在local.properties文件里要配置环境变量：

[plain]  view plain copy

1. <span style="font-size:18px">sdk.dir=H:/install/eclipse-SDK-3.7.2-win32/eclipse/android_sdk  
2. ANDROID_HOME=H:/install/eclipse-SDK-3.7.2-win32/eclipse/android_sdk  
3. ANT_HOME=F:/Soft/ant/apache-ant-1.9.2  
4. JAVA_HOME=C:/Program Files/Java/jdk1.6.0_10</span>  

执行编译，根据build.xml文件里的设置区执行debug或者release：

[plain]  view plain copy

1. <span style="font-size:18px">H:\install\eclipse-SDK-3.7.2-win32\eclipse\android_sdk\tools\android.bat  debug  
2. H:\install\eclipse-SDK-3.7.2-win32\eclipse\android_sdk\tools\android.bat release</span>  

以下是我使用的ant脚本（build.xml），解释什么的都有，只能编译打包一个单独的android工程或依赖一个library 的android工程:

[html]  view plain copy

1. <span style="font-size:18px"><?xml version="1.0" encoding="UTF-8"?>  
2. <project name="BuiltDemo" default="release">  
3.     <property file="local.properties" />  
4.   
5.     <!-- ANT环境变量 -->  
6.     <property environment="env" />  
7.     <!-- 应用名称 -->  
8.   
9.     <property name="appName" value="BuiltDemo" />  
10.     <property name="basedir" value="H:/workspace/prac_a3/BuiltDemo" />  
11.     <property name="library-dir" value="H:/workspace/prac_a3/BuiltDemo">  
12.     </property>  
13.     <!-- SDK目录(获取操作系统环境变量ANDROID_SDK_HOME的值) -->  
14.     <!-- <property name="sdk-folder" value="${env.ANDROID_SDK_HOME}" /> -->  
15.     <property name="sdk-folder" value="${env.ANDROID_HOME}" />  
16.     <!-- SDK指定平台目录 -->  
17.     <property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-8" />  
18.     <!-- SDK中tools目录 -->  
19.     <property name="sdk-tools" value="${sdk-folder}/tools" />  
20.     <!-- SDK指定平台中tools目录 -->  
21.     <property name="sdk-platform-tools" value="${sdk-folder}/platform-tools" />  
22.   
23.     <!-- 使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令) -->  
24.     <property name="aapt" value="${sdk-platform-tools}/aapt.exe" />  
25.     <property name="aidl" value="${sdk-platform-tools}/aidl.exe" />  
26.     <property name="dx" value="${sdk-platform-tools}/dx.bat" />  
27.     <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />  
28.     <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />  
29.   
30.     <!-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar -->  
31.     <property name="android-jar" value="${sdk-platform-folder}/android.jar" />  
32.   
33.     <!-- 编译aidl文件所需的预处理框架文件framework.aidl -->  
34.     <property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" />  
35.   
36.     <!-- 生成R文件的相对目录 -->  
37.     <property name="outdir-gen" value="gen" />  
38.     <!-- 编译后的文件放置目录 -->  
39.     <property name="outdir-bin" value="out" />  
40.   
41.     <!-- 清单文件 -->  
42.     <property name="manifest-xml" value="AndroidManifest.xml" />  
43.     <!-- 源文件目录 -->  
44.     <property name="resource-dir" value="res" />  
45.     <property name="asset-dir" value="assets" />  
46.     <!-- java源文件目录 -->  
47.     <property name="srcdir" value="src" />  
48.     <property name="srcdir-ospath" value="${basedir}/${srcdir}" />  
49.     <!-- 外部类库所在目录 -->  
50.     <property name="external-lib" value="libs" />  
51.     <property name="external-lib-ospath" value="${basedir}/${external-lib}" />  
52.   
53.     <!-- 生成class目录 -->  
54.     <property name="outdir-classes" value="${outdir-bin}" />  
55.     <property name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" />  
56.   
57.     <!-- classes.dex相关变量 -->  
58.     <property name="dex-file" value="classes.dex" />  
59.     <property name="dex-path" value="${outdir-bin}/${dex-file}" />  
60.     <property name="dex-ospath" value="${basedir}/${dex-path}" />  
61.   
62.     <!-- 经过aapt生成的资源包文件 -->  
63.     <property name="resources-package" value="${outdir-bin}/resources.ap_" />  
64.     <property name="resources-package-ospath" value="${basedir}/${resources-package}" />  
65.   
66.     <!-- 未认证apk包 -->  
67.     <property name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" />  
68.     <property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />  
69.   
70.     <!-- 证书文件 -->  
71.     <property name="keystore-file" value="${basedir}/sbx" />  
72.   
73.     <!-- 已认证apk包 -->  
74.     <property name="out-signed-package" value="${outdir-bin}/${appName}.apk" />  
75.     <property name="out-signed-package-ospath" value="${basedir}/${out-signed-package}" />  
76.   
77.   
78.     <!-- 初始化工作 -->  
79.     <target name="init">  
80.         <echo>Initializing all output directories...</echo>  
81.         <delete dir="${outdir-bin}" />  
82.         <mkdir dir="${outdir-bin}" />  
83.         <mkdir dir="${outdir-classes}" />  
84.     </target>  
85.   
86.     <!-- 根据工程中的资源文件生成R.java文件 -->  
87.     <target name="gen-R" depends="init">  
88.         <echo>Generating R.java from the resources...</echo>  
89.         <!--<exec executable="${aapt}" failonerror="true">  
90.             <arg value="package" />  
91.             <arg value="-f" />  
92.             <arg value="-m" />  
93.             <arg value="-J" />  
94.             <arg value="${outdir-gen}" />  
95.             <arg value="-S" />  
96.             <arg value="${resource-dir}" />  
97.             <arg value="-M" />  
98.             <arg value="${manifest-xml}" />  
99.             <arg value="-I" />  
100.             <arg value="${android-jar}" />  
101.         </exec>-->  
102.   
103.   
104.         <exec executable="${aapt}" failonerror="true">  
105.             <arg value="package" />  
106.             <arg value="-m" />  
107.             <arg value="--auto-add-overlay" />  
108.             <arg value="-J" />  
109.             <arg value="${outdir-gen}" />  
110.             <arg value="-M" />  
111.             <arg value="${manifest-xml}" />  
112.             <arg value="-S" />  
113.             <arg value="${resource-dir}" />  
114.             <arg value="-S" />  
115.             <arg value="${library-dir}/${resource-dir}" />  
116.             <arg value="--extra-packages" />  
117.             <arg value="com.mobcent.share.android" />  
118.             <arg value="-A" />  
119.             <arg value="${asset-dir}" />  
120.             <arg value="-I" />  
121.             <arg value="${android-jar}" />  
122.         </exec>  
123.     </target>  
124.   
125.   
126.     <!-- 编译aidl文件 -->  
127.     <target name="aidl" depends="gen-R">  
128.         <echo>Compiling .aidl into java files...</echo>  
129.         <apply executable="${aidl}" failonerror="true">  
130.             <!-- 指定预处理文件 -->  
131.             <arg value="-p${framework-aidl}" />  
132.             <!-- aidl声明的目录 -->  
133.             <arg value="-I${srcdir}" />  
134.             <!-- 目标文件目录 -->  
135.             <arg value="-o${outdir-gen}" />  
136.             <!-- 指定哪些文件需要编译 -->  
137.             <fileset dir="${srcdir}">  
138.                 <include name="**/*.aidl" />  
139.             </fileset>  
140.         </apply>  
141.     </target>  
142.   
143.     <!-- 将工程中的java源文件编译成class文件 -->  
144.     <target name="compile" depends="aidl">  
145.         <echo>Compiling java source code...</echo>  
146.         <javac encoding="utf-8" target="1.6" destdir="${outdir-classes}" bootclasspath="${android-jar}">  
147.             <src path="src" />  
148.             <src path="gen" />  
149.             <src path="${library-dir}/src" />  
150.             <classpath>  
151.                 <fileset dir="${external-lib}" includes="*.jar" />  
152.                 <fileset dir="${library-dir}/libs" includes="*.jar" />  
153.                 <filelist>  
154.                     <file name="${android-maps-jar}" />  
155.                 </filelist>  
156.             </classpath>  
157.         </javac>  
158.     </target>  
159.   
160.     <!-- 将.class文件转化成.dex文件 -->  
161.     <target name="dex" depends="compile">  
162.         <echo>Converting compiled files and external libraries into a .dex  
163.             file...  
164.         </echo>  
165.         <exec executable="${dx}" failonerror="true">  
166.             <arg value="--dex" />  
167.             <!-- 输出文件 -->  
168.             <arg value="--output=${dex-ospath}" />  
169.             <!-- 要生成.dex文件的源classes和libraries -->  
170.             <arg value="${outdir-classes-ospath}" />  
171.             <arg value="${external-lib-ospath}" />  
172. <!--             <arg value="${library-dir}/libs" /> -->  
173.         </exec>  
174.     </target>  
175.   
176.   
177.     <!-- 将资源文件放进输出目录 -->  
178.     <!--在这截断-->  
179.     <target name="package-res-and-assets" depends="dex">  
180.         <echo>Packaging resources and assets...</echo>  
181.         <exec executable="${aapt}" failonerror="true">  
182.             <arg value="package" />  
183.             <arg value="-f" />  
184.             <arg value="-M" />  
185.             <arg value="${manifest-xml}" />  
186.             <arg value="-S" />  
187.             <arg value="${resource-dir}" />  
188.   
189.             <arg value="-A" />  
190.             <arg value="${asset-dir}" />  
191.   
192.             <arg value="-S" />  
193.             <arg value="${library-dir}/${resource-dir}" />  
194.   
195.             <arg value="-A" />  
196.             <arg value="${library-dir}/${asset-dir}" />  
197.   
198.             <arg value="-I" />  
199.             <arg value="${android-jar}" />  
200.             <arg value="-F" />  
201.             <arg value="${resources-package}" />  
202.   
203.             <arg value="--auto-add-overlay" />  
204.         </exec>  
205.     </target>  
206.   
207.   
208.     <!-- 打包成未签证的apk -->  
209.     <target name="package" depends="dex, package-res-and-assets">  
210.         <echo>Packaging unsigned apk for release...</echo>  
211.         <exec executable="${apkbuilder}" failonerror="true">  
212.             <arg value="${out-unsigned-package-ospath}" />  
213.             <arg value="-u" />  
214.               
215.             <arg value="-z" />  
216.             <arg value="${resources-package-ospath}" />  
217.             <arg value="-f" />  
218.             <arg value="${dex-ospath}" />  
219.             <arg value="-rf" />  
220.             <arg value="${srcdir-ospath}" />  
221.             <arg value="-nf"/>  
222.             <arg value="${library-dir}/libs"/>  
223.         </exec>  
224.         <echo>It will need to be signed with jarsigner before being published.  
225.         </echo>  
226.     </target>  
227.   
228.   
229.     <!-- 对apk进行签证 -->  
230.     <target name="jarsigner" depends="package">  
231.         <echo>Packaging signed apk for release...</echo>  
232.         <exec executable="${jarsigner}" failonerror="true">  
233.             <arg value="-keystore" />  
234.             <arg value="${keystore-file}" />  
235.             <arg value="-storepass" />  
236.             <arg value="111111" />  
237.             <arg value="-keypass" />  
238.             <arg value="111111" />  
239.             <arg value="-signedjar" />  
240.             <arg value="${out-signed-package-ospath}" />  
241.             <arg value="${out-unsigned-package-ospath}" />  
242.             <!-- 不要忘了证书的别名 -->  
243.             <arg value="sbx" />  
244.         </exec>  
245.     </target>  
246.   
247.     <!-- 发布 -->  
248.     <target name="release" depends="jarsigner">  
249.         <!-- 删除未签证apk -->  
250.         <delete file="${out-unsigned-package-ospath}" />  
251.         <echo>APK is released. path:${out-signed-package-ospath}</echo>  
252.     </target>  
253.   
254. </project>  
255. </span>  

Android官方提供的打包脚本： 1400多行，我加了中文注释，希望能看懂。

详见build.xml

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <project name="pet_dog_base_forum" default="release">  
3.     <!--自己需要添加的属性 -->  
4.     <property name="sdk.dir" value="C:/Program Files/android-sdk_r15-windows/android-sdk-windows" />  
5.     <!--导入project.properties 文件，设置了编译的target 和相关的library工程-->  
6.     <property file="project.properties" />  
7.     <!--导入build.properties文件，设置了android的目录和key-->  
8.     <property file="ant.properties" />  
9.     <!--  
10.         This build file is imported by the project build file. It contains  
11.         all the targets and tasks necessary to build Android projects, be they  
12.         regular projects, library projects, or test projects.  
13.   
14.         At the beginning of the file is a list of properties that can be overridden  
15.         by adding them to your build.properties (properties are immutable, so their  
16.         first definition sticks and is never changed).  
17.   
18.         Follows:   
19.         - custom task definitions,  
20.         - more properties (do not override those unless the whole build system is modified).  
21.         - macros used throughout the build,  
22.         - base build targets,  
23.         - debug-specific build targets,  
24.         - release-specific build targets,  
25.         - instrument-specific build targets,  
26.         - test project-specific build targets,  
27.         - install targets,  
28.         - help target  
29.           
30.                        步骤如下：  
31.         —— 自定义task  
32.         —— 设置相关属性  
33.         —— 全局的使用整个构建  
34.         —— 基本bulid的targets    
35.         —— debug使用的targets  
36.         —— release使用的targets         
37.         —— 特定仪器使用的targets  
38.         —— 测试使用的targets  
39.         —— 安装的targets  
40.         —— 帮助的targets                
41.     -->  
42.   
43.     <!-- ********** Overrideable Properties ********** -->  
44.     <!-- ********** 可重写的属性 ********** -->  
45.   
46.     <!-- You can override these values in your build.xml or build.properties.  
47.          Overriding any other properties may result in broken build. -->  
48.     <!-- 你可以覆盖build.xml 或者 build.properties 文件中的任何属性，覆盖任何一个属性，都可能导致build出错，慎用 -->  
49.   
50.     <!-- Tells adb which device to target. You can change this from the command line  
51.          by invoking "ant -Dadb.device.arg=-d" for device "ant -Dadb.device.arg=-e" for  
52.          the emulator. -->  
53.     <!-- 设置链接的机器，  
54.     ant -Dadb.device.arg=-d 使用链接当前的设备  
55.     ant -Dadb.device.arg=-e 使用模拟器  
56.     -->  
57.   
58.     <property name="adb.device.arg" value="" />  
59.   
60.   
61.     <!-- fileset exclude patterns (space separated) to prevent  
62.          files inside src/ from being packaged. -->  
63.     <!-- 设置改属性可以排除编译一部分代码 
64.     -->  
65.     <property name="android.package.excludes" value="" />  
66.   
67.     <!-- set some properties used for filtering/override. If those weren't defined  
68.          before, then this will create them with empty values, which are then ignored  
69.          by the custom tasks receiving them. -->  
70.     <!-- 
71.     version.code，version.name可以替換AndroidManifest.xml中的android:versionCode和android:versionName 
72.     -->  
73.     <property name="version.code" value="11" />  
74.     <property name="version.name" value="111" />  
75.     <property name="aapt.resource.filter" value="" />  
76.   
77.     <!-- compilation options -->  
78.     <property name="java.encoding" value="UTF-8" />  
79.     <property name="java.target" value="1.6" />  
80.     <property name="java.source" value="1.6" />  
81.   
82.     <!-- Verbosity -->  
83.     <property name="verbose" value="false" />  
84.   
85.     <!-- ********** Custom Tasks ********** -->  
86.     <!-- ********** 自定义Tasks ********** -->  
87.       
88.     <!-- 导入自定义Task是需要的文件 -->  
89.     <path id="android.antlibs">  
90.         <pathelement path="${sdk.dir}/tools/lib/anttasks.jar" />  
91.     </path>  
92.   
93.     <!-- Custom tasks -->  
94.     <taskdef name="setup" classname="com.android.ant.NewSetupTask" classpathref="android.antlibs" />  
95.   
96.     <taskdef name="aapt" classname="com.android.ant.AaptExecTask" classpathref="android.antlibs" />  
97.   
98.     <taskdef name="aidl" classname="com.android.ant.AidlExecTask" classpathref="android.antlibs" />  
99.   
100.     <taskdef name="renderscript" classname="com.android.ant.RenderScriptTask" classpathref="android.antlibs" />  
101.   
102.     <taskdef name="dex" classname="com.android.ant.DexExecTask" classpathref="android.antlibs" />  
103.   
104.     <taskdef name="apkbuilder" classname="com.android.ant.ApkBuilderTask" classpathref="android.antlibs" />  
105.   
106.     <taskdef name="zipalign" classname="com.android.ant.ZipAlignTask" classpathref="android.antlibs" />  
107.   
108.     <taskdef name="xpath" classname="com.android.ant.XPathTask" classpathref="android.antlibs" />  
109.   
110.     <taskdef name="if" classname="com.android.ant.IfElseTask" classpathref="android.antlibs" />  
111.   
112.     <!-- Emma configuration   
113.     EMMA 是一种快速的，基于字节码指令的Java 代码覆盖工具。  
114.     -->  
115.     <property name="emma.dir" value="${sdk.dir}/tools/lib" />  
116.     <path id="emma.lib">  
117.         <pathelement location="${emma.dir}/emma.jar" />  
118.         <pathelement location="${emma.dir}/emma_ant.jar" />  
119.     </path>  
120.     <taskdef resource="emma_ant.properties" classpathref="emma.lib" />  
121.     <!-- End of emma configuration -->  
122.   
123.   
124.     <!-- ********** Other Properties ********** -->  
125.     <!-- overriding these properties may break the build  
126.          unless the whole file is updated -->  
127.   
128.     <!-- 输入文件 -->  
129.     <property name="source.dir" value="src" />  
130.     <property name="source.absolute.dir" location="${source.dir}" />  
131.     <property name="gen.absolute.dir" location="gen" />  
132.     <property name="resource.absolute.dir" location="res" />  
133.     <property name="asset.absolute.dir" location="assets" />  
134.     <property name="jar.libs.dir" value="libs" />  
135.     <property name="jar.libs.absolute.dir" location="${jar.libs.dir}" />  
136.     <property name="native.libs.absolute.dir" location="libs" />  
137.   
138.     <!-- 输出文件 -->  
139.     <property name="out.dir" value="bin" />  
140.     <property name="out.absolute.dir" location="${out.dir}" />  
141.     <property name="out.classes.absolute.dir" location="${out.dir}/classes" />  
142.     <property name="out.res.absolute.dir" location="${out.dir}/res" />  
143.   
144.     <!-- tools location 编译所需要用到的工具 -->  
145.     <property name="android.tools.dir" location="${sdk.dir}/tools" />  
146.     <property name="android.platform.tools.dir" location="${sdk.dir}/platform-tools" />  
147.     <condition property="exe" value=".exe" else="">  
148.         <os family="windows" />  
149.     </condition>  
150.     <condition property="bat" value=".bat" else="">  
151.         <os family="windows" />  
152.     </condition>  
153.     <property name="adb" location="${android.platform.tools.dir}/adb${exe}" />  
154.     <property name="zipalign" location="${android.tools.dir}/zipalign${exe}" />  
155.     <property name="aidl" location="${android.platform.tools.dir}/aidl${exe}" />  
156.     <property name="aapt" location="${android.platform.tools.dir}/aapt${exe}" />  
157.     <property name="dx" location="${android.platform.tools.dir}/dx${bat}" />  
158.     <!-- renderscript location is set by NewSetupTask since we have a choice of  
159.          several executables based on minSdkVersion -->  
160.   
161.     <!-- Intermediate files 中间文件 -->  
162.     <property name="dex.file.name" value="classes.dex" />  
163.     <property name="intermediate.dex.file" location="${out.absolute.dir}/${dex.file.name}" />  
164.     <property name="resource.package.file.name" value="${ant.project.name}.ap_" />  
165.   
166.     <!-- Build property file build的属性文件 -->  
167.     <property name="out.build.prop.file" location="${out.absolute.dir}/build.prop" />  
168.   
169.   
170.     <!-- This is needed by emma as it uses multilevel verbosity instead of simple 'true' or 'false'  
171.          The property 'verbosity' is not user configurable and depends exclusively on 'verbose'  
172.          value.  
173.          这是需要通过艾玛,因为它使用多级verbosity不是简单的“true”或“false”。属性“冗长”不是用户可配置的,只取决于verbose”值。  
174.          -->  
175.     <condition property="verbosity" value="verbose" else="quiet">  
176.         <istrue value="${verbose}" />  
177.     </condition>  
178.   
179.     <!-- properties for signing in release mode -->  
180.     <!-- 签名所需要的文件 -->  
181.     <condition property="has.keystore">  
182.         <and>  
183.             <isset property="key.store" />  
184.             <length string="${key.store}" when="greater" length="0" />  
185.             <isset property="key.alias" />  
186.         </and>  
187.     </condition>  
188.     <condition property="has.password">  
189.         <and>  
190.             <isset property="has.keystore" />  
191.             <isset property="key.store.password" />  
192.             <isset property="key.alias.password" />  
193.         </and>  
194.     </condition>  
195.   
196.     <!-- properties for packaging -->  
197.     <property name="build.packaging.nocrunch" value="true" />  
198.   
199.     <!-- ********** Macros ********** -->  
200.     <!-- ********** 宏定义         ********** -->  
201.   
202.     <!-- macro to do a task on if project.is.library is false.  
203.          elseText attribute is displayed otherwise -->  
204.     <!-- 定义了没有关联library工程时，将会打印elseText -->  
205.     <macrodef name="do-only-if-not-library">  
206.         <attribute name="elseText" />  
207.         <element name="task-to-do" implicit="yes" />  
208.         <sequential>  
209.             <if condition="${project.is.library}">  
210.                 <else>  
211.                     <task-to-do />  
212.                 </else>  
213.                 <then>  
214.                     <echo>@{elseText}</echo>  
215.                 </then>  
216.             </if>  
217.         </sequential>  
218.     </macrodef>  
219.   
220.     <!-- macro to do a task on if manifest.hasCode is true.  
221.          elseText attribute is displayed otherwise -->  
222.     <macrodef name="do-only-if-manifest-hasCode">  
223.         <attribute name="elseText" default="" />  
224.         <element name="task-to-do" implicit="yes" />  
225.         <sequential>  
226.             <if condition="${manifest.hasCode}">  
227.                 <then>  
228.                     <task-to-do />  
229.                 </then>  
230.                 <else>  
231.                     <if>  
232.                         <condition>  
233.                             <length string="@{elseText}" trim="true" when="greater" length="0" />  
234.                         </condition>  
235.                         <then>  
236.                             <echo>@{elseText}</echo>  
237.                         </then>  
238.                     </if>  
239.                 </else>  
240.             </if>  
241.         </sequential>  
242.     </macrodef>  
243.   
244.   
245.     <!-- Configurable macro, which allows to pass as parameters output directory,  
246.          output dex filename and external libraries to dex (optional)  
247.          配置宏，允许通过参数设置输出的目录，dex文件和dex额外的libraries  
248.           -->  
249.     <macrodef name="dex-helper">  
250.         <element name="external-libs" optional="yes" />  
251.         <attribute name="nolocals" default="false" />  
252.         <sequential>  
253.             <!-- sets the primary input for dex. If a pre-dex task sets it to  
254.                  something else this has no effect -->  
255.             <property name="out.dex.input.absolute.dir" value="${out.classes.absolute.dir}" />  
256.   
257.             <!-- set the secondary dx input: the project (and library) jar files  
258.                  If a pre-dex task sets it to something else this has no effect -->  
259.             <if>  
260.                 <condition>  
261.                     <isreference refid="out.dex.jar.input.ref" />  
262.                 </condition>  
263.                 <else>  
264.                     <path id="out.dex.jar.input.ref">  
265.                         <path refid="jar.libs.ref" />  
266.                     </path>  
267.                 </else>  
268.             </if>  
269.   
270.             <dex executable="${dx}" output="${intermediate.dex.file}" nolocals="@{nolocals}" verbose="${verbose}" previousBuildType="${build.last.target}" buildType="${build.target}">  
271.                 <path path="${out.dex.input.absolute.dir}" />  
272.                 <path refid="out.dex.jar.input.ref" />  
273.                 <external-libs />  
274.             </dex>  
275.         </sequential>  
276.     </macrodef>  
277.   
278.     <!-- This is macro that enable passing variable list of external jar files to ApkBuilder  
279.     设置ApkBuilder 是额外的jar文件  
280.     默认把工程下libs中的jar文件打到APK里  
281.          Example of use:  
282.          <package-helper>  
283.              <extra-jars>  
284.                 <jarfolder path="my_jars" />  
285.                 <jarfile path="foo/bar.jar" />  
286.                 <jarfolder path="your_jars" />  
287.              </extra-jars>  
288.          </package-helper> -->  
289.     <macrodef name="package-helper">  
290.         <element name="extra-jars" optional="yes" />  
291.         <sequential>  
292.             <apkbuilder outfolder="${out.absolute.dir}" resourcefile="${resource.package.file.name}" apkfilepath="${out.packaged.file}" debugpackaging="${build.is.packaging.debug}" debugsigning="${build.is.signing.debug}" verbose="${verbose}" hascode="${manifest.hasCode}" previousBuildType="${build.last.is.packaging.debug}/${build.last.is.signing.debug}" buildType="${build.is.packaging.debug}/${build.is.signing.debug}">  
293.                 <dex path="${intermediate.dex.file}" />  
294.                 <sourcefolder path="${source.absolute.dir}" />  
295.                 <jarfile refid="jar.libs.ref" />  
296.                 <nativefolder path="${native.libs.absolute.dir}" />  
297.                 <nativefolder refid="project.libraries.libs" />  
298.                 <extra-jars />  
299.             </apkbuilder>  
300.         </sequential>  
301.     </macrodef>  
302.   
303.     <!-- This is macro which zipaligns in.package and outputs it to out.package. Used by targets  
304.          debug, -debug-with-emma and release.  
305.          通过zipaligns 对APK进行优化  
306.          -->  
307.     <macrodef name="zipalign-helper">  
308.         <attribute name="in.package" />  
309.         <attribute name="out.package" />  
310.         <sequential>  
311.             <zipalign executable="${zipalign}" input="@{in.package}" output="@{out.package}" verbose="${verbose}" />  
312.         </sequential>  
313.     </macrodef>  
314.   
315.     <macrodef name="run-tests-helper">  
316.         <attribute name="emma.enabled" default="false" />  
317.         <element name="extra-instrument-args" optional="yes" />  
318.         <sequential>  
319.             <echo>Running tests ...</echo>  
320.             <exec executable="${adb}" failonerror="true">  
321.                 <arg line="${adb.device.arg}" />  
322.                 <arg value="shell" />  
323.                 <arg value="am" />  
324.                 <arg value="instrument" />  
325.                 <arg value="-w" />  
326.                 <arg value="-e" />  
327.                 <arg value="coverage" />  
328.                 <arg value="@{emma.enabled}" />  
329.                 <extra-instrument-args />  
330.                 <arg value="${manifest.package}/${test.runner}" />  
331.             </exec>  
332.         </sequential>  
333.     </macrodef>  
334.   
335.     <macrodef name="record-build-key">  
336.         <attribute name="key" default="false" />  
337.         <attribute name="value" default="false" />  
338.         <sequential>  
339.             <propertyfile file="${out.build.prop.file}" comment="Last build type">  
340.                 <entry key="@{key}" value="@{value}" />  
341.             </propertyfile>  
342.         </sequential>  
343.     </macrodef>  
344.   
345.     <macrodef name="record-build-info">  
346.         <sequential>  
347.             <record-build-key key="build.last.target" value="${build.target}" />  
348.             <record-build-key key="build.last.is.instrumented" value="${build.is.instrumented}" />  
349.             <record-build-key key="build.last.is.packaging.debug" value="${build.is.packaging.debug}" />  
350.             <record-build-key key="build.last.is.signing.debug" value="${build.is.signing.debug}" />  
351.         </sequential>  
352.     </macrodef>  
353.   
354.     <macrodef name="uninstall-helper">  
355.         <attribute name="app.package" default="false" />  
356.         <sequential>  
357.             <echo>Uninstalling @{app.package} from the default emulator or device...</echo>  
358.             <exec executable="${adb}" failonerror="true">  
359.                 <arg line="${adb.device.arg}" />  
360.                 <arg value="uninstall" />  
361.                 <arg value="@{app.package}" />  
362.             </exec>  
363.         </sequential>  
364.     </macrodef>  
365.   
366.     <!-- ********** Build Targets ********** -->  
367.   
368.     <!-- this target simply force running -setup making  
369.          the project info be read. To be used as  
370.              ant all clean  
371.          to clean the main project as well as the libraries and tested project  
372.          运行-setup,在此之前必须运行clean，  
373.           -->  
374.     <target name="all" depends="-setup" />  
375.   
376.     <!-- clean target -->  
377.     <target name="clean" description="Removes output files created by other targets.">  
378.         <delete dir="${out.absolute.dir}" verbose="${verbose}" />  
379.         <delete dir="${gen.absolute.dir}" verbose="${verbose}" />  
380.   
381.         <!-- if we know about a tested project or libraries, we clean them too. This  
382.              will only work if the target 'all' was called first -->  
383.         <if condition="${project.is.test}">  
384.             <then>  
385.                 <property name="tested.project.absolute.dir" location="${tested.project.dir}" />  
386.                 <subant failonerror="true">  
387.                     <fileset dir="${tested.project.absolute.dir}" includes="build.xml" />  
388.                     <target name="all" />  
389.                     <target name="clean" />  
390.                 </subant>  
391.             </then>  
392.         </if>  
393.   
394.         <if>  
395.             <condition>  
396.                 <isreference refid="project.libraries" />  
397.             </condition>  
398.             <then>  
399.                 <!-- 有libraries关联工程的时候，调用libraries工程中build.xml -->  
400.                 <subant buildpathref="project.libraries" antfile="build.xml" failonerror="true">  
401.                     <target name="all" />  
402.                     <target name="clean" />  
403.                 </subant>  
404.             </then>  
405.         </if>  
406.     </target>  
407.   
408.     <!-- generic setup 初始化-->  
409.     <target name="-setup">  
410.         <if>  
411.             <condition>  
412.                 <not>  
413.                     <isset property="setup.done" />  
414.                 </not>  
415.             </condition>  
416.             <then>  
417.                 <property name="setup.done" value="true" />  
418.                 <echo>Gathering info for ${ant.project.name}...</echo>  
419.                 <!-- load project properties, resolve Android target, library dependencies  
420.                      and set some properties with the results.  
421.                      All property names are passed as parameters ending in -Out  
422.                                                             加载project properties，设置 Android target，依赖的library工程和一些其他的属性  
423.                       -->  
424.                 <setup projectTypeOut="android.project.type" androidJarFileOut="android.jar" androidAidlFileOut="android.aidl" renderScriptExeOut="renderscript" renderScriptIncludeDirOut="android.rs" bootclasspathrefOut="android.target.classpath" projectLibrariesRootOut="project.libraries" projectLibrariesJarsOut="project.libraries.jars" projectLibrariesResOut="project.libraries.res" projectLibrariesPackageOut="project.libraries.package" projectLibrariesLibsOut="project.libraries.libs" targetApiOut="target.api" />  
425.   
426.                 <!-- sets a few boolean based on android.project.type  
427.                      to make the if task easier -->  
428.                 <condition property="project.is.library" else="false">  
429.                     <equals arg1="${android.project.type}" arg2="library" />  
430.                 </condition>  
431.                 <condition property="project.is.test" else="false">  
432.                     <equals arg1="${android.project.type}" arg2="test" />  
433.                 </condition>  
434.   
435.                 <!-- If a test project, resolve absolute path to tested project. -->  
436.                 <if condition="${project.is.test}">  
437.                     <then>  
438.                         <property name="tested.project.absolute.dir" location="${tested.project.dir}" />  
439.                     </then>  
440.                 </if>  
441.             </then>  
442.         </if>  
443.     </target>  
444.   
445.     <!-- Pre build setup   
446.     预编译  
447.     -->  
448.     <target name="-build-setup" depends="-setup">  
449.   
450.         <!-- read the previous build mode -->  
451.         <property file="${out.build.prop.file}" />  
452.         <!-- if empty the prop won't be set, so set it to the current target  
453.              to provide a default value equal to the current build -->  
454.         <property name="build.last.target" value="${build.target}" />  
455.         <!-- also set the default value for whether the build is instrumented -->  
456.         <property name="build.last.is.instrumented" value="${build.is.instrumented}" />  
457.         <property name="build.last.is.packaging.debug" value="${build.is.packaging.debug}" />  
458.         <property name="build.last.is.signing.debug" value="${build.is.signing.debug}" />  
459.   
460.         <!-- compile the libraries if any  
461.         编译libraries  
462.          -->  
463.         <if>  
464.             <condition>  
465.                 <isreference refid="project.libraries" />  
466.             </condition>  
467.             <then>  
468.                 <echo>Building Libraries</echo>  
469.                 <subant buildpathref="project.libraries" antfile="build.xml" target="${build.target}" failonerror="true" />  
470.                 <echo>  
471.                 </echo>  
472.                 <echo>############################################</echo>  
473.                 <echo>**** Back to project ${ant.project.name} ****</echo>  
474.                 <echo>############################################</echo>  
475.             </then>  
476.         </if>  
477.   
478.         <!-- compile the main project if this is a test project  
479.         编译主工程，如果这是测试工程  
480.          -->  
481.         <if condition="${project.is.test}">  
482.             <then>  
483.                 <!-- figure out which target must be used to build the tested project.  
484.                      If emma is enabled, then use 'instrument' otherwise, use 'debug' -->  
485.                 <condition property="tested.project.target" value="instrument" else="debug">  
486.                     <isset property="emma.enabled" />  
487.                 </condition>  
488.   
489.                 <echo>Building tested project at ${tested.project.absolute.dir}</echo>  
490.                 <subant target="${tested.project.target}" failonerror="true">  
491.                     <fileset dir="${tested.project.absolute.dir}" includes="build.xml" />  
492.                 </subant>  
493.                 <echo>  
494.                 </echo>  
495.                 <echo>############################################</echo>  
496.                 <echo>**** Back to project ${ant.project.name} ****</echo>  
497.                 <echo>############################################</echo>  
498.             </then>  
499.         </if>  
500.   
501.         <!-- Value of the hasCode attribute (Application node) extracted from manifest file -->  
502.         <xpath input="AndroidManifest.xml" expression="/manifest/application/@android:hasCode" output="manifest.hasCode" default="true" />  
503.   
504.         <!-- create a path with all the jar files, from the main project and the  
505.              libraries   
506.                                        创建一个path，关联所有的jar文件。每个工程下的libs下的jar文件  
507.              -->  
508.         <path id="jar.libs.ref">  
509.             <fileset dir="${jar.libs.absolute.dir}" includes="*.jar" />  
510.             <path refid="project.libraries.jars" />  
511.         </path>  
512.   
513.         <!-- special case for instrumented: if the previous build was  
514.              instrumented but not this one, clear out the compiled code   
515.              特殊情况被打断，清除已编译的代码  
516.              -->  
517.         <if>  
518.             <condition>  
519.                 <and>  
520.                     <istrue value="${build.last.is.instrumented}" />  
521.                     <isfalse value="${build.is.instrumented}" />  
522.                 </and>  
523.             </condition>  
524.             <then>  
525.                 <echo>Switching from instrumented to non-instrumented build.</echo>  
526.                 <echo>Deleting previous compilation output:</echo>  
527.                 <delete dir="${out.classes.absolute.dir}" verbose="${verbose}" />  
528.             </then>  
529.         </if>  
530.   
531.         <echo>Creating output directories if needed...</echo>  
532.         <mkdir dir="${resource.absolute.dir}" />  
533.         <mkdir dir="${jar.libs.absolute.dir}" />  
534.         <mkdir dir="${out.absolute.dir}" />  
535.         <mkdir dir="${out.res.absolute.dir}" />  
536.         <do-only-if-manifest-hasCode>  
537.             <mkdir dir="${gen.absolute.dir}" />  
538.             <mkdir dir="${out.classes.absolute.dir}" />  
539.         </do-only-if-manifest-hasCode>  
540.     </target>  
541.   
542.     <!-- empty default pre-build target. Create a similar target in  
543.          your build.xml and it'll be called instead of this one. -->  
544.     <target name="-pre-build" />  
545.   
546.     <!-- Code Generation: compile resources (aapt -> R.java), aidl, renderscript  
547.     通过appt 生成R.jar文件  
548.      -->  
549.     <target name="-code-gen">  
550.         <do-only-if-manifest-hasCode elseText="hasCode = false. Skipping aidl/renderscript/R.java">  
551.             <echo>----------</echo>  
552.             <echo>Handling aidl files...</echo>  
553.             <aidl executable="${aidl}" framework="${android.aidl}" genFolder="${gen.absolute.dir}">  
554.                 <source path="${source.absolute.dir}" />  
555.             </aidl>  
556.   
557.             <!-- renderscript generates resources so it must be called before aapt -->  
558.             <echo>----------</echo>  
559.             <echo>Handling RenderScript files...</echo>  
560.             <renderscript executable="${renderscript}" framework="${android.rs}" genFolder="${gen.absolute.dir}" resFolder="${resource.absolute.dir}/raw" targetApi="${target.api}">  
561.                 <source path="${source.absolute.dir}" />  
562.             </renderscript>  
563.   
564.             <echo>----------</echo>  
565.             <echo>Handling Resources...</echo>  
566.             <aapt executable="${aapt}" command="package" verbose="${verbose}" manifest="AndroidManifest.xml" androidjar="${android.jar}" rfolder="${gen.absolute.dir}" nonConstantId="${android.library}" projectLibrariesResName="project.libraries.res" projectLibrariesPackageName="project.libraries.package">  
567.                 <res path="${resource.absolute.dir}" />  
568.             </aapt>  
569.         </do-only-if-manifest-hasCode>  
570.     </target>  
571.   
572.     <!-- empty default pre-compile target. Create a similar target in  
573.          your build.xml and it'll be called instead of this one. -->  
574.     <target name="-pre-compile" />  
575.   
576.     <!-- Compiles this project's .java files into .class files.   
577.     编译  
578.     -->  
579.     <target name="-compile" depends="-build-setup, -pre-build, -code-gen, -pre-compile">  
580.         <do-only-if-manifest-hasCode elseText="hasCode = false. Skipping...">  
581.             <!-- If android rules are used for a test project, its classpath should include  
582.                  tested project's location   
583.                  如果是测试工程，classpath应该包括test的位置  
584.                  -->  
585.             <condition property="extensible.classpath" value="${tested.project.absolute.dir}/bin/classes" else=".">  
586.                 <isset property="tested.project.absolute.dir" />  
587.             </condition>  
588.             <condition property="extensible.libs.classpath" value="${tested.project.absolute.dir}/${jar.libs.dir}" else="${jar.libs.dir}">  
589.                 <isset property="tested.project.absolute.dir" />  
590.             </condition>  
591.             <javac encoding="${java.encoding}" source="${java.source}" target="${java.target}" debug="true" extdirs="" destdir="${out.classes.absolute.dir}" bootclasspathref="android.target.classpath" verbose="${verbose}" classpath="${extensible.classpath}" classpathref="jar.libs.ref">  
592.                 <src path="${source.absolute.dir}" />  
593.                 <src path="${gen.absolute.dir}" />  
594.                 <classpath>  
595.                     <fileset dir="${extensible.libs.classpath}" includes="*.jar" />  
596.                 </classpath>  
597.             </javac>  
598.             <!-- if the project is a library then we generate a jar file   
599.             如果工程是library工程，则生成jar文件  
600.             -->  
601.             <if condition="${project.is.library}">  
602.                 <then>  
603.                     <echo>Creating library output jar file...</echo>  
604.                     <property name="out.library.jar.file" location="${out.absolute.dir}/classes.jar" />  
605.                     <if>  
606.                         <condition>  
607.                             <length string="${android.package.excludes}" trim="true" when="greater" length="0" />  
608.                         </condition>  
609.                         <then>  
610.                             <echo>Custom jar packaging exclusion: ${android.package.excludes}