Ant的使用

最新推荐文章于 2021-11-04 00:32:49 发布

原创最新推荐文章于 2021-11-04 00:32:49 发布 · 425 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#ant

ant 专栏收录该内容

2 篇文章

订阅专栏

Ant 是一种基于java的生成工具。作用类似c编程的Make工具（Unix平台使用较多）

Ant具有平台的无关特性，但考虑到解压缩的方便性，通常建议Windows平台下载*.zip压缩包，而Linux平台下载.gz压缩包。

文件结构：

bin：启动和运行Ant的可执行性命令

docs：Ant工具的相关文档，这些文档对学习使用Ant有很大的作用

etc:包含一些样式单文件，通常无需理会该目录下的文件

lib：包含Ant的核心类库，以及编译和运行Ant所依赖的第三方类库。

LICENSES等说明文档

Ant的运行需要如下两个环境变量：

JAVA_HOME：该环境变量应指向JDK的安装路径。 ANT_HOME：该环境变量应指向Ant的安装路径

使用Ant工具

如果运行ant命令时没有指定任何参数，Ant会在当前目录下搜索build.xml文件。如果找到了就以该文件为生成文件，并执行默认的target

-find或-s作用相同，Ant会自动到上级目录中搜索生成文件，直到到达文件系统的根目录。

ant -f a.xml//显示指定使用a.xml作为生成文件

ant -file b.xml//显示指定使用b.xml作为生成文件

-quiet或-q选项 ant运行时只输出少量的必要信息

-verboe或-v ant运行时输出更多的提示信息

如果希望ant运行时将提示信息输出到指定文件，而不是控制台，则可使用-logfile<file>或-l<file>选项

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

--ant还允许运行时指定一些属性来覆盖生成文件中指定的属性值（使用property task来指定），如-D<property>=<value>,则此处指定的value将会覆盖生成文件中的property的属性值 ant -Dbook=Spring2//该命令将会覆盖生成文件中的book属性值

通过该方法可以将操作系统的环境变量值传入生成文件，如我们在运行Ant工具时使用如下命令： ant -Denvl=%ANT_HOME%

用于生成文件中传入一个env1属性，而该属性的值并没有直接给出，而是用%ANT_HOME%的形式给出--这是Windows下访问环境变量的形式。可以将windows环境变值传入生成文件了，如果希望在生成文件中访问到该环境变量的值，使用$env1

---定义生成文件

使用Ant的关键就是编写生成文件，生成文件定义了该项目的各个生成任务（每个target表示一个生成任务），并定义生成任务之间的依赖关系。

默认生成文件名为build.xml,也可以取其它的名字、

一个典型项目的层次结构

<project>:该文件夹存放了整个项目的全部资源

<src>:存放源文件、各种配置文件的文件夹

<classes>存放编译后的class文件的文件夹

<lib> 存放第三方JAR包的文件夹

<dist> 存放项目打包、项目发布文件的文件夹

build.xml Ant生成问件，根元素是<project../> 子元素是<target.../>

project常见属性default：指定默认的target，属性是必须的。

basedir：指定项目的基准路径，生成文件中其他相对路径都是基于该路径。

name：指定项目名，该属性仅指一个名字，对编译、生成项目没有太大的实际作用。

description：指定项目的描述信息，对编译、生成项目没有太大的实际作用。

<? version="1.0" encoding="GBK"?>
<!--下面的配置信息指定基准路径是当前路径，默认target为空-->
<project name="struts2" description="demo" basedir="." default="">


</project>

target元素包括

name：该属性是必须的，非常重要，当希望Ant运行指定的生成目标时，就是根据该name来确定生成目标的。所以可以得出一个结论：同一个生成文件里不能有两个同名的targ

</pre>et元素<p></p><p>depends： 该属性可指定一个或多个target名，表示运行该target之前应先运行该depends属性所指定的一个或多个target。</p><p>if：该属性指定一个属性名，用属性表示仅当设置了该属性时才执行此target</p><p>unless ： 该属性指定一个属性名，用属性表示仅当设置了该属性时才执行此target</p><p>description;指定该target的描述信息</p><p></p><pre code_snippet_id="1660848" snippet_file_name="blog_20160425_3_6461572" name="code" class="java">	<!--下面表示执行run target之前，必须先执行compile target-->
	<target name="run" depends="compile"/>
	<!--只有当设置了propl属性之后才会执行exA target-->
	<target name="exA" if="propl"/>
	<!--只要没有设置prop2属性，就可以执行exB target-->
	<target name="exB" unless="prop2"/>

每个生成目标有可能由一个或多个任务序列组成，当执行某个生成目标时，实际上就是依次完成该目标所包含的全部任务。每个任务由一段可执行的代码组成。

----ant 生成文件的属性值不可改变

<!--定义一个名为builddir的属性，其值为dd-->
	<property name="builddir" value="dd">

如需要获取属性值，则使用${propName}的形式 ${builddir}

$在Ant生成文件中具有特设意义，若要将$当成普通字符使用$$

