一. 配置环境变量
1. 添加ANT_HOME——Ant目录;(可选)
2. 在PATH追加"Ant目录/bin"
3.在控制台cmd输入命令ant,提示
“Buildfile: build.xml does not exist!
Build failed“
表示系统能够识别ant 命令了,这样可以在任意文件夹下运行该命令。
二. build.xml文件的组成
build.xml文件的主干是,一个根结点project,project里面包含多个target,target内含不同的task。
Ant的大概运行过程
当运行ant命令,则尝试读取当前目录的build.xml,分析xml文件,按照project的default属性,执行指定的target。
当运行ant targetname,则在读取xml文件后,分析找到相应的target并执行。
1.project根结点 基本属性:name、default、basedir。
name: 项目名称(可选)
default: 默认开始执行的target。(必需)
basedir: 用于计算所有其他路径的基路径。可以被basedir property覆盖。当覆盖时,该属性被忽略。如果属性和basedir property都没有设定,就使用build.xml的父目录。一般basedir=".",设置为build.xml所在的目录。(可选)
2.target
Attribute属性 Description属性值内容 Required name target的名字 Y depends 需要依赖的其他target N description 关于target功能的简短描述 N if 为了执行本target而被设置的属性的名字 N unless 为了执行本target而不被设置的属性的名字 N
2.1 依赖关系depends <target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
当执行target D,则先执行A,再B,然后C,最后D。
一个target只能被执行一次,即使有多个target依赖于它。
2.2 if,unless
if属性表示该属性内容的变量如果已经被设置了,则可以执行本target;
unless属性则表示该属性内容的变量如果还没有被设置,则可以执行本target。
伪代码:
//if="ready" //unless="ready"
if(ready == "ok"){ if(ready == null){
execute target; execute target;
}else { }else {
skip; skip;
} }
如果没有if或unless属性,target总会被执行。
2.3 description属性
可选的description属性可用来提供关于target的一行描述,可由-projecthelp命令行选项输出
3. task
常用的task:
3.1 创建目录mkdir 创建一个目录,如果其父目录不存在,也会被同时创建。
<mkdir dir="build/classes"/>
<target name="init">
<mkdir dir="${dist.dir}" />
<mkdir dir="${dist.classes.dir}" />
<mkdir dir="${dist.webapps.dir}" />
</target>
3.2 删除目录delete
<delete includeEmptyDirs="true">
<fileset dir="${build}"/>
</delete>
<target name="clean" description="clean up" >
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>
3.3 copy文件或目录
<copy file="file" tofile="file.bak"/>
<copy file="config.xml" todir="${dist.classes.dir}"/>
<copy todir="${targetdir}">
<fileset dir="${sourcedir}"/>
</copy>
<target name="copy-resources" depends="clean">
<copy todir="${targetdir}">
<fileset dir="${sourcedir}">
<exclude name="**/**/*.java" />
</fileset>
</copy>
</target>
3.4 move文件或目录
<move file="file" tofile="file.bak"/>
<move todir="${targetdir}">
<fileset dir="${sourcedir}"/>
</move>
<move todir="${targetdir}">
<fileset dir="${sourcedir}">
<include name="**/**/*.java" />
</fileset>
</move>
3.5 compile <path id="libraries">
<fileset dir="${libdir}">
<include name="*.jar" />
</fileset>
</path>
<target name="compile" depends="copy-resources">
<javac srcdir="${sourcedir}"
destdir="${targetdir}"
classpathref="libraries" />
<jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>
</target>
3.6 jar <jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>
<jar destfile="${dist}/lib/app.jar">
<fileset dir="${build}/classes"
excludes="**/Test.class"
/>
<fileset dir="${src}/resources"/>
</jar>
3.7 java
Ant中可以使用java任务实现运行Java程序的功能。下面在1的例子中进行如下的修改,修改后的build.xml文件的内容如下:
<?xml version="1.0"?>
<projectname="javaTest"default="jar"basedir=".">
<targetname="clean">
<deletedir="build"/>
</target>
<targetname="compile"depends="clean">
<mkdirdir="build/classes"/>
<javacsrcdir="src"destdir="build/classes"/>
</target>
<target name="run"depends="compile">
<java classname="HelloWorld">
<classpath>
<pathelement path="build/classes"/>
</classpath>
</java>
</target>
4. 变量property
<property name="sourcedir" value="${basedir}/src" />
<property name="build" location="build" />
除了可以使用自定义的变量,还可以使用java系统属性, 例如${os.name}对应操作系统的名字,以及Ant内置属性:
basedir <project>的basedir属性
ant.file buildfile的绝对路径
ant.version Ant的版本
ant.project.name 当前执行的project的名字;由<project>的name属性设定
ant.java.version Ant检测到的JVM的版本
5. build.xml example
<?
xml
version
="1.0"
encoding
="UTF-8"
?>
<
project
default
="junitTest"
name
="myProject"
basedir
="."
>
<
property
name
="sourcedir"
value
="${basedir}/src"
/>
<
property
name
="targetdir"
value
="${basedir}/WEB-INF/classes"
/>
<
property
name
="libdir"
value
="${basedir}/WEB-INF/lib"
/>
<
path
id
="libraries"
>
<
fileset
dir
="${libdir}"
>
<
include
name
="*.jar"
/>
</
fileset
>
</
path
>
<
target
name
="junitTest"
depends
="compile"
>
<
java
classname
="junit.textui.TestRunner"
>
<
classpath
>
<
path
refid
="libraries"
/>
<
path
location
="${targetdir}"
/>
</
classpath
>
<
arg
value
="can.junit.HibernateDemoTest"
/>
</
java
>
</
target
>
<
target
name
="compile"
depends
="copy-resources"
>
<
javac
srcdir
="${sourcedir}"
destdir
="${targetdir}"
classpathref
="libraries"
/>
</
target
>
<
target
name
="copy-resources"
depends
="clean"
>
<
copy
todir
="${targetdir}"
>
<
fileset
dir
="${sourcedir}"
>
<
exclude
name
="**/**/*.java"
/>
</
fileset
>
</
copy
>
</
target
>
<
target
name
="clean"
>
<
delete
dir
="${targetdir}"
/>
<
mkdir
dir
="${targetdir}"
/>
</
target
>
</
project
>