Ant的最完整build.xml解釋

1、ant 的概念make 命令是一個(gè)項(xiàng)目管理工具，而 ant 所實(shí)現(xiàn)功能與此類似。像 make，gnumake 和 nmake這些編譯工具都有一定的缺陷，但是 ant 卻克服了這些工具的缺陷。最初 ant 開(kāi)發(fā)者在開(kāi)發(fā)跨平臺(tái)的應(yīng)用時(shí)，用樣也是基于這些缺陷對(duì)ant 做了更好的設(shè)計(jì)。ant 與 makefile makefile 有一些不足之處，比如很多人都會(huì)碰到的煩人的tab 問(wèn)題。最初的ant 開(kāi)發(fā)者多次強(qiáng)調(diào) ” 只是我在tab 前面加了一個(gè)空格，所以我的命令就不能執(zhí)行” 。有一些工具在一定程度上解決了這個(gè)問(wèn)題，但還是有很多其他的問(wèn)題。ant 則與一般基于命令的工具有所不同，它是 java類的擴(kuò)

2、展。 ant 運(yùn)行需要的xml 格式的文件不是shell 命令文件。它是由一個(gè)project組成的，而一個(gè)project 又可分成可多target ，target 再細(xì)分又分成很多task，每一個(gè) task 都是通過(guò)一個(gè)實(shí)現(xiàn)特定接口的java 類來(lái)完成的。ant 的優(yōu)點(diǎn)ant 是 apache 軟件基金會(huì)jakarta 目錄中的一個(gè)子項(xiàng)目，它有以下的優(yōu)點(diǎn)?？缙脚_(tái)性。 ant 是存 java語(yǔ)言編寫的，所示具有很好的跨平臺(tái)性。操作簡(jiǎn)單。 ant 是由一個(gè)內(nèi)置任務(wù)和可選任務(wù)組成的。ant 運(yùn)行時(shí)需要一個(gè)xml 文件 (構(gòu)建文件 )。ant 通過(guò)調(diào)用target 樹(shù)，就可以執(zhí)行各種task。每個(gè) t

3、ask 實(shí)現(xiàn)了特定接口對(duì)象。由于ant 構(gòu)建文件時(shí)xml 格式的文件，所以和容易維護(hù)和書寫，而且結(jié)構(gòu)很清晰。ant 可以集成到開(kāi)發(fā)環(huán)境中。由于ant 的跨平臺(tái)性和操作簡(jiǎn)單的特點(diǎn)，它很容易集成到一些開(kāi)發(fā)環(huán)境中去。ant 開(kāi)發(fā)ant 的構(gòu)建文件當(dāng)開(kāi)始一個(gè)新的項(xiàng)目時(shí)，首先應(yīng)該編寫ant 構(gòu)建文件。 構(gòu)建文件定義了構(gòu)建過(guò)程，并被團(tuán)隊(duì)開(kāi)發(fā)中每個(gè)人使用。ant 構(gòu)建文件默認(rèn)命名為build.xml ，也可以取其他的名字。只不過(guò)在運(yùn)行的時(shí)候把這個(gè)命名當(dāng)作參數(shù)傳給ant。構(gòu)建文件可以放在任何的位置。一般做法是放在項(xiàng)目頂層目錄中，這樣可以保持項(xiàng)目的簡(jiǎn)潔和清晰。下面是一個(gè)典型的項(xiàng)目層次結(jié)構(gòu)。(1) src存放文件

4、。(2) class存放編譯后的文件。(3) lib 存放第三方j(luò)ar包。(4) dist 存放打包，發(fā)布以后的代碼。ant 構(gòu)建文件是xml 文件。每個(gè)構(gòu)建文件定義一個(gè)唯一的項(xiàng)目(project 元素 )。每個(gè)項(xiàng)目下可以定義很多目標(biāo)(target元素 )，這些目標(biāo)之間可以有依賴關(guān)系。當(dāng)執(zhí)行這類目標(biāo)時(shí)，需要執(zhí)行他們所依賴的目標(biāo)。 每個(gè)目標(biāo)中可以定義多個(gè)任務(wù)，目標(biāo)中還定義了所要執(zhí)行的任務(wù)序列。ant 在構(gòu)建目標(biāo)時(shí)必須調(diào)用所定義的任務(wù)。任務(wù)定義了ant 實(shí)際執(zhí)行的命令。ant 中的任務(wù)可以為 3 類。（1） 核心任務(wù)。核心任務(wù)是ant 自帶的任務(wù)。（2） 可選任務(wù)?？蛇x任務(wù)實(shí)來(lái)自第三方的任務(wù)，因此

