Ant学习一

阅读更多

Ant标签

 

Ant的构建文件

　　当开始一个新的项目时，首先应该编写Ant构建文件。构建文件定义了构建过程，并被团队开发中每个人使用。Ant构建文件默认命名为 build.xml，也可以取其他的名字。只不过在运行的时候把这个命名当作参数传给Ant。构建文件可以放在任何的位置。一般做法是放在项目顶层目录 中，这样可以保持项目的简洁和清晰。下面是一个典型的项目层次结构。

　　(1) src存放文件。

　　(2) class存放编译后的文件。

　　(3) lib存放第三方JAR包。

　　(4) dist存放打包，发布以后的代码。

　　Ant构建文件是XML文件。每个构建文件定义一个唯一的项目(Project元素)。每个项目下可以定义很多目标(target元素)，这些目标之间可以有依赖关系。当执行这类目标时，需要执行他们所依赖的目标。

　　每个目标中可以定义多个任务，目标中还定义了所要执行的任务序列。Ant在构建目标时必须调用所定义的任务。任务定义了Ant实际执行的命令。Ant中的任务可以为3类。

　　（1） 核心任务。核心任务是Ant自带的任务。

　　（2） 可选任务。可选任务实来自第三方的任务，因此需要一个附加的JAR文件。

　　（3） 用户自定义的任务。用户自定义的任务是用户自己开发的任务。

　　1.标签

　　每个构建文件对应一个项目。标签时构建文件的根标签。它可以有多个内在属性，就如代码中所示，其各个属性的含义分别如下。

　　(1) default表示默认的运行目标，这个属性是必须的。

　　(2) basedir表示项目的基准目录。

　　(3) name表示项目名。

　　(4) description表示项目的描述。

　　每个构建文件都对应于一个项目，但是大型项目经常包含大量的子项目，每一个子项目都可以有自己的构建文件。

　　2.标签

　　一个项目标签下可以有一个或多个target标签。一个target标签可以依赖其他的target标签。

　　例如，有一个target用于编译程序，另一个target用于声称可执行文件。在生成可执行文件之前必须先编译该文件，因策可执行文件的target依赖于编译程序的target。Target的所有属性如下。

　　(1).name表示标明，这个属性是必须的。

　　(2).depends表示依赖的目标。

　　(3)if表示仅当属性设置时才执行。

　　(4)unless表示当属性没有设置时才执行。

　　(5)description表示项目的描述。

　　Ant的depends属性指定了target的执行顺序。Ant会依照depends属性中target出现顺序依次执行每个target。 在执行之前，首先需要执行它所依赖的target。程序中的名为run的target的depends属性compile，而名为compile的 target的depends属性是prepare，所以这几个target执行的顺序是prepare->compile->run。

　　一个target只能被执行一次，即使有多个target依赖于它。如果没有if或unless属性，target总会被执行。

　　3.标签

　　该标签用于创建一个目录，它有一个属性dir用来指定所创建的目录名，其代码如下：

　　

　　通过以上代码就创建了一个目录，这个目录已经被前面的property标签所指定。

　　4标签

　　该标签用来生成一个JAR文件，其属性如下。

　　(1) destfile表示JAR文件名。

　　(2) basedir表示被归档的文件名。

　　(3) includes表示别归档的文件模式。

　　(4) exchudes表示被排除的文件模式。

　　5．

　　该标签用于编译一个或一组java文件，其属性如下。

　　(1).srcdir表示源程序的目录。

　　(2).destdir表示class文件的输出目录。

　　(3).include表示被编译的文件的模式。

　　(4).excludes表示被排除的文件的模式。

　　(5).classpath表示所使用的类路径。

　　(6).debug表示包含的调试信息。

　　(7).optimize表示是否使用优化。

　　(8).verbose 表示提供详细的输出信息。

　　(9).fileonerror表示当碰到错误就自动停止。

　　6．标签

　　该标签用来执行编译生成的.class文件，其属性如下。

　　(1).classname 表示将执行的类名。

　　(2).jar表示包含该类的JAR文件名。

　　(3).classpath所表示用到的类路径。

　　(4).fork表示在一个新的虚拟机中运行该类。

　　(5).failonerror表示当出现错误时自动停止。

　　(6).output 表示输出文件。

　　(7).append表示追加或者覆盖默认文件。

　　7.标签

　　该标签用于删除一个文件或一组文件，其属性如下。

　　(1)/file表示要删除的文件。

　　(2).dir表示要删除的目录。

　　(3).includeEmptyDirs 表示指定是否要删除空目录，默认值是删除。

　　(4).failonerror 表示指定当碰到错误是否停止，默认值是自动停止。

　　(5).verbose表示指定是否列出所删除的文件，默认值为不列出。

　　8.标签

　　该标签用于文件或文件集的拷贝，其属性如下。

　　(1).file 表示源文件。

　　(2).tofile 表示目标文件。

　　(3).todir 表示目标目录。

　　(4).overwrite 表示指定是否覆盖目标文件，默认值是不覆盖。

　　(5).includeEmptyDirs 表示制定是否拷贝空目录，默认值为拷贝。

　　(6).failonerror 表示指定如目标没有发现是否自动停止，默认值是停止。

　　(7).verbose 表示制定是否显示详细信息，默认值不显示。