Eclipse中集成和调试Ant工程

转载自：http://www.uml.org.cn/j2ee/201205103.asp

摘要：使用Ant来构建 Java小型或大型项目的好处是不言而喻的。本文展示如何在Eclipse里集成Ant的工程，并配置使能调试Ant构建脚本build.xml 和.java源代码文件。一般我们把使用Ant构建的Java项目导入到Eclipse里时，会遇到这个问题：调试Ant的build.xml脚本和指定 使用哪个Ant的任务（task）来调试java源代码文件。

1 快速从0开始搭建Eclipse+Ant环境

为简单起见，本文的Eclipse开发环境采用nvidia提供的一键式组合开发包Tegra Android Developer Pack（NVPACK），在下面的网址中可以下载你需要的版本：

http://developer.nvidia.com/tegra-resources

我选择了：Tegra Android Developer Pack 1.0r7，它包含了下面的开发组件：

• Android SDK r18

• Android NDK r7c

• JDK 6u24

• Cygwin 1.7

• Eclipse 3.7.1

• CDT 8.0.0

• ADT 15.0.0

• Apache Ant 1.8.2

• NVIDIA Debug Manager for Eclipse 12.0.0

• Tegra Sample Code
  

在Ubuntu下如何安装这个NVPACK，请参考文章：

一键解决Ubuntu下安装Eclipse Android/C/C++ 开发环境

2 创建一个简单的Ant工程

例子工程zebra的目录结构如下：

 

[plain] view plaincopyprint?    zebra/          -----build.xml          +----src/               +----org/                    +----cheungmine/                         +----study/                              ----Main.java

build.xml的内容如下：

 

[html] view plaincopyprint?    <span style="font-size:12px;color:#333333;"><?xml version="1.0" encoding="UTF-8"?>      <project name="zebra" default="compile">          <description>My first complete build file, including packaging and executing a Java program.</description>          <target name="init" description="Create the output directories">              <mkdir dir="build/classes"/>              <mkdir dir="dist"/>          </target>                <target name="compile" depends="init" description="Compiles into the output directories">              <javac srcdir="src" debug="true" destdir="build/classes" includeantruntime="false"></javac>          </target>                <target name="package" depends="compile" description="Creates the JAR package files">              <jar destfile="dist/zebra.jar" basedir="build/classes"></jar>          </target>                <target name="clean" description="Delete the output directories">              <delete dir="build"/>              <delete dir="dist"/>          </target>                    <target name="exec" depends="compile" description="Running programs under Ant">              <!-- $ java -cp build/classes org.cheungmine.study.Main hello world . -->              <java classname="org.cheungmine.study.Main" classpath="build/classes">                  <arg value="hello"/>                  <arg value="world"/>                  <!--                       the following arg uses the file attribute, which tells Ant to resolve                       that attribute to an absolute file location before calling the program.                  -->                  <arg file="."/>              </java>              <!--              <echo level="verbose" message="running"/>              <echo level="info" message="running"/>              <echo level="warning" message="running"/>              <echo level="error" message="running"/>              -->          </target>      </project></span>                          

Main.java的内容如下：

 

[java] view plaincopyprint?    package org.cheungmine.study;      public class Main {          public static void main(String args[]) {              System.out.println("org.cheungmine.study");              for(int i=0; i< args.length; i++) {                  System.out.println(args[i]);              }          }      }                          

3 导入Ant工程到Eclipse中

上面的工程在ant下构建成功。下面把它导入到Eclipse中。选择菜单：

Eclipse->File->New->Project...->Java Project from Existing Ant Buildfile

按[Next]，在Ant buildfile选择：<yourpath>\zebra\build.xml

按[Finish]。这样Ant工程就被导入到Eclipse中了。

在Eclipse的Package Explorer中定位到文件build.xml，在任一行设置断点，

菜 单Eclipse->Window->Show View->Ant确保Ant和Outline出现在右边的窗口中。如果Outline中没有build.xml的内容，切换到Ant窗口，选择 Add Buildfiles来加入build.xml，这样在Outline中就出现了如下面的图1：

