Oo缘来是你oO


posts - 120,comments - 125,trackbacks - 0
Eclipse快速上手指南之使用Ant

作者:佚名     来自:J2ME开发网

  Ant是Java平台下非常棒的批处理命令执行程序,能自动完成编译,测试,打包,部署等等一系列任务。

  Ant是Java平台下非常棒的批处理命令执行程序,能非常方便地自动完成编译,测试,打包,部署等等一系列任务,大大提高开发效率。如果你现在还没有开始使用Ant,那就要赶快开始学习使用,使自己的开发水平上一个新台阶。

  Eclipse 中已经集成了Ant,我们可以直接在Eclipse中运行Ant。

  以前面建立的Hello工程为例,创建以下目录结构:

  新建一个build.xml,放在工程根目录下。build.xml定义了Ant要执行的批处理命令。虽然Ant也可以使用其它文件名,但是遵循标准能更使开发更规范,同时易于与别人交流。

  通常,src存放Java源文件,classes存放编译后的class文件,lib存放编译和运行用到的所有jar文件,web存放JSP等web文件,dist存放打包后的jar文件,doc存放API文档。

  然后在根目录下创建build.xml文件,输入以下内容:

<xml version="1.0"?>
<roject name="Hello world" default="doc">

<-- properies -->
<roperty name="src.dir" value="src" />
<roperty name="report.dir" value="report" />
<roperty name="classes.dir" value="classes" />
<roperty name="lib.dir" value="lib" />
<roperty name="dist.dir" value="dist" />
<roperty name="doc.dir" value="doc"/>

<-- 定义classpath -->
<ath id="master-classpath">
<ileset file="${lib.dir}/*.jar" />
<athelement path="${classes.dir}"/>
<path>

<-- 初始化任务 -->
<arget name="init">
<target>

<-- 编译 -->
<arget name="compile" depends="init" description="compile the source files">
<kdir dir="${classes.dir}"/>
<avac srcdir="${src.dir}" destdir="${classes.dir}" target="1.4">
<lasspath refid="master-classpath"/>
<javac>
<target>

<-- 测试 -->
<arget name="test" depends="compile" description="run junit test">
<kdir dir="${report.dir}"/>
<unit printsummary="on"
haltonfailure="false"
failureproperty="tests.failed"
showoutput="true">
<lasspath refid="master-classpath" />
<ormatter type="plain"/>
<atchtest todir="${report.dir}">
<ileset dir="${classes.dir}">
<nclude name="**/*Test.*"/>
<fileset>
<batchtest>
<junit>
<ail if="tests.failed">
***********************************************************
**** One or more tests failed! Check the output ... ****
***********************************************************
<fail>
<target>

<-- 打包成jar -->
<arget name="pack" depends="test" description="make .jar file">
<kdir dir="${dist.dir}" />
<ar destfile="${dist.dir}/hello.jar" basedir="${classes.dir}">
<xclude name="**/*Test.*" />
<xclude name="**/Test*.*" />
<jar>
<target>

<-- 输出api文档 -->
<arget name="doc" depends="pack" description="create api doc">
<kdir dir="${doc.dir}" />
<avadoc destdir="${doc.dir}"
author="true"
version="true"
use="true"
windowtitle="Test API">
<ackageset dir="${src.dir}" defaultexcludes="yes">
<nclude name="example/**" />
<packageset>
<octitle>[CDATA[<1>ello, test<h1>]>doctitle>
<ottom>[CDATA[<>ll Rights Reserved.<i>]>bottom>
<ag name="todo" scope="all" description="To do:" />
<javadoc>
<target>
<project>

  以上xml依次定义了init(初始化),compile(编译),test(测试),doc(生成文档),pack(打包)任务,可以作为模板。

  选中Hello工程,然后选择“Project”,“Properties”,“Builders”,“New…”,选择“Ant Build”:

  填入Name:Ant_Builder;Buildfile:build.xml;Base Directory:${workspace_loc:/Hello}(按“Browse Workspace”选择工程根目录),由于用到了junit.jar包,搜索Eclipse目录,找到junit.jar,把它复制到Hello/lib目录下,并添加到Ant的Classpath中:

  然后在Builder面板中钩上Ant_Build,去掉Java Builder:

  再次编译,即可在控制台看到Ant的输出:

Buildfile: F:\eclipse-projects\Hello\build.xml

init:

compile:
[mkdir] Created dir: F:\eclipse-projects\Hello\classes
[javac] Compiling 2 source files to F:\eclipse-projects\Hello\classes

test:
[mkdir] Created dir: F:\eclipse-projects\Hello\report
[junit] Running example.HelloTest
[junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 0.02 sec

pack:
[mkdir] Created dir: F:\eclipse-projects\Hello\dist
[jar] Building jar: F:\eclipse-projects\Hello\dist\hello.jar

doc:
[mkdir] Created dir: F:\eclipse-projects\Hello\doc
[javadoc] Generating Javadoc
[javadoc] Javadoc execution
[javadoc] Loading source files for package example...
[javadoc] Constructing Javadoc information...
[javadoc] Standard Doclet version 1.4.2_04
[javadoc] Building tree for all the packages and classes...
[javadoc] Building index for all the packages and classes...
[javadoc] Building index for all classes...
[javadoc] Generating F:\eclipse-projects\Hello\doc\stylesheet.css...
[javadoc] Note: Custom tags that could override future standard tags: @todo. To avoid potential overrides, use at least one period character (.) in custom tag names.
[javadoc] Note: Custom tags that were not seen: @todo
BUILD SUCCESSFUL
Total time: 11 seconds

  Ant依次执行初始化,编译,测试,打包,生成API文档一系列任务,极大地提高了开发效率。将来开发J2EE项目时,还可加入部署等任务。并且,即使脱离了Eclipse环境,只要正确安装了Ant,配置好环境变量ANT_HOME=<nt解压目录>Path=…;%ANT_HOME%\bin,在命令行提示符下切换到Hello目录,简单地键入ant即可。



马嘉楠
jianan.ma@gmail.com

posted on 2006-08-11 17:55 马嘉楠 阅读(190) 评论(0)  编辑  收藏

只有注册用户登录后才能发表评论。


网站导航: