ANT帮组文档

1. ant使用简介
3. ant 是apache 工程的一个子工程，是一个基于java的build工具。ant类似于make工具，但没有传统的make工具的缺点。传统的make往往只能限制在某一平台上使用，ant本身用java类实现，要构建的工程的配置文件用xml格式描述，可以很方便实现多平台编译,非常适合build大型工程。
5. 1.安装配置ant:
6. ant 可以从http://ant.apache.org下载，目前最新版本为1.5.2。下载完毕后直接解压缩，目录如下：
7. ant 
8. +-- bin // contains launcher scripts
9. |
10. +-- lib // contains Ant jars plus necessary dependencies
11. |
12. +-- docs // contains documentation
13. |    +-- ant2 // a brief description of ant2 requirements
14. |    |
15. |    +-- images // various logos for html documentation
16. |    |
17. |    +-- manual // Ant documentation (a must read )
18. |
19. +-- etc 
21. 需要设置的环境变量：
22. ANT_HOME:ant的安装目录
23. JAVA_HOME:jdk的安装目录
24. PATH:把%ANT_HOME%/bin目录加到path变量，以便于从命令行下直接运行ant
26. 假定ant装在c:/ant   jdk装d:/j2sdk1.4.0
27. 则在命令行下执行以下命令：
28. set ANT_HOME=c:/ant
29. set JAVA_HOME=D:/j2sdk1.4.0
30. set PATH=%PATH%;c:/ant/bin
32. 在win2000命令提示符下工作时，每次都必须进行上面的设置，退出命令提示符后，这些变量的值又会恢复成原来的样子。为了避免这些麻烦，可以在 控制面板/系统/高级/环境变量 中设置。
34. 上述设置完成后，就可以使用ant了。
36. 2.建立工程描述文件build.xml
37. 用ant编译规模较大的工程非常方便，每个工程都对应一个build.xml文件，这个文件包含与这个工程有关的路径信息和任务。下面是一个build.xml的例子：
39. <project name="logon" basedir="." default="dist">
41. <property name="dist.name" value="struts_demo"/>
42. <property name="src" location="src"/>
43. <property name="build" location="WEB-INF/classes"/>
44. <property name="dist" location="D:/tomcat/webapps/dist"/>
46. <!-- Build working classpath -->
47. <path id="project.class.path">
48. <pathelement path ="WEB-INF/lib/struts.jar"/>
49. <pathelement path ="WEB-INF/classes"/>
50. <pathelement path ="${classpath}"/>
51. </path>
53. <target name="init">
54. <tstamp/>
55. <!-- Create the build directory structure used by compile -->
56. <delete dir="${dist}"/>
57. </target>
59. <target name="compile" depends="init">
60. <javac srcdir="${src}" destdir="${build}">
61. <classpath refid="project.class.path"/>
62. </javac> 
63. </target>
65. <!-- Build binary distribution -->
66. <target name="dist" depends="compile"
67. description="Create binary distribution">
68. <mkdir dir="${dist}"/>
69. <war destfile="${dist}/${dist.name}.war"
70. webxml="WEB-INF/web.xml">
71. <lib dir="WEB-INF/lib"/>
72. <classes dir="WEB-INF/classes"/>
73. <fileset dir="${basedir}"/>
74. </war>
75. </target>
77. </project>
79. 要构建的工程目录如下：
80. struts_demo
81. +--jsp
82. |
83. +--src
84. |
85. +--WEB-INF
86. |  +--classes
87. |  |
88. |  +--lib
89. |  |
90. |  +--web.xml
91. |
92. +--build.xml
94. 每个build.xml文件都包含一个project和至少一个target。target包含任务元素，任务是一段可执行代码，每个任务元素都有一个id属性，以便于在文件中引用。ant有内置任务集可供使用，如上面文件中用到的property、javac和war,分别完成设置属性、编译和打包任务。当然如果需要的话也可以写自己的任务。
96. build.xml 的根元素是progject,它有三个属性name default basedir,其中default是必需的。name指定工程的名字， basedir表示工程的基路径，设置为"."表示build.xml所在的路径。default表示默认的target，运行ant时如果不指定 target，则用default指定的target.
98. property任务用来设置属性，一个工程可以设置很多属性，属性有名字和值，属性设置后可以在后面引用。
100. <property name="dist.name" value="struts_demo"/>设置一个名字为dist.name的属性，其值为struts_demo，后面使用时用${dist.name}引用，表示字符串struts_demo.
102. < property name="src" location="src"/>设置一个名字为src的属性，它的值是一个路径，用location设置。如果location内容以/或/或D:/ C:/之类开始，表示绝对路径，否则表示相对路径，相对于project中设置的basedir.
104. 使用path或classpath可以设置类的路径，后面引用时用id设置的值
106. 构建工程最常用的ant内置任务：
107. mkdir：    创建目录，dir=要创建的目录
108. delete:    删除文件或文件夹 dir=要删除的文件或文件夹
109. javac:     编译java源文件，java源文件放在srcdir指定的文件夹中，生成的.class文件按照 package语句组织目录，存放在destdir指定的文件夹中。要注意源文件的目录组织要与package语句相一致（<javac srcdir="${src}" destdir="${build}">）
110. war:        为web应用程序打包，destfile指定打包后生成的文件名，webxml指定所用的web.xml文件。<fileset dir="${basedir}"/>将basedir目录下所有的文件也放在包中
112. 上面的build.xml例子中，target中的属性depends表示在执行本target之前必须要做的target,
113. 例如dist 的depends=compile,意思是在用dist打包之前必须先用compile编译。这样当执行dist时首先执行compile
116. 3.运行ant:
117. 使用ant.bat可以直接运行ant,如果不带任何参数，ant会在当前路径下搜索build.xml文件，如果找到，就运行project的default指定的target.也可以带参数来选择build.xml文件和要运行的target
119. 对于上面的例子,假定build.xml所在的目录为D:/struts_demo/ ,则下面三种执行方式效果是一样的：
120.     1.   cd d:/struts_demo
121.          ant
122.     2.   ant -buildfile d:/struts_demo/build.xml
123.     3.   ant -buildfile d:/struts_demo/build.xml    dist
125. 如果执行ant -buildfile d:/struts_demo/build.xml  compile,则执行compile target