Jenkins ant介绍(学习笔记五)
转载自：https://www.cnblogs.com/pixy/p/4792887.html
Ant的由来（序）
James Duncan Davidson当年用纯Java开发Tomcat的时候，不仅想让它跨平台运行，还想要在不同的操作系统上都能够进行开发和构建。这种较大的项目的编译构建过程是很复杂，需要用到很多工具和脚本（比如GNU make，Shell脚本，批处理文件等等）处理资源、处理依赖项、控制编译过程、打包（Jar，War），某些特别的Java技术如EJB、RMI在编译打包时还需要特别处理。James尝试了很多工具和方案，最后的结论就是太TM难用了。
首先是慢。举个栗子，编译java代码要用javac，javac其实就是包装了下java用于编译的Java工具类（JDK工具都是用纯Java写的，JDK目录下的那些exe文件实际上都是调用Java类来实现具体功能的）。但是用make，shell这些工具每次调用javac，都要开新进程创建新的VM实例，如果每编译一个文件调用一次javac，开销就老大了，不慢才怪呢。调用命令后还必须要解析控制台输出信息才能知道执行情况，更不可能使用Java提供的异常和错误信息来确定执行状态。
然后是累。make，shell脚本要跨平台太困难，在不同的系统上要用不同的版本；而且要编写shell脚本和make脚本（make只是shell基础上的语言扩展），得有linux编程基础，门槛还是比较高的；这类脚本编写起来容易出错（Makefile的tab问题能烦死人），难以调试。总之，如果构建过程用了一堆这样的脚本，维护起来肯定是又烦又累。慢的问题还能通过一次编译一批文件来缓解，但这个问题可就无解了。
James实在受不了了，就自己用Java开发了一个小工具，就是Ant，用来编译和打包Java项目。构建中用到JDK中工具时都是直接调用Java类，而不是从命令行调用，慢的问题就解决了。构建中直接向Java编译类提供或获取数据，编译过程中有什么问题，也能进行错误或异常处理。因为是用Java写的，天然就是可以跨平台的使用的。Ant从配置文件中读取数据来控制构建过程，刚开始的时候用Properties文件，但是Properties文件难用表达比较复杂的层次结构关系，当他把Ant解决方案设计成"工程-目标-任务"的层次结构时，改用XML作为构建配置文件，XML文件是很好理解和掌握的，学习门槛变得非常低。再后来又利用反射功能，支持自定义任务，Ant的功能就不再仅限于构建Java项目了，可以使用在更广泛的场合。至此Ant就基本成型了。
James完成这个工具之后，自己用着很爽并且在网上共享，然后就没怎么再关注了，直到后来有一天忽然发现老多人都已经在用他的这个杰作了。James说他很庆幸当时没有把精力一直花在这上面，否则可以能会不自觉的加入很多更本不必要的功能，让Ant变得臃肿复杂，反而不好了。
这个故事除了说了Ant的来源和特点外，还有一点启示：如果遇到问题，已有的工具都不能满足需求，就应当另找一个。如果不存在这样的工具，就自己动手创建一个。然后与大家共享，其他数以千计的人可能有着类似的难题。
第一章 Ant入门
ant的使用非常简单：安装好Ant后（最好配置Path环境变量），在构建文件中（默认名字为build.xml）配置好构建任务，然后调用ant命令，配置的任务就开始执行了。
1.编写构建文件
创建一个用于编译和打包Java项目的配置文件build.xml（名字可以随便起，如mybuild.xml，执行的时候用-f 选项指定这个文件就可以）：
这个配置文件很好理解，用任何文本编辑器都能编写，只要保证是一个合法的XML文件并且用了正确的标签和属性，就可以使用ant运行。
根据这个配置文件就可以看出。Ant把任何任务都分成了3层。
最顶层的Project
目标Target（可以在ant命令中调用的基本单位）。如clean, compile, jar 等，在命令行可以这样调用：ant clean或 ant clean jar。Target之间可以存在依赖关系，一个Target执行前会先执行它依赖的那些Target。Project可以设置一个默认的Targe， ant命令中不指定任何target时就调用这个默认的。
任务Task。
各种Task可以执行各种不同的具体任务。如mkdir, delete, javac, jar等。Task可以分3种，核心任务和可选任务有100多种，常用的功能全都覆盖了
核心Task。Ant内置的任务
可选任务。第三方提供的，把相应的Jar包放到Ant安装目录的lib目录下就能使用。
自定义任务
Task详细说明可以查看官方文档：http://ant.apache.org/manual/tasklist.html
Ant文件中还能用Property标签配置属性值，在定义之后的其他地方就可以引用，避免硬编码。
所有的构建文件都要有且只能有一个元素，其中至少要有一个 元素。project的defualt属性没有默认值，如果这个属性没有设置，不指定Target运行ant不会调用任何target。
2.运行Ant
ant命令语法如下，详细选项说明列在后面。
ant [option [option...]] [target [target...]]
调用Ant时默认会在当前目录中查找默认的构建文件名：build.xml。
当然也可以用ant -f buildfile的方式手动指定构建文件（-f, -buildfile, -file都是等效的）。
调用Ant时可以指定一个或多个要执行的Target。如果不指定就调用Project标签default属性中配置的默认Target(上面这个例子中就是compile目标)。
以上面的构建配置文件为例，下面的几种调用都可以：
ant调用默认构建文件(build.xml)中的默认目标(compile)ant -f mybuild.xml jar调用构建文件mybuild.xml中的jar目标ant clean jar调用默认构建文件(build.xml)中的clean和jar目标。需要注意多个目标会按调用先后顺序执行。如果调用ant jar clean就是先编译打包(jar)，然后全清理掉(clean)，就白干了。
Ant执行时会按执行顺序显示每个Target的名字，也会显示每个任务的名字（[任务名]）和任务中输出的信息。直接调用ant的输出结果为：
Buildfile: e:\wsJava\AntDemo\build.xml
clean:
[delete] Deleting directory e:\wsJava\AntDemo\build
prepare:
[mkdir] Createddir: e:\wsJava\AntDemo\build
[mkdir] Createddir: e:\wsJava\AntDemo\build\classes
[mkdir] Createddir: e:\wsJava\AntDemo\build\lib
compile:
[javac] Compiling 2 sourcefilesto e:\wsJava\AntDemo\build\classes
jar:
[jar] Building jar: e:\wsJava\AntDemo\build\lib\antDemo.jar
all:
BUILD SUCCESSFUL
Total time: 0 seconds
3.查看构建文件中所有目标
构建文件中的目标description属性可有可无，除了方便人看外没什么卵用。有没有这个属性叫法也不一样的（没有实际作用），有该属性的叫主目标，没有的叫子目标。下面这个命令可以列出构建文件中的所有目标和description信息。
ant [-f BUILDFILE] -projecthelp
4.Ant命令选项
-h, -help 查看帮助信息
-p, -projecthelp 查看构建文件中的所有目标信息
-version 显示Ant版本
-q, -quiet 抑制并非由构建文件中echo任务所产生的大多数输出消息
-S, -silent 只显示Task输出和构建失败信息
-v, -verbose 显示构建过程中每个操作的详细消息， 不能和-debug同时使用
-d, -debug 显示Ant和任务开发人员已经标志位调试信息的消息。不能与-verbose同时使用
-e, -emacs 对日志消息进行格式化，使其能够Emacs的shell模式解析。具体就是打印任务消息时不缩排也不输出前面的 [任务名]
-diagnostics 显示对调试有用的信息
-f , -buildfile , -file 指定一个构建文件，而不是使用默认的build.xml
-D=通过命令行向构建过程中传递属性值
-propertyfile 从property文件中加载属性值并传递到构建过程
-s , -find 指定Ant应当使用的构建文件，如果指定的filename文件在当前目录中没找到，就到父目录中进行搜索，直到到达文件系统的根，还找不到则构建失败。
-k, -keep-going 执行不依赖失败目标的所有目标。
-lib 指定查找jars和classes的目录
-l , -logfile 将日志重定向到指定文件
-logger 指定一个类来处理Ant的日志记录。该类必须实现了org.apache.tools.ant.BuildLogger接口
-listener 为Ant设置一个监听类，将其增加到Ant的监听器列表中。Ant与IDE或其他程序集成时非常有用，后面会专门写这个。
-inputhandler 指定用于处理输入请求的类
-main 覆盖Ant正常的入口点
-noinput 不允许交互式输入
-autoproxy Java1.5+，使用OS的代理设置
-nice number
-nouserlib
-noclasspath
第二章 安装和配置
基本使用
下载ant发布包
解压缩到一个目录既可
将该目录下的子目录bin添加到PATH环境变量
高级配置
留坑待填....
第三章 构建文件
构建文件需要根据具体项目的特性编写，不过同一类型的项目基本上是可以使用一套构建配置的。
Java提供了用于构建的Java工具库，使用Java语言编写Ant是最容易实现和维护的。XML有丰富的解析类库，并且被开发人员广泛使用，也能够表达Ant的数据模型，使用XML作为构建文件时最好的选择。
XML是一种树形的文档对象模型（DOM），其中的Project，Target等元素与Ant的模型组件相对应。
1.Ant的构建块
Project（工程） 任何构建文件的第一个元素必须是标签，而且只能有一个。
name属性 工程的名字，也是构建文件的标识符。
default属性 运行Ant不指定Target时，默认执行的Target。可以设置成一个构建文件中定义的Target名字。推荐默认Target显示构建文件的帮助信息或者执行完成的构建。
basedir属性 定义工程的根目录，一般情况下都是" . "，也就是构建文件所在的目录（不是运行Ant命令是的目录）。在一个多层次的项目中，basedir还可以定义不同的参考点。
Target（目标） 一个Project可以包含多个Target，一个总的任务过程可以拆分成几个target，每个Target可以单独调用。可以把target理解成能够单独执行的一个个步骤（阶段）。具体怎么拆分这个总任务，拆分粒度是粗还是细，把哪些Task放在哪几个Target中，都是编写构建文件要考虑的问题。一般来说，粒度更小可以更灵活的组合，有些target失败也不会影响另一些的执行。但是粒度也不能太小，太小了会很琐碎不好维护。
name属性
depends属性
description属性
前面的build.xml实例中，编译打包拆成了两个target，如果每次这两个target都是一起被调用的，把他们放在一个target中也是可以的。
Task（任务） 任务是构建文件中的最小构建单位。通过Target把一个总过程组织成了几个大的Target目标（步骤），但是Target并不做任何具体的工作，Target下面有包含一些Task，所有的具体工作都是靠这些task来完成。Ant提供非常多的Task，如编译，大包，文件系统操作等等。Ant中每个任务对应于Ant对象模型中的一个Java对象，要自定义新的任务就是要编写执行该任务类然后提供给Ant调用。很多系统命令也都是用Task包装，而不是直接调用shell命令，在不同的操作系统上Task的使用方式是完全一致的。
构建文件中任务标签内部也可以有很多层次。但是Task内部的这些层次结构和Java类的层次结构没有任何关系了。
Task标签不再有统一的属性和子元素，内部层次完全取决于具体的任务。
2.数据元素（data element）
构建文件中除了与任务构建过程相关的元素外。还包括了保存数据的变量和抽象数据类型等元素。数据元素有两类：Property和DataType
Property
表示字符串型的“键-值”对，只能用在可使用字符串的位置。
Propery和Java中的Property对象是兼容的，可以使用Property文件或JVM命令行-Dproperty=value选项，在运行ant时动态定义。
可以使用${propName}的形式引用Property数据。
property数据定义和引用
加载config.properties文件中定义的property数据
通过命令行在运行时动态定义propery数据
ant mytarget -Dname=value
DataType
Property数据值都是字符串，ant并不知道这些字符串代表了什么对象。如果将包含很多个Jar文件的长串路径保存在Property数据中，就很容易出错，修改也不方便。
Ant还提供了很多种具体的数据类型（DataType），各种数据类型能够更清晰地描述特定类型的数据，如Path（路径）, FileSet（文件集合，可以使用通配符）等，修改起来更加方便。
使用Property表示路径和使用Path/FileSet对象表示路径的对比：
３.工程结构和构建文件
要编写工程的构建文件，必须要了解项目的结构。项目类型不同，项目结构往往存在较大的差异（如Web项目和GUI项目），没有最佳的工程组织模式。工程结构是比较复杂的，需要考虑跨平台（使用相对路径），依赖自包含无外部需求，功能模块和不同类型文件分离等等。
以下面的项目结构为例：
projectName
build.xml 构建文件
src/
api
module
doc/ 项目相关文档（非JavaDoc文档，不能自动生成），如readme，license等
lib/ 依赖的外部库，统一依赖
bin/ 可选目录，包含安装、执行等脚本或者是难找的、定制的可执行工具（为跨平台，最好不要使用可执行程序）
build/ 构建产出目录
classes/
doc/ javadoc产出
lib/
bin/
dist/ 最终用于发布的目录（内容一般都是从其他目录复制而来）
lib/
bin/
doc/
config/
编写构建文件
