|
摘要：使用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，它包含了下面的开发组件：
在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工程源码
|
