日期:2014-05-16 浏览次数:20710 次
? 在上一篇博文中简单介绍了一下Ant是如何编译和发布Java项目,对使用用的一些标签命令也没有做说明,现在该是做说明的时候了。
? 我们都看到了,Ant的构件文件是基于XML的,默认加载执行build.xml,project元素构成了Ant文件的根元素,Ant构件文件至少应该包含一个project元素。在每个project元素下,可以包含多个target元素,target就是Ant构件所要做的事情,现在列个简单的build.xml来加深一下对文件结构的印象:
?
<?xml version="1.0" encoding="UTF-8"?> <project name="helloProj"> <target name="sayHello"> <echo message="Hello,Ant!"></echo><!-- 该标签用于输出指定的文本信息--> </target> </project>
? 进入到指定目录antDemo,在控制台输入ant ,回车:
?
? 相信你一定看出问题了,sayHello没有输出,事实是这样的,一个project元素下有多个target,如果你不在build.xml文件中或者在命令行指定target,那么Ant怎么知道你要去执行哪一个target,所以可通过以下方法解决,project元素有一属性default,就是指定默认执行的target名;另一个方法就是命令行输入ant (指定target);我们采用第一种方式:
?
<?xml version="1.0" encoding="UTF-8"?> <project name="helloProj" default="sayHello"> <target name="sayHello"> <echo message="Hello,Ant!"></echo> </target> </project>
? 所以,在控制台输入ant,并出现了Hello,Ant!的打印信息了。
? 前面我们聊到了,Ant是默认加载执行build.xml,如果我们依个人喜好,没有指定这样的一个默认的build.xml文件,而是指定了build_helloProj.xml,在控制台输入肯定会出错,毫无疑问,那么怎么加载这样一个另指定的文件呢,命令行参数就需要做些少许改变了,可通过如下命令参数
?
ant -f build_helloProj.xml ant -file build_helloProj.xml ant -buildfile build_helloProj.xml
? 命令控制台输出如下信息:
?
? 更具体的命令行参数使用方法,可在控制台输入ant -help/ant -h查看,在此就不列出了。
? Ant的关键元素和常用元素语义说明:
? 1)project:
??? ant构件文件的根元素,这个是必须的元素噢!它的三个属性我们都已经见到过了,分别为name、default、basedir。name属性就是指定project的名称了;default属性用于指定project默认执行的target名称;basedir属性用于指定基路径的位置,没有指定或者指定为".",则为Ant构件文件的附目标作为基准目录。看应用build_showbasedir.xml示例:
?
<?xml version="1.0" encoding="UTF-8"?> <project name="antElementLearnProj" default="printBaseDir" basedir="."> <target name="printBaseDir"> <echo message="The base dir is: ${basedir}"></echo> </target> </project>?
? 结果显示如下:
??
?
? 2)target:
??? Ant的基本执行单元,它可以包含一个或多个具体的执行任务。多个target可以存在相互依赖关系(depends属性),所以,看看它的一些属性:
?? name属性指定target的名称,这是属性是project元素中唯一的;depends属性用于描述多个target之间的依赖关系,被依赖的先执行。比如,我们运行一个java程序之前必须先编译它,所以,我们在运行的target中指定depends依赖于编译的target。如果与多个target存在依赖关系,则要用","间隔。Ant会依照depends属性中的target出现的顺序依次执行每个target;if属性验证执行此target的成立条件;unless属性与if属性相反,验证指定属性为假时所在的target执行;description属性是对此target功能的简短描述和说明,看build_targetElement.xml示例:
?
<?xml version="1.0" encoding="UTF-8"?> <project name="antTargetElementLearnProj" default="target_b" basedir="."> <target name="target_a" if="ant.java.version"> <echo message="Java Version: ${ant.java.version}"/> </target> <target name="target_b" depends="target_a" unless="targetdemo" description="a depend example!"> <echo message="The base dir is: ${basedir}"/> </target> </project>
? 在控制台输入ant -f build_targetElement.xml,显示信息如下图所示:
??
?? 我们运行的是名为target_b的target,因为它依赖于名为target_a的target,所以先执行target_a,运行Ant,java环境肯定存在,所以打印信息:Java Version:1.6。target_a执行完毕之后,接着执行名为target_b的target,targetdemo属性不存在,所以打印出当前的根目录。
? 3)property :
??? 该元素说得直白些,就是一变量,project里的属性可通过property元素来设定,也可在外部引入一文件,例如build.properties(一定程度上可增加系统的维护性,一些开源项目常这么干),可通过如下方式引入:<property file="build.properties"/>。
?? 在引用property元素时,可通过将属性名放在"${"和"}"之间,当然了,Ant本身也提供一些内置属性,另外它也能得到的系统属性列表与Java文档中的System.getProperties()方法得到的属性一致,Ant的内置属性包括basedir()、ant.file、ant.version、ant.project.name、ant.java.version,下面我们来看一个简单的property示例build_proper