5、需要一個(gè)附加的jar文件。（3） 用戶自定義的任務(wù)。用戶自定義的任務(wù)實(shí)用戶自己開(kāi)發(fā)的任務(wù)。1. 標(biāo)簽每個(gè)構(gòu)建文件對(duì)應(yīng)一個(gè)項(xiàng)目。標(biāo)簽時(shí)構(gòu)建文件的根標(biāo)簽。它可以有多個(gè)內(nèi)在屬性，就如代碼中所示，其各個(gè)屬性的含義分別如下。(1) default 表示默認(rèn)的運(yùn)行目標(biāo)，這個(gè)屬性是必須的。(2) basedir 表示項(xiàng)目的基準(zhǔn)目錄。(3) name 表示項(xiàng)目名。(4) description 表示項(xiàng)目的描述。每個(gè)構(gòu)建文件都對(duì)應(yīng)于一個(gè)項(xiàng)目，但是大型項(xiàng)目經(jīng)常包含大量的子項(xiàng)目，每一個(gè)子項(xiàng)目都可以有自己的構(gòu)建文件。2. 標(biāo)簽一個(gè)項(xiàng)目標(biāo)簽驢梢雜幸桓齷蚨喔?/spantarget 標(biāo)簽。一個(gè)target 標(biāo)簽可以依賴其

6、他的target標(biāo)簽。例如，有一個(gè)target 用于編譯程序，另一個(gè)target 用于聲稱可執(zhí)行文件。在生成可執(zhí)行文件之前必須先編譯該文件，因策可執(zhí)行文件的target 依賴于編譯程序的target 。t arget的所有屬性如下。(1).name 表示標(biāo)明，這個(gè)屬性是必須的。(2).depends 表示依賴的目標(biāo)。(3)if 表示僅當(dāng)屬性設(shè)置時(shí)才執(zhí)行。(4)unless 表示當(dāng)屬性沒(méi)有設(shè)置時(shí)才執(zhí)行。(5)description 表示項(xiàng)目的描述。ant 的 depends 屬性指定了target 的執(zhí)行順序。ant 會(huì)依照 depends 屬性中 target 出現(xiàn)順序依次執(zhí)行每個(gè)target

7、。在執(zhí)行之前，首先需要執(zhí)行它所依賴的target。程序中的名為run 的target 的 depends 屬性 compile，而名為compile 的 target 的 depends 屬性是 prepare，所以這幾個(gè) target 執(zhí)行的順序是prepare-compile-run 。一個(gè) target 只能被執(zhí)行一次，即使有多個(gè) target 依賴于它。如果沒(méi)有if 或 unless屬性， target 總會(huì)被執(zhí)行。3.標(biāo)簽該標(biāo)簽用于創(chuàng)建一個(gè)目錄，它有一個(gè)屬性dir 用來(lái)指定所創(chuàng)建的目錄名，其代碼如下：通過(guò)以上代碼就創(chuàng)建了一個(gè)目錄，這個(gè)目錄已經(jīng)被前面的property 標(biāo)簽所指定。4標(biāo)

8、簽該標(biāo)簽用來(lái)生成一個(gè)jar文件，其屬性如下。(1) destfile 表示 jar文件名。(2) basedir 表示被歸檔的文件名。(3) includes 表示別歸檔的文件模式。(4) exchudes表示被排除的文件模式。5 該標(biāo)簽用于編譯一個(gè)或一組java 文件，其屬性如下。(1).srcdir 表示源程序的目錄。(2).destdir 表示 class文件的輸出目錄。(3).include 表示被編譯的文件的模式。(4).excludes 表示被排除的文件的模式。(5).classpath 表示所使用的類路徑。(6).debug 表示包含的調(diào)試信息。(7).optimize 表示是否

