Ant 工具学习

亦凉 2022-07-26 06:03 208阅读 0赞

今天在使用eclipse集成了的Ant工具build时，发生错误：

BUILD FAILED  
/workspace/xxx/build.xml:49: Cannot find /workspace/xxx/C:/android-sdk-windows/tools/ant/build.xml imported from /workspace/xxx/build.xml

因为以前没怎么用过这，也不知道到底错在哪里了；查看了下工程的build.xml文件，感觉没有错阿，自己sdk/tools/ant下也存在build.xml文件阿；

后来才在自己的工程下的project.properties文件下发现了错误所在；原来是我sdk的路径写错了。。。

既然开始使用ant了，我就想着先了解学习学习下这个工具吧!

#### 1. 什么是Ant ####

Ant是一个基于Java的生成工具；在软件开发中用来将源代码和其他输入文件生成可执行文件；实现项目的自动构建和部署，确保每次的生成版本一致。

#### 2. Ant的安装 ####

一般Eclipse,MyEclipse等都已经给我们预先集成好了Ant，不需要我们生动安装；

当然你也可以选择自己安装；一般就是自己去下载个Apache Ant, 解压，然后添加系统环境变量：ANT\_HOME，该变量指向Ant解压后的根目录；

为了能让系统自动找到Ant 需要在系统环境变量path中添加Ant的bin目录；

完成后在命令行输入Ant就可以用啦～

#### 3. Ant的关键元素 ####

Ant的构建是基于XML编写的，默认名称为build.xml；

构建文件包括<project>元素，以及其中嵌套的<target>、<property> 和<path> 元素。

##### 1）project元素 #####

project元素是Ant构建文件的根元素，每个构建文件至少包含一个project元素；在每个project元素下可包含多个target元素

接下来看看project元素的各个属性：

name：用于指定project的名称

default：用于指定执行project默认执行时所执行的target名称

basedir：用于指定基路经的位置；该属性可以被basedir property覆盖。当覆盖时，该属性被忽略。如果属性和basedir property都没有设定，就使用buildfile文件的父目录。

##### 2）target元素 #####

它为Ant的基本执行单元，可以包含一个或多个具体任务；多个target可以存在相互依赖关系

接下来看看target元素的各个属性：

name：指定target元素的名称，这个属性在一个project元素中是唯一的

depends：用于描述target之间的依赖关系；若与多个target存在依赖关系时以“,”间隔；Ant会依据depends中target出现的先后顺序进行执行，被依赖的target先执行

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

unless：与if功能恰好相反，也用于验证指定的属性是否存在，若不存在，则target会被执行

description：对target功能的简单描述和说明

##### 3）property元素 #####

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

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

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

同时，Ant还提供了一些它自己的内置属性，如下：

basedir：project基目录的绝对路径，该属性在讲解project元素时有详细说明，不再赘述；

ant.file：buildfile的绝对路径，如上面的各例子中，ant.file的值为E:"build.xml；

ant.version：Ant的版本，在本文中，值为1.7.0；

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

ant.java.version ：Ant 检测到的JDK 的版本

#### 4. Java相关 ####

##### 1）Javac #####

编译java原代码

例子

1.<javac srcdir="\{src\}"

destdir="\{build\}"

classpath="xyz.jar"

debug="on"

编译\{src\}目录及其子目录下的所有。Java文件，。Class文件将放在｛build｝指定的目录下，classpath表示需要用到的类文件或者目录，debug设置为on表示输出debug信息

##### 2）<javac srcdir="\{src\}:\{src2\}"  destdir="\{build\}"  includes="mypackage/p1/\*\*,mypackage/p2/\*\*"  excludes="mypackage/p1/testpackage/\*\*"  classpath="xyz.jar"  debug="on"  />  编译\{src\}和\{src2\}目录及其子目录下的所有。Java文件，但是package/p1/\*\*,mypackage/p2/\*\*将被编译，而mypackage/p1/testpackage/\*\*将不会被编译。Class文件将放在｛build｝指定的目录下，classpath表示需要用到的类文件或者目录，debug设置为on表示输出debug信息 #####

##### 3） #####

<javac srcdir="\{src\}"

destdir="\{src\}"

classpath="\{classpath\}"

debug="on"

路径是在property中定义的

##### 4）打包相关 #####

jar

将一组文件打包

例子：

1.<jar destfile="\{dist\}/lib/app.jar" basedir="\{build\}/classes"/>

将\{build\}/classes下面的所有文件打包到\{dist\}/lib/app.jar中