ANT及build.xml文档编写


为了批量编译java文件,今天学习了ANT(Another Neat Tool另一个整洁的工具,http://www.apache.org/)及build.xml文档的编写,找了篇文章,先学习模仿~~

Ant是一个基于Java的生成工具,类似于C中的make,但比make优越,与其它大多数Build工具相比较,Ant的两个特性决定了它是一款优秀的Build工具:

1. 基于Java的实现。具有良好的跨平台性,同时可以通过增加新的Java类来扩展Ant的功能,而无需去了解不同平台上不同的脚本语言。 

2.基于XML的配置文件。Ant以XML树来描述Target/Task的关系,文件结构清晰、易读易写,并且利用XML对格式的控制来避免由于配置文件的错误造成的Build操作失败。

ANT下载地址:http://apache.mirror.phpchina.com/ant/binaries/apache-ant-1.7.0-bin.zip

安装与配置 

Ant的安装非常简单,把从网上下载的jakarta-ant-1.5.1-bin.zip解开到一个目录下即可(以下假定安装在目录D:\jakarta-ant-1.5.1)。接下来需要进行环境变量配置: SET ANT_HOME=D:\jakarta-ant-1.5.1 //注意是Ant的安装目录,不是bin子目录
SET PATH=%PATH%;%ANT_HOME%\bin; 

在配置环境变量之前,请确认已经正确设置了JAVA_HOME系统变量。输入ant命令,看到如下输出说明已成功安装了Ant工具: 

Buildfile: build.xml does not exist!
Build failed

提示信息表明在当前目录不存在build.xml配置文件,但这本身已经说明Ant成功运行了。 

快速入门 

下面用一个最简单也是最经典的例子-HelloWorld来感受一下Ant吧。 

//HelloWorld.java
package com.sharetop.antdemo;
public class HelloWorld {
public static void main( String args[] ) {
System.out.println("Hello world. ");
}


要让Ant编译这个文件,首先需要编写一个Build配置文件。在一般情况下,这个文件被命名为build.xml。 

<?xml version="1.0" encoding="UTF-8" ?>
<project name="HelloWorld" default="run" basedir="." >
<property name="src" value="src"/>
<property name="dest" value="classes"/>
<property name="hello_jar" value="hello.jar" />
<target name="init">
<mkdir dir="${dest}"/>
</target>
<target name="compile" depends="init">
<javac srcdir="${src}" destdir="${dest}"/>
</target>
<target name="build" depends="compile">
<jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
<target name="run" depends="build">
<java classname="com.sharetop.antdemo.HelloWorld" classpath="${hello_jar}"/>
</target>
</project> 

来看一下这个文件的内容,它描述了以下信息:工程的名字为HelloWorld,工程有四个target,分别是init、compil、build和run,缺省是run。compile只有一个任务javac,源文件位于src目录下,输出的类文件要放在classes目录下。build的任务是jar,生成的jar文件为hello.jar,它打包时以classes为根目录。而run则是执行这个HelloWorld类,用hello.jar作为classpath。这四个target之间有一个依赖关系,这种关系用depends来指定。即如果Target A依赖于Target B,那么在执行Target A之前会首先执行Target B。所以从下面运行缺省Target(run)的输出看,这四个Target的执行顺序是:init→compile→build→run。文件目录结构如图1所示。HelloWorld.java文件在src\com\sharetop\antdemo子目录下。 

 
图1 ant_demo应用的目录结构

在命令行输入命令:
如果配置文件名不是build.xml,比如是build_front.xml,那么,可以使用-buildfile命令参数指定: 

G:\myDoc\ant_demo>ant -buildfile build_front.xml 

也可以单独执行指定的某个target,比如,只编译不打包执行,可以使用下面输入命令即可: 

G:\myDoc\ant_demo>ant compile 
在相应的目录下会找到编译出的HelloWorld.class文件。 

再看看上面的build.xml配置文件,文件开头定义了3个属性,分别指定了源文件输出路径、类文件输出路径和生成的Jar文件名,后面对这些路径的引用都通过一个${property name}来引用。所以,要注意这样一个原则“目录的定义与目录的引用应该分开”。

build.xml文档编写:

<?xml version="1.0"?>
<project default="dist" name="Project A">
    <description>
         一段描述信息,没有实际作用。
    </description>
    <!--property 元素相当于变量,存放一定的值,一旦给定以后不能改变,只能通过控制台命令行给初始值。
                 一般用 value 给其赋值,这里用 location 代替 value 是因为 location 属性专门设
                 计用于以平台无关的方式包含文件系统路径,也就是当前路径。-->
    <property name="srcDir" location="."/>
    <property name="buildDir" location="classes"/>
    <property name="distDir" location="dist"/>
    
    <!--一个target 元素就是一个任务,一个步骤,如果命令行没有指定开始任务,则由 project 元素的 default 属性决定要执行的任务-->
    <target name="init" description="在元素中指定描述信息!">
        <echo message="这里的信息将被输出到控制台!">
        <!--tstamp 元素一般不定义属性和内容,不产生任何输出;相反,它根据当前系统时间和日期设置 Ant 以下属性:
         属性                 说明                                     例子
         DSTAMP             设置为当前日期,默认格式为yyyymmdd         20031217
         TSTAMP             设置为当前时间,默认格式为hhmm             1603
         TODAY             设置为当前日期,带完整的月份             2003 年12 月17 日-->
        <tstamp/>
        <!--mkdir 元素用来创建目录 dir 属性用来指定目录路径-->
        <!--$ 引用 property 元素指定的 name 为 buildDir 的属性变量,这里为classes-->
        <mkdir dir="$"/>
        <mkdir dir="$"/>
        <!--文件操作:
             <copy file="src/Test.java" tofile="src/TestCopy.java"/> 把文件 Test.java 拷贝一份 TestCopy.java 
             <move file="src/Test.java" tofile="src/TestCopy.java"/> 把文件 Test.java 重新命名为 TestCopy.java
             <copy file="src/Test.java" todir="archive"/> 把文件 Test.java 从 src 目录复制一份到 archive 目录下
             <move file="src/Test.java" todir="archive"/> 把文件 Test.java 从 src 目录下移动到 archive 目录下
             <replace file="input.txt" token="old" value="new"/>replace 任务,它执行文件中的查找和替换操作。
             token 属性指定要查找的字符串,
             value 属性指定一个新的字符串,
             查找到的标记字符串的所有实例都被替换为这个新的字符串.
             替换操作将在文件本身之内的适当位置进行。为了提供更详细的输出,可把 summary 属性设置为
             true。这将导致该任务输出找到和替换的标记字符串实例的数目。
             <copy todir="archive">---使用模式匹配复制多个文件
                 <fileset dir="src">--fileset 代替 file 属性
                     <include name="*.java"/>--包含 src 目录下所有的 *.java 文件
                     <exclude name="*.class"/>--不包含 src 目录下所有的 *.class 文件
                 </fileset>
             </copy>-->
    </target>

    <!--target 元素的 depends 属性用来设置多个 target 元素之间的依赖关系,如果要执行某个任务,必须先执行 depends 属性指定的所有
         它所依赖的 target 元素,只有它所依赖的所有 target 元素都执行完了才能执行它自己-->
    <target name="com" depends="init">
        <!--javac 元素把 srcdir 指定目录下所有 *.java 文件编译成 *.class 文件到 destdir 指定的目录下!
             如果不指定 destdir 属性,那么默认编译到同一目录下。其他属性:
              classpath:等价于javac 的-classpath 选项。
              debug="true":指示编译器应该带调试信息编译源文件。
              fork="true":当你希望指定编译器的某些内存选项,或者需要使用一种不同级别的编译器的时候。该属性设置为“true”
              executable="d:sdk141 injavac":指定一个不同的 javac 可执行文件。
              memoryMaximumSize="128m":向上边指定的 javac 传递一个最大内存设置-->
        <javac srcdir="$" destdir="$"/>
    </target>

    <target name="dist" depends="com">
        <!--jar 元素:在编译 Java 源文件之后,结果类文件通常被打包到一个 JAR 文件中,这个文件类似 zip 归档文
             件。每个 JAR 文件都包含一个清单文件,它可以指定该 JAR 文件的属性。
             还可以把目录下的所有内容打包为 WAR 文件
             destfile:打包后的文件全名
             basedir:要打包的文件路径-->
        <jar destfile="$/package-$.jar" basedir="$">
            <!--manifest 属性允许指定一个用作该 JAR 文件的清单的文件。清单文件的内容还可以使用 manifest
                 任务在生成文件中指定。这个任务能够像文件系统写入一个清单文件,或者能够实际嵌套在 jar 之
                 内,以便一次性地创建清单文件和 JAR 文件。-->
            <manifest>
                <attribute name="Built-By" value="$"/>
                <attribute name="Main-Class" value="package.Main"/>
            </manifest>
        </jar>
        <jar destfile="$/package-src-$.jar" basedir="$"/>
    </target>

    <target name="zip" depends="dist">
        <!--zip 元素用来创建 zip 包,和 jar 元素相似-->
        <zip destfile="output.zip" basedir="output"/>
        <!--相同的语法也可用于创建 tar 文件。 还可以使用 GZip 和 BZip 任务来压缩文件。-->
        <tar destfile="output.tar" basedir="output"/>
        <gzip src="output.tar" zipfile="output.tar.gz"/>
        <!--解压缩和提取文件同样也很简单.-->
        <unzip src="output.tar.gz" dest="extractDir"/>
        <!--还可以包括 overwrite 属性来控制覆盖行为。默认设置是覆盖与正在被提取的归档文件中的条目相
             匹配的所有现有文件。相关的任务名称是 untar、unjar、gunzip 和 bunzip2。-->
    </target>

    <!--编写一个 clean目标来从目标目录移除生成的任何类文件是个很好的习惯。如果想要确
         保所有源文件都已编译,就可以使用这个任务。这种行为刻画了 Ant 的许多任务的特点:
         如果某个任务能够确定所请求的操作不需要执行,那么该操作就会被跳过。-->

       <!--delete 元素用来删除目录 $ 引用 property 元素指定的 name 为 buildDir 的属性变量-->
    <target name="clean">
        <delete dir="$"/>
        <delete dir="$"/>
    </target>
</project>

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值