Ant：build.xml 结构

•  Ant build.xml 结构

1. • project
   • target
   • task
   • data
     • property
     • datatype

 

Ant build.xml 结构

 

最基本的build.xml结构：

<?xml version="1.0" encoding="UTF-8" ?>

<project name="test" default="main">

    <property name="test.prop1" value="hello, java"/>

    <target name="main">

       <echo>${test.prop1}</echo>

    </target>

</project>

根元素是project，project下可以包括多个target，每个target下可以有多个task。

另外还可以指定task在执行过程中使用的数据，例如property。

 

build.xml的基本结构就是：project、target、task、datadef。

下面就针对这些元素分别说明：

 

project

    每个ant的构建文件（build.xml）都必须以project元素做为根元素，

 

属性	描述	必要
name	名称	否
default	指定默认的target	否
basedir	计算build.xml中路径的基路径。默认值是build.xml文件所在的目录。	否

 

 

target

    一个target包括多个task，通过多个task来达成想要的目标。一个target可以依赖于其它的targets。

   

<target name="A"/>

<target name="B" depends="A"/>

<target name="C" depends="B"/>

<target name="D" depends="C,B,A"/>

假如要执行D目标，实际上的执行过程是这样的：

Call-Graph:  A --> B --> C --> D

 

Target的属性说明：

Attribute	Description	Required
name	名称	Yes
depends	指定依赖，用逗号分隔	No
if	如果一个property name,那么这个property的值必须被设置。 如果不是属性名，应该是一个可以被计算为true的表达式。	No
unless	如果一个property name,那么这个property的值必须没有被设置。如果不是属性名，应该是一个可以被计算为false的表达式。	No
description	描述	No
extensionOf	Adds the current target to the depends list of the namedextension-point. since Ant 1.8.0.	No
onMissingExtensionPoint	What to do if this target tries to extend a missing extension-point. ("fail", "warn", "ignore"). since Ant 1.8.2.	No. Not allowed unless extensionOf is present. Defaults to fail.

 

 

示例：

<?xml version="1.0" encoding="UTF-8" ?>

<project name="test" default="main">

    <property name="test.prop1" value="hello, ant"/>

    <target name="main" depends="IF_SET,IF_UNSET,UNLESS_SET,UNLESS_UNSET">

        <echo>${test.prop1}</echo>

    </target>

    <property name="test.a" value="hello, ant"/>

    <target name="IF_SET" if="test.a">

       <echo>IF_SET</echo>

    </target>

    <target name="IF_UNSET" if="test.b">

       <echo>IF_UNSET</echo>

    </target>

 

    <target name="UNLESS_SET" unless="test.a">

       <echo>UNLESS_SET</echo>

    </target>

    <target name="UNLESS_UNSET" unless="test.b">

       <echo>UNLESS_UNSET</echo>

    </target>

 

</project>

 

执行结果：

 

IF_SET:

     [echo] IF_SET

 

IF_UNSET:

 

UNLESS_SET:

 

UNLESS_UNSET:

     [echo] UNLESS_UNSET

 

main:

     [echo] hello, ant

 

BUILD SUCCESSFUL

Total time: 0 seconds

 

 

task

task代表一个任务，target由一系统的task组成。

每个task都有3个属性：

Attribute	Description	Required
id	task实例的id，用于在其它地方引用这个任务时使用	No
taskname	task实例的别名，在执行task时，如果指定了，日志中可以看到别名	No
description	任务说明	No

 

示例：

<?xml version="1.0" encoding="UTF-8" ?>

<project default="hello">

    <target name="hello">

       <echo taskname="echoMessage" id="echo_01">Hello, execute Ant task : [echo]</echo>

    </target>

</project>

 

结果：

 

hello:

[echoMessage] Hello, execute Ant task : [echo]

 

BUILD SUCCESSFUL

Total time: 0 seconds

 

Ant内置了很多的task，可以在官方手册里找到：

http://ant.apache.org/manual/，另外官方手册中，也对这些Ant任务进行了归类：

data

    Ant的task要执行，必不可少的是要使用数据。我将数据类型大致的分为几类：properties、path、fileset、selector、其他类型。

这些数据内容，将在下一次说明。

　　·Property

　　·datatype