使用Ant打包工具 基本介绍

时间:2023-03-08 16:56:12

由于使用java,javac,jar等工具进行编译打包,即繁琐低效又容易出错,因此Ant出现了。

Ant的出现就是专门为了打包编译java代码的,使用之前得稍微学一下。Ant的运行起来主要是依靠配置文件(XML格式),通常命名为build.xml。

使用ant之前当然先装好Java的JDK,JRE,该设的环境变量都弄好。

然后在cmd窗口中输入ant.bat。如果设置好ant_home的话,不需要绝对路径的。本人偷懒,没设,但照样可以用。

输入ant.bat -version,查看版本号。

使用Ant打包工具 基本介绍

如果正确显示,说明安装没有问题了。

接下来的主要任务,其实是如何编辑build.xml,因为ant所做的动作都是按照build.xml中规定的来执行的。可以从ant官网下载帮助文档。

帮助文档很详细,此处只是快速上手,因此简单讲解一下。

build.xml中的节点很多,但是以下几个节点比较重要,理解这些节点是很有必要的。

project,target,property,task,build-in property等.

project是项目的意思,它是Ant中build.xml文件的根节点, 配置文件至少应该包含一个project,否则会发生错误。在每个project元素下,可包含多个target元素。

project通常的写法为:

<project name ="jTest" default="jar" basedir=".">

意思是项目名为jTest,默认执行jar命令,基准目录是当前目录。

default指的是该配置文件中要运行的默认的目标。看稍后的例子就会明白。

再说一下property节点,这个节点类似是定义了一些常量。Ant自身内建了一些预定义的属性,比如${os.name} 的值就是当前操作系统的名字。如果某个值经常要用到的,那么把它自定义在属性里面,这样要用到这个值的时候,直接用${属性名} 的方式就可以获得了。内建属性也有很多,可以看帮助文档了解更多。这里只说明一下basedir属性,该属性设置了项目的基准路径,该属性在poject节点中定义。

property节点中,有2个特性,value和location,稍微有点区别,使用了value就不能使用location,反之亦然,如果这个属性的值是一个路径,那么,如果用value的话,就必须给出绝对路径,但是如果有location的话,可以只给出相对路径(相对于project中的basedir)。

target是目标的意思,它包含在project节点内部的,一个project节点可以包含多个target。

一个target内部是定义一些动作命令,即target内定义要做些什么任务。这些任务被称作task。要做什么任务必须要写什么样的指令。这些指令在帮助文档中都可以查到,这里只列出几个常见的。

copy,delete,mkdir,Jar,Java,Javac,看名字类似dos命令,作用也确实和dos命令的差不多。jar表示打包,java表示运行类文件,javac编译文件。

看一个例子:

  1. <target name="compile" depends="init"
  2. description="compile the source " >
  3. <!-- Compile the java code from ${src} into ${build} -->
  4. <javac srcdir="${src}" destdir="${build}"/>
  5. </target>

这组xml意思是target的名称为compile,这个可以自定义,depends指的是依赖另一个目标,也就是说若果要运行compile目标,必须先运行depends目标。

接下来就是javac任务,通过<javac srcdir="${src}" destdir="${build}"/>,表示对srcdir路径下的类运行javac命令编译,然后编译的结果输出到destdir中去。

${src},${build}都是属性值。

最后看一个例子。

假设当前的要打包的原文件的目录结构如下,把编辑好的build.xml文件放到要编译打包的目录中去。

  1. D:\TMPMULU
  2. │  build.xml
  3. └─src
  4. └─mytest
  5. ├─AnotherPackage
  6. │      ClassPrintA.java
  7. │      ClassPrintB.java
  8. └─mytestpkg
  9. Tj.java

build.xml的内容如下:

  1. <?xml version="1.0" ?>
  2. <project name ="jTest" default="jar" basedir="."><!--默认运行jar目标,但是jar目标依赖run目标,
  3. run目标依赖compile目标,compile目标依赖clean目标,因此运行顺序是clean,compile,run,jar-->
  4. <target name="clean">
  5. <delete dir="${basedir}/build"/><!--执行删除动作,删除路径在dir中定义,
  6. ${basedir}属性值在project节点中定义了-->
  7. </target>
  8. <target name="compile"  depends ="clean">
  9. <mkdir dir ="${basedir}/build/classes"/><!--mkdir,创建目录,运行该任务前必须先运行clean目标-->
  10. <javac srcdir ="${basedir}/src" destdir ="${basedir}/build/classes"/><!--运行javac,执行编译,编译的路径是srcdir,编译完成后输出目录是destdir-->
  11. </target>
  12. <target name="run" depends ="compile">
  13. <java classname ="mytest.mytestpkg.Tj"><!--执行java命令,即运行编译后的类,该目标必须在compile目标之后运行-->
  14. <classpath>
  15. <pathelement path="${basedir}/build/classes"/><!--dos中java命令要设置classpath参数,通过这个节点设置-->
  16. </classpath>
  17. </java>
  18. </target>
  19. <target name="jar" depends="run">
  20. <jar destfile="Tj.jar" basedir="${basedir}/build/classes"><!--运行jar命令,执行打包动作,必须在run目标完成才执行。-->
  21. <manifest>
  22. <attribute name="Main-class" value="mytest.mytestpkg.Tj"/><!--创建一个manifest文件。manifest文件的概念可以参考JAR文件规范
  23. http://docs.oracle.com/javase/1.5.0/docs/guide/jar/jar.html#JAR Manifest-->
  24. </manifest>
  25. </jar>
  26. </target >
  27. </project>

运行ant命令。两种方式:如果当前路径不是D:\tmpmulu\,则可以通过-f参数指定build.xml文件的位置。

C:\Users\Administrator>C:\ant\bin\ant.bat -f D:\tmpmulu\build.xml

如果当前路径是D:\tmpmulu\,直接运行ant.bat就可以了,ant会自动寻找build.xml.

使用Ant打包工具 基本介绍

运行后,界面上会显示出每个目标的运行情况,run目标中,会输出程序打印的内容。并且在basedir下,生成一个Tj.jar的包。运行后的文件结构如下:

  1. D:\TMPMULU
  2. │  build.xml
  3. │  Tj.jar
  4. ├─build
  5. │  └─classes
  6. │      └─mytest
  7. │          ├─AnotherPackage
  8. │          │      ClassPrintA.class
  9. │          │      ClassPrintB.class
  10. │          │
  11. │          └─mytestpkg
  12. │                  Tj.class
  13. └─src
  14. └─mytest
  15. ├─AnotherPackage
  16. │      ClassPrintA.java
  17. │      ClassPrintB.java
  18. └─mytestpkg
  19. Tj.java

借助一些IDE工具,比如eclipse等,可以不必手动编辑build.xml,工具会自动帮我们生成的。

本文出自 “一只博客” 博客,请务必保留此出处http://cnn237111.blog.51cto.com/2359144/1130502