Ant入门基础教程

一 Ant 介绍

Ant是构建工具，用来实现软件的自动化的构建，类似于VisualStudio的project文件，Linux上构建C++的makefile，Ant通常用来构建Java程序。

Ant是基于XML的文件，所以更容易阅读；Ant是用Java实现的，本身支持跨平台；Ant基于插件的方式开发，本身内置了常用的大部分的插件，而且第三方的扩展也很容易；Ant除了用来构建Java程序，也可以用来构建其他的任何程序，例如C++等。

和Ant类似，能够支持跨平台的其他的一些非常优秀的构建工具有Maven，Scons，CMake等。

二 Ant的配置

1）安装jdk，设置
JAVA_HOME=D:\Java\Jdk1.5
classpath=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

path=%JAVA_HOME%\bin;%path%

2）下载安装Ant，且设置
ANT_HOME=E:\Lab\apache-ant-1.8.2

path=E:\Lab\apache-ant-1.8.2\bin

3） 最后验证是否安装成功在dos中输入ant，如果显示

Buildfile: build.xml does not exist!

Build failed

则安装成功

三 Ant的基础元素

1）Project元素

Project元素是Ant文件的根元素，Ant构建文件中至少应该包含一个project元素，否则会发生错误。在每个project元素下面可以包含多个target元素。project的属性包括：

name ： 项目名称

default：当调用时没有指定target时，此project的默认targe

basedir：用于指定基路径的位置，改属性没有指定时，使用Ant的构建文件的父目录作为基路径

例如：
< ?xml version="1.0" ?>
< project name ="antPro" default ="getBaseDir" basedir ="C:/ThinkInJavaCode">
<target name="getBaseDir">
<echo message="The base dir is: ${basedir}"/>
</target>
< /project>

从上例可以看出，在这里定义了default 属性的值为getBaseDir ，即当运行ant 命令时，如果没有指明待执行的target，则将执行默认的target--getBaseDir 。此外，还定义了basedir 属性的值为 "C:/ThinkInJavaCode" ，进入"C:/ThinkInJavaCode" 后运行ant 命令，得一下结果：
Buildfile: C:\ThinkInJavaCode\build.xml

sayBaseDir:
[echo] The base dir is: C:\ThinkInJavaCode

BUILD SUCCESSFUL
Total time: 0 seconds

2）target元素

target为Ant的基本执行单元，他可以包含一个或多个具体的任务。

target的属性有：

name： target的名称，这个属性在一个project中是唯一的。我们可以通过指定 target 元素的名称来指定某个 target 。

depends：用来描述target间的依赖关系，若与多个 target 存在依赖关系时，需要以“,”间隔。 Ant 会依照 depends 属性中 target 出现的顺序依次执行每个 target 。被依赖的 target 会先执行。

if：用于验证指定的属性是否存在，若不存在，所在 target 将不会被执行。

unless：该属性的功能与 if 属性的功能正好相反，它也用于验证指定的属性是否存在，若不存在，所在 target 将会被执行。

description：该属性是关于 target 功能的简短描述和说明。

多个target可以存在相互依赖的关系。Ant会依照depends属性中target出现的顺序依次执行每个target。然而，要记住的是只要某个target依赖于一个target，后者就会被先执行。

<target name="A"/>

<target name="B" depends="A"/>

<target name="C" depends="B"/>

<target name="D" depends="C,B,A"/>

假定我们要执行target D。从它的依赖属性来看，你可能认为先执行C，然后B，最后A被执行。错了，C依赖于B，B依赖于A，所以先执行A，然后B，然后C，最后D被执行。

一个target只能被执行一次，即时有多个target依赖于它。

3）property元素

property元素可看作变量或者参数的定义（即经常使用的变量），project 的属性可以通过 property 元素来设定，也可在 Ant 之外设定。例如<property name ="name" value ="philander"/>。若要在外部引入某文件，例如 build.properties 文件，可以通过如下内容将其引入<property file=” build.properties”/>。

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

basedir:project 基目录的绝对路径；

ant.file:buildfile的绝对路径，上例中ant.file值为C:\ThinkInJavaCode\build.xml；

ant.version:Ant 的版本信息，本文为1.8.1 ；

ant.project.name:当前指定的project的名字，即前文说到的project的name属性值；

