点击打开链接:http://blog.sina.com.cn/s/blog_47021dd401010f2f.html

Build.xml文件详解

1. <?xmlversion="1.0"encoding="UTF-8"?>
2. <!--
3. 参考文章：
4. http://www.cnblogs.com/zuolongsnail/archive/2011/05/25/2058210.html
5. http://haya.iteye.com/?show_full=true
6. http://jojol-zhou.iteye.com/blog/729271
7. http://jojol-zhou.iteye.com/blog/729254
8. http://www.cnblogs.com/Pickuper/archive/2011/6/14.html
9. http://www.51testing.com/?uid-213912-action-viewspace-itemid-235086
10. http://jimmy-duan.iteye.com/blog/1057967
11. 命名原则：
12. (1)使用"."替代local.properties文件中的"-"作为文件分隔符
13. (2)前缀：
14. 使用"jar"表示包
15. 使用"tools"表示工具
16. 使用"in"表示输入
17. 使用"out"表示输出
18. 使用"release"表示产品
19. (3)后缀：使用"dir"表示目录,"file"表示文件
20. (3)使用"absolute"表示绝对路径,未使用"absolute"的表示相对路径,所有路径实际使用前转换为绝对路径再使用
21. 文件及变量使用：
22. (1)使用到了系统自带的proguard.cfg文件，用于配置混淆设置
23. (2)使用到了系统自带的local.properties文件，用于定义用户设置的本地变量，典型的文件中包含：
24. #SDK路径
25. sdk-dir=D:\\Android\\android-sdk-windows
26. #混淆路径
27. proguard=D:\\Android\\proguard\\lib\\proguard.jar
28. #jarsiger路径
29. jarsigner=D:\\Java\\jdk1.6.0_25\\bin\\jarsigner.exe
30. #签名文件
31. keystore=D:\\Android\\xxxx.keystore
32. keyalias=xxxxx
33. password=xxxxxx
34. #motoSecondaryTelephonyManagerjar包
35. secondarysecondary-apis-moto-xt882-zip=secondary-apis-moto_xt882.zip
36. secondarysecondary-apis-moto-xt800plus-zip=secondary-apis-moto_xt800plus.zip
37. #QASSDK包
38. appstat-jar=appstat_A1.0.0.7_20110726.jar
39. #资源路径
40. res-dir=res480x320
41. #Manifest文件
42. manifestmanifest-file=manifest/AndroidManifest.xml
43. #UA
44. UA=SamsungI569
45. #assets路径
46. assetsassets-dir=assets${UA}
47. #输出路径
48. out-release-dir=E:\\tmp
49. #版本号
50. TYSX_VER=2.1.11.2
51. #android版本
52. android_ver=AD23
53. #文件名
54. #TYSX-机型型号（UA）-版本号-厂商缩写-操作系统缩写
55. release-apk-file=XXXX-${UA}-${TYSX_VER}-MH-${android_ver}.apk
56. -->
58. <!--
59. <project>标签
60. 每个构建文件对应一个项目。<project>标签时构建文件的根标签。它可以有多个内在属性，
61. 就如代码中所示，其各个属性的含义分别如下。
62. (1)default表示默认的运行目标，这个属性是必须的。
63. (2)basedir表示项目的基准目录。
64. (3)name表示项目名。
65. (4)description表示项目的描述。
66. 每个构建文件都对应于一个项目，但是大型项目经常包含大量的子项目，每一个子项目都可以有
67. 自己的构建文件。
68. -->
69. <projectname="AntTest"default="release">
70. <!--指定配置文件-->
71. <propertyfile="default.properties"/>
72. <propertyfile="local.properties"/>
74. <!--定义工具目录-->
75. <propertyname="sdk.dir"value="${sdk-dir}"/>
76. <propertyname="android.tools.dir"value="${sdk.dir}/tools"/>
77. <propertyname="android.platformtools.dir"value="${sdk.dir}/platform-tools"/>
78. <propertyname="android.platforms.dir"value="${sdk.dir}/platforms/${target}"/>
80. <propertyname="android.tools.absolute.dir"location="${android.tools.dir}"/>
81. <propertyname="android.platformtools.absolute.dir"location="${android.platformtools.dir}"/>
82. <propertyname="android.platforms.absolute.dir"location="${android.platforms.dir}"/>
84. <!--定义工具
85. <propertyname="verbose"value="false"/>-->
86. <conditionproperty="exe"value=".exe"else="">
87. <osfamily="windows"/>
88. </condition>
89. <propertyname="jar.proguard"value="${proguard-jar}"/>
90. <propertyname="jar.android"value="${android.platforms.absolute.dir}/android.jar"/>
91. <propertyname="tools.dx"value="${android.platformtools.absolute.dir}/dx.bat"/>
92. <propertyname="tools.apkbuilder"value="${android.tools.absolute.dir}/apkbuilder.bat"/>
93. <propertyname="tools.adb"value="${android.tools.absolute.dir}/adb${exe}"/>
94. <propertyname="tools.zipalign"value="${android.tools.absolute.dir}/zipalign${exe}"/>
95. <propertyname="tools.aapt"value="${android.platformtools.absolute.dir}/aapt${exe}"/>
96. <propertyname="tools.aidl"value="${android.platformtools.absolute.dir}/aidl${exe}"/>
97. <propertyname="tools.jarsigner"value="${JAVA_HOME}/bin/jarsigner${exe}"/>
99. <!--定义引入工具库
100. <pathid="android.antlibs">
101. <pathelementpath="${sdk.dir}/tools/lib/anttasks.jar"/>
102. <pathelementpath="${sdk.dir}/tools/lib/sdklib.jar"/>
103. <pathelementpath="${sdk.dir}/tools/lib/androidprefs.jar"/>
104. <pathelementpath="${sdk.dir}/tools/lib/apkbuilder.jar"/>
105. <pathelementpath="${sdk.dir}/tools/lib/jarutils.jar"/>
106. </path>
107. 定义任务
108. <taskdefname="aaptexec"classname="com.android.ant.AaptExecLoopTask"classpathref="android.antlibs"/>
109. <taskdefname="apkbuilder"classname="com.android.ant.ApkBuilderTask"classpathref="android.antlibs"/>
110. <taskdefname="xpath"classname="com.android.ant.XPathTask"classpathref="android.antlibs"/>
111. -->
113. <!--定义源代码及资源等输入目录-->
114. <propertyname="in.source.dir"value="src"/>
115. <propertyname="in.resource.dir"value="${res-dir}"/>
116. <propertyname="in.asset.dir"value="${assets-dir}"/>
118. <propertyname="in.source.absolute.dir"location="${in.source.dir}"/>
119. <propertyname="in.resource.absolute.dir"location="${in.resource.dir}"/>
120. <propertyname="in.asset.absolute.dir"location="${in.asset.dir}"/>
122. <!--定义本地库/第三方工具库文件目录-->
123. <propertyname="in.external.libs.dir"value="libs"/>
124. <propertyname="in.native.libs.dir"value="libs"/>
126. <propertyname="in.external.libs.absolute.dir"location="${in.external.libs.dir}"/>
127. <propertyname="in.native.libs.absolute.dir"location="${in.native.libs.dir}"/>
129. <!--定义输入文件-->
130. <propertyname="in.manifest.file"value="${manifest-file}"/>
131. <propertyname="in.android.aidl.file"value="${android.platforms.dir}/framework.aidl"/>
133. <propertyname="in.manifest.absolute.file"location="${in.manifest.file}"/>
134. <propertyname="in.android.aidl.absolute.file"location="${in.android.aidl.file}"/>
136. <!--定义输出文件目录-->
137. <propertyname="out.gen.dir"value="gen"/>
138. <propertyname="out.dir"value="bin"/>
139. <propertyname="out.classes.dir"value="${out.dir}/classes"/>
141. <propertyname="out.gen.absolute.dir"location="${out.gen.dir}"/>
142. <propertyname="out.absolute.dir"location="${out.dir}"/>
143. <propertyname="out.classes.absolute.dir"location="${out.classes.dir}"/>
144. <propertyname="release.absolute.dir"location="${release-dir}"/>
146. <!--定义输出文件-->
147. <propertyname="out.dex.file"value="${ant.project.name}-classes.dex"/>
148. <propertyname="out.resource.package.file"value="${ant.project.name}-resource.apk"/>
149. <propertyname="out.unsigned.package.file"value="${ant.project.name}-unsigned.apk"/>
150. <propertyname="out.signed.package.file"value="${ant.project.name}-signed.apk"/>
151. <propertyname="out.aligned.package.file"value="${ant.project.name}-aligned.apk"/>
152. <propertyname="release.package.file"value="${release-apk-file}"/>
154. <propertyname="out.dex.absolute.file"location="${out.dir}/${out.dex.file}"/>
155. <propertyname="out.resource.package.absolute.file"location="${out.dir}/${out.resource.package.file}"/>
156. <propertyname="out.unsigned.package.absolute.file"location="${out.dir}/${out.unsigned.package.file}"/>
157. <propertyname="out.signed.package.absolute.file"location="${out.dir}/${out.signed.package.file}"/>
158. <propertyname="out.aligned.package.absolute.file"location="${out.dir}/${out.aligned.package.file}"/>
159. <propertyname="release.package.absolute.file"location="${release.absolute.dir}/${release.package.file}"/>
162. <!--
163. <target>标签
164. 一个项目标签下可以有一个或多个target标签。一个target标签可以依赖其他的target标签。例
165. 如，有一个target用于编译程序，另一个target用于声称可执行文件。在生成可执行文件之前必
166. 须先编译该文件，因策可执行文件的target依赖于编译程序的target。Target的所有属性如下。
167. (1)name表示标明，这个属性是必须的。
168. (2)depends表示依赖的目标。
169. (3)if表示仅当属性设置时才执行。
170. (4)unless表示当属性没有设置时才执行。
171. (5)description表示项目的描述。
172. Ant的depends属性指定了target的执行顺序。Ant会依照depends属性中target出现顺序依次执行
173. 每个target。在执行之前，首先需要执行它所依赖的target。程序中的名为run的target的
174. depends属性compile，而名为compile的target的depends属性是prepare，所以这几个target执
175. 行的顺序是prepare->compile->run。
176. 一个target只能被执行一次，即使有多个target依赖于它。如果没有if或unless属性，target总
177. 会被执行。
178. -->
179. <targetname="-clean">
180. <echo>Creatingoutputdirectoriesifneeded...</echo>
181. <deletedir="${out.absolute.dir}"/>
182. <deletedir="${out.gen.absolute.dir}"/>
183. </target>
185. <targetname="-dirs"depends="-clean">
186. <echo>Creatingoutputdirectoriesifneeded...</echo>
187. <mkdirdir="${in.resource.absolute.dir}"/>
188. <mkdirdir="${in.external.libs.absolute.dir}"/>
189. <mkdirdir="${out.gen.absolute.dir}"/>
190. <mkdirdir="${out.absolute.dir}"/>
191. <mkdirdir="${out.classes.absolute.dir}"/>
192. </target>
194. <!--
195. 第一步生成R.java类文件：
196. Eclipse中会自动生成R.java，ant和命令行使用androidSDK提供的aapt.ext程序生成R.java。
197. -->
198. <targetname="-resource-src"depends="-dirs">
199. <echo>GeneratingR.java/Manifest.javafromtheresources...</echo>
200. <execexecutable="${tools.aapt}"failonerror="true">
201. <argvalue="package"/>
202. <argvalue="-m"/>
203. <argvalue="-J"/>
204. <argpath="${out.gen.absolute.dir}"/>
205. <argvalue="-M"/>
206. <argpath="${in.manifest.absolute.file}"/>
207. <argvalue="-S"/>
208. <argpath="${in.resource.absolute.dir}"/>
209. <argvalue="-I"/>
210. <argpath="${jar.android}"/>
211. </exec>
212. </target>
214. <!--
215. 第二步将.aidl文件生成.java类文件：
216. Eclipse中自动生成，ant和命令行使用androidSDK提供的aidl.exe生成.java文件。
217. -->
218. <!--Generatesjavaclassesfrom.aidlfiles.-->
219. <targetname="-aidl"depends="-dirs">
220. <echo>CompilingaidlfilesintoJavaclasses...</echo>
221. <applyexecutable="${tools.aidl}"failonerror="true">
222. <argvalue="-p${in.android.aidl.file}"/>
223. <argvalue="-I${in.source.absolute.dir}"/>
224. <argvalue="-o${out.gen.absolute.dir}"/>
225. <filesetdir="${in.source.absolute.dir}">
226. <includename="**/*.aidl"/>
227. </fileset>
228. </apply>
229. </target>
231. <!--
232. 第三步编译.java类文件生成class文件：
233. Eclipse中自动生成，ant和命令行使用jdk的javac编译java类文件生成class文件。
234. -->
235. <!--Compilesthisproject's.javafilesinto.classfiles.-->
236. <targetname="compile"depends="-resource-src,-aidl">
237. <echo>Compilesproject's.javafilesinto.classfiles</echo>
238. <javacencoding="utf-8"target="1.5"debug="true"extdirs=""srcdir="."
239. destdir="${out.classes.absolute.dir}"bootclasspath="${jar.android}">
240. <classpath>
241. <filesetdir="${in.external.libs.absolute.dir}"includes="*.jar"/>
242. <filesetdir="${in.external.libs.absolute.dir}"includes="*.zip"/>
243. </classpath>
244. </javac>
245. </target>
247. <!--Executeproguardclassflies-->
248. <targetname="optimize"depends="compile">
249. <echo>optimizeclassesareputto"${out.absolute.dir}".</echo>
250. <jarbasedir="${out.classes.absolute.dir}"destfile="${out.absolute.dir}/temp.jar"/>
251. <taskdefresource="proguard/ant/task.properties"classpath="${jar.proguard}"/>
252. <proguard>
253. -injars${out.absolute.dir}/temp.jar
254. -outjars${out.absolute.dir}/optimized.jar
255. -libraryjars${jar.android}
256. -optimizationpasses5
257. -dontusemixedcaseclassnames
258. -dontskipnonpubliclibraryclasses
259. -dontpreverify
260. -verbose
261. -optimizations!code/simplification/arithmetic,!field/*,!class/merging/*
262. -includeproguard.cfg
263. </proguard>
264. <deletefile="${out.absolute.dir}/temp.jar"/>
265. <deletedir="${out.classes.dir}"failonerror="false"/>
266. <mkdirdir="${out.classes.dir}"/>
267. <unzipsrc="${out.absolute.dir}/optimized.jar"dest="${out.classes.absolute.dir}"/>
268. <deletefile="${out.absolute.dir}/optimized.jar"/>
269. </target>
271. <!--
272. 第四步将class文件打包生成classes.dex文件：
273. Eclipse中自动生成,ant和命令行使用androidSDK提供的dx.bat命令行脚本生成classes.dex文件。
274. -->
275. <targetname="dex"depends="optimize">
276. <echo>Convertingcompiledfilesandexternallibrariesinto${out.absolute.dir}/${out.dex.file}...</echo>
277. <applyexecutable="${tools.dx}"failonerror="true"parallel="true">
278. <argvalue="--dex"/>
279. <argvalue="--output=${out.dex.absolute.file}"/>
280. <argpath="${out.classes.absolute.dir}"/>
281. <filesetdir="${in.external.libs.absolute.dir}"includes="*.jar"/>
282. </apply>
283. <deletedir="${out.classes.absolute.dir}"/>
284. </target>
286. <!--
287. 第五步打包资源文件（包括res、assets、androidmanifest.xml等）：
288. Eclipse中自动生成,ant和命令行使用AndroidSDK提供的aapt.exe生成资源包文件。
289. -->
290. <targetname="package-resource">
291. <echo>Packagingresourcesandassets${out.resource.package.absolute.file}...</echo>
292. <execexecutable="${tools.aapt}"failonerror="true">
293. <argvalue="package"/>
294. <argvalue="-f"/>
295. <argvalue="-M"/>
296. <argvalue="${in.manifest.file}"/>
297. <argvalue="-S"/>
298. <argvalue="${in.resource.absolute.dir}"/>
299. <argvalue="-A"/>
300. <argvalue="${in.asset.absolute.dir}"/>
301. <argvalue="-I"/>
302. <argvalue="${jar.android}"/>
303. <argvalue="-F"/>
304. <argvalue="${out.resource.package.absolute.file}"/>
305. </exec>
306. </target>
308. <!--
309. 第六步生成未签名的apk安装文件：
310. Eclipse中自动生成debug签名文件存放在bin目录中，ant和命令行使用androidSDK提供的apkbuilder.bat命令脚本生成未签名的apk安装文件。
311. -->
312. <!--Packagetheapplicationwithoutsigningit.Thisallowsfortheapplicationtobesignedlaterwithanofficialpublishingkey.-->
313. <targetname="package"depends="dex,package-resource">
314. <echo>Packaging${out.unsigned.package.absolute.file}forrelease...</echo>
315. <execexecutable="${tools.apkbuilder}"failonerror="true">
316. <argvalue="${out.unsigned.package.absolute.file}"/>
317. <argvalue="-u"/>
318. <argvalue="-z"/>
319. <argvalue="${out.resource.package.absolute.file}"/>
320. <argvalue="-f"/>
321. <argvalue="${out.dex.absolute.file}"/>
322. <argvalue="-rf"/>
323. <argvalue="${in.source.absolute.dir}"/>
324. <argvalue="-rj"/>
325. <argvalue="${in.external.libs.absolute.dir}"/>
326. </exec>
327. <echo>Itwillneedtobesignedwithjarsignerbeforebeingpublished.</echo>
328. <deletefile="${out.resource.package.absolute.file}"/>
329. <deletefile="${out.dex.absolute.file}"/>
330. </target>
332. <!--
333. 第七步对未签名的apk进行签名生成签名后的android文件：
334. -->
335. <!--Packagetheapplicationwithoutsigningit.Thisallowsfortheapplicationtobesignedlaterwithanofficialpublishingkey.-->
336. <targetname="jarsigner"depends="package">
337. <echo>Packaging${out.unsigned.package.absolute.file}forrelease...</echo>
338. <execexecutable="${tools.jarsigner}"failonerror="true">
339. <argvalue="-keystore"/>
340. <argvalue="${keystore}"/>
341. <argvalue="-storepass"/>
342. <argvalue="${password}"/>
343. <argvalue="-keypass"/>
344. <argvalue="${password}"/>
345. <argvalue="-signedjar"/>
346. <argvalue="${out.signed.package.absolute.file}"/>
347. <argvalue="${out.unsigned.package.absolute.file}"/>
348. <argvalue="${keyalias}"/>
349. </exec>
350. <deletefile="${out.unsigned.package.absolute.file}"/>
351. </target>
353. <!--
354. 第七步签名的文件进行字节对齐；
355. -->
356. <targetname="zipalign"depends="jarsigner">
357. <echo>Zipalign${out.aligned.package.absolute.file}forrelease...</echo>
358. <execexecutable="${tools.zipalign}">
359. <argvalue="-f"/>
360. <argvalue="-v"/>
361. <argvalue="4"/>
362. <argvalue="${out.signed.package.absolute.file}"/>
363. <argvalue="${out.aligned.package.absolute.file}"/>
364. </exec>
365. <deletefile="${out.signed.package.absolute.file}"/>
366. </target>
368. <!--
369. 第八步签名的文件进行字节对齐；
370. -->
371. <targetname="release"depends="zipalign">
372. <copytofile="${release.package.absolute.file}">
373. <filesetdir="${out.absolute.dir}"includes="${out.aligned.package.file}"/>
374. </copy>
375. <deletefile="${out.aligned.package.absolute.file}"/>
376. </target>
379. </project>