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的内容如下:
<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的内容如下:
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任务后,顺利进入代码中的断点