ant.java.version:Ant 检测到的JDK版本，本文为 1.6 。

举例说明如下：
<? xml version="1.0" ?>
<project name ="propertyPro" default ="example">
<property name ="name" value ="philander"/>
<property name ="age" value ="25"/>
<target name ="example">
<echo message ="name: ${name}, age: ${age}"/>
</target>
</project>

上例中用户设置了名为name 和age的两个属性，这两个属性设置后，在下文中可以通过 ${name} 和 ${age} 分别取得这两个属性值。

四 ANT常用命令

1. copy 命令

copy主要用来对文件和目录的复制功能。举例如下：

eg1. 复制单个文件：
<copy file="original.txt" tofile="copied.txt"/>

eg2. 对文件目录进行复制：
<copy todir="../dest_dir">

<fileset dir="src_dir"/>
</copy>

eg3. 将文件复制到另外的目录：
<copy file="source.txt" todir="../home/philander"/>

2. delete 命令

对文件或目录进行删除，举例如下：

eg1. 删除某个文件：
<delete file="/home/photos/philander.jpg"/>

eg2. 删除某个目录：
<delete dir="/home/photos"/>

eg3. 删除所有的备份目录或空目录：
<delete includeEmptyDirs="true">
<fileset dir="." includes="**/*.bak"/>
</delete>

3. mkdir 命令

创建目录。 eg ：
<mkdir dir="/home/philander/build/classes"/>

4. move 命令

移动文件或目录，举例如下：

eg1. 移动单个文件：
<move file="sourcefile" tofile=”destfile”/>

eg2. 移动单个文件到另一个目录：
<move file="sourcefile" todir=”movedir”/>

eg3. 移动某个目录到另一个目录：

<move todir="newdir"> <fileset dir="olddir"/></move>

5. echo 命令

该任务的作用是根据日志或监控器的级别输出信息。它包括 message 、 file 、 append 和 level 四个属性，举例如下
<echo message="Hello,ANT" file="/home/philander/logs/ant.log" append="true">

五 利用ant 构建和部署Java项目

Ant 可以代替使用 javac 、 java 和 jar 等命令来执行 java 操作，从而达到轻松的构建和部署 Java 项目的目的。

1. 利用ant 的javac命令来编译Java程序

Ant 的javac命令用于实现编译Java 程序的功能。下面来看一个简单的例子：首先我们建立名为 JavaTestPro的Java项目，建立src目录为源代码目录，在src目录下建立HelloWorld.java这个类文件。该类文件的内容如下：
public class HelloWorld {
public static void main(String[] args) {
System.out.println("hello world!");
}
}

同时在JavaTestPro项目的根目录下建立build.xml 文件，在该文件中编译src 目录下的Java文件，并将编译后的class文件放入build/classes 目录中，整个项目的目录结构如下：

|JavaTestPro

|src

|build

|classes

|build.xml

在编译前，需清除classes 目录，该文件的内容如下：
<?xml version="1.0" ?> 
<project name ="javacTest" default="compile" basedir=".">
<target name="clean">
<delete dir="${basedir}/build"/>
</target>
<target name="compile" depends ="clean">
<mkdir dir ="${basedir}/build/classes"/>
<javac srcdir ="${basedir}/src" destdir ="${basedir}/build/classes"/>
</target>
</project>

在项目根目录(C:\ThinkInJavaCode\JavaTestPro)执行ant命令后，可在该目录下发现新生成的build/classes子目录，编译后生成的HelloWorld.class文件就在该目录下。

2. 使用java命令执行Java程序

Ant 中可以使用 java命令实现运行Java程序的功能。可以在上面的build.xml基础上做修改来实现：
<?xml version="1.0" ?>
<project name ="javacTest" default="run" basedir=".">
<target name="clean">
<delete dir="${basedir}/build"/>
</target>
<target name="compile" depends ="clean">
<mkdir dir ="${basedir}/build/classes"/>
<javac srcdir ="${basedir}/src" destdir ="${basedir}/build/classes"/>
</target>
<target name="run" depends ="compile">
<java classname ="HelloWorld">
<classpath>
<pathelement path="${basedir}/build/classes"/>
</classpath>
</java>
</target>
</project>

接着，就可以在控制台看见输出："[java] hello world!"

3. 使用jar命令生成jar文件