图1 在Eclipse中调试build.xml

选择Outline->exec->右键->Debug As->Ant Build，即看到左边的断点被调试执行。这个仅仅是调试Ant的build.xml文件，接下来的方法用来直接调试Java代码，本例中是Main.java。

4 使用 Ant 构建文件作为项目构建器

在 使用 Eclipse Java IDE 时，默认使用了 Java Builder。每当我们保存文件时，Java Builder 就会在后台默默地运行，并立即对这些文件进行编译。它是 Eclipse 重大的特性之一：Java Builder 允许我们完全跳过编译过程，因为我们的程序总是 处于已编译状态，即使它充满了错误亦是如此。因此，我们可以在键入之后立即运行 Java 程序，无需首先通过一个漫长而乏味的编译过程。该功能为 Eclipse 用户省去了大量的时间和争论，也是 Eclipse 能够在程序员中广泛流行的原因之一。

但 是如果我们想要做编译文件以外的事情呢？如果我们想要为整个项目创建一个 jar 文件，并且在每次修改项目时将该文件复制到一个特定的目录呢？如果我们想要所有这些都发生在后台，无需每次都告诉 Eclipse 呢？我们完全可以坐下来、放松、编写一些代码、喝杯咖啡，让 Eclipse 在后台处理复杂的构建过程，甚至无需知道这个过程正在后台进行。

听起来是不是像做梦呀？不是做梦。我们可以真正做到这样的事情。我们只需要将一个 Ant 构建文件作为“构建器” 添加到我们的项目即可，这个构建文件中定义了构建过程的所有复杂性。这样做之后，魔术将开始上演。

右 击 Package Explorer 视图中的项目并单击 Properties（或者：Eclipse菜单->Project->Properties），展开 Builders 并单击 New，向项目添加一个新的构建器MyAntBuilder。添加之后的样子如下图2：

图2 使用Ant构建文件作为项目构建器

图3a Ant项目构建器Main属性

图3b Ant项目构建器Refresh属性

图3c Ant项目构建器Target属性

在这里，我们选择构建文件何时真正运行，更具体来说，运行哪个目标。有四个选项：

??? After a "Clean" —— 每当我们在项目上执行一个清除操作时，目标就会运行。

??? Manual Build —— 在自动构建被关闭的时候使用该选项。每当我们执行手动构建时，指定的目标就将运行。

??? Auto-Build —— 每当执行自动构建时，目标就会运行。一般来说，就是每当我们保存 Java 文件时。

??? During a "Clean" —— 该选项与 After a "Clean" 选项不同，因为目标是在清除操作本身期间被调用。使用该选项在清除操作期间执行一些定制的文件清除。

这样，每次我们Eclipse->Project->Build All / Clean时，Eclipse都是调用Ant的构建器来构建项目了。但是仍然不能调试到Java源代码中。因此我们需要：

5 在Eclipse内调试自定义的Ant task

在 左边的Package Explorer中右键点击zebra项目，选择Build Path->Add External Archives...，选中你的${ANT_HOME}/lib/下的全部jar文件。我这里是：C:\NVPACK\apache-ant- 1.8.2\lib\*.jar。

再一次，选择Build Path->Add External Archives...，选中你的${JAVA_HOME}/lib/下面的tools.jar文件。我这里是：

C:\NVPACK\jdk1.6.0_24\lib\tools.jar。

这些jar都被增加到zebra的Referenced Libraries下面。接下来配置使用Ant的Main来调试java。进入菜单：Eclipse->Run->Debug Configurations...，在左边的Java Application下面增加一个设置：Ant_Main。如图4：

图4a Ant项目Debug配置

图4b Ant项目Debug配置

这样就表示我们要用Ant的exec这个task来调试我们的java代码。如下图5 在Main.java中放置断点，并启动Ant_Main来调试，可以看到Ant任务后，顺利进入代码中的断点。

图5a Eclipse启动Ant任务调试

图5b Eclipse中调试Ant工程源码