简介
Apache Ant是一个Java库和命令行工具,其任务是将构建文件中描述的进程作为相互依赖的目标和扩展点。只要使用过Linux系统的读者,应该知道 make这个命令。当编译Linux内核及一些软件源程序时,经常要用这个命令。Make命令其实就 是一个项目管理工具,而Ant所实现功能与此类似,像make,gnumake和nmake这些编译工具都有 一定的缺陷,但是Ant却克服了这些工具的缺陷。
Ant的优点
跨平台性。Ant是存Java语言编写的,所示具有很好的跨平台性。
操作简单。Ant是由一个内置任务和可选任务组成的。Ant运行时需要一个XML文件(构建文件)。
Ant通过调用target树,就可以执行各种task。每个task实现了特定接口对象。由于Ant构建文件时XML格式的文件,所以和容易维护和书写,而且结构很清晰。
Ant可以集成到开发环境中。由于Ant的跨平台性和操作简单的特点,它很容易集成到一些开发环境中去。
Ant的开发
Ant的构建文件
当开始一个新的项目时,首先应该编写Ant构建文件。构建文件定义了构建过程,并被团队开发中每个人使用。Ant构建文件默认命名为 build.xml,也可以取其他的名字。只不过在运行的时候把这个命名当作参数传给Ant。构建文件可以放在任何的位置。一般做法是放在项目顶层目录中,这样可以保持项目的简洁和清晰。下面是一个典型的项目层次结构。
( 注:很多项目的ant脚本中的命名基本上都是一致的,比如:编译一般叫build或者compile;打包一般叫jar或war;生成文档一般命名为 javadoc或javadocs;执行全部任务all。在每个任务的中,ANT会根据配置调用一些外部应用并配以相应参数执行。虽然ANT可调用的外部应用种类非常丰富,但其实最常用的就2,3个:比如javac javadoc jar等。)
(1) src存放文件。
(2) class存放编译后的文件。
(3) lib存放第三方JAR包。
(4) dist存放打包,发布以后的代码。
Ant构建文件是XML文件
每个构建文件定义一个唯一的项目(Project元素)。每个项目下可以定义很多目标(target元素),这些目标之间可以有依赖关系。当执行这类目标时,需要执行他们所依赖的目标。每个目标中可以定义多个任务,目标中还定义了所要执行的任务序列。Ant在构建目标时必须调用所定义的任务。任务定义了Ant实际执行的命令。Ant中的任务可以为3类。
(1) 核心任务。核心任务是Ant自带的任务。
(2) 可选任务。可选任务实来自第三方的任务,因此需要一个附加的JAR文件。
(3) 用户自定义的任务。用户自定义的任务实用户自己开发的任务。
Eclipse的集成ANT
打开Eclipse,点击导航栏的"Window"-->"Preferences"-->"Ant"
创建一个java项目
在根目录创建一个build.xml文件
切换默认的Ant版本,Ant的插件管理
- 1、菜单栏中打开Window-Preferences-Ant-Runtime
总共需要设置两项:
1、Ant Home Entries(Default),点击Ant Home,选择ant插件路径:
2、设置Global Entries路径,即为jdk中tools.jar路径
Ant自动化构建
使用ant的主要工作就是配置它的xml文件,默认为build.xml文件。
build.xml的配置参数
1.
每个构建文件都有一个对应
- default:表示默认的运行目标,即指定默认的target(即任务),这个属性是必须的。
- basedir:表示项目的基准目录。
- name:表示项目名。
- description:表示项目的描述。
每个项目对应一个构建文件,但是如果项目比较复杂,包含大量的子项目,每一个子项目都对应有自己的构建文件。
2.
有两个特点:
- 大小写敏感
- 不可改变,谁先设定,之后的都不能改变。
语法:${property}
1 、设置 name 和 value 属性值,比如:
2 、 设置 name 和 refid 属性值,比如:
3 、设置 name 和 location 属性值,比如:
4 、设置 file 属性值,比如:
5 、设置 resource 属性值,比如:
6 、设置 url 属性值,比如:
7 、设置环境变量,比如:
3.
引入别的xml文件,提高复用性
含有相同的 target,最终调用哪个target都是以 调用的那个xml文件为基础。若当前xml中没有target,就会从import中寻找。
4.
任务,一个project标签下有一个或多个target标签,代表任务,任务间可以存在依赖关系。有如下属性:
- name表示目标名,这个属性是必须的。
- depends表示依赖的任务目标。
- if表示仅当属性设置时才执行,用于验证指定的属性是否存在,若不存在,所在target将不会被执行。
- unless表示当属性没有设置时才执行。
- description表示项目的描述。
5.
控制台显示,用于打印/输出信息,类似于log4j的info方法
${msg} hello!
以上四种方式均可以显示相应信息
6.
该标签用于删除文件或文件目录,有如下属性:
- file:删除文件
- dir:删除目录
- includeEmptyDirs:值得是否删除空目录,默认是true
- failonerror:报错是否停止,默认是true
- verbose:是否列出删除的文件,默认是false
7.
该标签用于创建一个目录,它有一个属性dir用来指定所创建的目录名,其代码如下:
通过以上代码就创建了一个目录,这个目录已经被前面的property标签所指定。
8.
该标签用于拷贝文件或文件目录,属性如下:
- file:表示源文件
- tofile:表示目标文件。
- todir:表示目标目录。
- overwrite:是否覆盖目标文件,默认为false
- includeEmptyDirs:是否拷贝空目录,默认为true
- failonerror:如目标没有发现是否自动停止,默认值true
- verbose:是否显示详细信息,默认值false
9.
文件集标签,通常与任务结合来使用,用于批量cope和delete
- dir:指定目录
- include:包含的子目录
10.
用来执行系统命令,或者指定环境的命令
打开命名行,并转到c盘执行dir命令
能够执行系统命令,就相当于可以执行各种环境比如node、gulp、bower等等:
11.
该标签用来生成一个JAR文件,其属性如下
- destfile表示JAR文件名
- basedir表示被归档的文件名
- includes表示被归档的文件模式
- excludes表示被排除的文件模式
该标签用来生成一个WAR包,其属性如下:
- destfile表示生产JAR文件名。
- dir表示被归档的文件目录。
- includes表示别归档的文件模式。
- exchudes表示被排除的文件模式。
12.
该标签用于编译一个或一组java文件,其属性如下
- srcdir表示源程序的目录,必须的
- destdir表示class文件的输出目录,默认是当前文件夹
- include表示被编译的文件的模式
- excludes表示被排除的文件的模式
- classpath表示所使用的类路径
- debug表示包含的调试信息
- optimize表示是否使用优化
- verbose 表示提供详细的输出信息
- fileonerror表示当碰到错误就自动停止
13.
该标签用来执行编译生成的.class文件其属性如下
- classname 表示将执行的类名
- jar表示包含该类的JAR文件名
- classpath所表示用到的类路径
- fork表示在一个新的虚拟机中运行该类
- failonerror表示当出现错误时自动停止
- output 表示输出文件
- append表示追加或者覆盖默认文件
14.
AntCall 任务的作用是允许在一个target的执行过程中调用并执行其他的target,AntCall任务必须在target元素内执行,这个任务不能在target元素外执行。
需要从一个target传递参数到被调用的target时,可以使用 类型进行传递,对于param 类型只有两个属性:name和value
执行sync_module_item任务,并设置参数html.dir的值为org。
该任务定义如下:
或者更为简单的表达:
15.
并行执行多个子任务
通过failonany控制如果一个失败,则不执行。通过并行执行,来提升性能,降低构建花费的时间
**16.
用于正则的定义的使用,可以与matches结合使用。
比如,定义正则:
通过pattern指定正则内容,通过id标识。
在需要匹配的时候,使用之:
**17.
用来判断,如果包含的内容符合条件,则将property指定的属性设置为true,否则为false。
比如上面的例子中,就是将basedir变量的值和regexp_env_test对应的正则匹配,如果正确,就将is_test设置为true,然后后面的流程再去判断。
与之配合的标签有很多,下面一一介绍:
- istrue,isfalse:断言
只有is_test和is_backend变量的值均为true,is_test_backend的值才为true。
- and:逻辑与,需要都满足条件才行,如上例所述。
- not:逻辑非,反过来的结果。
- or,xor:逻辑或和逻辑异或。
- isset:指定属性是否存在:
- equils:指定属性是否相等:
- filesmatch:指定文件是否相等:
实例
builds, tests, and runs the project.
==================================================
显示项目基本信息.
项目名称: ${project.name}
项目版本: ${project.version}
作者 : ${author}
时戳 : ${dstamp}-${tstamp}
用法:
ant -buildfile build.xml compile 或
ant compile 或
ant 甚至
ant clean dist
帮助:
ant -projecthelp
==================================================
==================================================
创建各种文件夹.
==================================================
==================================================
生成帮助文档.
==================================================
==================================================
编译所有源程序.
==================================================
==================================================
运行所有测试程序.
==================================================
==================================================
生成分发文件:
${dist.jar}
==================================================
==================================================
把文件部署到指定位置:
${deploy.war}
==================================================
模板
以下xml依次定义了init(初始化),compile(编译),test(测试),doc(生成文档),pack(打包)任务,可以作为模板
***********************************************************
**** One or more tests failed! Check the output ... ****
***********************************************************
Hello, test]]>
All Rights Reserved.]]>