还可以在上例的基础上更进一步，来生成jar包，可在run 这个 target 下再加上如下 target ：
<?xml version="1.0" ?>
<project name ="javacTest" default="jar" basedir=".">
<target name="clean">
<delete dir="${basedir}/build"/>
</target>
<target name="compile" depends ="clean">
<mkdir dir ="${basedir}/build/classes"/>
<javac srcdir ="${basedir}/src" destdir ="${basedir}/build/classes"/>
</target>
<target name="run" depends="compile">
<java classname ="HelloWorld">
<classpath>
<pathelement path="${basedir}/build/classes"/>
</classpath>
</java>
</target>
<target name="jar" depends="run">
<jar destfile="helloworld.jar" basedir="${basedir}/build/classes">
<manifest>
<attribute name="Main-class" value="HelloWorld"/>
</manifest>
</jar>
</target >
</project>

其中，project的default 属性设置为应设为jar，ant运行完毕后，可看到在项目的根目录下生成了一个 helloworld.jar的jar包 。可通过运行以下命令来执行该jar包：
java -jar helloworld.jar

4. 使用war命令打包JavaEE项目

建立一个JavaEE项目，其中src 为Java源代码目录，WebContent为各jsp存放目录，lib 为项目引用的的包的目录。在WebTest项目目录下建立了build.xml 文件，该文件为该工程的 Ant 构件文件。

|WebContent

|src

|build

|classes

|WebContent

|META-INF

|MANIFEST.MF

|WEB-INF

|lib

|classes

|HelloJSP.jsp

|build.xml

读者可以 src 目录下放入在前续例子中开发的 HelloWorld.java 文件，并在 WebContent下建立 HelloJSP.jsp 文件，其内容很简单，就是输出 Hello 信息，代码如下所示如下
<%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>war test for ant</title>
</head>
<body>
Hello JSP!Hello Ant!
</body>
</html>

接下来编写 build.xml 文件，其内容如下:
<?xml version="1.0" encoding="UTF-8" ?>
<project name ="WebTest" default ="war" basedir =".">
<property name ="classes" value ="${basedir}/build/classes"/>
<property name ="build" value ="${basedir}/build"/>
<property name ="lib" value ="${basedir}/WebContent/WEB-INF/lib"/>
<!-- 删除build 路径-->
<target name ="clean">
<delete dir ="${build}"/>
</target>

<!-- 建立build/classes 路径，并编译class 文件到build/classes 路径下-->
<target name ="compile" depends ="clean">
<mkdir dir ="${classes}"/>
<javac srcdir ="${basedir}/src" destdir ="${classes}"/>
</target>

<!-- 打war 包-->
<target name ="war" depends ="compile">
<war destfile ="${build}/WebTest.war" webxml ="${basedir}/WebContent/WEB-INF/web.xml">
<!-- 拷贝WebRoot 下除了WEB-INF 和META-INF 的两个文件夹-->
<fileset dir ="${basedir}/WebContent" includes ="**/*.jsp"/>
<!-- 拷贝lib 目录下的jar 包-->
<lib dir ="${lib}"/>
<!-- 拷贝build/classes 下的class 文件-->
<classes dir ="${classes}"/>
</war>
</target>
</project>

在C:\ThinkInJavaCode\WebTest目录下运行ant后，就生成了WebTest.war 文件了，然后可以将其放入Web容器(如Tomcat)的相应目录下(${Tomcata安装目录}\webapps)运行该web项目了。

参考：

http://www.cnblogs.com/wangchenyang/archive/2011/09/14/2176688.html

http://www.cnblogs.com/philander/articles/1782254.html

感谢，Thanks！

作者：iTech
出处：http://itech.cnblogs.com/

时间： 2024-10-07 10:19:32

Ant入门基础教程的相关文章

【转】Gulp入门基础教程

