您的位置: 首页  >  文章  >  通过ant脚本，编译打包android工程

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

分类: 文章 • 2024-12-12 18:29:22

通过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工程

通过命令打包的脚本：见附件bulid0.xml，这个ant脚本只能编译打包一个单独的android工程或依赖一个library 的android工程


[html]view plaincopy
  1. <?xmlversion="1.0"encoding="UTF-8"?>
  2. <projectname="ant"default="release">
  3. <!--ANT环境变量-->
  4. <propertyenvironment="env"/>
  5. <!--应用名称-->
  7. <propertyname="appName"value="TestPack"/>
  8. <propertyname="basedir"value=""/>
  9. <propertyname="library-dir"value="">
  10. </property>
  11. <!--SDK目录(获取操作系统环境变量ANDROID_SDK_HOME的值)-->
  12. <!--<propertyname="sdk-folder"value="${env.ANDROID_SDK_HOME}"/>-->
  13. <propertyname="sdk-folder"value=""/>
  14. <!--SDK指定平台目录-->
  15. <propertyname="sdk-platform-folder"value="${sdk-folder}/platforms/android-4"/>
  16. <!--SDK中tools目录-->
  17. <propertyname="sdk-tools"value="${sdk-folder}/tools"/>
  18. <!--SDK指定平台中tools目录-->
  19. <propertyname="sdk-platform-tools"value="${sdk-folder}/platform-tools"/>
  21. <!--使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令)-->
  22. <propertyname="aapt"value="${sdk-platform-tools}/aapt.exe"/>
  23. <propertyname="aidl"value="${sdk-platform-tools}/aidl.exe"/>
  24. <propertyname="dx"value="${sdk-platform-tools}/dx.bat"/>
  25. <propertyname="apkbuilder"value="${sdk-tools}/apkbuilder.bat"/>
  26. <propertyname="jarsigner"value="${env.JAVA_HOME}/bin/jarsigner"/>
  28. <!--编译需要的jar;如果项目使用到地图服务则需要maps.jar-->
  29. <propertyname="android-jar"value="${sdk-platform-folder}/android.jar"/>
  31. <!--编译aidl文件所需的预处理框架文件framework.aidl-->
  32. <propertyname="framework-aidl"value="${sdk-platform-folder}/framework.aidl"/>
  34. <!--生成R文件的相对目录-->
  35. <propertyname="outdir-gen"value="gen"/>
  36. <!--编译后的文件放置目录-->
  37. <propertyname="outdir-bin"value="out"/>
  39. <!--清单文件-->
  40. <propertyname="manifest-xml"value="AndroidManifest.xml"/>
  41. <!--源文件目录-->
  42. <propertyname="resource-dir"value="res"/>
  43. <propertyname="asset-dir"value="assets"/>
  44. <!--java源文件目录-->
  45. <propertyname="srcdir"value="src"/>
  46. <propertyname="srcdir-ospath"value="${basedir}/${srcdir}"/>
  47. <!--外部类库所在目录-->
  48. <propertyname="external-lib"value="lib"/>
  49. <propertyname="external-lib-ospath"value="${basedir}/${external-lib}"/>
  51. <!--生成class目录-->
  52. <propertyname="outdir-classes"value="${outdir-bin}"/>
  53. <propertyname="outdir-classes-ospath"value="${basedir}/${outdir-classes}"/>
  55. <!--classes.dex相关变量-->
  56. <propertyname="dex-file"value="classes.dex"/>
  57. <propertyname="dex-path"value="${outdir-bin}/${dex-file}"/>
  58. <propertyname="dex-ospath"value="${basedir}/${dex-path}"/>
  60. <!--经过aapt生成的资源包文件-->
  61. <propertyname="resources-package"value="${outdir-bin}/resources.ap_"/>
  62. <propertyname="resources-package-ospath"value="${basedir}/${resources-package}"/>
  64. <!--未认证apk包-->
  65. <propertyname="out-unsigned-package"value="${outdir-bin}/${appName}-unsigned.apk"/>
  66. <propertyname="out-unsigned-package-ospath"value="${basedir}/${out-unsigned-package}"/>
  68. <!--证书文件-->
  69. <propertyname="keystore-file"value="${basedir}/release.keystore"/>
  71. <!--已认证apk包-->
  72. <propertyname="out-signed-package"value="${outdir-bin}/${appName}.apk"/>
  73. <propertyname="out-signed-package-ospath"value="${basedir}/${out-signed-package}"/>
  76. <!--初始化工作-->
  77. <targetname="init">
  78. <echo>Initializingalloutputdirectories...</echo>
  79. <deletedir="${outdir-bin}"/>
  80. <mkdirdir="${outdir-bin}"/>
  81. <mkdirdir="${outdir-classes}"/>
  82. </target>
  84. <!--根据工程中的资源文件生成R.java文件-->
  85. <targetname="gen-R"depends="init">
  86. <echo>GeneratingR.javafromtheresources...</echo>
  87. <!--<execexecutable="${aapt}"failonerror="true">
  88. <argvalue="package"/>
  89. <argvalue="-f"/>
  90. <argvalue="-m"/>
  91. <argvalue="-J"/>
  92. <argvalue="${outdir-gen}"/>
  93. <argvalue="-S"/>
  94. <argvalue="${resource-dir}"/>
  95. <argvalue="-M"/>
  96. <argvalue="${manifest-xml}"/>
  97. <argvalue="-I"/>
  98. <argvalue="${android-jar}"/>
  99. </exec>-->
  102. <execexecutable="${aapt}"failonerror="true">
  104. <argvalue="package"/>
  106. <argvalue="-m"/>
  108. <argvalue="--auto-add-overlay"/>
  110. <argvalue="-J"/>
  112. <argvalue="${outdir-gen}"/>
  114. <argvalue="-M"/>
  116. <argvalue="${manifest-xml}"/>
  118. <argvalue="-S"/>
  120. <argvalue="${resource-dir}"/>
  122. <argvalue="-S"/>
  124. <argvalue="${library-dir}/${resource-dir}"/>
  126. <argvalue="--extra-packages"/>
  128. <argvalue="com.mobcent.share.android"/>
  130. <argvalue="-A"/>
  132. <argvalue="${asset-dir}"/>
  134. <argvalue="-I"/>
  136. <argvalue="${android-jar}"/>
  138. </exec>
  139. </target>
  142. <!--编译aidl文件-->
  143. <targetname="aidl"depends="gen-R">
  144. <echo>Compiling.aidlintojavafiles...</echo>
  145. <applyexecutable="${aidl}"failonerror="true">
  146. <!--指定预处理文件-->
  147. <argvalue="-p${framework-aidl}"/>
  148. <!--aidl声明的目录-->
  149. <argvalue="-I${srcdir}"/>
  150. <!--目标文件目录-->
  151. <argvalue="-o${outdir-gen}"/>
  152. <!--指定哪些文件需要编译-->
  153. <filesetdir="${srcdir}">
  154. <includename="**/*.aidl"/>
  155. </fileset>
  156. </apply>
  157. </target>
  159. <!--将工程中的java源文件编译成class文件-->
  160. <targetname="compile"depends="aidl">
  161. <echo>Compilingjavasourcecode...</echo>
  162. <javacencoding="utf-8"target="1.6"destdir="${outdir-classes}"bootclasspath="${android-jar}">
  163. <srcpath="src"/>
  164. <srcpath="gen"/>
  165. <srcpath="${library-dir}/src"/>
  166. <classpath>
  167. <filesetdir="${external-lib}"includes="*.jar"/>
  168. <filesetdir="${library-dir}/libs"includes="*.jar"/>
  169. <filelist>
  170. <filename="${android-maps-jar}"/>
  171. </filelist>
  172. </classpath>
  173. </javac>
  174. </target>
  176. <!--将.class文件转化成.dex文件-->
  177. <targetname="dex"depends="compile">
  178. <echo>Convertingcompiledfilesandexternallibrariesintoa.dex
  179. file...
  180. </echo>
  181. <execexecutable="${dx}"failonerror="true">
  182. <argvalue="--dex"/>
  183. <!--输出文件-->
  184. <argvalue="--output=${dex-ospath}"/>
  185. <!--要生成.dex文件的源classes和libraries-->
  186. <argvalue="${outdir-classes-ospath}"/>
  187. <argvalue="${external-lib-ospath}"/>
  188. <argvalue="${library-dir}/libs"/>
  189. </exec>
  190. </target>
  193. <!--将资源文件放进输出目录-->
  194. <!--在这截断-->
  195. <targetname="package-res-and-assets"depends="dex">
  196. <echo>Packagingresourcesandassets...</echo>
  197. <execexecutable="${aapt}"failonerror="true">
  198. <argvalue="package"/>
  199. <argvalue="-f"/>
  200. <argvalue="-M"/>
  201. <argvalue="${manifest-xml}"/>
  202. <argvalue="-S"/>
  203. <argvalue="${resource-dir}"/>
  205. <argvalue="-A"/>
  206. <argvalue="${asset-dir}"/>
  208. <argvalue="-S"/>
  209. <argvalue="${library-dir}/${resource-dir}"/>
  211. <argvalue="-A"/>
  212. <argvalue="${library-dir}/${asset-dir}"/>
  214. <argvalue="-I"/>
  215. <argvalue="${android-jar}"/>
  216. <argvalue="-F"/>
  217. <argvalue="${resources-package}"/>
  219. <argvalue="--auto-add-overlay"/>
  220. </exec>
  221. </target>
  224. <!--打包成未签证的apk-->
  225. <targetname="package"depends="dex,package-res-and-assets">
  226. <echo>Packagingunsignedapkforrelease...</echo>
  227. <execexecutable="${apkbuilder}"failonerror="true">
  228. <argvalue="${out-unsigned-package-ospath}"/>
  229. <argvalue="-u"/>
  231. <argvalue="-z"/>
  232. <argvalue="${resources-package-ospath}"/>
  233. <argvalue="-f"/>
  234. <argvalue="${dex-ospath}"/>
  235. <argvalue="-rf"/>
  236. <argvalue="${srcdir-ospath}"/>
  237. <argvalue="-nf"/>
  238. <argvalue="${library-dir}/libs"/>
  239. </exec>
  240. <echo>Itwillneedtobesignedwithjarsignerbeforebeingpublished.
  241. </echo>
  242. </target>
  245. <!--对apk进行签证-->
  246. <targetname="jarsigner"depends="package">
  247. <echo>Packagingsignedapkforrelease...</echo>
  248. <execexecutable="${jarsigner}"failonerror="true">
  249. <argvalue="-keystore"/>
  250. <argvalue="${keystore-file}"/>
  251. <argvalue="-storepass"/>
  252. <argvalue=""/>
  253. <argvalue="-keypass"/>
  254. <argvalue=""/>
  255. <argvalue="-signedjar"/>
  256. <argvalue="${out-signed-package-ospath}"/>
  257. <argvalue="${out-unsigned-package-ospath}"/>
  258. <!--不要忘了证书的别名-->
  259. <argvalue=""/>
  260. </exec>
  261. </target>
  263. <!--发布-->
  264. <targetname="release"depends="jarsigner">
  265. <!--删除未签证apk-->
  266. <deletefile="${out-unsigned-package-ospath}"/>
  267. <echo>APKisreleased.path:${out-signed-package-ospath}</echo>
  268. </target>
  271. </project>

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