9、使用優(yōu)化。(8).verbose 表示提供詳細(xì)的輸出信息。(9).fileonerror 表示當(dāng)碰到錯(cuò)誤就自動(dòng)停止。6標(biāo)簽該標(biāo)簽用來(lái)執(zhí)行編譯生成的.class文件，其屬性如下。(1).classname 表示將執(zhí)行的類名。(2).jar 表示包含該類的jar文件名。(3).classpath 所表示用到的類路徑。(4).fork 表示在一個(gè)新的虛擬機(jī)中運(yùn)行該類。(5).failonerror 表示當(dāng)出現(xiàn)錯(cuò)誤時(shí)自動(dòng)停止。(6).output 表示輸出文件。(7).append 表示追加或者覆蓋默認(rèn)文件。7.標(biāo)簽該標(biāo)簽用于刪除一個(gè)文件或一組文件，去屬性如下。(1)/file 表示要?jiǎng)h除的文件。(2

10、).dir 表示要?jiǎng)h除的目錄。(3).includeemptydirs 表示指定是否要?jiǎng)h除空目錄，默認(rèn)值是刪除。(4).failonerror 表示指定當(dāng)碰到錯(cuò)誤是否停止，默認(rèn)值是自動(dòng)停止。(5).verbose 表示指定是否列出所刪除的文件，默認(rèn)值為不列出。8.標(biāo)簽該標(biāo)簽用于文件或文件集的拷貝，其屬性如下。(1).file 表示源文件。(2).tofile 表示目標(biāo)文件。(3).todir 表示目標(biāo)目錄。(4).overwrite 表示指定是否覆蓋目標(biāo)文件，默認(rèn)值是不覆蓋。(5).includeemptydirs 表示制定是否拷貝空目錄，默認(rèn)值為拷貝。(6).failonerror 表示指定

11、如目標(biāo)沒(méi)有發(fā)現(xiàn)是否自動(dòng)停止，默認(rèn)值是停止。(7).verbose 表示制定是否顯示詳細(xì)信息，默認(rèn)值不顯示。ant 的數(shù)據(jù)類型在 構(gòu) 建 文 件 中 為 了 標(biāo) 識(shí) 文 件或 文 件 組 ， 經(jīng) 常 需 要使 用 數(shù) 據(jù) 類 型 。 數(shù)據(jù) 類 型 包 含 在org.apache.tool.ant.types包中。下面簡(jiǎn)單介紹構(gòu)建文件中常用的數(shù)據(jù)類型。1. argument 類型由 ant 構(gòu)建文件調(diào)用的程序，可以通過(guò) 元素向其傳遞命令行參數(shù)，如 apply,exec 和 java任務(wù)均可接受嵌套元素，可以為各自的過(guò)程調(diào)用指定參數(shù)。以下是的所有屬性。(1).values 是一個(gè)命令參數(shù)。如果參數(shù)種

12、有空格，但又想將它作為單獨(dú)一個(gè)值，則使用此屬性。(2).file 表示一個(gè)參數(shù)的文件名。在構(gòu)建文件中，此文件名相對(duì)于當(dāng)前的工作目錄。(3).line 表示用空格分隔的多個(gè)參數(shù)列表。(4).path 表示路徑。2.ervironment 類型由 ant 構(gòu)建文件調(diào)用的外部命令或程序，元素制定了哪些環(huán)境變量要傳遞給正在執(zhí)行的系統(tǒng)命令，元素可以接受以下屬性。(1).file 表示環(huán)境變量值得文件名。此文件名要被轉(zhuǎn)換位一個(gè)絕對(duì)路徑。(2).path 表示環(huán)境變量的路徑。ant 會(huì)將它轉(zhuǎn)換為一個(gè)本地約定。(3).value 表示環(huán)境變量的一個(gè)直接變量。(4).key 表示環(huán)境變量名。注意file pat

13、h 或 value 只能取一個(gè)。3.filelist 類型filelist 是一個(gè)支持命名的文件列表的數(shù)據(jù)類型，包含在一個(gè)filelist類型中的文件不一定是存在的文件。以下是其所有的屬性。(1).dir 是用于計(jì)算絕對(duì)文件名的目錄。(2).files 是用逗號(hào)分隔的文件名列表。(3).refid 是對(duì)某處定義的一個(gè)的引用。注意dir 和 files 都是必要的，除非指定了refid( 這種情況下， dir 和 files 都不允許使用)。4.fileset 類型fileset 數(shù)據(jù)類型定義了一組文件，并通常表示為元素。不過(guò)，許多ant 任務(wù)構(gòu)建成了隱式的fileset,這說(shuō)明他們支持所有的f

14、ileset 屬性和嵌套元素。以下為 fileset 的屬性列表。(1).dir 表示 fileset 的基目錄。(2).casesensitive 的值如果為false，那么匹配文件名時(shí)，fileset 不是區(qū)分大小寫的，其默認(rèn)值為 true. (3).defaultexcludes 用來(lái)確定是否使用默認(rèn)的排除模式，默認(rèn)為true 。(4).excludes 是用逗號(hào)分隔的需要派出的文件模式列表。(5).excludesfile 表示每行包含一個(gè)排除模式的文件的文件名。(6).includes 是用逗號(hào)分隔的，需要包含的文件模式列表。(7).includesfile 表示每行包括一個(gè)包含模式

