一、 修改Ant Classpath
在使用一个可选的或定制的任务时,你可能需要把其它库添加到classpath中。为此,你可以通过以全局方式或使用一个单独工程的启动配置来修改Ant classpath。为了给一个单独的Eclipse工程设置Ant classpath,打开该工程的Ant启动配置并点击Classpath选择卡;然后,通过点击"Add External JARs"按钮来添加外部的JAR文件。
你可以用全局方式修改Ant classpath以使之应用于所有的工程。为此,你可以选择"Window→Preferences→Ant→Runtime"并点击"Classpath"选项卡。在此,你可以据需要添加JAR文件,通过这种途径进行的设置可以为所有的Ant构建所用。
二、 设置属性值
你可以使用"Ant preferences"页面(通过"Window→Preferences→Ant→Runtime"并点击"Properties"选项卡来打开它)来设置全局的Ant属性。为了添加一个新属性,点击"Add Property"按钮,然后在出现的对话框中填入Name和Value域。这样以来,将为Eclipse中的所有Ant构建设置全局属性;并且由于属性是不可改变的,所以你也就设置了这些属性的最终值。
你可以通过设置工程的Ant启动配置来为每个工程进行属性设置。为此,你可以点击启动配置中的Properties选项卡(见图1),取消选定"Use global properties as specified in the Ant runtime preferences"复选框,并且点击"Add Property"按钮来设置新属性。
图1.设置属性
三、 设置环境变量
你可以设置你想要传递到Ant的环境变量,但是你必须确保Ant会运行在它自己的JRE中(默认情况)。在工程的Ant启动配置中,点击"JRE"选项卡并点击"Separate JRE"单选按钮。为了设置环境变量,点击"Environment"选项卡(显示于图2),并点击"New"按钮来创建一个新的环境变量。
图2.设置环境变量
当你点击"New"按钮时,出现"New Environment Variable"对话框。然后,在适当的域中输入该环境变量的名字和值,并且单击"OK"即可。
四、 配置Ant编辑器
你可以使用Ant编辑器上下文菜单中的"Format"命令(Ctrl-Shift-F)或选择"Edit→Format"命令来重新格式化一个Ant build文件。为此,你可以通过"Window→Preferences→Ant→Editor→Formatter"来打开"Ant preferences"页面,见图3。你所做的任何变化都会反映到该Preview框中。
图3.配置Ant格式
选择"Window→Preferences→Ant→Editor"能够允许你配置build文件编辑器(设置制表位宽度,边界区域,高亮,等等)。
五、 添加新的Ant任务和类型
你可以通过使用"Window→Preferences→Ant→Runtime"中的"Ant preferences"页面来把新的Ant任务和类型添加到Eclipse中。这些任务和类型可以在将来用于build文件而不必使用taskdef或typedef任务(它们在通常情况下是需要的)。
为了添加一项新任务,请选择显示在图4中的"Tasks"选项卡,并点击"Add Task"按钮,然后导航到新的Ant任务所在的JAR文件。为了添加一个新类型,点击"Types"选项卡,并且遵循与刚才一样的步骤即可。
图4.添加Ant任务
提示:如果你不能找到你需要的JAR文件,那么你应该首先把它们添加到Ant classpath中。
作为选择,你可以通过点击Classpath选项卡来把定义任务和类型的其它类添加到Ant classpath中。
六、 使用不同版本的Ant
随同Eclipse一起发行的是Ant 1.6.1,但是也可使用另外其它版本。为此,你可以选择"Window→Preferences→Ant→Runtime"并点击Classpath选项卡从而打开"Ant preferences"页面。
当Eclipse运行Ant时,它在Ant的classpath中查找适当的类-这与在"Ant Home Entries"中设置的一致。为了改变"Ant Home Entries",只要点击"Ant Home"按钮并且选择你希望使用的Ant安装即可。
提示 如果你不想改变classpath,你可以从Eclipse中把Ant作为一个外部的工具运行。为此,你只要选择"Run→External Tools→External Tools"来打开"External Tools"对话框,再点击Program,然后点击New按钮,为这个新工具输入一个名字(例如"Ant 1.8"或其它任何适当的名字)。接下来,转到"Location"域,点击"Browse File System"按钮并且导航到ant.sh或ant.bat(具体依赖于你的操作系统),并且点击"Open"。之后出现"External Tools"对话框;在"Arguments"域中输入你想要传递到Ant的任何参数。最后,在"Working Directory"域中,输入你想要使用的build文件所在的目录并且点击"Run"来启动这个新版本的Ant。这样做所存在的问题是,当在Eclipse中工作时,你不能方便地存取你所拥有的预定义值。总之,在大多数情况中,当构建Eclipse工程时,从Eclipse内使用Ant更好一些。
选中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=<Ant解压目录>,Path=…;%ANT_HOME%\bin,在命令行提示符下切换到Hello目录,简单地键入ant即可。