Ant与Eclipse的集成 第一部分

编者按:每当我们做了一项调查,我们发现越来越少的java开发者严格地使用command-line/text-editor（命令行/文本编辑器）方式. 绝大多数都采用了IDE（集成开发环境）,而且大部分选择了Eclipse.设想一下，你乐意用IDE生成代码，而又不得不用命令行来编译? 答案当然是否定的.在对两个部分节选 Ant:权威指南第二版 两个节选的第一部分SteveHolzner说明如何将Ant集成到Eclipse中、通过在Eclipse中编写一个Ant  build.xml 文件,就可以在IDE内部运行编译了。

Ant是Java开发者首选的编译工具，Eclipse是Java程序员首选的集成开发环境(IDE)。Eclipse擅长可视化开发，Ant擅长编译。为此，最新Eclipse版本(3.0)集成了Ant 1.6.1(此版本就是这本书写的版本)，在Eclipse中有了Ant扩展接口。

作者:greenieu(作者的blog:http://blog.matrix.org.cn/page/greenieu)
原文:http://www.matrix.org.cn/resource/article/44/44341_Eclipse+Ant.html
关键字:Eclipse;Ant

提示：Ant没有自己的IDE么？当然不是，Antidote，一种始于2000年的Ant IDE 项目；详见http://archive.apache.org/dist/ant/antidote/。不幸的是，这个项目现在半死不活的，主要原因是Eclipse背后的大人物开始把Ant纳入他们的IDE中了。

介绍Eclipse

作为一个Java开发者，你有时可能感受到Java格式的严格。丢失 import声明，忘记声明变量，没有分号，语法混淆，以及文本编辑器的排版都可能引起Java命令行编译器 javac 的反应，其结果就是显示若干页的错误信息。
错误信息告诉你 javac 知道了错误,但是为什么不解决这个问题，让你得以继续工作？ javac 不能解决这个问题； 要做到这一点，你可以用一个IDE，在编译之前捕获错误,并给出建议。 Java现急需好的IDE，目前Java最好的IDE是Eclipse. 如图11-1.


图11-1  Eclipse

像其它许多Java IDEs, Eclipse免费下载,但是Eclipse背后有许多优势,这是IBM的力量,据说花费4000万美元开发. 现在，它是一个开放源码的项目,主要是在IBM软件开发,但部分是由名为 Eclipse.org 的软件组织.
提示: 如果想阅读更多关于Eclipse. 查看 Eclipse的帮助 (O'Reilly).

获得Eclipse

Eclipse免费下载; 你所要做的是浏览 http://www.eclipse.org/downloads . 在网页上选择一个可下载的镜像. 当你做什么,你会提出一系列的可下载各种类型: 当你打开网页，你会看到一个不同版本的可下载地址的列表。

Release builds（发布版）
这是供一般使用的版本.

Stable builds （稳定版）
类似于试用版.

Integration builds（集成版）
这个版本是由经过一定测试的组件组成的,但集成操作可能会有一些问题.

Nightly builds
这个版本是Eclipse所有发布版本中最具实验性质的，是由Eclipse团队每天发布的，但最能否正常工作并不提供什么担保.
提示: 同其他软件,你一般使用最新的Eclipse发布版; 本节中我用最新的发布版，Eclipse3.0。

选择适合你操作系统的版本，点击适当的链接,并下载它. Eclipse安装很容易; 你所要做的就是unzip（Windows OS）或untar（linux/Unix OS）它（解压缩）,具体的操作取决于你的操作系统. 因为你下载的版本是针对你的操作系统的,所以当你解压缩Eclipse后，就会发现文件夹中存在可执行文件. 通过运行Eclipse可执行文件开始运行Eclipse. 当你第一次运行Eclipse,你应该看到欢迎页. 要查看Eclipse的概况或教程,只要适当的链接. 关闭欢迎页,只要点击页面标题栏的X号.

建立Eclipse项目

如果你有安装Eclipse并开始运行,你就进入了Ant/Eclipse界面，并不修要做什么额外的工作. Eclipse开发是基于项目 的,我将创造了一个新的项目,演示如何在Eclipse中使用Ant. 建立一个新项目,选择 File→ New→ Project,打开New Project对话框. 选择Java项目点击 Next.

在下一页中,给项目起名为 AntExample . 其他选项默认，然后按完成.

这样在Eclipse中就建立了一个新项目. 你可以在Eclipse左侧的Package Explorer中看到 AntExample 项目。

这个项目到目前为止是空的; 要想加入Java代码，在Package Explorer中选择 AntExample项目，然后选择File→ New→ Class，打开New Java Class对话框. 在package name中填入 org.antbook ,新类的名字为 AntClass ，选中标为public static void main(String[] args)的复选框，使Eclipse创建一个main方法. 点击Finish按钮.

这样就完成了创建一个带有main( ) 方法的 Antclass.java 代码，你可以在图11-2中间的Eclipse编辑器中看到。


图11-2 一个新的Java类

增加如下代码是这个类完成一些功能。

public static void main(String args[]) 
{
    System.out.println("No worries.");    
}

在工具栏中点击Save图标保存对AntClass.java的更改，然后选择Run→ Run As→ Java Application，你可以在Eclipse底端的Console制表位中看到这段代码的输出，No worries.。

在Eclipse 中写一个Ant 编译文件

在Eclipse 中建立一个Ant 编译文件，在Package Explorer中右键点击 AntExample 项目,选择 New→ File. 在File Name框中填入 build.xml ,点击完成,在 AntExample 项目中添加新的文件. 将项目打包，将这个XML填入build文件 。

<?xml version="1.0" ?>
<project default="main">
    <target name="main" depends="compile, compress" description="Main target">
        <echo>
            Building the .jar file.
        </echo>
    </target>
  
    <target name="compile" description="Compilation target">
        <javac srcdir="org/antbook"/>
    </target>
  
  <target name="compress" description="Compression target">
        <jar jarfile="Project.jar" basedir="org/antbook" includes="*.class" />
  </target>
</project>

将XML代码填入build文件中并保存。Eclipse显然支持Ant; build.xml 在Package Explorer中左侧出现了一个Ant图标，而且build文件的语法着色也发生了变化，XML声明用一个颜色,属性值用一个颜色,而Ant关键字用另一个颜色，如图11-3(用鲜明的黑色和白色). Build文件的目标（targets）出现在右侧的Outline视图中



提示: 如果你关闭 build.xml 你可以在Eclipse Ant编辑器中重新打开; 在Package Explorer中双击它. 这是不同于以往版本Eclipse,没有默认的蚂蚁编辑器. 你不得不采取额外措施打开Ant编译文件来编辑.
显然Eclipse的 代码助手 (又称 内容助手 )对Ant支持, Eclipse3.0增加了对Ant build文件的代码助手支持. 当你进入描述Ant元素或属性的区域时，可以按Ctrl-Space打开代码助手,将列出你可能要打的内容,如图11-4.


图11-4 使用代码助手

提示: 如果你键入 $ 并且使用代码助手,Eclipse的Ant编辑器将列出所有Ant属性名.
Eclipse3.0能够在Ant build 文件中捕捉到语法错误. 例如,用</targe>终止一个目标  而不是</target>标签,立即引起了Eclipse Ant编辑器的注意,如图11-5. 如果你让你光标停留在问题线左侧的 图标上,就可以看到Eclipse对于这个问题的解释:" Expected `</target>' to terminate element starting on line 3."（缺少`</target>'终止第三行开始的元素）单独这种语法检查和纠正句法就很值钱了。


图11-5 处理语法错误

提示: 为了更加精细的排版,你可以重新格式化一个Ant build文件，在Ant编辑器的环境菜单中使用格式化命令(Ctrl-Shift-F)或选择Edit→ Format.

想要看到属性值， 将鼠标在其上方停留,属性值将出现在提示工具中.

提示: 在某些情况下, Eclipse会为你产生Ant脚本. 举例来说,如果你创建一个Eclipse插件,使用自己的视图和编辑器来扩展Eclipse,你会使用一个插件说明文件 Plugin.xml . 如果你右键点击说明文件并且选择”Create Ant Build File”（创建Ant编译文件）项,Eclipse会为您创建一个build文件. 如果你选择Project→ Generate Javadoc，Javadoc向导将使用javadoc工具生成Ant编译文件,可以根据需要进行编辑.

运行Ant Build文件

在Eclipse中运行build文件,你有两种选择. 你可以在Package Explorer中右击 build.xml选择Run→ Ant Build. 这样来运行Ant，在Eclipse的控制台给出结果.

提示: Eclipse3.0在一个隔离的JVM中运行Ant,解决了不少困扰以前版本的问题,.

控制台给出的如果和你用命令行运行build文件的结果是一样的:
Buildfile: D:/eclipse3/eclipse/workspace/AntExample/build.xml
compile:
    [javac] Compiling 1 source file
compress:
      [jar] Building jar: D:/eclipse3/eclipse/workspace/AntExample/Project.jar
main:
     [echo] Building the .jar file.
BUILD SUCCESSFUL
Total time: 2 seconds

如果有问题,你可以看控制台中Ant的输出. Eclipse将在问题栏中给你一个问题汇总,你可以通过点击Eclipse底部的问题栏查看.
另一种运行build文件的方法是, Package Explorer中右键点击 build.xml 选择Run→ Ant Build...,带有省略号(3个点). 将打开Ant运行配置对话框，如图11-6. Ant运行配置是针对当前项目的.


图11-6 选择一个Ant目标

默认的，对话框选中的是目标栏，显示build.xml文件中的目标（target）列表. 默认目标已被选定; 你可以点击Run按钮运行目标,或者你可以选择其他目标. 如果你只选定默认目标,也可以在控制台看到同样的结果.

你可以设置目标的执行顺序,目标的执行顺序显示在对话框的最下面Target execution order 文本框中(你选择项目的先后次序将是他们运行的顺序). Ant仍然会运行每个目标的先决条件，但你还是得小心，以免把整个编译顺序搞乱.

为Ant选择build文件和传递参数

在Eclipse中你可以得到和用命令行运行Ant的所有功能. 例如，对Ant传递参数,右键点击 build.xml 选择Run→ Ant Build... 打开Ant运行配置. 点击Main栏如图11-7. 在此页,你可以制定你想使用的编译文件、编译的目录,还可以给Ant传递参数.


图11-7 设置build文件，将参数传给Ant

提示: 位于对话框底端的Capture output复选框表明你是否想在Eclipse控制台中显示Ant的输出，默认是选中的.

Ant与Eclipse的集成 第二部分 <script language="javascript" type="text/javascript">document.title="Ant与Eclipse的集成 第二部分 - "+document.title</script>