<echo>$${builddir}=${builddir}</echo>

输出结果是 ${builddir}=dd

property元素可以接受的常用属性：

name：指定需要设置的属性名

value：指定需要设置的属性值

resource：指定属性文件的资源名称，Ant将负责从属性文件中读取属性名和属性值

file：指定属性文件的文件名，Ant将负责从属性文件中读取属性名和属性值

encvironment：用于指定系统环境变量的前缀。通过这种方式允许Ant访问系统环境变量

classpath：指定搜索属性文件的文件和路径集

classpathref：指定搜索属性文件的文件和路径集引用，该属性并不是直接给出系列文件或路径，而是给定文件和路径集引用。

	<!--指定读取foo.properties属性文件中的属性名和属性值-->
	<property file="foo.properties"/>
	<!--从网络中读取属性名和属性值-->
	<property url="http://www.crazyit.org/props/foo.properties"/>

属性文件就是普通的属性文件，该文件的内容由系列的name=value组成，

author=Yeeku.H.Lee

book=Light Weight Java EE

price=56

<!--定义访问操作系统环境变量的前缀是env-->
	<property environment="env"/

定义之后可以在Ant生成文件中通过如下形式来访问操作系统环境变量：

<echo>${env.JAVA_HOME}</echo>

2.path元素和classpath元素

通常需要使用Ant编译、运行Java文件，编译、运行Java文件时常常需要引用第三方JAR包，这就需要使用<classpath.../>元素了。用于定义文件和路径集，区别是classpath元素通常作为其他任务的子元素，既可引用已有的文件和目录集，也可临时定义一个文件和目录集；path则作为project元素的子元素，用于定义一个独立的、有名称的文件和目录集，用于被引用。

二者都用于文件和目录集，定义的内容称为Path-like Structures（似目录结构）

子元素：

pathelement：用于指定一个或多个目录包括两个属性①path：指定一个或多个目录（或者jar文件），多个目录或jar文件之间以英文（：）或英文分号（；）分开②location：指定一个目录和jar文件

dirset：采用模式字符串的方式指定系列目录

fileset：采用模式字符串的方式指定系列文件

filelist：采用直接列出系列文件名的方式指定系列文件

<!--定义/path/to/file2.jar  /path/to/class2和/path/to/class3所组成的目录集-->
	<pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3"/>
	<!--定义由lib/helper.jar单个文件对应的目录-->
	<pathelement location="lib/helper.jar"/>、

如果需要指定多个目录集，则应该使用<dirset.../>,该元素需要一个dir属性，dir属性指定该目录集的根路径。除此之外dirset还可以使用<include.../>和<exclude.../>两个子元素来指定包含和不包含那些目录，

	<!--指定该目录集的根路径是build目录-->
	<dirset dir="build">
		<!--指定包含apps目录下的所有classes目录-->
		<incldue name="apps/**/classed"/>
		<!--指定排除目录名中有Test的目录-->
		<exclude name="apps/**/*Test*"/>
	</dirset>

上面的配置文件代表build/apps目录下，所有名为classes且文件名不包含Test子串的目录

如果给希望配置多个文件，则可用<fileset.../>或者<filelist.../>元素，通常<fileset.../>使用模式字符串来匹配文件集，而<filelist.../>则通过列出文件名的方式指定文件集

<filelist.../>元素需要指定两个属性dir和files，dir指定文件集里多个文件所在的基准路径，必需属性

files：多个文件名列表，多个文件名之间以英文逗号，或空白隔开

<!--配置src/foo.xml和src/bar.xml文件组成的文件集-->
	<filelist id="docfiles" dir="src" files="foo.xml,bar.xml"/>

<!--等价-->
	<filelist id="docfiles" dir="${doc.src}">
		<!--通过两个file子元素指定的文件列表和通过files属性指定的效果完全一样-->
		<file name="foo.xml"/>
		<file name="bar.xml"/>
	</filelist>

<fileset/>元素可指定两个元素 dir：指定文件集里多个文件所在的基准路径，必需属性 casesensitive：指定是否区分大小写，默认区分大小写

	<!--定义src路径下的文件集-->
	<fileset dir="src" casesensitive="yes">
		<!--包含所有*.java文件-->
		<include name="**/*.java"/>
		<!--排除所有文件中有Test子串的文件-->
		<exclude name="**/*Test*"/>
	</fileset>

下面是比较完整的使用：

	<path id="classpath">
		<!--定义classpath属性值所代表的路径-->
		<pathelement path="${classpath}"/>
		<!--定义lib路径下的所有*.jar文件-->
		<fileset dir="lib">
			<include name="**/*.jar"/>
		</fileset>
		<!--定义classes路径-->
		<pathelement location="classes"/>
			<!--定义build/app路径下所有classes路径-->
		<dirset dir="build">
			<include name="apps/**/classed"/>
			<exclude name ="apps/**/*Test*"/>
		</dirset>
		<!--定义res路径下的a.properties和b.xml文件-->
		<filelist dir="res" files="a.properties,b.xml"/>
	</path>