15、的文件名。5.patternset 類型fileset 是對(duì)文件的分組， 而 patternset 是對(duì)模式的分組， 他們是緊密相關(guān)的概念。支持 4 個(gè)屬性： includes excludex includexfile 和 excludesfile,與 fileset 相同。 patternset 還允許以下嵌套元素：include,exclude,includefile 和 excludesfile. 6.filterset 類型filterset 定義了一組過(guò)濾器，這些過(guò)濾器將在文件移動(dòng)或復(fù)制時(shí)完成文件的文本替換。主要屬性如下：(1).begintoken 表示嵌套過(guò)濾器所搜索的記號(hào)，這

16、是標(biāo)識(shí)其開(kāi)始的字符串。(2).endtoken 表示嵌套過(guò)濾器所搜索的記號(hào)這是標(biāo)識(shí)其結(jié)束的字符串。(3).id 是過(guò)濾器的唯一標(biāo)志符。(4).refid 是對(duì)構(gòu)建文件中某處定義一個(gè)過(guò)濾器的引用。7.path 類型path 元素用來(lái)表示一個(gè)類路徑，不過(guò)它還可以用于表示其他的路徑。在用作揖個(gè)屬性時(shí)，路經(jīng)中的各項(xiàng)用分號(hào)或冒號(hào)隔開(kāi)。在構(gòu)建的時(shí)候， 此分隔符將代替當(dāng)前平臺(tái)中所有的路徑分隔符，其擁有的屬性如下。(1).location 表示一個(gè)文件或目錄。ant 在內(nèi)部將此擴(kuò)展為一個(gè)絕對(duì)路徑。(2).refid 是對(duì)當(dāng)前構(gòu)建文件中某處定義的一個(gè)path 的引用。(3).path 表示一個(gè)文件或路徑名列表。

17、8.mapper 類型mapper 類型定義了一組輸入文件和一組輸出文件間的關(guān)系，其屬性如下。(1).classname 表示實(shí)現(xiàn)mapper類的類名。當(dāng)內(nèi)置mapper 不滿足要求時(shí)，用于創(chuàng)建定制mapper. (2).classpath 表示查找一個(gè)定制mapper 時(shí)所用的類型路徑。(3).classpathref 是對(duì)某處定義的一個(gè)類路徑的引用。(4).from 屬性的含義取決于所用的mapper. (5).to 屬性的含義取決于所用的mapper. (6).type 屬性的取值為identity ，flatten glob merge regexp 其中之一，它定義了要是用的內(nèi)置 m

18、apper 的類型。ant 的運(yùn)行安裝好 ant 并且配置好路徑之后，在命令行中切換到構(gòu)建文件的目錄，輸入 ant 命令就可以運(yùn)行 ant.若沒(méi)有指定任何參數(shù)，ant 會(huì)在當(dāng)前目錄下查詢build.xml 文件。如果找到了就用該文件作為構(gòu)建文件。如果使用了 find 選項(xiàng)， ant 就會(huì)在上級(jí)目錄中找構(gòu)建文件，直至到達(dá)文件系統(tǒng)得跟目錄。如果構(gòu)建文件的名字不是build.xml ，則 ant 運(yùn)行的時(shí)候就可以使用 buildfile file , 這里 file 指定了要使用的構(gòu)建文件的名稱，示例如下：ant 如 下 說(shuō) 明 了 表 示 當(dāng) 前 目 錄 的 構(gòu)建 文 件 為build.xml 運(yùn)

19、 行ant 執(zhí) 行 默 認(rèn) 的 目 標(biāo) 。 ant buildfile test.xml 使用當(dāng)前目錄下的test.xml 文件運(yùn)行ant ,執(zhí)行默認(rèn)的目標(biāo). xml 代碼1. 2. 13. !- 14. 文檔結(jié)構(gòu)為 : 15. 16. 全局變量的定義17. . 18.19. 任務(wù)組 (tasks) 20. 一項(xiàng) javac任務(wù)21. . 22. 一項(xiàng)其它任務(wù)23. 24.25. 26. 27. . 28. 29. 30. 31.32. project 代表一個(gè)項(xiàng)目，33. default: 運(yùn)行到名稱為dist 的 target(任務(wù)組 ) 34. basedir:基準(zhǔn)路徑。35. - 36

