<转>修改Ant 的 classpath

laorer

浏览: 434671 次
性别:
来自: 深圳

最近访客更多访客>>

xubukang

nowayout

495127903

nucleus

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

j2EE

Ant Eclipse IDE XML 浏览器

修改Ant 的 classpath

当使用一个有选择的或可订制的任务, 增添额外的动态链接库到classpath可能是必要的. Ant的classpath可以全局性的修改，也可以使用单个项目的launch configuration（启动配置）来修改. 为Eclipse项目设置Ant的classpath的方法为：打开项目的Ant launch configuration,点击Classpath选项卡，点击Add External JARs 按钮增加额外的JARs.

你可以全局性的为所有项目修改Ant classpath. 方法为：选择Window→ Preferences→ Ant→ Runtime,点击classpath选项卡. 你可以在这里根据需要增加JARs文件,就会被所有的Ant构建使用了.

设置属性值

你可以用Ant参数页设置Ant 全局属性,选择打开Window→ Preferences→ Ant→ Runtime点击Properties（属性）选项卡. 添加新属性的方法：点击属性按钮，再弹出的对话框中填写名称和值. 这将就在Eclipse中为所有的Ant编译设置了全局属性,因为属性是不可改变的,你将为每一个属性确定一个最终的值.

还可以设定一个基于项目的 Ant 项目的属性，通过设定项目的Ant启动配置。在启动配置中点击属性选项卡（如图11-8），取消选择"Use global properties as specified in the Ant runtime preferences（按Ant运行时首选项中指定的方式使用全局变量）"，点击Add Property（增加属性）按钮来增加新的属性。

图11-8 设置属性

设定环境变数

你可以设定要传给Ant的环境变数,但你必须保证Ant运行在自己的JRE(默认)中. 在该项目的Ant启动配置,点击JRE选项卡，选择the Separate JRE（独立的JRE）单选按钮. 设定环境变数,点击Environment（环境）选项卡,如图11-9,点击New（新）按钮创建新的环境变量.

图11-9 设置环境变量

当你点击New按钮后，回弹出New Environment Variable（新的环境变量）对话框。在适当的位置键入环境变量的名字和值后点击OK。

配置Ant编辑器

你有两种办法重新设定Ant构建文件的格式，一是使用Ant编辑器的环境菜单中的Format命令(Ctrl-Shift-F)，另一个是选择Edit→ Format 。通过选择Window→ Preferences→ Ant→ Editor→ Formatter 打开Ant参数设置页来使格式生效，如图11-10。你做的任何改变都将在预览中显示。

图11-10 设置Ant格式

选择Window→ Preferences→ Ant→ Editor 使你通过设置tab大小，边距，突出显示等等来配置Ant构建文件。

增加新的Ant任务和类型

你可以在Eclipse中增加新的Ant任务和类型，通过选择Window→ Preferences→ Ant→ Runtime使用Ant参数设置。这些任务和类型在不使用通常要使用的taskdef或typedef任务，就可以被构建文件使用了。
选择Tasks（任务）选项卡添加新的任务，如图11-11。点击Add Task（添加任务）按钮，导向新的Ant任务所在的JAR文件添加新任务。点击Types（类型）选项卡同样的方法添加新类型。

图11-11 增加Ant任务

提示：如果你没找到你需要的JAR文件，请把它加入Ant的classpath.
另外你可以在classpath选项卡中向Ant classpath添加其他类定义任务和类型。

使用不同版本的ANT

Eclipse集成的是Ant 1.6.1，但是也可以使用其他的版本。选择Window→ Preferences→ Ant→ Runtime 打开Ant参数设置页选择Classpath选项卡。

当设置好Ant主目录项后，Eclipse在运行Ant时会在Ant classpath中选择合适的类。改变Ant主目录，点击Ant Home按钮然后选择你想使用的Ant安装地。

提示：如果你不想改变Classpath，你可以在Eclipse中将Ant作为一个外部工具来运行。选择Run→ External Tools→ External Tools 打开External Tools （外部工具）对话框。点击Program（程序）项，然后点击New按钮。为新工具键入名字（如"Ant 1.8"或其他适当的名字）。然后，在Location(位置)项中，点击Browse File System（浏览文件系统）按钮，浏览找到ant.sh或ant.bat，某一适合你操作系统的文件，然后点击Open。External Tools对话框将会重新出现；在Arguments（自变量）项中，填入你想要传给Ant的参数。最后，在Working Directory （工作目录）项，填入你想使用的构建文件，然后点击Run启动新版本的Ant。这样做的问题是你不能使用Eclipse中的一些预设值。在大多数情况下，在构建Eclipse项目时，这样做远好于使用Eclipse内部的Ant。

使用Ant视图

Eclipse带有一个专门用来使用Ant的视图，成为Ant视图，即一个显示构建文件目标纵览的窗口。选择Window→ Show View→ Ant打开视图；Ant视图会出现在右侧，如图11-12。

图11-12 Ant视图

视图中工具条包含以下按钮（从左到右）：

添加构建文件
使用搜索添加构建文件
隐藏内部目标
运行缺省目标
删除选中的构建文件
删除所有构建文件

点击Add Build Files（增加构建文件）按钮，打开Choose Location（选择位置）对话框，在Ant视图中增加构建文件。在左侧的框中选择你要使用的Eclipse项目，在右侧的框中选择加入Ant视图中的构建文件。点击OK，在Ant视图中添加构建文件。

提示：在Windows中，你可以直接通过拖拽在Ant视图中添加构建文件。

除了给出构建文件的纵览，在Ant视图中你还可以运行构建文件。通过在Ant视图中选择一个构建文件点击Run the Default Target（运行确实目标）按钮，或者右击目标在出现的菜单中选择Run项。在Ant视图中双击构建文件就可以在Ant编辑器中打开它，类似右击构建文件然后选择Open With→ Ant Editor项。

在Eclipse中使用Ant是一个强大的组合，Eclipse可以开发﹑调试代码，而Ant可以构建﹑发布它。两个工具都是免费的。这是我推荐的一个组合。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=678178

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

编者按:每当我们做了一项调查,我们发现越来越少的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的输出，默认是选中的.