ant使用手册

ant安装：

下载Apache ant，然后将bin目录添加到path。临时使用可以设置临时环境变量：

Windows:

set ANT_HOME=f:\ant
set PATH=%PATH%;%ANT_HOME%\bin

Linux:

export ANT_HOME=/usr/local/ant
export PATH=${PATH}:${ANT_HOME}/bin

ant命令：

执行ant：将ant文件保存为build.xml，则在当前目录输入ant即可执行build.xml。如果使用其他名字，则使用 ant 文件名 即可执行ant文件。

基本格式：

<project name="Tutorial" default="welcome" basedir=".">

<!-- Property -->
<property name= "AUTHOR" value= "Geurney"/>

<!-- welcome -->
<target name="welcome" description="Basic Information">
<echo message="Author: ${AUTHOR}"/>
</target>

<!-- greeting -->
<target name="greeting" description="Basic Information" depends="welcome">
<echo message="How are you?"/>
<input message="Press Return key to continue..."/>
</target>

</project>

其中default是指当执行ant命令时默认首先执行welcome这个target，如果想执行greeting这个target，则输入 ant greeting 。depends是指先执行depends的target，再执行本target。

输入任务和条件任务：

<!-- input task & condition task -->
<target name="input" description="Input test">
<input
message="Yes or No (y/n)?"
validargs="y,n"
addproperty="choice"
defaultvalue="y"
/>
<condition property="choiceIsNo">
<equals arg1="n" arg2="${choice}"/>
</condition>
<echo message="${choice} is ${choiceIsNo}"/>
<fail if="choiceIsNo">Build aborted by user.</fail>
</target>

1. validargs是允许的输入，addproperty是将输入生成一个新的property，defaultvalue是默认值。
2. condition的property是只有当条件满足才会生成这个property，上面的是当arg1和arg2相等时，才生成choiceIsNo这个property，其值为true。

3. fail当条件满足时，终止并退出build。

创建文件夹/拷贝文件/删除文件夹：

<property name="filepath" location="test.txt"/>
<property name="directorypath" location="testdir/"/>
<target name="filetest">
<mkdir dir="${directorypath}"/>
<copy file="${filepath}" todir="${directorypath}"/>
<copy file="${filepath}" tofile="${directorypath}/tt.txt"/>
<delete dir="${directorypath}"/>
</target>

java任务：

编译java文件：

<!-- Compile Star -->
<property name="StarJavaPath"  location="src/p2"/>
<property name="StarClassPath" location="classes2"/>
<target name="compile-star">
<javac srcdir="${StarJavaPath}" destdir="${StarClassPath}" includeantruntime="false"/>
</target>

直接使用srcdir，将该目录下的所有java文件编译。注意StarJavaPath是到java文件地址的（进入包了）。

另一种编译方式：

<!-- Compile Universe -->
<property name="UnivereJavaPath"   location="src/p1"/>
<property name="UniverseClassPath" location="classes1"/>
<property name="UniverseJarPath"   location="jar/Universe.jar"/>
<target name="compile-universe">
<javac destdir="${UniverseClassPath}" includeantruntime="false">
<src path = "${UnivereJavaPath}"/>
<include name="Universe.java"/>
<include name="Sun.java"/>
<classpath>
<pathelement location="${StarClassPath}"/>
</classpath>
</javac>

<jar destfile="${UniverseJarPath}">
<fileset dir="${UniverseClassPath}" includes="p1/*.class"/>
<fileset dir="${StarClassPath}"     includes="p2/*.class"/>
<manifest>
<attribute name="Implementation-Vendor"  value="${AUTHOR}"/>
<attribute name="Implementation-Version" value="${VERSION}"/>
<attribute name="Main-Class" value="p1.Universe"/>
</manifest>
</jar>
</target>

这里使用了src和include的组合添加java文件，可以使用多组src、include。classpath可以使用多个pathelement。jar使用了fileset和manifest。

运行universe：

<!-- Run Universe -->
<target name="run-universe">
<java jar="${UniverseJarPath}" fork="true">
<arg value="hello!"/>
</java>

<java classname="p1.Universe" fork="true">
<classpath>
<pathelement location="${UniverseJarPath}"/>
<fileset dir="jar"  includes="Universe.jar"/>
</classpath>
</java>
</target>

两种运行方式，第一种使用jar，可以使用多个arg传入参数。第二种使用classpath，既可以用pathelement也可使用fileset来指定文件。

生成javadoc：

<!-- Generate javadoc -->
<target name="javadoc" description="create javadocs">
<javadoc packagenames="p1.*, p2.*" sourcepath="src" destdir="javadocs" />
</target>