Ant的安装与使用

ゝ一纸荒年。 2022-06-07 10:20 176阅读 0赞

**下载与安装**

*  在ant.apache.org可以找到下载的界面，根据推荐下载1.10.1的版本。
 *  解压到安装目录，解压后的目录有manual文件夹，包含Ant工具相关文档。
 *  ant的运行需要JAVA\_HOME环境变量指向jdk，以及ANT\_HOME的环境变量指向Ant的安装路径。需要识别ant.bat命令，还需要吧%ANT\_HOME%\\bin 加到Path环境变量中。
 *  使用ant工具只要输入ant或者ant.bat，Ant会在目录下搜索build.xml文件，作为生成文件执行默认的target。
 *  使用-s 或者-find ，Ant会在上级目录中搜索生成文件，直到到达文件系统根目录。
 *  ant也可以使用-buildfile使用其他文件作为生成文件，这里的-buildfile也可以使用-file或者-f代替。如下：

ant -f a.xml
    ant -file b.xml

*  ant运行只提示少量信息：-quite或者-q
 *  ant运行提示更多信息：-verbose或者-v
 *  ant运行将提示信息输出到指定文件，而不是直接输出到控制台，-logfile 或者-l，例如：

ant -verbose -l a.log  //运行ant时生成更多提示信息，并将信息输出到a.log中

*  使用类似-D=可以将指定value来覆盖property的属性值。

ant -Dbook=Spring4 //覆盖生成文件中的book属性
    ant -Denvl=%ANT_HOME%   //这样可以使用Windows的环境变量，在生成文件中，可以使用$envl来访问该环境变量的值

*  ant -help获取帮助文档
 *  典型的项目层次结构：

<priject>
        -src:源文件、配置文件     -classes:编译后的class文件     -lib:第三方jar包     -dist:存放项目打包、项目发布文件的文件夹     build.xml:Ant生成文件

*  Ant生成文件的根元素是project，每个项目下可以定义多个生成目标，每个目标使用target元素来定义。project元素的属性包括：

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>default</td> 
   <td>默认target</td> 
  </tr> 
  <tr> 
   <td>basedir</td> 
   <td>指定项目的基准路径</td> 
  </tr> 
  <tr> 
   <td>name</td> 
   <td>项目名</td> 
  </tr> 
  <tr> 
   <td>description</td> 
   <td>项目描述信息</td> 
  </tr> 
 </tbody> 
</table>

*  target元素的属性

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>target名称</td> 
  </tr> 
  <tr> 
   <td>depends</td> 
   <td>指定一个或多个target，表示运行该target之前需要运行的target</td> 
  </tr> 
  <tr> 
   <td>if</td> 
   <td>指定一个属性名，表示仅当设置了该属性才执行该target</td> 
  </tr> 
  <tr> 
   <td>unless</td> 
   <td>设置一个属性名，表示仅当没有设置该属性才执行该target</td> 
  </tr> 
  <tr> 
   <td>description</td> 
   <td>描述信息</td> 
  </tr> 
 </tbody> 
</table>

*  每个生成目标（target）可以对应一个或多个任务序列，如：`<name attribute1="value1" attribuute2="value2">`name为任务的名称，attribute和value为执行该任务需要的属性名与属性值。

以下是一份[《轻量级JAVAEE 企业应用实战的》][JAVAEE]的生成文件：

<?xml version="1.0" encoding="GBK"?>
    
    <project name="antQs" basedir="." default="">
        
        <property name="src" value="src"/>
        <property name="classes" value="classes"/>
        <property name="dest" value="dest"/>
        
        <path id="classpath">
            <pathelement path="${classes}"/>
        </path>
        
        <target name="help" description="打印帮助信息">
            <echo>help - 打印帮助信息</echo>
            <echo>compile - 编译Java源文件</echo>
            <echo>run - 运行程序</echo>
            <echo>build - 打包JAR包</echo>
            <echo>clean - 清除所有编译生成的文件</echo>
        </target>
        
        <target name="compile" description="编译Java源文件">
            
            <delete dir="${classes}"/>
            
            <mkdir dir="${classes}"/>
            
            <javac destdir="${classes}" debug="true" includeantruntime="yes" deprecation="false" optimize="false" failonerror="true">
                
                <src path="${src}"/>
                
                <classpath refid="classpath"/>
            </javac>
        </target>
        
        <target name="run" description="运行程序" depends="compile">
            
            <java classname="lee.HelloTest" fork="yes" failonerror="true">
                <classpath refid="classpath"/>
                
                <arg line="测试参数1 测试参数2"/>
            </java>
        </target>
        
        <target name="build" description="打包JAR文件" depends="compile">
            
            <delete dir="${dest}"/>
            
            <mkdir dir="${dest}"/>
            
            <jar destfile="${dest}/app.jar" basedir="${classes}" includes="**/*.class">
                
                <manifest>
                    <attribute name="Main-Class" value="lee.HelloTest"/>
                </manifest>
            </jar>
        </target>
        
        <target name="clean" description="清除所有编译生成的文件">
            
            <delete dir="${classes}"/>
            <delete dir="${dest}"/>
        </target>
    </project>

[JAVAEE]: https://baike.baidu.com/item/%E8%BD%BB%E9%87%8F%E7%BA%A7Java%20EE%E4%BC%81%E4%B8%9A%E5%BA%94%E7%94%A8%E5%AE%9E%E6%88%98%EF%BC%9AStruts%202+Spring%203+Hibernate%E6%95%B4%E5%90%88%E5%BC%80%E5%8F%91/12978676?fr=aladdin&fromid=12073612&fromtitle=%E8%BD%BB%E9%87%8F%E7%BA%A7Java+EE%E4%BC%81%E4%B8%9A%E5%BA%94%E7%94%A8%E5%AE%9E%E6%88%98