Eclipse集成和调试Ant工程
Eclipse中集成和调试Ant工程
cheungmine
2012-5-01
摘要：使用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的目录结构如下：
zebra/
-----build.xml
+----src/
+----org/
+----cheungmine/
+----study/
----Main.java
build.xml的内容如下：
<?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>
Main.java的内容如下：
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工程源码