Ant应用.docx
- 文档编号:23608279
- 上传时间:2023-05-19
- 格式:DOCX
- 页数:15
- 大小:317.99KB
Ant应用.docx
《Ant应用.docx》由会员分享,可在线阅读,更多相关《Ant应用.docx(15页珍藏版)》请在冰豆网上搜索。
Ant应用
在Eclipse中集成Ant编程之配置篇
提要:
本文将向你展示如何使用Eclipse设置为Ant所用的属性值和环境变量,并简要分析如何配置Ant编辑器以便从Eclipse内部操作Ant文件。
1.修改AntClasspath
在使用一个可选的或定制的任务时,你可能需要把其它库添加到classpath中。
为此,你可以通过以全局方式或使用一个单独工程的启动配置来修改Antclasspath。
为了给一个单独的Eclipse工程设置Antclasspath,打开该工程的Ant启动配置并点击Classpath选择卡;然后,通过点击"AddExternalJARs"按钮来添加外部的JAR文件。
你可以用全局方式修改Antclasspath以使之应用于所有的工程。
为此,你可以选择"Window→Preferences→Ant→Runtime"并点击"Classpath"选项卡。
在此,你可以据需要添加JAR文件,通过这种途径进行的设置可以为所有的Ant构建所用。
2.设置属性值
你可以使用"Antpreferences"页面(通过"Window→Preferences→Ant→Runtime"并点击"Properties"选项卡来打开它)来设置全局的Ant属性。
为了添加一个新属性,点击"AddProperty"按钮,然后在出现的对话框中填入Name和Value域。
这样以来,将为Eclipse中的所有Ant构建设置全局属性;并且由于属性是不可改变的,所以你也就设置了这些属性的最终值。
你可以通过设置工程的Ant启动配置来为每个工程进行属性设置。
为此,你可以点击启动配置中的Properties选项卡(见图1),取消选定"UseglobalpropertiesasspecifiedintheAntruntimepreferences"复选框,并且点击"AddProperty"按钮来设置新属性。
图1.设置属性
3.设置环境变量
你可以设置你想要传递到Ant的环境变量,但是你必须确保Ant会运行在它自己的JRE中(默认情况)。
在工程的Ant启动配置中,点击"JRE"选项卡并点击"SeparateJRE"单选按钮。
为了设置环境变量,点击"Environment"选项卡(显示于图2),并点击"New"按钮来创建一个新的环境变量。
图2.设置环境变量
当你点击"New"按钮时,出现"NewEnvironmentVariable"对话框。
然后,在适当的域中输入该环境变量的名字和值,并且单击"OK"即可。
4.配置Ant编辑器
你可以使用Ant编辑器上下文菜单中的"Format"命令(Ctrl-Shift-F)或选择"Edit→Format"命令来重新格式化一个Antbuild文件。
为此,你可以通过"Window→Preferences→Ant→Editor→Formatter"来打开"Antpreferences"页面,见图3。
你所做的任何变化都会反映到该Preview框中。
图3.配置Ant格式
选择"Window→Preferences→Ant→Editor"能够允许你配置build文件编辑器(设置制表位宽度,边界区域,高亮,等等)。
5.添加新的Ant任务和类型
你可以通过使用"Window→Preferences→Ant→Runtime"中的"Antpreferences"页面来把新的Ant任务和类型添加到Eclipse中。
这些任务和类型可以在将来用于build文件而不必使用taskdef或typedef任务(它们在通常情况下是需要的)。
为了添加一项新任务,请选择显示在图4中的"Tasks"选项卡,并点击"AddTask"按钮,然后导航到新的Ant任务所在的JAR文件。
为了添加一个新类型,点击"Types"选项卡,并且遵循与刚才一样的步骤即可。
图4.添加Ant任务
提示:
如果你不能找到你需要的JAR文件,那么你应该首先把它们添加到Antclasspath中。
作为选择,你可以通过点击Classpath选项卡来把定义任务和类型的其它类添加到Antclasspath中。
6.使用不同版本的Ant
随同Eclipse一起发行的是Ant1.6.1,但是也可使用另外其它版本。
为此,你可以选择"Window→Preferences→Ant→Runtime"并点击Classpath选项卡从而打开"Antpreferences"页面。
当Eclipse运行Ant时,它在Ant的classpath中查找适当的类-这与在"AntHomeEntries"中设置的一致。
为了改变"AntHomeEntries",只要点击"AntHome"按钮并且选择你希望使用的Ant安装即可。
提示如果你不想改变classpath,你可以从Eclipse中把Ant作为一个外部的工具运行。
为此,你只要选择"Run→ExternalTools→ExternalTools"来打开"ExternalTools"对话框,再点击Program,然后点击New按钮,为这个新工具输入一个名字(例如"Ant1.8"或其它任何适当的名字)。
接下来,转到"Location"域,点击"BrowseFileSystem"按钮并且导航到ant.sh或ant.bat(具体依赖于你的操作系统),并且点击"Open"。
之后出现"ExternalTools"对话框;在"Arguments"域中输入你想要传递到Ant的任何参数。
最后,在"WorkingDirectory"域中,输入你想要使用的build文件所在的目录并且点击"Run"来启动这个新版本的Ant。
这样做所存在的问题是,当在Eclipse中工作时,你不能方便地存取你所拥有的预定义值。
总之,在大多数情况中,当构建Eclipse工程时,从Eclipse内使用Ant更好一些。
7.使用Ant视图
Eclipse的发行中提供了一个Ant视图-它其实是一个窗口(它能够给出在build文件中的目标的概要信息)。
为了打开这个视图,选择"Window→ShowView→Ant";则该Ant视图即出现在图5的右边。
图5.Ant视图
该视图中的工具栏包含下面按钮(从左到右):
·"AddBuildFiles"
·"AddBuildFileswithSearch"
·"HideInternalTargets"
·"RuntheDefaultTarget"
·"RemoveSelectedBuildFile"
·"RemoveAllBuildFiles"
为了把build文件添加到Ant视图,请点击"AddBuildFiles"按钮以打开"ChooseLocation"对话框。
从该容器的左边,选择你想要使用的Eclipse工程;然后从右边,选择你想要添加到Ant视图的build文件。
然后,单击"OK"即可把build文件添加到Ant视图。
提示在Windows下,你可以通过拖放方式把build文件添加到Ant视图。
除了向你展示一个build文件的概要信息以外,Ant视图还允许你运行build文件。
从Ant视图中选择一个build文件并且点击"RuntheDefaultTarget"按钮。
或右单击一个目标,然后从出现的上下文菜单中选择"Run"。
双击Ant视图中的一个build文件将会在Ant编辑器中打开该build文件(这与右单击该build文件并且选择"OpenWith→AntEditor"效果一样)。
8.总结
总之,与Eclipse一起使用Ant是一种非常有潜力的结合。
Eclipse允许你开发和调试代码,而Ant让你方便地构建和发布工程。
而且,这两个工具都可以自由下载,所以我特别推荐把它们二者联合使用。
Eclipse快速上手指南之使用ANT
Ant是Java平台下非常棒的批处理命令执行程序,能非常方便地自动完成编译,测试,打包,部署等等一系列任务,大大提高开发效率。
如果你现在还没有开始使用Ant,那就要赶快开始学习使用,使自己的开发水平上一个新台阶。
Eclipse中已经集成了Ant,我们可以直接在Eclipse中运行Ant。
以前面建立的Hello工程为例,创建以下目录结构:
新建一个build.xml,放在工程根目录下。
build.xml定义了Ant要执行的批处理命令。
虽然Ant也可以使用其它文件名,但是遵循标准能更使开发更规范,同时易于与别人交流。
通常,src存放Java源文件,classes存放编译后的class文件,lib存放编译和运行用到的所有jar文件,web存放JSP等web文件,dist存放打包后的jar文件,doc存放API文档。
然后在根目录下创建build.xml文件,输入以下内容:
<?
xmlversion="1.0"?
>
<projectname="Helloworld"default="doc">
<!
--properies-->
<propertyname="src.dir"value="src"/>
<propertyname="report.dir"value="report"/>
<propertyname="classes.dir"value="classes"/>
<propertyname="lib.dir"value="lib"/>
<propertyname="dist.dir"value="dist"/>
<propertyname="doc.dir"value="doc"/>
<!
--定义classpath-->
<pathid="master-classpath">
<filesetfile="${lib.dir}/*.jar"/>
<pathelementpath="${classes.dir}"/>
</path>
<!
--初始化任务-->
<targetname="init">
</target>
<!
--编译-->
<targetname="compile"depends="init"description="compilethesourcefiles">
<mkdirdir="${classes.dir}"/>
<javacsrcdir="${src.dir}"destdir="${classes.dir}"target="1.4">
<classpathrefid="master-classpath"/>
</javac>
</target>
<!
--测试-->
<targetname="test"depends="compile"description="runjunittest">
<mkdirdir="${report.dir}"/>
<junitprintsummary="on"
haltonfailure="false"
failureproperty="tests.failed"
showoutput="true">
<classpathrefid="master-classpath"/>
<formattertype="plain"/>
<batchtesttodir="${report.dir}">
<filesetdir="${classes.dir}">
<includename="**/*Test.*"/>
</fileset>
</batchtest>
</junit>
<failif="tests.failed">
***********************************************************
****Oneormoretestsfailed!
Checktheoutput...****
***********************************************************
</fail>
</target>
<!
--打包成jar-->
<targetname="pack"depends="test"description="make.jarfile">
<mkdirdir="${dist.dir}"/>
<jardestfile="${dist.dir}/hello.jar"basedir="${classes.dir}">
<excludename="**/*Test.*"/>
<excludename="**/Test*.*"/>
</jar>
</target>
<!
--输出api文档-->
<targetname="doc"depends="pack"description="createapidoc">
<mkdirdir="${doc.dir}"/>网管论坛bbs_bitsCN_com
<javadocdestdir="${doc.dir}"
author="true"
version="true"
use="true"
windowtitle="TestAPI">
<packagesetdir="${src.dir}"defaultexcludes="yes">
<includename="example/**"/>
</packageset>
<doctitle><!
[CDATA[<h1>Hello,test</h1>]]></doctitle>
<bottom><!
[CDATA[<i>AllRightsReserved.</i>]]></bottom>
<tagname="todo"scope="all"description="Todo:
"/>
</javadoc>
</target>
</project>
以上xml依次定义了init(初始化),compile(编译),test(测试),doc(生成文档),pack(打包)任务,可以作为模板。
选中Hello工程,然后选择“Project”,“Properties”,“Builders”,“New…”,选择“AntBuild”:
填入Name:
Ant_Builder;Buildfile:
build.xml;BaseDirectory:
${workspace_loc:
/Hello}(按“BrowseWorkspace”选择工程根目录),由于用到了junit.jar包,搜索Eclipse目录,找到junit.jar,把它复制到Hello/lib目录下,并添加到Ant的Classpath中:
然后在Builder面板中钩上Ant_Build,去掉JavaBuilder:
再次编译,即可在控制台看到Ant的输出:
Buildfile:
F:
\eclipse-projects\Hello\build.xml
init:
compile:
[mkdir]Createddir:
F:
\eclipse-projects\Hello\classes
[javac]Compiling2sourcefilestoF:
\eclipse-projects\Hello\classes
test:
[mkdir]Createddir:
F:
\eclipse-projects\Hello\report
[junit]Runningexample.HelloTest
[junit]Testsrun:
1,Failures:
0,Errors:
0,Timeelapsed:
0.02sec
pack:
[mkdir]Createddir:
F:
\eclipse-projects\Hello\dist
[jar]Buildingjar:
F:
\eclipse-projects\Hello\dist\hello.jar
doc:
[mkdir]Createddir:
F:
\eclipse-projects\Hello\doc
[javadoc]GeneratingJavadoc
[javadoc]Javadocexecution
[javadoc]Loadingsourcefilesforpackageexample...
[javadoc]ConstructingJavadocinformation...
[javadoc]StandardDocletversion1.4.2_04
[javadoc]Buildingtreeforallthepackagesandclasses...
[javadoc]Buildingindexforallthepackagesandclasses...
[javadoc]Buildingindexforallclasses...
[javadoc]GeneratingF:
\eclipse-projects\Hello\doc\stylesheet.css...
[javadoc]Note:
Customtagsthatcouldoverridefuturestandardtags:
@todo.Toavoidpotentialoverrides,useatleastoneperiodcharacter(.)incustomtagnames.
[javadoc]Note:
Customtagsthatwerenotseen:
@todo
BUILDSUCCESSFUL
Totaltime:
11seconds
Ant依次执行初始化,编译,测试,打包,生成API文档一系列任务,极大地提高了开发效率。
将来开发J2EE项目时,还可加入部署等任务。
并且,即使脱离了Eclipse环境,只要正确安装了Ant,配置好环境变量ANT_HOME=<Ant解压目录>,Path=…;%ANT_HOME%\bin,在命令行提示符下切换到Hello目录,简单地键入ant即可。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Ant 应用