ANT学习笔记

下载ANT

google、baidu。

Windows用户下载zip格式。

 

Windows安装ANT

解压即可以使用。

所谓的安装ANT，即配置环境变量。

1. 添加ANT_HOME，以指定ant的路径。该路径指的是包含bin，lib的文件夹。
2. 配置PAHT，将%ANT_HOME%添加至环境变量PATH中。可以不配。只是为了方便的在cmd环境下使用。

注意Win7下安装时，若ANT_HOME配置在用户变量中，需要以管理员身份打开cmd才可以正常使用。所以，可以把ANT_HOME配置在系统变量中就好了。

 

 

基础入门

一、ant关键元素

1. project元素

    project 元素是 Ant 构件文件的根元素， Ant 构件文件至少应该包含一个 project 元素，否则会发生错误。在每个 project 元素下，可包含多个 target 元素。接下来向读者展示一下 project 元素的各属性。

• name 属性：用于指定 project 元素的名称。
• default 属性：用于指定 project 默认执行时所执行的 target 的名称。
• basedir 属性：用于指定基路径的位置。该属性没有指定时，使用 Ant 的构件文件的附目录作为基准目录。
• description 属性：该属性指定project描述说明。

 

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描述说明。

 

3. property 元素

    property元素可看作参量或者参数的定义。

    project 的属性可以通过 property 元素来设定，也可以Ant 之外设定。若要在外部引入某文件，例如 build.properties 文件。

 

property元素的常用属性

• name：指定名称。
• value：指定值。
• resource：指定属性文件的资源名称，ant将负责从属性文件中读取属性名和属性值。
• file：指定属性文件的文件名，
• url：指定属性文件的URL地址，
• environment：用于指定系统环境变量的前缀。ant可以访问系统环境变量。
• classpath：指定搜索属性文件的文件和路径集。
• classpathref：指定搜索属性文件的文件和路径集引用，该属性并不是直接给出系列文件或路径，而是给定文件和路径集引用。

 

    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 。

 

使用属性值
使用$符号使用属性值。例：${builddir}  //输出builddir属性值。

即$符号在Ant生成文件中具有特殊意义，若希望Ant把$当成普通字符，则应该使用$$。

例：

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

输出为：[echo] ${builddir}=dd

 

 

4.path元素与classpath元素

通常使用ant编译、运行java需要第三方JAR包。

path元素

 

classpath元素

 

 

 

二、ANT常用命令

javac：用于编译一个或多个Java元文件。

• srcdir属性：Java源文件位置。
• destdir属性：编译后的class文件的保存位置。

java：用于运行某个Java类，通常需要classname属性，用于指定需要运行哪个类。

 

jar：用于生产JAR包，通常需要指定destfile属性，用于指定所创建JAR包的文件名。通常还指定一个文件集，表示需要将哪些文件打包到JAR包里。

 

sql：用于执行一条或多条SQL语句，通常需要driver、url、userid和password等属性，用于指定连接数据库的基本信息。还可以通过src来指定需要执行的sql文件。或直接使用文本内容的方式指定SQL脚本字符串。

 

 

1. copy 命令

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

eg1. 复制单个文件：

 

eg2. 对文件目录进行复制：

 

eg3. 将文件复制到另外的目录：

 

2. delete 命令

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

eg1. 删除某个文件：

 

eg2. 删除某个目录：

 

eg3. 删除所有的备份目录或空目录：

 

3. mkdir 命令

    创建目录。 eg ：

 

4. move 命令

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

eg1. 移动单个文件：

 

eg2. 移动单个文件到另一个目录：

 

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

 

5. echo 命令

    该任务的作用是根据日志或监控器的级别输出信息。它包括 message 、 file 、 append 和 level 四个属性，举例如下

 

 

三、使用Ant工具

先使用cd命令到达目标文件夹下。

ant：该命令会让ant自动搜索当前文件夹下的build.xml。若找到，则以该文件作为生成文件，并执行默认的target。

 

ant -buildfile a.xml：该命令解析执行当前路径下的a.xml文件。-buildfile可以使用 -f -file代替。

ant -f a.xml：同上。

ant -file b.xml：同上。

 

-quiet 或 -q 选项：ant运行时，输出少量必要信息。

-verbose 或 -v 选项：ant运行是，输出更多提示信息。

-logfile 或 -l 选项：ant运行时将提示信息输出到指定文件，而不是直接输出到控制台。

例如：

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

 

-D ：运行时自定属性来覆盖生成文件中的属性值。

ant -Dbook=Spring2  该命令会覆盖生成文件中的book属性值。

ant -Denv=%ANT_HOME% 该命令使用环境变量的值。通过这种方式就可以将环境变量的值传入生产文件。在Linux平台下改为 ant -Denv1=$ANT_HOME。

 

默认情况下下，Ant运行生成文件里指定的默认target。

ant target ：运行时指定需要运行的target。

ant target1 target2 ：运行多个target。

例：ant run ：即运行生成文件中名称为run的target。

 

ant -help ：获取更多ant命令的详细信息。