20、. 37.38. !- 39. = 40. 定義屬性（ property tasks）41. 最好把用到的路徑呀，名稱呀都在這里定義成全局變量42. 例：定義43. 44. 以后就可以這樣用它：45. 46. 現(xiàn)在 :b=hello/b 47. = 48. - 49.50. 51. 52. 53. 54.55. 56. 57. 58. 59.60. 61. 62. 63. 64.65. 66. 67.68. 69. 70. 71. 72. 73. 74.75. 76. 77. 78. 79. 80.81. 82. 83.84. !- 85. 定義一組路徑以后可以通過(guò)id 重用這組路徑，例：86

21、. 87. 88. 89. - 90. 91. 92. 93. 94. 95.96. 102. 103. 104. 105. 106.107. 108. 109. 110. 111. 112. 113.114. 115. 116. 117.118. 119.120. 125. 126. 127. 128. 129. 130. 131.132. 138. 139. 140. 141.142. 147. creates the api documentation 150. 151. 152. 153. 154.155. 163. !cdatahello ant docs api 164. !cda

22、ta$app.copyright 165. 166. 167. 168.169. 175. 176. 177. 178. 179. 180. 181. 182. 183. 184. 185. 186. 187.188. 189. 195. 趁熱打鐵，接著上面的再發(fā)一個(gè)實(shí)例：xml 代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42

23、. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. clean output dirs/ 71. compile main java sources and copy libraries/ 72. build the web application archive/ 73. clean, build, warfile/ 74. 75. 76. 77. 78. 79. 80. 81. 82. 83. 84. 85. 86.

24、 88. 89. 90. 91. 92. 93. 94. 95. 96. 97. 98. 99. 100. 101. 102. 103. 104. 105. 106. 107. 108.109. 110. 111. 112. 117. 118. 119. 120. 121. 122. 123. 124. 125. 126. 127. 128. 129. 130. 131. 132. 133. 134. 135. 在 eclipse中使用 ant ant 是 java 平臺(tái)下非常棒的批處理命令執(zhí)行程序，能非常方便地自動(dòng)完成編譯，測(cè)試，打包，部署等等一系列任務(wù)，大大提高開(kāi)發(fā)效率。如果你現(xiàn)在還沒(méi)有開(kāi)

25、始使用 ant，那就要趕快開(kāi)始學(xué)習(xí)使用，使自己的開(kāi)發(fā)水平上一個(gè)新臺(tái)階。eclipse中已經(jīng)集成了ant，我們可以直接在eclipse 中運(yùn)行 ant。以前面建立的hello 工程為例，創(chuàng)建以下目錄結(jié)構(gòu)：新建一個(gè)build.xml，放在工程根目錄下。build.xml 定義了ant 要執(zhí)行的批處理命令。雖然ant 也可以使用其它文件名，但是遵循標(biāo)準(zhǔn)能更使開(kāi)發(fā)更規(guī)范，同時(shí)易于與別人交流。通常， src 存放 java源文件， classes存放編譯后的class文件， lib 存放編譯和運(yùn)行用到的所有 jar 文件， web 存放 jsp等 web 文件， dist 存放打包后的jar 文件， d

26、oc 存放 api文檔。然后在根目錄下創(chuàng)建build.xml 文件，輸入以下內(nèi)容：xml 代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. * 42. * one or more tests failed! check the output . * 43. * 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 5

27、6. 57. 62. 63. 64. 65. !cdatahello, test 66. !cdataall rights reserved. 67. 68. 69. 70. 以上 xml 依次定義了init（初始化），compile（編譯）， test（測(cè)試），doc（生成文檔） ，pack（打包）任務(wù)，可以作為模板。選中 hello 工程，然后選擇“project ”，“properties ”，“builders ”，“new ”，選擇 “ant build ”：填入 name：ant_builder； buildfile：build.xml ；basedirectory： $works

28、pace_loc: /hello （按“ browseworkspace ”選擇工程根目錄），由于用到了junit.jar包，搜索eclipse 目錄，找到j(luò)unit.jar ，把它復(fù)制到hello/lib 目錄下，并添加到ant 的 classpath中：然后在 builder 面板中鉤上ant_build，去掉 java builder：再次編譯，即可在控制臺(tái)看到ant 的輸出：buildfile: f:eclipse-projectshellobuild.xml init: compile: mkdir created dir: f:eclipse-projectshelloclasses javac compiling 2 source files to f:eclipse-projectshelloclasses test: mkdir created dir: f:eclipse-projectshelloreport junit running example.hellotest junit tests run: 1, failures: 0, errors: 0, time elapsed: 0.02 secpack: mkdir created dir: f:eclipse-p