详见build.xml

[html]view plaincopy
  1. <?xmlversion="1.0"encoding="UTF-8"?>
  2. <projectname="pet_dog_base_forum"default="release">
  3. <!--自己需要添加的属性-->
  4. <propertyname="sdk.dir"value="C:/ProgramFiles/android-sdk_r15-windows/android-sdk-windows"/>
  5. <!--导入project.properties文件，设置了编译的target和相关的library工程-->
  6. <propertyfile="project.properties"/>
  7. <!--导入build.properties文件，设置了android的目录和key-->
  8. <propertyfile="ant.properties"/>
  9. <!--
  10. Thisbuildfileisimportedbytheprojectbuildfile.Itcontains
  11. allthetargetsandtasksnecessarytobuildAndroidprojects,bethey
  12. regularprojects,libraryprojects,ortestprojects.
  14. Atthebeginningofthefileisalistofpropertiesthatcanbeoverridden
  15. byaddingthemtoyourbuild.properties(propertiesareimmutable,sotheir
  16. firstdefinitionsticksandisneverchanged).
  18. Follows:
  19. -customtaskdefinitions,
  20. -moreproperties(donotoverridethoseunlessthewholebuildsystemismodified).
  21. -macrosusedthroughoutthebuild,
  22. -basebuildtargets,
  23. -debug-specificbuildtargets,
  24. -release-specificbuildtargets,
  25. -instrument-specificbuildtargets,
  26. -testproject-specificbuildtargets,
  27. -installtargets,
  28. -helptarget
  30. 步骤如下：
  31. ——自定义task
  32. ——设置相关属性
  33. ——全局的使用整个构建
  34. ——基本bulid的targets
  35. ——debug使用的targets
  36. ——release使用的targets
  37. ——特定仪器使用的targets
  38. ——测试使用的targets
  39. ——安装的targets
  40. ——帮助的targets
  41. -->
  43. <!--**********OverrideableProperties**********-->
  44. <!--**********可重写的属性**********-->
  46. <!--Youcanoverridethesevaluesinyourbuild.xmlorbuild.properties.
  47. Overridinganyotherpropertiesmayresultinbrokenbuild.-->
  48. <!--你可以覆盖build.xml或者build.properties文件中的任何属性，覆盖任何一个属性，都可能导致build出错，慎用-->
  50. <!--Tellsadbwhichdevicetotarget.Youcanchangethisfromthecommandline
  51. byinvoking"ant-Dadb.device.arg=-d"fordevice"ant-Dadb.device.arg=-e"for
  52. theemulator.-->
  53. <!--设置链接的机器，
  54. ant-Dadb.device.arg=-d使用链接当前的设备
  55. ant-Dadb.device.arg=-e使用模拟器
  56. -->
  58. <propertyname="adb.device.arg"value=""/>
  61. <!--filesetexcludepatterns(spaceseparated)toprevent
  62. filesinsidesrc/frombeingpackaged.-->
  63. <!--设置改属性可以排除编译一部分代码
  64. -->
  65. <propertyname="android.package.excludes"value=""/>
  67. <!--setsomepropertiesusedforfiltering/override.Ifthoseweren'tdefined
  68. before,thenthiswillcreatethemwithemptyvalues,whicharethenignored
  69. bythecustomtasksreceivingthem.-->
  70. <!--
  71. version.code，version.name可以替換AndroidManifest.xml中的android:versionCode和android:versionName
  72. -->
  73. <propertyname="version.code"value="11"/>
  74. <propertyname="version.name"value="111"/>
  75. <propertyname="aapt.resource.filter"value=""/>
  77. <!--compilationoptions-->
  78. <propertyname="java.encoding"value="UTF-8"/>
  79. <propertyname="java.target"value="1.6"/>
  80. <propertyname="java.source"value="1.6"/>
  82. <!--Verbosity-->
  83. <propertyname="verbose"value="false"/>
  85. <!--**********CustomTasks**********-->
  86. <!--**********自定义Tasks**********-->
  88. <!--导入自定义Task是需要的文件-->
  89. <pathid="android.antlibs">
  90. <pathelementpath="${sdk.dir}/tools/lib/anttasks.jar"/>
  91. </path>
  93. <!--Customtasks-->
  94. <taskdefname="setup"classname="com.android.ant.NewSetupTask"classpathref="android.antlibs"/>
  96. <taskdefname="aapt"classname="com.android.ant.AaptExecTask"classpathref="android.antlibs"/>
  98. <taskdefname="aidl"classname="com.android.ant.AidlExecTask"classpathref="android.antlibs"/>
  100. <taskdefname="renderscript"classname="com.android.ant.RenderScriptTask"classpathref="android.antlibs"/>
  102. <taskdefname="dex"classname="com.android.ant.DexExecTask"classpathref="android.antlibs"/>
  104. <taskdefname="apkbuilder"classname="com.android.ant.ApkBuilderTask"classpathref="android.antlibs"/>
  106. <taskdefname="zipalign"classname="com.android.ant.ZipAlignTask"classpathref="android.antlibs"/>
  108. <taskdefname="xpath"classname="com.android.ant.XPathTask"classpathref="android.antlibs"/>
  110. <taskdefname="if"classname="com.android.ant.IfElseTask"classpathref="android.antlibs"/>
  112. <!--Emmaconfiguration
  113. EMMA是一种快速的，基于字节码指令的Java代码覆盖工具。
  114. -->
  115. <propertyname="emma.dir"value="${sdk.dir}/tools/lib"/>
  116. <pathid="emma.lib">
  117. <pathelementlocation="${emma.dir}/emma.jar"/>
  118. <pathelementlocation="${emma.dir}/emma_ant.jar"/>
  119. </path>
  120. <taskdefresource="emma_ant.properties"classpathref="emma.lib"/>
  121. <!--Endofemmaconfiguration-->
  124. <!--**********OtherProperties**********-->
  125. <!--overridingthesepropertiesmaybreakthebuild
  126. unlessthewholefileisupdated-->
  128. <!--输入文件-->
  129. <propertyname="source.dir"value="src"/>
  130. <propertyname="source.absolute.dir"location="${source.dir}"/>
  131. <propertyname="gen.absolute.dir"location="gen"/>
  132. <propertyname="resource.absolute.dir"location="res"/>
  133. <propertyname="asset.absolute.dir"location="assets"/>
  134. <propertyname="jar.libs.dir"value="libs"/>
  135. <propertyname="jar.libs.absolute.dir"location="${jar.libs.dir}"/>
  136. <propertyname="native.libs.absolute.dir"location="libs"/>
  138. <!--输出文件-->
  139. <propertyname="out.dir"value="bin"/>
  140. <propertyname="out.absolute.dir"location="${out.dir}"/>
  141. <propertyname="out.classes.absolute.dir"location="${out.dir}/classes"/>
  142. <propertyname="out.res.absolute.dir"location="${out.dir}/res"/>
  144. <!--toolslocation编译所需要用到的工具-->
  145. <propertyname="android.tools.dir"location="${sdk.dir}/tools"/>
  146. <propertyname="android.platform.tools.dir"location="${sdk.dir}/platform-tools"/>
  147. <conditionproperty="exe"value=".exe"else="">
  148. <osfamily="windows"/>
  149. </condition>
  150. <conditionproperty="bat"value=".bat"else="">
  151. <osfamily="windows"/>
  152. </condition>
  153. <propertyname="adb"location="${android.platform.tools.dir}/adb${exe}"/>
  154. <propertyname="zipalign"location="${android.tools.dir}/zipalign${exe}"/>
  155. <propertyname="aidl"location="${android.platform.tools.dir}/aidl${exe}"/>
  156. <propertyname="aapt"location="${android.platform.tools.dir}/aapt${exe}"/>
  157. <propertyname="dx"location="${android.platform.tools.dir}/dx${bat}"/>
  158. <!--renderscriptlocationissetbyNewSetupTasksincewehaveachoiceof
  159. severalexecutablesbasedonminSdkVersion-->
  161. <!--Intermediatefiles中间文件-->
  162. <propertyname="dex.file.name"value="classes.dex"/>
  163. <propertyname="intermediate.dex.file"location="${out.absolute.dir}/${dex.file.name}"/>
  164. <propertyname="resource.package.file.name"value="${ant.project.name}.ap_"/>
  166. <!--Buildpropertyfilebuild的属性文件-->
  167. <propertyname="out.build.prop.file"location="${out.absolute.dir}/build.prop"/>
  170. <!--Thisisneededbyemmaasitusesmultilevelverbosityinsteadofsimple'true'or'false'
  171. Theproperty'verbosity'isnotuserconfigurableanddependsexclusivelyon'verbose'
  172. value.
  173. 这是需要通过艾玛,因为它使用多级verbosity不是简单的“true”或“false”。属性“冗长”不是用户可配置的,只取决于verbose”值。
  174. -->
  175. <conditionproperty="verbosity"value="verbose"else="quiet">
  176. <istruevalue="${verbose}"/>
  177. </condition>
  179. <!--propertiesforsigninginreleasemode-->
  180. <!--签名所需要的文件-->
  181. <conditionproperty="has.keystore">
  182. <and>
  183. <issetproperty="key.store"/>
  184. <lengthstring="${key.store}"when="greater"length="0"/>
  185. <issetproperty="key.alias"/>
  186. </and>
  187. </condition>
  188. <conditionproperty="has.password">
  189. <and>
  190. <issetproperty="has.keystore"/>
  191. <issetproperty="key.store.password"/>
  192. <issetproperty="key.alias.password"/>
  193. </and>
  194. </condition>
  196. <!--propertiesforpackaging-->
  197. <propertyname="build.packaging.nocrunch"value="true"/>
  199. <!--**********Macros**********-->
  200. <!--**********宏定义**********-->
  202. <!--macrotodoataskonifproject.is.libraryisfalse.
  203. elseTextattributeisdisplayedotherwise-->
  204. <!--定义了没有关联library工程时，将会打印elseText-->
  205. <macrodefname="do-only-if-not-library">
  206. <attributename="elseText"/>
  207. <elementname="task-to-do"implicit="yes"/>
  208. <sequential>
  209. <ifcondition="${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>
  220. <!--macrotodoataskonifmanifest.hasCodeistrue.
  221. elseTextattributeisdisplayedotherwise-->
  222. <macrodefname="do-only-if-manifest-hasCode">
  223. <attributename="elseText"default=""/>
  224. <elementname="task-to-do"implicit="yes"/>
  225. <sequential>
  226. <ifcondition="${manifest.hasCode}">
  227. <then>
  228. <task-to-do/>
  229. </then>
  230. <else>
  231. <if>
  232. <condition>
  233. <lengthstring="@{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>
  245. <!--Configurablemacro,whichallowstopassasparametersoutputdirectory,
  246. outputdexfilenameandexternallibrariestodex(optional)
  247. 配置宏，允许通过参数设置输出的目录，dex文件和dex额外的libraries
  248. -->
  249. <macrodefname="dex-helper">
  250. <elementname="external-libs"optional="yes"/>
  251. <attributename="nolocals"default="false"/>
  252. <sequential>
  253. <!--setstheprimaryinputfordex.Ifapre-dextasksetsitto
  254. somethingelsethishasnoeffect-->
  255. <propertyname="out.dex.input.absolute.dir"value="${out.classes.absolute.dir}"/>
  257. <!--setthesecondarydxinput:theproject(andlibrary)jarfiles
  258. Ifapre-dextasksetsittosomethingelsethishasnoeffect-->
  259. <if>
  260. <condition>
  261. <isreferencerefid="out.dex.jar.input.ref"/>
  262. </condition>
  263. <else>
  264. <pathid="out.dex.jar.input.ref">
  265. <pathrefid="jar.libs.ref"/>
  266. </path>
  267. </else>
  268. </if>
  270. <dexexecutable="${dx}"output="${intermediate.dex.file}"nolocals="@{nolocals}"verbose="${verbose}"previousBuildType="${build.last.target}"buildType="${build.target}">
  271. <pathpath="${out.dex.input.absolute.dir}"/>
  272. <pathrefid="out.dex.jar.input.ref"/>
  273. <external-libs/>
  274. </dex>
  275. </sequential>
  276. </macrodef>
  278. <!--ThisismacrothatenablepassingvariablelistofexternaljarfilestoApkBuilder
  279. 设置ApkBuilder是额外的jar文件
  280. 默认把工程下libs中的jar文件打到APK里
  281. Exampleofuse:
  282. <package-helper>
  283. <extra-jars>
  284. <jarfolderpath="my_jars"/>
  285. <jarfilepath="foo/bar.jar"/>
  286. <jarfolderpath="your_jars"/>
  287. </extra-jars>
  288. </package-helper>-->
  289. <macrodefname="package-helper">
  290. <elementname="extra-jars"optional="yes"/>
  291. <sequential>
  292. <apkbuilderoutfolder="${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. <dexpath="${intermediate.dex.file}"/>
  294. <sourcefolderpath="${source.absolute.dir}"/>
  295. <jarfilerefid="jar.libs.ref"/>
  296. <nativefolderpath="${native.libs.absolute.dir}"/>
  297. <nativefolderrefid="project.libraries.libs"/>
  298. <extra-jars/>
  299. </apkbuilder>
  300. </sequential>
  301. </macrodef>
  303. <!--Thisismacrowhichzipalignsin.packageandoutputsittoout.package.Usedbytargets
  304. debug,-debug-with-emmaandrelease.
  305. 通过zipaligns对APK进行优化
  306. -->
  307. <macrodefname="zipalign-helper">
  308. <attributename="in.package"/>
  309. <attributename="out.package"/>
  310. <sequential>
  311. <zipalignexecutable="${zipalign}"input="@{in.package}"output="@{out.package}"verbose="${verbose}"/>
  312. </sequential>
  313. </macrodef>
  315. <macrodefname="run-tests-helper">
  316. <attributename="emma.enabled"default="false"/>
  317. <elementname="extra-instrument-args"optional="yes"/>
  318. <sequential>
  319. <echo>Runningtests...</echo>
  320. <execexecutable="${adb}"failonerror="true">
  321. <argline="${adb.device.arg}"/>
  322. <argvalue="shell"/>
  323. <argvalue="am"/>
  324. <argvalue="instrument"/>
  325. <argvalue="-w"/>
  326. <argvalue="-e"/>
  327. <argvalue="coverage"/>
  328. <argvalue="@{emma.enabled}"/>
  329. <extra-instrument-args/>
  330. <argvalue="${manifest.package}/${test.runner}"/>
  331. </exec>
  332. </sequential>
  333. </macrodef>
  335. <macrodefname="record-build-key">
  336. <attributename="key"default="false"/>
  337. <attributename="value"default="false"/>
  338. <sequential>
  339. <propertyfilefile="${out.build.prop.file}"comment="Lastbuildtype">
  340. <entrykey="@{key}"value="@{value}"/>
  341. </propertyfile>
  342. </sequential>
  343. </macrodef>
  345. <macrodefname="record-build-info">
  346. <sequential>
  347. <record-build-keykey="build.last.target"value="${build.target}"/>
  348. <record-build-keykey="build.last.is.instrumented"value="${build.is.instrumented}"/>
  349. <record-build-keykey="build.last.is.packaging.debug"value="${build.is.packaging.debug}"/>
  350. <record-build-keykey="build.last.is.signing.debug"value="${build.is.signing.debug}"/>
  351. </sequential>
  352. </macrodef>
  354. <macrodefname="uninstall-helper">
  355. <attributename="app.package"default="false"/>
  356. <sequential>
  357. <echo>[email protected]{app.package}fromthedefaultemulatorordevice...</echo>
  358. <execexecutable="${adb}"failonerror="true">
  359. <argline="${adb.device.arg}"/>
  360. <argvalue="uninstall"/>
  361. <argvalue="@{app.package}"/>
  362. </exec>
  363. </sequential>
  364. </macrodef>
  366. <!--**********BuildTargets**********-->
  368. <!--thistargetsimplyforcerunning-setupmaking
  369. theprojectinfoberead.Tobeusedas
  370. antallclean
  371. tocleanthemainprojectaswellasthelibrariesandtestedproject
  372. 运行-setup,在此之前必须运行clean，
  373. -->
  374. <targetname="all"depends="-setup"/>
  376. <!--cleantarget-->
  377. <targetname="clean"description="Removesoutputfilescreatedbyothertargets.">
  378. <deletedir="${out.absolute.dir}"verbose="${verbose}"/>
  379. <deletedir="${gen.absolute.dir}"verbose="${verbose}"/>
  381. <!--ifweknowaboutatestedprojectorlibraries,wecleanthemtoo.This
  382. willonlyworkifthetarget'all'wascalledfirst-->
  383. <ifcondition="${project.is.test}">
  384. <then>
  385. <propertyname="tested.project.absolute.dir"location="${tested.project.dir}"/>
  386. <subantfailonerror="true">
  387. <filesetdir="${tested.project.absolute.dir}"includes="build.xml"/>
  388. <targetname="all"/>
  389. <targetname="clean"/>
  390. </subant>
  391. </then>
  392. </if>
  394. <if>
  395. <condition>
  396. <isreferencerefid="project.libraries"/>
  397. </condition>
  398. <then>
  399. <!--有libraries关联工程的时候，调用libraries工程中build.xml-->
  400. <subantbuildpathref="project.libraries"antfile="build.xml"failonerror="true">
  401. <targetname="all"/>
  402. <targetname="clean"/>
  403. </subant>
  404. </then>
  405. </if>
  406. </target>
  408. <!--genericsetup初始化-->
  409. <targetname="-setup">
  410. <if>
  411. <condition>
  412. <not>
  413. <issetproperty="setup.done"/>
  414. </not>
  415. </condition>
  416. <then>
  417. <propertyname="setup.done"value="true"/>
  418. <echo>Gatheringinfofor${ant.project.name}...</echo>
  419. <!--loadprojectproperties,resolveAndroidtarget,librarydependencies
  420. andsetsomepropertieswiththeresults.
  421. Allpropertynamesarepassedasparametersendingin-Out
  422. 加载projectproperties，设置Androidtarget，依赖的library工程和一些其他的属性
  423. -->
  424. <setupprojectTypeOut="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"/>
  426. <!--setsafewbooleanbasedonandroid.project.type
  427. tomaketheiftaskeasier-->
  428. <conditionproperty="project.is.library"else="false">
  429. <equalsarg1="${android.project.type}"arg2="library"/>
  430. </condition>
  431. <conditionproperty="project.is.test"else="false">
  432. <equalsarg1="${android.project.type}"arg2="test"/>
  433. </condition>
  435. <!--Ifatestproject,resolveabsolutepathtotestedproject.-->
  436. <ifcondition="${project.is.test}">
  437. <then>
  438. <propertyname="tested.project.absolute.dir"location="${tested.project.dir}"/>
  439. </then>
  440. </if>
  441. </then>
  442. </if>
  443. </target>
  445. <!--Prebuildsetup
  446. 预编译
  447. -->
  448. <targetname="-build-setup"depends="-setup">
  450. <!--readthepreviousbuildmode-->
  451. <propertyfile="${out.build.prop.file}"/>
  452. <!--ifemptythepropwon'tbeset,sosetittothecurrenttarget
  453. toprovideadefaultvalueequaltothecurrentbuild-->
  454. <propertyname="build.last.target"value="${build.target}"/>
  455. <!--alsosetthedefaultvalueforwhetherthebuildisinstrumented-->
  456. <propertyname="build.last.is.instrumented"value="${build.is.instrumented}"/>
  457. <propertyname="build.last.is.packaging.debug"value="${build.is.packaging.debug}"/>
  458. <propertyname="build.last.is.signing.debug"value="${build.is.signing.debug}"/>
  460. <!--compilethelibrariesifany
  461. 编译libraries
  462. -->
  463. <if>
  464. <condition>
  465. <isreferencerefid="project.libraries"/>
  466. </condition>
  467. <then>
  468. <echo>BuildingLibraries</echo>
  469. <subantbuildpathref="project.libraries"antfile="build.xml"target="${build.target}"failonerror="true"/>
  470. <echo>
  471. </echo>
  472. <echo>############################################</echo>
  473. <echo>****Backtoproject${ant.project.name}****</echo>
  474. <echo>############################################</echo>
  475. </then>
  476. </if>
  478. <!--compilethemainprojectifthisisatestproject
  479. 编译主工程，如果这是测试工程
  480. -->
  481. <ifcondition="${project.is.test}">
  482. <then>
  483. <!--figureoutwhichtargetmustbeusedtobuildthetestedproject.
  484. Ifemmaisenabled,thenuse'instrument'otherwise,use'debug'-->
  485. <conditionproperty="tested.project.target"value="instrument"else="debug">
  486. <issetproperty="emma.enabled"/>
  487. </condition>
  489. <echo>Buildingtestedprojectat${tested.project.absolute.dir}</echo>
  490. <subanttarget="${tested.project.target}"failonerror="true">
  491. <filesetdir="${tested.project.absolute.dir}"includes="build.xml"/>
  492. </subant>
  493. <echo>
  494. </echo>
  495. <echo>############################################</echo>
  496. <echo>****Backtoproject${ant.project.name}****</echo>
  497. <echo>############################################</echo>
  498. </then>
  499. </if>
  501. <!--ValueofthehasCodeattribute(Applicationnode)extractedfrommanifestfile-->
  502. <xpathinput="AndroidManifest.xml"expression="/manifest/application/@android:hasCode"output="manifest.hasCode"default="true"/>
  504. <!--createapathwithallthejarfiles,fromthemainprojectandthe
  505. libraries
  506. 创建一个path，关联所有的jar文件。每个工程下的libs下的jar文件
  507. -->
  508. <pathid="jar.libs.ref">
  509. <filesetdir="${jar.libs.absolute.dir}"includes="*.jar"/>
  510. <pathrefid="project.libraries.jars"/>
  511. </path>
  513. <!--specialcaseforinstrumented:ifthepreviousbuildwas
  514. instrumentedbutnotthisone,clearoutthecompiledcode
  515. 特殊情况被打断，清除已编译的代码
  516. -->
  517. <if>
  518. <condition>
  519. <and>
  520. <istruevalue="${build.last.is.instrumented}"/>
  521. <isfalsevalue="${build.is.instrumented}"/>
  522. </and>
  523. </condition>
  524. <then>
  525. <echo>Switchingfrominstrumentedtonon-instrumentedbuild.</echo>
  526. <echo>Deletingpreviouscompilationoutput:</echo>
  527. <deletedir="${out.classes.absolute.dir}"verbose="${verbose}"/>
  528. </then>
  529. </if>
  531. <echo>Creatingoutputdirectoriesifneeded...</echo>
  532. <mkdirdir="${resource.absolute.dir}"/>
  533. <mkdirdir="${jar.libs.absolute.dir}"/>
  534. <mkdirdir="${out.absolute.dir}"/>
  535. <mkdirdir="${out.res.absolute.dir}"/>
  536. <do-only-if-manifest-hasCode>
  537. <mkdirdir="${gen.absolute.dir}"/>
  538. <mkdirdir="${out.classes.absolute.dir}"/>
  539. </do-only-if-manifest-hasCode>
  540. </target>
  542. <!--emptydefaultpre-buildtarget.Createasimilartargetin
  543. yourbuild.xmlandit'llbecalledinsteadofthisone.-->
  544. <targetname="-pre-build"/>
  546. <!--CodeGeneration:compileresources(aapt->R.java),aidl,renderscript
  547. 通过appt生成R.jar文件
  548. -->
  549. <targetname="-code-gen">
  550. <do-only-if-manifest-hasCodeelseText="hasCode=false.Skippingaidl/renderscript/R.java">
  551. <echo>----------</echo>
  552. <echo>Handlingaidlfiles...</echo>
  553. <aidlexecutable="${aidl}"framework="${android.aidl}"genFolder="${gen.absolute.dir}">
  554. <sourcepath="${source.absolute.dir}"/>
  555. </aidl>
  557. <!--renderscriptgeneratesresourcessoitmustbecalledbeforeaapt-->
  558. <echo>----------</echo>
  559. <echo>HandlingRenderScriptfiles...</echo>
  560. <renderscriptexecutable="${renderscript}"framework="${android.rs}"genFolder="${gen.absolute.dir}"resFolder="${resource.absolute.dir}/raw"targetApi="${target.api}">
  561. <sourcepath="${source.absolute.dir}"/>
  562. </renderscript>
  564. <echo>----------</echo>
  565. <echo>HandlingResources...</echo>
  566. <aaptexecutable="${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. <respath="${resource.absolute.dir}"/>
  568. </aapt>
  569. </do-only-if-manifest-hasCode>
  570. </target>
  572. <!--emptydefaultpre-compiletarget.Createasimilartargetin
  573. yourbuild.xmlandit'llbecalledinsteadofthisone.-->
  574. <targetname="-pre-compile"/>
  576. <!--Compilesthisproject's.javafilesinto.classfiles.
  577. 编译
  578. -->
  579. <targetname="-compile"depends="-build-setup,-pre-build,-code-gen,-pre-compile">
  580. <do-only-if-manifest-hasCodeelseText="hasCode=false.Skipping...">
  581. <!--Ifandroidrulesareusedforatestproject,itsclasspathshouldinclude
  582. testedproject'slocation
  583. 如果是测试工程，classpath应该包括test的位置
  584. -->
  585. <conditionproperty="extensible.classpath"value="${tested.project.absolute.dir}/bin/classes"else=".">
  586. <issetproperty="tested.project.absolute.dir"/>
  587. </condition>
  588. <conditionproperty="extensible.libs.classpath"value="${tested.project.absolute.dir}/${jar.libs.dir}"else="${jar.libs.dir}">
  589. <issetproperty="tested.project.absolute.dir"/>
  590. </condition>
  591. <javacencoding="${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. <srcpath="${source.absolute.dir}"/>
  593. <srcpath="${gen.absolute.dir}"/>
  594. <classpath>
  595. <filesetdir="${extensible.libs.classpath}"includes="*.jar"/>
  596. </classpath>
  597. </javac>
  598. <!--iftheprojectisalibrarythenwegenerateajarfile
  599. 如果工程是library工程，则生成jar文件
  600. -->
  601. <ifcondition="${project.is.library}">
  602. <then>
  603. <echo>Creatinglibraryoutputjarfile...</echo>
  604. <propertyname="out.library.jar.file"location="${out.absolute.dir}/classes.jar"/>
  605. <if>
  606. <condition>
  607. <lengthstring="${android.package.excludes}"trim="true"when="greater"length="0"/>
  608. </condition>
  609. <then>
  610. <echo>Customjarpackagingexclusion:${android.package.excludes}</echo>
  611. </then>
  612. </if>
  613. <jardestfile="${out.library.jar.file}">
  614. <filesetdir="${out.classes.absolute.dir}"excludes="**/R.class**/R$*.class"/>
  615. <filesetdir="${source.absolute.dir}"excludes="**/*.java${android.package.excludes}"/>
  616. </jar>
  617. </then>
  618. </if>
  620. <!--iftheprojectisinstrumented,intrumenttheclasses
  621. 如果工程被打断，插入相关的class
  622. -->
  623. <ifcondition="${build.is.instrumented}">
  624. <then>
  625. <echo>Instrumentingclassesfrom${out.absolute.dir}/classes...</echo>
  626. <!--Itonlyinstrumentsclassfiles,notanyexternallibs-->
  627. <emmaenabled="true">
  628. <instrverbosity="${verbosity}"mode="overwrite"instrpath="${out.absolute.dir}/classes"outdir="${out.absolute.dir}/classes">
  629. </instr>
  630. <!--TODO:exclusionfiltersonR*.classandallowingcustomexclusionfrom
  631. userdefinedfile-->
  632. </emma>
  633. </then>
  634. </if>
  635. </do-only-if-manifest-hasCode>
  636. </target>
  638. <!--emptydefaultpost-compiletarget.Createasimilartargetin
  639. yourbuild.xmlandit'llbecalledinsteadofthisone.-->
  640. <targetname="-post-compile"/>
  642. <!--Obfuscatetarget
  643. Thisisonlyactiveinreleasebuildswhenproguard.configisdefined
  644. indefault.properties.
  646. ToreplaceProguardwithadifferentobfuscationengine:
  647. Overridethefollowingtargetsinyourbuild.xml,beforethecallto<setup>
  648. -release-obfuscation-check
  649. Checkwhetherobfuscationshouldhappen,andputtheresultinaproperty.
  650. -debug-obfuscation-check
  651. Obfuscationshouldnothappen.Setthesamepropertytofalse.
  652. -obfuscate
  653. checkifthepropertysetin-debug/release-obfuscation-checkissettotrue.
  654. Iftrue:
  655. Performobfuscation
  656. Setpropertyout.dex.input.absolute.dirtobetheoutputoftheobfuscation
  657. 混淆代码
  658. -->
  659. <targetname="-obfuscate">
  660. <ifcondition="${proguard.enabled}">
  661. <then>
  662. <propertyname="obfuscate.absolute.dir"location="${out.absolute.dir}/proguard"/>
  663. <propertyname="preobfuscate.jar.file"value="${obfuscate.absolute.dir}/original.jar"/>
  664. <propertyname="obfuscated.jar.file"value="${obfuscate.absolute.dir}/obfuscated.jar"/>
  665. <!--inputfordexwillbeproguard'soutput-->
  666. <propertyname="out.dex.input.absolute.dir"value="${obfuscated.jar.file}"/>
  668. <!--AddProguardTasks-->
  669. <propertyname="proguard.jar"location="${android.tools.dir}/proguard/lib/proguard.jar"/>
  670. <taskdefname="proguard"classname="proguard.ant.ProGuardTask"classpath="${proguard.jar}"/>
  672. <!--SettheandroidclasspathPathobjectintoasingleproperty.It'llbe
  673. allthejarfilesseparatedbyaplatformpath-separator.
  674. Eachpathmustbequotedifitcontainsspaces.
  675. -->
  676. <pathconvertproperty="android.libraryjars"refid="android.target.classpath">
  677. <firstmatchmapper>
  678. <regexpmapperfrom='^([^]*)(.*)$$'to='"\1\2"'/>
  679. <identitymapper/>
  680. </firstmatchmapper>
  681. </pathconvert>
  683. <!--Buildapathobjectwithallthejarfilesthatmustbeobfuscated.
  684. Thisincludetheprojectcompiledsourcecodeandany3rdpartyjar
  685. files.-->
  686. <pathid="project.jars.ref">
  687. <pathelementlocation="${preobfuscate.jar.file}"/>
  688. <pathrefid="jar.libs.ref"/>
  689. </path>
  690. <!--SettheprojectjarfilesPathobjectintoasingleproperty.It'llbe
  691. allthejarfilesseparatedbyaplatformpath-separator.
  692. Eachpathmustbequotedifitcontainsspaces.
  693. -->
  694. <pathconvertproperty="project.jars"refid="project.jars.ref">
  695. <firstmatchmapper>
  696. <regexpmapperfrom='^([^]*)(.*)$$'to='"\1\2"'/>
  697. <identitymapper/>
  698. </firstmatchmapper>
  699. </pathconvert>
  701. <mkdirdir="${obfuscate.absolute.dir}"/>
  702. <deletefile="${preobfuscate.jar.file}"/>
  703. <deletefile="${obfuscated.jar.file}"/>
  704. <jarbasedir="${out.classes.absolute.dir}"destfile="${preobfuscate.jar.file}"/>
  705. <proguard>
  706. @${proguard.config}
  707. -injars${project.jars}
  708. -outjars"${obfuscated.jar.file}"
  709. -libraryjars${android.libraryjars}
  710. -dump"${obfuscate.absolute.dir}/dump.txt"
  711. -printseeds"${obfuscate.absolute.dir}/seeds.txt"
  712. -printusage"${obfuscate.absolute.dir}/usage.txt"
  713. -printmapping"${obfuscate.absolute.dir}/mapping.txt"
  714. </proguard>
  715. </then>
  716. </if>
  717. </target>
  719. <!--Convertsthisproject's.classfilesinto.dexfiles
  720. 将.class打包成.dex文件
  721. -->
  722. <targetname="-dex"depends="-compile,-post-compile,-obfuscate">
  723. <do-only-if-manifest-hasCodeelseText="hasCode=false.Skipping...">
  724. <!--onlyconverttodalvikbytecodeis*not*alibrary-->
  725. <do-only-if-not-libraryelseText="Libraryproject:donotconvertbytecode...">
  726. <!--specialcaseforinstrumentedbuilds:needtouseno-localsandneed
  727. topassintheemmajar.
  728. 特殊情况下，检测build，需要通过emma
  729. -->
  730. <ifcondition="${build.is.instrumented}">
  731. <then>
  732. <dex-helpernolocals="true">
  733. <external-libs>
  734. <filesetfile="${emma.dir}/emma_device.jar"/>
  735. </external-libs>
  736. </dex-helper>
  737. </then>
  738. <else>
  739. <dex-helper/>
  740. </else>
  741. </if>
  742. </do-only-if-not-library>
  743. </do-only-if-manifest-hasCode>
  744. </target>
  746. <!--Updatesthepre-processedPNGcache处理png图片-->
  747. <targetname="-crunch">
  748. <execexecutable="${aapt}"taskName="crunch">
  749. <argvalue="crunch"/>
  750. <argvalue="-v"/>
  751. <argvalue="-S"/>
  752. <argpath="${resource.absolute.dir}"/>
  753. <argvalue="-C"/>
  754. <argpath="${out.res.absolute.dir}"/>
  755. </exec>
  756. </target>
  758. <!--Putstheproject'sresourcesintotheoutputpackagefile
  759. Thisactuallycancreatemultipleresourcepackageincase
  760. Somecustomapkwithspecificconfigurationhavebeen
  761. declaredindefault.properties.
  762. 打包资源文件
  763. -->
  764. <targetname="-package-resources"depends="-crunch">
  765. <!--onlypackageresourcesif*not*alibraryproject-->
  766. <do-only-if-not-libraryelseText="Libraryproject:donotpackageresources...">
  767. <aaptexecutable="${aapt}"command="package"versioncode="${version.code}"versionname="${version.name}"debug="${build.is.packaging.debug}"manifest="AndroidManifest.xml"assets="${asset.absolute.dir}"androidjar="${android.jar}"apkfolder="${out.absolute.dir}"nocrunch="${build.packaging.nocrunch}"resourcefilename="${resource.package.file.name}"resourcefilter="${aapt.resource.filter}"projectLibrariesResName="project.libraries.res"projectLibrariesPackageName="project.libraries.package"previousBuildType="${build.last.target}"buildType="${build.target}">
  768. <respath="${out.res.absolute.dir}"/>
  769. <respath="${resource.absolute.dir}"/>
  770. <!--<nocompress/>forcesnocompressiononanyfilesinassetsorres/raw-->
  771. <!--<nocompressextension="xml"/>forcesnocompressiononspecificfileextensionsinassetsandres/raw-->
  772. </aapt>
  773. </do-only-if-not-library>
  774. </target>
  776. <!--Packagestheapplication.打包-->
  777. <targetname="-package"depends="-dex,-package-resources">
  778. <!--onlypackageapkif*not*alibraryproject-->
  779. <do-only-if-not-libraryelseText="Libraryproject:donotpackageapk...">
  780. <ifcondition="${build.is.instrumented}">
  781. <then>
  782. <package-helper>
  783. <extra-jars>
  784. <!--Injectedfromexternalfile-->
  785. <jarfilepath="${emma.dir}/emma_device.jar"/>
  786. </extra-jars>
  787. </package-helper>
  788. </then>
  789. <else>
  790. <package-helper/>
  791. </else>
  792. </if>
  793. </do-only-if-not-library>
  794. </target>
  796. <targetname="-set-mode-check">
  797. <failif="out.final.file"message="Cannotruntwodifferentmodesatthesametime.Ifyouarerunningmorethanonedebug/release/instrumenttypetargets,callthemfromdifferentAntcalls."/>
  798. </target>
  800. <!--**********Debugspecifictargets**********-->
  802. <!--设置debug-->
  804. <targetname="-set-debug-files"depends="-set-mode-check">
  806. <propertyname="out.packaged.file"location="${out.absolute.dir}/${ant.project.name}-debug-unaligned.apk"/>
  807. <propertyname="out.final.file"location="${out.absolute.dir}/${ant.project.name}-debug.apk"/>
  808. </target>
  810. <targetname="-set-debug-mode">
  811. <!--recordthecurrentbuildtarget-->
  812. <propertyname="build.target"value="debug"/>
  814. <propertyname="build.is.instrumented"value="false"/>
  816. <!--whetherthebuildisadebugbuild.alwaysset.-->
  817. <propertyname="build.is.packaging.debug"value="true"/>
  819. <!--signingmode:debug-->
  820. <propertyname="build.is.signing.debug"value="true"/>
  822. </target>
  824. <!--debug模式下，不使用混淆-->
  825. <targetname="-debug-obfuscation-check">
  826. <!--proguardisneverenabledindebugmode-->
  827. <propertyname="proguard.enabled"value="false"/>
  828. </target>
  830. <!--Buildsdebugoutputpackage-->
  831. <targetname="-do-debug"depends="-set-debug-mode,-debug-obfuscation-check,-package">
  832. <!--onlycreateapkif*not*alibraryproject-->
  833. <do-only-if-not-libraryelseText="Libraryproject:donotcreateapk...">
  834. <sequential>
  835. <zipalign-helperin.package="${out.packaged.file}"out.package="${out.final.file}"/>
  836. <echo>DebugPackage:${out.final.file}</echo>
  837. </sequential>
  838. </do-only-if-not-library>
  839. </target>
  841. <!--Buildsdebugoutputpackage-->
  842. <targetname="debug"depends="-set-debug-files,-do-debug"description="Buildstheapplicationandsignsitwithadebugkey.">
  843. <record-build-info/>
  844. </target>
  847. <!--**********Releasespecifictargets**********-->
  848. <!--发布的targets-->
  850. <!--calledthroughtarget'release'.Onlyexecutedifthekeystoreand
  851. keyaliasareknownbutnottheirpassword.
  852. 需要输入key.alias.password，key.store.password
  853. -->
  854. <targetname="-release-prompt-for-password"if="has.keystore"unless="has.password">
  855. <!--Getspasswords-->
  856. <inputmessage="Pleaseenterkeystorepassword(store:${key.store}):"addproperty="key.store.password"/>
  857. <inputmessage="Pleaseenterpasswordforalias'${key.alias}':"addproperty="key.alias.password"/>
  858. </target>
  860. <!--calledthroughtarget'release'.Onlyexecutedifthere'sno
  861. keystore/keyaliasset-->
  862. <targetname="-release-nosign"unless="has.keystore">
  863. <!--noreleasebuildsforlibraryproject-->
  864. <do-only-if-not-libraryelseText="">
  865. <sequential>
  866. <echo>Nokey.storeandkey.aliaspropertiesfoundinbuild.properties.</echo>
  867. <echo>Pleasesign${out.packaged.file}manually</echo>
  868. <echo>andrunzipalignfromtheAndroidSDKtools.</echo>
  869. </sequential>
  870. </do-only-if-not-library>
  871. <record-build-info/>
  872. </target>
  875. <!--检查是否混淆代码-->
  876. <targetname="-release-obfuscation-check">
  877. <conditionproperty="proguard.enabled"value="true"else="false">
  878. <and>
  879. <issetproperty="build.is.mode.release"/>
  880. <issetproperty="proguard.config"/>
  881. </and>
  882. </condition>
  883. <ifcondition="${proguard.enabled}">
  884. <then>
  885. <!--Secondarydxinput(jarfiles)isemptysinceallthe
  886. jarfileswillbeintheobfuscatedjar-->
  887. <pathid="out.dex.jar.input.ref"/>
  888. </then>
  889. </if>
  890. </target>
  892. <targetname="-set-release-mode"depends="-set-mode-check">
  893. <propertyname="out.packaged.file"location="${out.absolute.dir}/${ant.project.name}-release-unsigned.apk"/>
  894. <propertyname="out.final.file"location="${out.absolute.dir}/${ant.project.name}-release.apk"/>
  896. <!--recordthecurrentbuildtarget-->
  897. <propertyname="build.target"value="release"/>
  899. <propertyname="build.is.instrumented"value="false"/>
  901. <!--releasemodeisonlyvalidifthemanifestdoesnotexplicitly
  902. setdebuggabletotrue.defaultisfalse.-->
  903. <xpathinput="AndroidManifest.xml"expression="/manifest/application/@android:debuggable"output="build.is.packaging.debug"default="false"/>
  905. <!--signingmode:release-->
  906. <propertyname="build.is.signing.debug"value="false"/>
  908. <ifcondition="${build.is.packaging.debug}">
  909. <then>
  910. <echo>*************************************************</echo>
  911. <echo>****AndroidManifesthasdebuggable=true****</echo>
  912. <echo>****DoingDEBUGpackagingwithRELEASEkeys****</echo>
  913. <echo>*************************************************</echo>
  914. </then>
  915. <else>
  916. <!--propertyonlysetinreleasemode.
  917. Usefulforif/unlessattributesintargetnode
  918. whenusingAntbefore1.8-->
  919. <propertyname="build.is.mode.release"value="true"/>
  920. </else>
  921. </if>
  922. </target>
  924. <!--Thisruns-package-releaseand-release-nosignfirstandthenruns
  925. onlyifrelease-signistrue(setin-release-check,
  926. calledby-release-no-sign)-->
  927. <targetname="release"depends="-set-release-mode,-release-obfuscation-check,-package,-release-prompt-for-password,-release-nosign"if="has.keystore"description="Buildstheapplication.Thegeneratedapkfilemustbesignedbefore
  928. itispublished.">
  930. <!--onlycreateapkif*not*alibraryproject-->
  931. <do-only-if-not-libraryelseText="Libraryproject:donotcreateapk...">
  932. <sequential>
  933. <propertyname="out.unaligned.file"location="${out.absolute.dir}/${ant.project.name}-release-unaligned.apk"/>
  935. <!--SignstheAPK-->
  936. <echo>Signingfinalapk...</echo>
  937. <signjarjar="${out.packaged.file}"signedjar="${out.unaligned.file}"keystore="${key.store}"storepass="${key.store.password}"alias="${key.alias}"keypass="${key.alias.password}"verbose="${verbose}"/>
  939. <!--ZipalignstheAPK-->
  940. <zipalign-helperin.package="${out.unaligned.file}"out.package="${out.final.file}"/>
  941. <echo>ReleasePackage:${out.final.file}</echo>
  942. </sequential>
  943. </do-only-if-not-library>
  944. <record-build-info/>
  945. </target>
  947. <!--**********Instrumentedspecifictargets**********-->
  948. <!--需要插入的特殊targets-->
  950. <!--Thesetargetsarespecificfortheprojectundertestwhenit
  951. getscompiledbythetestprojectsinawaythatwillmakeit
  952. supportemmacodecoverage-->
  954. <targetname="-set-instrumented-mode"depends="-set-mode-check">
  955. <propertyname="out.packaged.file"location="${out.absolute.dir}/${ant.project.name}-instrumented-unaligned.apk"/>
  956. <propertyname="out.final.file"location="${out.absolute.dir}/${ant.project.name}-instrumented.apk"/>
  958. <!--whetherthebuildisaninstrumentedbuild.-->
  959. <propertyname="build.is.instrumented"value="true"/>
  960. </target>
  962. <!--Buildsinstrumentedoutputpackage-->
  963. <targetname="instrument"depends="-set-instrumented-mode,-do-debug"description="Buildsaninstrumentedpackaged.">
  964. <!--onlycreateapkif*not*alibraryproject-->
  965. <do-only-if-not-libraryelseText="Libraryproject:donotcreateapk...">
  966. <sequential>
  967. <zipalign-helperin.package="${out.packaged.file}"out.package="${out.final.file}"/>
  968. <echo>InstrumentedPackage:${out.final.file}</echo>
  969. </sequential>
  970. </do-only-if-not-library>
  971. <record-build-info/>
  972. </target>
  974. <!--**********Testprojectspecifictargets**********-->
  975. <!--测试工程特殊的targets-->
  977. <!--enablecodecoverage-->
  978. <targetname="emma">
  979. <propertyname="emma.enabled"value="true"/>
  980. </target>
  982. <!--failsiftheprojectisnotatestproject-->
  983. <targetname="-test-project-check">
  984. <!--can'tuseproject.is.testsincethesetuptargetisnotrun-->
  985. <if>
  986. <condition>
  987. <issetproperty="tested.project.dir"/>
  988. </condition>
  989. <else>
  990. <failmessage="Projectisnotatestproject."/>
  991. </else>
  992. </if>
  993. </target>
  995. <targetname="test"depends="-test-project-check"description="Runstestsfromthepackagedefinedintest.packageproperty">
  997. <propertyname="tested.project.absolute.dir"location="${tested.project.dir}"/>
  999. <propertyname="test.runner"value="android.test.InstrumentationTestRunner"/>
  1001. <!--Applicationpackageofthetestedprojectextractedfromitsmanifestfile-->
  1002. <xpathinput="${tested.project.absolute.dir}/AndroidManifest.xml"expression="/manifest/@package"output="tested.manifest.package"/>
  1003. <xpathinput="AndroidManifest.xml"expression="/manifest/@package"output="manifest.package"/>
  1005. <propertyname="emma.dump.file"value="/data/data/${tested.manifest.package}/coverage.ec"/>
  1007. <ifcondition="${emma.enabled}">
  1008. <then>
  1009. <echo>WARNING:CodeCoverageiscurrentlyonlysupportedontheemulatorandrooteddevices.</echo>
  1010. <run-tests-helperemma.enabled="true">
  1011. <extra-instrument-args>
  1012. <argvalue="-e"/>
  1013. <argvalue="coverageFile"/>
  1014. <argvalue="${emma.dump.file}"/>
  1015. </extra-instrument-args>
  1016. </run-tests-helper>
  1017. <echo>Downloadingcoveragefileintoprojectdirectory...</echo>
  1018. <execexecutable="${adb}"failonerror="true">
  1019. <argline="${adb.device.arg}"/>
  1020. <argvalue="pull"/>
  1021. <argvalue="${emma.dump.file}"/>
  1022. <argvalue="coverage.ec"/>
  1023. </exec>
  1024. <echo>Extractingcoveragereport...</echo>
  1025. <emma>
  1026. <reportsourcepath="${tested.project.absolute.dir}/${source.dir}"verbosity="${verbosity}">
  1027. <!--TODO:report.dirorsomethinglikeshouldbeintroducedifnecessary-->
  1028. <infilesetdir=".">
  1029. <includename="coverage.ec"/>
  1030. <includename="coverage.em"/>
  1031. </infileset>
  1032. <!--TODO:reportsinother,indicatedbyuserformats-->
  1033. <htmloutfile="coverage.html"/>
  1034. </report>
  1035. </emma>
  1036. <echo>Cleaninguptemporaryfiles...</echo>
  1037. <deletefile="coverage.ec"/>
  1038. <deletefile="coverage.em"/>
  1039. <echo>Savingthereportfilein${basedir}/coverage/coverage.html</echo>
  1040. </then>
  1041. <else>
  1042. <run-tests-helper/>
  1043. </else>
  1044. </if>
  1045. </target>
  1048. <!--**********Install/uninstallspecifictargets**********-->
  1049. <!--安装和卸载-->
  1051. <targetname="install"description="Installsthenewlybuildpackage.Mustbeusedinconjunctionwithabuildtarget
  1052. (debug/release/instrument).Iftheapplicationwaspreviouslyinstalled,theapplication
  1053. isreinstalledifthesignaturematches.">
  1054. <!--onlydoinstallif*not*alibraryproject-->
  1055. <do-only-if-not-libraryelseText="Libraryproject:nothingtoinstall!">
  1056. <if>
  1057. <condition>
  1058. <issetproperty="out.final.file"/>
  1059. </condition>
  1060. <then>
  1061. <if>
  1062. <condition>
  1063. <resourceexists>
  1064. <filefile="${out.final.file}"/>
  1065. </resourceexists>
  1066. </condition>
  1067. <then>
  1068. <echo>Installing${out.final.file}ontodefaultemulatorordevice...</echo>
  1069. <execexecutable="${adb}"failonerror="true">
  1070. <argline="${adb.device.arg}"/>
  1071. <argvalue="install"/>
  1072. <argvalue="-r"/>
  1073. <argpath="${out.final.file}"/>
  1074. </exec>
  1076. <!--nowinstallthetestedprojectifapplicable-->
  1077. <!--can'tuseproject.is.testsincethesetuptargetmightnothaverun-->
  1078. <if>
  1079. <condition>
  1080. <issetproperty="tested.project.dir"/>
  1081. </condition>
  1082. <then>
  1083. <propertyname="tested.project.absolute.dir"location="${tested.project.dir}"/>
  1085. <!--figureoutwhichtestedpackagetoinstallbasedonemma.enabled-->
  1086. <conditionproperty="tested.project.install.target"value="installi"else="installd">
  1087. <issetproperty="emma.enabled"/>
  1088. </condition>
  1089. <subanttarget="${tested.project.install.target}"failonerror="true">
  1090. <filesetdir="${tested.project.absolute.dir}"includes="build.xml"/>
  1091. </subant>
  1092. </then>
  1093. </if>
  1094. </then>
  1095. <else>
  1096. <failmessage="File${out.final.file}doesnotexist."/>
  1097. </else>
  1098. </if>
  1099. </then>
  1100. <else>
  1101. <echo>Installfilenotspecified.</echo>
  1102. <echo>
  1103. </echo>
  1104. <echo>'antinstall'nowrequiresthebuildtargettobespecifiedaswell.</echo>
  1105. <echo>
  1106. </echo>
  1107. <echo>
  1108. </echo>
  1109. <echo>antdebuginstall</echo>
  1110. <echo>antreleaseinstall</echo>
  1111. <echo>antinstrumentinstall</echo>
  1112. <echo>Thiswillbuildthegivenpackageandinstallit.</echo>
  1113. <echo>
  1114. </echo>
  1115. <echo>Alternatively,youcanuse</echo>
  1116. <echo>antinstalld</echo>
  1117. <echo>antinstallr</echo>
  1118. <echo>antinstalli</echo>
  1119. <echo>antinstallt</echo>
  1120. <echo>toonlyinstallanexistingpackage(thiswillnotrebuildthepackage.)</echo>
  1121. <fail/>
  1122. </else>
  1123. </if>
  1124. </do-only-if-not-library>
  1125. </target>
  1127. <targetname="installd"depends="-set-debug-files,install"description="Installs(only)thedebugpackage."/>
  1128. <targetname="installr"depends="-set-release-mode,install"description="Installs(only)thereleasepackage."/>
  1129. <targetname="installi"depends="-set-instrumented-mode,install"description="Installs(only)theinstrumentedpackage."/>
  1130. <targetname="installt"depends="-test-project-check,installd"description="Installs(only)thetestandtestedpackages."/>
  1133. <!--Uninstallsthepackagefromthedefaultemulator/device-->
  1134. <targetname="uninstall"description="Uninstallstheapplicationfromarunningemulatorordevice.">
  1135. <!--Nameoftheapplicationpackageextractedfrommanifestfile-->
  1136. <xpathinput="AndroidManifest.xml"expression="/manifest/@package"output="manifest.package"/>
  1138. <if>
  1139. <condition>
  1140. <issetproperty="manifest.package"/>
  1141. </condition>
  1142. <then>
  1143. <uninstall-helperapp.package="${manifest.package}"/>
  1144. </then>
  1145. <else>
  1146. <echo>Couldnotfindapplicationpackageinmanifest.Cannotrun'adbuninstall'.</echo>
  1147. </else>
  1148. </if>
  1150. <!--Nowuninstallthetestedproject,ifapplicable-->
  1151. <!--can'tuseproject.is.testsincethesetuptargetmightnothaverun-->
  1152. <if>
  1153. <condition>
  1154. <issetproperty="tested.project.dir"/>
  1155. </condition>
  1156. <then>
  1157. <propertyname="tested.project.absolute.dir"location="${tested.project.dir}"/>
  1159. <!--Applicationpackageofthetestedprojectextractedfromitsmanifestfile-->
  1160. <xpathinput="${tested.project.absolute.dir}/AndroidManifest.xml"expression="/manifest/@package"output="tested.manifest.package"/>
  1161. <if>
  1162. <condition>
  1163. <issetproperty="tested.manifest.package"/>
  1164. </condition>
  1165. <then>
  1166. <uninstall-helperapp.package="${tested.manifest.package}"/>
  1167. </then>
  1168. <else>
  1169. <echo>Couldnotfindtestedapplicationpackageinmanifest.Cannotrun'adbuninstall'.</echo>
  1170. </else>
  1171. </if>
  1172. </then>
  1173. </if>
  1175. </target>
  1178. <targetname="help">
  1179. <!--displaysstartsatcol13
  1180. |1380|-->
  1181. <echo>AndroidAntBuild.Availabletargets:</echo>
  1182. <echo>help:Displaysthishelp.</echo>
  1183. <echo>clean:Removesoutputfilescreatedbyothertargets.</echo>
  1184. <echo>The'all'targetcanbeusedtocleandependencies</echo>
  1185. <echo>(testedprojectsandlibraries)atthesametime</echo>
  1186. <echo>using:'antallclean'</echo>
  1187. <echo>debug:Buildstheapplicationandsignsitwithadebugkey.</echo>
  1188. <echo>release:Buildstheapplication.Thegeneratedapkfilemustbe</echo>
  1189. <echo>signedbeforeitispublished.</echo>
  1190. <echo>instrument:Buildsaninstrumentedpackageandsignsitwitha</echo>
  1191. <echo>debugkey.</echo>
  1192. <echo>test:Runsthetests.Projectmustbeatestprojectand</echo>
  1193. <echo>musthavebeenbuilt.Typicalusagewouldbe:</echo>
  1194. <echo>ant[emma]debuginstallttest</echo>
  1195. <echo>emma:Transientlyenablescodecoverageforsubsequent</echo>
  1196. <echo>targets.</echo>
  1197. <echo>install:Installsthenewlybuildpackage.Musteitherbeused</echo>
  1198. <echo>inconjunctionwithabuildtarget(debug/release/</echo>
  1199. <echo>instrument)orwiththepropersuffixindicating</echo>
  1200. <echo>whichpackagetoinstall(seebelow).</echo>
  1201. <echo>Iftheapplicationwaspreviouslyinstalled,the</echo>
  1202. <echo>applicationisreinstalledifthesignaturematches.</echo>
  1203. <echo>installd:Installs(only)thedebugpackage.</echo>
  1204. <echo>installr:Installs(only)thereleasepackage.</echo>
  1205. <echo>installi:Installs(only)theinstrumentedpackage.</echo>
  1206. <echo>installt:Installs(only)thetestandtestedpackages.</echo>
  1207. <echo>uninstall:Uninstallstheapplicationfromarunningemulatoror</echo>
  1208. <echo>device.</echo>
  1209. </target>
  1210. </project>

相关推荐