Ant之build.xml配置详解

前言
国内关于build.xml的配置资料太零散了，实在是受不了，故而将自己的笔记整理成博文，方便大家查阅和理解。

build.xml配置参数
构建文件默认叫build.xml，其有很多配置参数。

project
每个构建文件都有一个project标签，有以下属性：

• default：表示默认的运行目标，这个属性是必须的。
• basedir：表示项目的基准目录。
• name：表示项目名。
• description：表示项目的描述。

如下：

每个项目对应一个构建文件，但是如果项目比较复杂，业务线比较多，则有可能对应很多个构建文件，比如：

这时我们需要注意，每个构建文件都需要以project标签包含起来。

property
类似于常量，可以供给build.xml中的其他标签使用。有两个特点：

• 大小写敏感
• 不可改变，谁先设定，之后的都不能改变。

该标签可以与多个属性配合使用。

• name和value:
  
  后面直接使用即可：
  
• name和refid:
  
  其中的dao.compile.classpath在别的地方进行了定义。当然，也可以通过直接引用的方式：
  
• name和location:
  
  将srcdir的值设置为当前文件路径/src。
• file:
  
  导入相对文件中的所有变量，这里的build.properties专门用来存放各种变量，示例如下：

url:

导入对应文件的属性
environment:

设置系统的环境变量前缀为env。比如

将系统的tomcat安装目录设置到tomcat.home属性中。
import
引入别的xml文件，提高复用性：

1 2 甚至可以批量匹配： 1 2 3 4 5 target 任务，一个project标签下有一个或多个target标签，代表任务，任务间可以存在依赖关系。有如下属性： - name：用于标识，这个是必须的 - depends：用来指定所依赖的任务。 1 2 3 4 5 6 7 8 9 10 11 12 13 if：当属性设置时才执行该任务。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 通过判断变量是否存在，执行不同的任务。 - unless：当属性未设置时才执行。 - description：任务描述。

echo
控制台显示

1 delete 删除文件或文件目录，有如下属性 - file：删除文件 - dir：删除目录 - includeEmptyDirs：值得是否删除空目录，默认是true - failonerror：报错是否停止，默认是true - verbose：是否列出删除的文件，默认是false

示例如下：

<target name="clean_other_dir">
    <echo message="begin clean_other_dir..."/>
    <delete dir="${basedir}/${compress.dir}"/>
    <delete dir="${basedir}/pub"/>
    <echo message="begin clean html module-xx..."/>
    <delete includeemptydirs="true">
        <fileset dir="${basedir}/src/html" >
            <include name="**/module-*/**"/>
        </fileset>
    </delete>
    <echo message="begin clean res/module-xx、component-xx、res-base..."/>
    <delete includeemptydirs="true">
        <fileset dir="${basedir}/res" >
            <include name="module-*/**"/>
            <include name="component-*/**"/>
            <include name="res-base/**"/>
        </fileset>
    </delete>
</target>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
mkdir
创建一个目录

1 copy 拷贝文件或文件目录，属性如下： - file:表示源文件。 - tofile:表示目标文件。 - todir:表示目标目录。 - overwrite:是否覆盖目标文件，默认为false。 - includeEmptyDirs:是否拷贝空目录，默认为true。 - failonerror:如目标没有发现是否自动停止，默认值true。 - verbose:是否显示详细信息，默认值false。

示例：

1 2 3 4 5 6 7 8 9 fileset 文件集标签，通常与任务结合来使用，例如上面的copy的demo中，通过将fileset定义的文件路径下的文件，拷贝到todir指定的路径中。 也可以用于批量删除： 1 2 3 4 5 6 7 8 9 10 11 12 13 也就是说，但凡遇到文件集操作，都需要用到fileset标签。

exec
用来执行系统命令，或者指定环境的命令。
比如：

1 2 3 4 5 打开命名行，并转到c盘执行dir命令。

能够执行系统命令，就相当于可以执行各种环境比如node、gulp、bower等等：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 antcall 执行某个定义的任务。 1 2 3 4 5 执行sync_module_item任务，并设置参数html.dir的值为org。 该任务定义如下： 1 2 3 4 5 6 7 8 或者更为简单的表达： 1 2 3 4 5 6 7 8 9 10 parallel 并行执行多个子任务。

<antcall target="build_style"/>

1 2 3 4 5 6 7 8 9 10 11 12 通过failonany控制如果一个失败，则不执行。通过并行执行，来提升性能，降低构建花费的时间。

regexp
用于正则的定义的使用，可以与matches结合使用。
比如，定义正则：

1 2 通过pattern指定正则内容，通过id标识。 在需要匹配的时候，使用之： 1 2 3 4 5 condition 用来判断，如果包含的内容符合条件，则将property指定的属性设置为true，否则为false。 比如上面的例子中，就是将basedir变量的值和regexp_env_test对应的正则匹配，如果正确，就将is_test设置为true，然后后面的流程再去判断。 与之配合的标签有很多，下面一一介绍: - istrue,isfalse:断言 1 2 3 4 5 6 只有is_test和is_backend变量的值均为true，is_test_backend的值才为true。 - and:逻辑与，需要都满足条件才行，如上例所述。 - not:逻辑非，反过来的结果。 - or,xor:逻辑或和逻辑异或。 - isset：指定属性是否存在： 1 2 3 4 equils：指定属性是否相等： 1 2 3 4 filesmatch：指定文件是否相等： 1 2 3 4

————————————————
版权声明：本文为CSDN博主「布瑞泽的童话」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/mevicky/article/details/72828554