在命令行下使用Apache Ant

Apache Ant的帮助文档

离线帮助文档

在<ant的安装目录>/manual下是离线帮助文档

双击index.html可以看到帮助文档的内容：

在线帮助文档

最新发布版本的帮助文档https://ant.apache.org/manual/index.html

Apache Ant的命令

ant命令行格式

ant [options] [target [target2 [target3] ...]]

具体的options可以使用ant -help命令查看。

查看ant的帮助信息

在命令行下输入命令ant -help可以查看帮助信息。例如：

运行ant，如果没有指明参数，则运行project 的default属性指定的target

如果在命令行下直接运行ant，没有指明参数，那么ant会在当前目录下寻找build.xml这个文件，如果找到了，就运行build.xml中project的default属性指定的target。

例如JAX-WS Eclipse参考实现，目录下面有build.xml，project 的default属性指定target是help：

该build.xml文件的片段：

<?xml version="1.0"?>

<project name="XML-WS RI 4.0.0 On Tomcat" default="help" basedir=".">

    <target name="help">
        <antcall target="glassfish-message"/>
        <echo message="Usage:"/>
        <echo message="  ant {install,uninstall}"/>
        <echo/>
        <echo message="$CATALINA_HOME must be set to the installation directory of Tomcat."/>
        <echo/>
        <echo message="install:"/>
        <echo message="  Installs XML-WS RI 4.0.0 on Tomcat"/>
        <echo/>
        <echo message="uninstall: "/>
        <echo message="  Uninstalls XML-WS RI 4.0.0 from Tomcat"/>
        <echo/>
    </target>
</project>

运行ant命令，输出如下：

运行ant，指明了target

例如，target是install，则ant install表示运行install这个target：

注：该目录下有build.xml文件，其中定义了install这个target：

build.xml文件的片段：

<target name="install" depends="update-catalina-props" description="Install XML-WS RI 4.0.0 jars">
    <echo message="Installing XML-WS RI 4.0.0 for ${catalina.home} ..."/>

    <mkdir dir="${catalina.lib.home}"/>
    <copy toDir="${catalina.lib.home}" overwrite="true">
        <fileset dir="${basedir}/lib" includes="*.jar"/>
    </copy>

</target>

<target name="update-catalina-props">
    <echo message="Backing up ${catalina.home}/conf/catalina.properties..."/>
    <copy file="${catalina.home}/conf/catalina.properties" tofile="${catalina.home}/conf/catalina.properties.backup"/>
    <echo message="Adding XML-WS RI jars to shared.loader property in ${catalina.home}/conf/catalina.properties..."/>
    <replace file="${catalina.home}/conf/catalina.properties" token="shared.loader=" value="shared.loader=$${catalina.home}/shared/lib/*.jar,"/>
</target>