Ant 简易教程

简介: 前言 Apache Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具,大多用于Java环境中的软件开发。由Apache软件基金会所提供。 Ant是纯Java语言编写的,所以具有很好的跨平台性。

前言

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

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

 

1 下载和安装

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' 不是内部或外部命令,也不是可运行的程序或批处理文件

说明安装失败:(可以重复前述步骤,直至安装成功。)

 

2 例子

在安装和配置成功后,我们就可以使用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 ${src} into ${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 ${build} into the MyProject-${DSTAMP}.jar file  -->
     < jar  jarfile ="${dist}/lib/MyProject-${DSTAMP}.jar"  basedir ="${build}" />
   </ target >

   < target  name ="clean"
        description
="clean up"   >
     <!--  Delete the ${build} and ${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

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

 

ant clean

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

 

一个细节

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

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

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

 

3 关键元素

 

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

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

 

3.1 Project 元素

 

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

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

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

< project  name ="MyProject"  default ="dist"  basedir ="." >

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

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

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

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

 

3.2 Target 元素

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

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

< target  name ="compile"  depends ="init"  description ="compile the source "   >
     <!--  Compile the java code from ${src} into ${build}  -->
     < javac  srcdir ="${src}"  destdir ="${build}" />
</ target >
这个 target 中出现了几个属性。

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

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

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

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

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

if属性,验证指定的属性是否存在,若不存在,所在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

< target  name ="generate-sources" extensionOf ="ready-to-compile" >
   ...
</ target >
调用target顺序:  create-directory-layout --> generate-sources  --> compile
onMissingExtensionPoint属性:当无法找到一个extension-point时,target尝试去做的动作("fail", "warn", "ignore")。 ——Ant1.8.2新特性。

 

 

3.3 Task 元素

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

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

task的通常结构为

< name  attribute1 ="value1"  attribute2 ="value2"  ...  />

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

还是以 compile 做为例子:

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

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

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

常用task 

javac:用于编译一个或者多个Java源文件,通常需要srcdir和destdir两个属性,用于指定Java源文件的位置和编译后class文件的保存位置。
< javac  srcdir ="${src}"  destdir ="${build}"  classpath ="abc.jar"  debug ="on"  source ="1.7"   />
java:用于运行某个Java类,通常需要classname属性,用于指定需要运行哪个类。
< java  classname ="test.Main" >
     < arg  value ="-h"   />
     < classpath >
         < pathelement  location ="dist/test.jar"   />
     </ classpath >
</ java > 
jar:用于生成JAR包,通常需要指定destfile属性,用于指定所创建JAR包的文件名。除此之外,通常还应指定一个文件集,表明需要将哪些文件打包到JAR包里。
< jar  jarfile ="${dist}/lib/MyProject-${DSTAMP}.jar"  basedir ="${build}" />
echo:输出某个字符串。
< echo  message ="Building to ${builddir}" />
< echo >You are using version ${java.version}  of Java! This message spans two lines. </ echo >
copy:用于复制文件或路径。
< copy  todir ="${builddir}/srccopy" >
     < fileset  dir ="${srcdir}" >
         < include  name ="**/*.java" />
     </ fileset >
     < filterset >
         < filter  token ="VERSION"  value ="${app.version}" />
     </ filterset >
</ copy > 
delete:用于删除文件或路径。
< delete  file ="/lib/ant.jar"   />
< delete  dir ="lib"   />
< delete >
     < fileset  dir ="."  includes ="**/*.bak"   />
</ delete > 
mkdir:用于创建文件夹。
< mkdir  dir ="${dist}/lib"   /> 
move:用户移动文件和路径。
< move  todir ="some/new/dir" >
     < fileset  dir ="my/src/dir" >
         < include  name ="**/*.jar"   />
         < exclude  name ="**/ant.jar"   />
     </ fileset >
</ move > 

 

3.4 Property 元素

Property 是对参数的定义。

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

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

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

< javac  srcdir ="${src}"  destdir ="${build}" />

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

 

3.5 extension-point元素

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

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

 

参考资料

[1] ant官方手册:http://ant.apache.org/manual/index.html

[2] http://www.blogjava.net/amigoxie/archive/2007/11/09/159413.html
目录
相关文章
|
12月前
|
Java 应用服务中间件
Ant使用总结
Ant使用总结
87 0
|
Java
Ant 简介-下
Ant 简介-下
137 0
|
XML Java Apache
Ant简介
Apache Ant 是由 Java 语言开发的工具,由 Apache 软件基金会所提供。Apache Ant 的配置文件写成 XML 容易维护和书写,而且结构很清晰。本教程将以简单的方式会向你展示如何利用 Apache ANT 来自动地构建和部署过程。 下载到某个目录解压到, 例如安装路径C:\L_Executable\apache-ant-1.10.5 配置环境变量 ANT_HOME C:\L_Executable\apache-ant-1.10.5 Path %ANT_HOME%\bin 运行ant -version查看是否安装成功Apache Ant(TM) version 1.10
858 0
Ant简介
|
Apache 开发工具
Ant 环境安装
超级详细的ant环境安装过程
1631 0
|
Java Apache C++
|
Java 数据格式 XML
|
XML Java 开发工具
|
Java 数据格式 XML