在Eclipse中集成Ant编程之配置祥解篇

一、 修改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即可。