Ant 简易教程

标签：

Apache Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java环境中的软件开发。由Apache软件基金会所提供。

Ant是纯Java语言编写的，所以具有很好的跨平台性。

一、下载和安装

1.1 下载

ant的官方下载地址：http://ant.apache.org/bindownload.cgi

进入页面后，在下图的红色方框中可以下载最新版本。笔者下载的版本是 apache-ant-1.9.4。

 

1.2 配置环境变量

配置环境变量（我的电脑 -> 属性 -> 高级 -> 环境变量）。

设置ant环境变量：

ANT_HOME    C:/ apache-ant-1.9.4

path               C:/ apache-ant-1.9.4/bin

 

classpath        C:/apache-ant-1.9.4/lib

 

1.3 验证

点击 开始 -> 运行 -> 输入cmd

执行构建文件 

输入如下命令：ant
如果出现如下内容，说明安装成功：

Buildfile: build.xml does not exist!
Build failed

注意：因为ant默认运行build.xml文件，这个文件需要我们创建。

如果不想命名为build.xml，运行时可以使用 ant -buildfile test.xml 命令指明要运行的构建文件。

 

查看版本信息

输入 ant  -version，可以查看版本信息。 

 

但如果出现 ‘ant‘ 不是内部或外部命令，也不是可运行的程序或批处理文件

说明安装失败：（可以重复前述步骤，直至安装成功。）

 

二、例子

---

在安装和配置成功后，我们就可以使用ant了。

为了让读者对ant有一个直观的认识，首先以Ant官方手册上的一个简单例子做一个说明。

以下是一个build.xml文件的内容： 

<project name="MyProject" default="dist" basedir=".">
    <description>
        simple example build file
    </description>
  <!-- set global properties for this build -->
  <property name="src" location="src"/>
  <property name="build" location="build"/>
  <property name="dist"  location="dist"/>

  <target name="init">
    <!-- Create the time stamp -->
    <tstamp/>
    <!-- Create the build directory structure used by compile -->
    <mkdir dir="${build}"/>
  </target>

  <target name="compile" depends="init"
        description="compile the source " >
    <!-- Compile the java code from srcinto{build} -->
    <javac srcdir="${src}" destdir="${build}"/>
  </target>

  <target name="dist" depends="compile"
        description="generate the distribution" >
    <!-- Create the distribution directory -->
    <mkdir dir="${dist}/lib"/>

    <!-- Put everything in buildintotheMyProject−{DSTAMP}.jar file -->
    <jar jarfile="dist/lib/MyProject−{DSTAMP}.jar" basedir="${build}"/>
  </target>

  <target name="clean"
        description="clean up" >
    <!-- Delete the buildand{dist} directory trees -->
    <delete dir="${build}"/>
    <delete dir="${dist}"/>
  </target>
</project>

在这个xml文件中，有几个target标签，每个target对应一个执行目标。

我们将这个build.xml放在 D:\Temp\ant_test 路径下，然后在dos界面下进行测试。 

ant init

在 D:\Temp\ant_test 路径下创建了一个build目录，执行成功。

  

ant compile 

提示错误，原来是在build.xml的所在目录下找不到src目录。好的，我们直接创建一个src目录，然后再次尝试。 

这次，执行成功。

ant dist 

清除创建的build和dist目录，执行成功。 

一个细节

细心的读者，想必已经发现一个问题——在执行 ant compile 和 ant dist 命令的时候把前面的命令也执行了。这是为什么呢？

请留意一下build.xml中的内容。有部分 target 标签中含有 depends 关键字。 

这表明，当前的 target 在执行时需要依赖其他的target，必须先执行依赖的target，然后再执行。 

三、 关键元素

Ant的构件文件都是XML格式的。每个构件文件包含一个project元素和至少一个target。

target元素可以包含多个task元素。 

3.1 Project 元素

project 元素是构建文件的根元素。 

一个 project 元素可以有多个 target 元素，一个 target 元素可以有多个 task。

在上节的例子中，project标签里有三个属性。  

name属性，指示 project 元素的名字。例子中的名字就是 MyProject。

default属性，指示这个 project 默认执行的 target。在本文的例子中，默认执行的 target 为 dist。

如果我们输入命令 ant 时，不指定 target 参数，默认会执行 dist 这个 target。

basedir属性，指定根路径的位置。该属性没有指定时，使用Ant的构件文件的所在目录作为根目录。

3.2 Target 元素

target 元素是 task 的容器，也就是 Ant 的一个基本执行单元。 

以上节例子中的 compile 来举例。

name属性，指示target元素的名称。

这个属性在一个project元素中必须是唯一的。这很好理解，如果出现重复，Ant就不知道具体该执行哪个 target 了。

depends属性，指示依赖的 target，当前的 target 必须在依赖的 target 之后执行。

description属性，是关于 target 的简短说明。

此外，还有其他几个未出现在构建文件中的属性。

unless属性，正好和 if属性相反，验证指定的属性是否存在，若存在，所在target将不会被执行。

extensionOf属性，添加当前 target 到 extension-point 依赖列表。——Ant1.8.0新特性。

extension-point 元素和 target 元素十分类似，都可以指定依赖的target。但是不同的是，extension-point 中不能包含任何 task。

请看以下实例： 

<target name="create-directory-layout">
   ...
</target>
<extension-point name="ready-to-compile" depends="create-directory-layout"/>
<target name="compile" depends="ready-to-compile">
   ...
</target>

调用target顺序:  create-directory-layout --> ‘empty slot‘ --> compile 

3.3 Task 元素

task是一段可以被执行的代码。

一个task可以有多个属性， 一个属性可以包含对一个 property 的引用。

task的通常结构为

其中，name 是 task 的名字， attributeN 是属性名， valueN 是这个属性的值。

还是以 compile 做为例子：

在 compile 这个 target 标签中包含了一个任务。

这个任务的动作是：执行JAVA编译，编译src下的代码，并把编译生成的文件放在build目录中。

常用task 

<copy todir="${builddir}/srccopy">
    <fileset dir="${srcdir}">
        <include name="**/*.java"/>
    </fileset>
    <filterset>
        <filter token="VERSION" value="${app.version}"/>
    </filterset>

</copy> 

3.4 Property 元素

project的属性可以通过property元素来设定，也可在Ant之外设定。若要在外部引入某文件，例如build.properties文件，可以通过如下内容将其引入：<property file=” build.properties”/>。

property元素可用作 task 的属性值。在task中是通过将属性名放在“${”和“}”之间，并放在task属性值的位置来实现的。

例如 complile 例子中，使用了前面定义的 src 作为源目录。 

Ant提供了一些内置的属性，它能得到的系统属性的列表与Java文档中System.getPropertis()方法得到的属性一致，这些系统属性可参考sun网站的说明。

和 target 元素十分类似，都可以指定依赖的target。但是不同的是，extension-point 中不能包含任何 task。——Ant1.8.0新增特性。

在 target元素中的例子里已提到过，不再赘述。 

参考资料

ant官方手册：http://ant.apache.org/manual/index.html 

Ant 简易教程

标签：

原文地址：http://www.cnblogs.com/iamcui/p/4441041.html