Gulp入门基础教程 原文在此 前言最近流行前端构建工具,苦于之前使用Grunt,代码很难阅读,现在出了Gulp, 真是摆脱了痛苦.发现了一篇很好的Gulp英文教程,整理翻译给大家看看. 为什么使用GulpGulp基于Node.js的前端构建工具,通过Gulp的插件可以实现前端 代码的编译(sass.less).压缩.测试:图片的压缩:浏览器自动刷新,还有许多 强大的插件可以在这里查找.比起Grunt不仅配置简单而且更容易阅读和维护,我们 可以做一个对比: Grunt: sass: { dist

HBase入门基础教程 HBase之单机模式与伪分布式模式安装

在本篇文章中,我们将介绍Hbase的单机模式安装与伪分布式的安装方式,以及通过浏览器查看Hbase的用户界面.搭建HBase伪分布式环境的前提是我们已经搭建好了Hadoop完全分布式环境,搭建Hadoop环境请参考:[Hadoop入门基础教程]4.Hadoop之完全分布式环境搭建 开发环境 硬件环境:CentOS 6.5 服务器4台(一台为Master节点,三台为Slave节点) 软件环境:Java 1.7.0_45.Eclipse Juno Service Release 2.hadoop-1

Daydream VR入门基础教程，学习Google VR for Android全景应用示例SimpleVrPanorama制作VR全景应用

前言 前两篇介绍了Daydream Android VR开发环境的搭建和官方VR Demo寻宝游戏的演示,这篇我们来一起研究下示例项目SimpleVrPanorama,同时通过了解它来了解如何开发一款VR全景图形应用. -------------------------------------------------------------------------------------------------------------------- Daydream快速入门开发基础教程一:And

HTML入门基础教程相关知识

HTML入门基础教程 html是什么,什么是html通俗解答: html是hypertext markup language的缩写,即超文本标记语言.html是用于创建可从一个平台移植到另一平台的超文本文档的一种简单标记语言,经常用来创建web页面.html文件是带有格式标识符和超文本链接的内嵌代码的ascii 文本文件——html结构了解. html文本是由 html命令组成的描述性文本,html 命令可以说明文字. 图形.动画.声音.表格.链接等. html网页结构包括头部 (head).主

经典Spring入门基础教程详解

经典Spring入门基础教程详解 https://pan.baidu.com/s/1c016cI#list/path=%2Fsharelink2319398594-201713320584085%2F%E7%BB%8F%E5%85%B8Spring%E5%85%A5%E9%97%A8%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B%E8%AF%A6%E8%A7%A3&parentPath=%2Fsharelink2319398594-201713320584085 博达远

学python入门基础教程[推荐]

python入门经典必备推荐基础教程 绝对是python初学者入门必备,比learning python写的好100倍, 远超python基础教程n个数量级 下载地址 http://pan.baidu.com/s/1jGwzpeY 更多python学习资料 http://dou.bz/35ODPo

[Java] Apache Ant 构建基础教程

环境:Ubuntu 12.04, java 1.7.0, ant 1.8.2. 前言 Apache Ant 是一个软件自动化构建工具,构建过程包括编译.测试和部署等.它和 Make 工具相似,但由 Java 实现,所以要求 Java 运行环境,非常适合构建 Java 程序. Ant 和 Make 明显不同之处在于 Ant 使用 XML 来表述构建过程与依赖关系,而 Make 使用 Makefile 格式文件.Ant 默认的构建文件名为 build.xml.每一个 build.xml 文件包含一个

Daydream VR入门基础教程，VR开发基础知识——VR view基本介绍

VR view基本介绍 VR view是Google在2016年4月推出的一个VR基本概念,是一种"客户端"VR显示技术,可将 360 度照片或视频部署在各种设备上的简易方式,囊括 PC 端和移动端.在APP上嵌入VR View代码之后,全景照片或者视频将会变成分屏的VR内容.用户可以在手机上通过Cardboard等盒子或者在PC端通过头盔体验VR. 我们来看看一张VR全景图片是什么样的: 为什么是两张一模一样的呢?因为这是分别给左右眼观看的,遵循了VR view视图的基本规则,关于V

WPF入门基础教程之布局(1)

WPF的常用布局控件的介绍及使用方法 (1) 开局一张图,内容全靠写,本系列的文章, 主要针对刚入门.亦或是从 winform/bs转过来的开发人员快速入门的指南, 相对于其它一些文章中会详细的从项目如何建立到其实现的原理及组成部分, 本系列的文章则旨在如果快速的构建: 从布局.样式.触发器.绑定.显示.MVVM架构一系列的阶段学习,构建一个基础的呈现以达到学习的目的. WPF相关资料合集 (含书籍.框架.及开源UI组件等) WPF编程宝典.pdf 深入浅出WPF.pdf MaterialDes