ant命令总结范文.doc

ant命令总结范文 ant命令总结1Ant是什么？Apache Ant是一个基于Java的生成工具。 生成工具在软件开发中用来将源代码和其他输入文件转换为可执行文件的形式（也有可能转换为可安装的产品映像形式）。 随着应用程序的生成过程变得更加复杂，确保在每次生成期间都使用精确相同的生成步骤，同时实现尽可能多的自动化，以便及时产生一致的生成版本2下载、安装Ant安装Ant下载.zip文件，解压缩到c:ant1.3(后面引用为%ANT_HOME%)2.1在你运行Ant之前需要做一些配置工作。 ?将bin目录加入PATH环境变量。 ?设定ANT_HOME环境变量，指向你安装Ant的目录。 在一些OS上，Ant的脚本可以猜测ANT_HOME（Unix和Windos NT/2000）但最好不要依赖这一特性。 ?可选地，设定JAVA_HOME环境变量（参考下面的高级小节），该变量应该指向你安装JDK的目录。 注意不要将Ant的ant.jar文件放到JDK/JRE的lib/ext目录下。 Ant是个应用程序，而lib/ext目录是为JDK扩展使用的（如JCE，JSSE扩展）。 而且通过扩展装入的类会有安全方面的限制。 2.2运行Ant运行Ant非常简单，当你正确地安装Ant后，只要输入ant就可以了。 ?没有指定任何参数时，Ant会在当前目录下查询build.xml文件。 如果找到了就用该文件作为buildfile。 如果你用-find选项。 Ant就会在上级目录中寻找buildfile，直至到达文件系统的根。 要想让Ant使用其他的buildfile，可以用参数-buildfile file，这里file指定了你想使用的buildfile。 ?可以指定执行一个或多个target。 当省略target时，Ant使用标签的default属性所指定的target。 命令行选项总结antoptionstargettarget2target3.Options:-help printthis message-projecthelp printproject helpinformation-version printthe versioninformation andexit-quiet beextra quiet-verbose beextra verbose-debug printdebugging information-emacs producelogging informationwithout adornments-logfile fileuse givenfile forlog output-logger classnamethe classthat isto performlogging-listener classnameadd aninstance ofclass asa projectlistener-buildfile fileuse specifiedbuildfile-find filesearch forbuildfile towardsthe rootof thefilesystem anduse thefirst onefound-Dproperty=value setproperty tovalue例子ant使用当前目录下的build.xml运行Ant，执行缺省的target。 ant-buildfile test.xml使用当前目录下的test.xml运行Ant，执行缺省的target。 ant-buildfile test.xml dist使用当前目录下的test.xml运行Ant，执行一个叫做dist的target。 ant-buildfile test.xml-Dbuild=build/classes dist使用当前目录下的test.xml运行Ant，执行一个叫做dist的target，并设定build属性的值为build/classes。 3编写build.xml Ant的buildfile是用XML写的。 每个buildfile含有一个project。 buildfile中每个task元素可以有一个id属性，可以用这个id值引用指定的任务。 这个值必须是唯一的。 （详情请参考下面的Task小节）3.1Projects project有下面的属性Attribute DescriptionRequired name项目名称.No default当没有指定target时使用的缺省target Yesbasedir用于计算所有其他路径的基路径。 该属性可以被basedir property覆盖。 当覆盖时，该属性被忽略。 如果属性和basedir property都没有设定，就使用buildfile文件的父目录。 No项目的描述以一个顶级的元素的形式出现（参看description小节）。 一个项目可以定义一个或多个target。 一个target是一系列你想要执行的。 执行Ant时，你可以选择执行那个target。 当没有给定target时，使用project的default属性所确定的target。 3.2Targets一个target可以依赖于其他的target。 例如，你可能会有一个target用于编译程序，一个target用于生成可执行文件。 你在生成可执行文件之前必须先编译通过，所以生成可执行文件的target依赖于编译target。 Ant会处理这种依赖关系。 然而，应当注意到，Ant的depends属性只指定了target应该被执行的顺序如果被依赖的target无法运行，这种depends对于指定了依赖关系的target就没有影响。 Ant会依照depends属性中target出现的顺序（从左到右）依次执行每个target。 然而，要记住的是只要某个target依赖于一个target，后者就会被先执行。 假定我们要执行target D。 从它的依赖属性来看，你可能认为先执行C，然后B，最后A被执行。 错了，C依赖于B，B依赖于A，所以先执行A，然后B，然后C，最后D被执行。 一个target只能被执行一次，即时有多个target依赖于它（看上面的例子）。 如果（或如果不）某些属性被设定，才执行某个target。 这样，允许根据系统的状态（java version,OS,命令行属性定义等等）来更好地控制build的过程。 要想让一个target这样做，你就应该在target元素中，加入if（或unless）属性，带上target因该有所判断的属性。 例如如果没有if或unless属性，target总会被执行。 可选的description属性可用来提供关于target的一行描述，这些描述可由-projecthelp命令行选项输出。 将你的tstamp task在一个所谓的初始化target是很好的做法，其他的target依赖这个初始化target。 要确保初始化target是出现在其他target依赖表中的第一个target。 在本手册中大多数的初始化target的名字是init。 target有下面的属性Attribute DescriptionRequired nametarget的名字Yes depends用逗号分隔的target的名字列表，也就是依赖表。 No if执行target所需要设定的属性名。 No unless执行target需要清除设定的属性名。 No description关于target功能的简短描述。 No3.3Tasks一个task是一段可执行的代码。 一个task可以有多个属性（如果你愿意的话，可以将其称之为变量）。 属性只可能包含对property的引用。 这些引用会在task执行前被解析。 下面是Task的一般构造形式这里name是task的名字，attributeN是属性名，valueN是属性值。 有一套内置的（built-in）task，以及一些可选task，但你也可以编写自己的task。 所有的task都有一个task名字属性。 Ant用属性值来产生日志信息。 可以给task赋一个id属性这里taskname是task的名字，而taskID是这个task的唯一标识符。 通过这个标识符，你可以在脚本中引用相应的task。 例如，在脚本中你可以这样task1.setFoo(bar);设定某个task实例的foo属性。 在另一个task中（用java编写），你可以利用下面的语句存取相应的实例。 project.getReference(task1).注意1如果task1还没有运行，就不会被生效（例如不设定属性），如果你在随后配置它，你所作的一切都会被覆盖。 注意2未来的Ant版本可能不会兼容这里所提的属性，因为很有可能根本没有task实例，只有proxies。 3.4Properties一个project可以有很多的properties。 可以在buildfile中用property task来设定，或在Ant之外设定。 一个property有一个名字和一个值。 property可用于task的属性值。 这是通过将属性名放在$和之间并放在属性值的位置来实现的。 例如如果有一个property builddir的值是build，这个property就可用于属性值$builddir/classes。 这个值就可被解析为build/classes。 内置属性如果你使用了task定义了所有的系统属性，Ant允许你使用这些属性。 例如，$对应操作系统的名字。 要想得到系统属性的列表可参考the Javadocof System.getProperties。 除了Java的系统属性，Ant还定义了一些自己的内置属性basedir project基目录的绝对路径(与的basedir属性一样)。 ant.file buildfile的绝对路径。 ant.version Ant的版本。 当前执行的project的名字；由的name属性设定.ant.java.version Ant检测到的JVM的版本；目前的值有1.1,1.2,1.3and1.4.例子3.5Path-like Structures你可以用:和;作为分隔符，指定类似PATH和CLASSPATH的引用。 Ant会把分隔符转换为当前系统所用的分隔符。 当需要指定类似路径的值时，可以使用嵌套元素。 一般的形式是location属性指定了相对于project基目录的一个文件和目录，而path属性接受逗号或分号分隔的一个位置列表。 path属性一般用作预定义的路径其他情况下，应该用多个location属性。 为简洁起见，classpath标签支持自己的path和location属性。 所以可以被简写作也可通过元素指定路径。 构成一个fileset的多个文件加入path-like structure的顺序是未定的。 上面的例子构造了一个路径值包括$classpath的路径，跟着lib目录下的所有jar文件，接着是classes目录。 如果你想在多个task中使用相同的path-like structure，你可以用元素定义他们（与target同级），然后通过id属性引用参考Referencs例子。 path-like structure可能包括对另一个path-like structurede的引用（通过嵌套元素）前面所提的关于的简洁写法对于也是有效的，如可写成命令行变量有些task可接受参数，并将其传递给另一个进程。 为了能在变量中包含空格字符，可使用嵌套的arg元素。 Attribute DescriptionRequired value一个命令行变量；可包含空格字符。 只能用一个line空格分隔的命令行变量列表。 file作为命令行变量的文件名；会被文件的绝对名替代。 path一个作为单个命令行变量的path-like的字符串；或作为分隔符，Ant会将其转变为特定平台的分隔符。 例子是一个含有空格的单个的命令行变量。 是两个空格分隔的命令行变量。 是一个命令行变量，其值在DOS系统上为dir;dir2;dir3；在Unix系统上为/dir:/dir2:/dir3。 References buildfile元素的id属性可用来引用这些元素。 如果你需要一遍遍的复制相同的XML代码块，这一属性就很有用如多次使用结构。 下面的例子可以写成如下形式所有使用PatternSets,FileSets或path-like structures嵌套元素的task也接受这种类型的引用。 4.1File（Directory）类4.1.1Mkdir?创建一个目录，如果他的父目录不存在，也会被同时创建。 ?例子?说明如果build不存在，也会被同时创建4.1.2Copy?拷贝一个（组）文件、目录?例子1.拷贝单个的文件2.拷贝单个的文件到指定目录下3.拷贝一个目录到另外一个目录下4.拷贝一批文件到指定目录下5.拷贝一批文件到指定目录下，将文件名后增加。 Bak后缀6.拷贝一组文件到指定目录下，替换其中的标签内容4.1.3Delete?删除一个（组）文件或者目录?例子1.删除一个文件2.删除指定目录及其子目录3.删除指定的一组文件4.删除指定目录及其子目录，包括他自己4.1.4Move?移动或重命名一个（组）文件、目录?例子1.移动或重命名一个文件2.移动或重命名一个文件到另一个文件夹下面3.将一个目录移到另外一个目录下4.将一组文件移动到另外的目录下5.移动文件过程中增加。 Bak后缀4.2Java相关4.2.1Javac?编译java原代码?例子1.编译$src目录及其子目录下的所有。 Java文件，。 Class文件将放在$build指定的目录下，classpath表示需要用到的类文件或者目录，debug设置为on表示输出debug信息2.编译$src和$src2目录及其子目录下的所有。 Java文件，但是package/p1/*,mypackage/p2/*将被编译，而mypackage/p1/testpackage/*将不会被编译。 Class文件将放在$build指定的目录下，classpath表示需要用到的类文件或者目录，debug设置为on表示输出debug信息3.路径是在property中定义的4.2.2java?执行指定的java类?例子1.classname中指定要执行的类，classpath设定要使用的环境变量2.4.3打包相关4.3.1jar?将一组文件打包?例子1.将$build/classes下面的所有文件打包到$dist/lib/app.jar中2.将$build/classes下面的所有文件打包到$dist/lib/app.jar中，但是包括mypackage/test所有文件不包括所有的Test.class3.manifest属性指定自己的META-INF/MANIFEST.MF文件，而不是由系统生成4.3.2war?对Jar的扩展，用于打包Web应用?例子?假设我们的文件目录如下thirdparty/libs/jdbc1.jar thirdparty/libs/jdbc2.jar build/main/myco/myapp/Servlet.class src/metadata/myapp.xml src/html/myapp/index.html src/jsp/myapp/front.jsp src/graphics/images/gifs/small/logo.gif src/graphics/images/gifs/large/logo.gif?下面是我们的任务的内容?完成后的结果WEB-INF/web.xml WEB-INF/lib/jdbc2.jar WEB-INF/classes/myco/myapp/Servlet.class META-INF/MANIFEST.MF index.html front.jsp images/small/logo.gif images/large/logo.gif4.3.3ear?用于打包企业应用?例子4.4时间戳在生成环境中使用当前时间和日期，以某种方式标记某个生成任务的输出，以便记录它是何时生成的，这经常是可取的。 这可能涉及一个文件，以便插入一个字符串来指定日期和时间，或将这个信息合并到JAR或zip文件的文件名中。 这种需要是通过简单但是非常有用的tstamp任务来解决的。 这个任务通常在某次生成过程开始时调用，比如在一个init目标中。 这个任务不需要属性，许多情况下只需就足够了。 tstamp不产生任何输出；相反，它根据当前系统时间和日期设置Ant属性。 下面是tstamp设置的一些属性、对每个属性的说明，以及这些属性可被设置到的值的例子属性说明例子DSTAMP设置为当前日期，默认格式为yyyymmddxx1217TSTAMP设置为当前时间，默认格式为hhmm1603TODAY设置为当前日期，带完整的月份xx年12月17日例如，在前一小节中，我们按如下方式创建了一个JAR文件在调用tstamp任务之后，我们能够根据日期命名该JAR文件，如下所示因此，如果这个任务在xx年12月17日调用，该JAR文件将被命名为package-xx1217.jar。 还可以配置tstamp任务来设置不同的属性，应用一个当前时间之前或之后的时间偏移，或以不同的方式格式化该字符串。 所有这些都是使用一个嵌套的format元素来完成的，如下所示上面的清单将OFFSET_TIME属性设置为距离当前时间10分钟之后的小时数、分钟数和秒数。 用于定义格式字符串的字符与java.text.SimpleDateFormat类所定义的那些格式字符相同4.5执行SQL语句?通过jdbc执行SQL语句?例子1.2.只有在oracle、版本是8.1的时候才执行4.6发送邮件?使用SMTP服务器发送邮件?例子The$buildnamenightly buildhas pleted?mailhost SMTP服务器地址?mailport服务器端口?subject主题?from发送人地址?to接受人地址?message发送的消息?fileset设置附件=在ANT出现之前，编译和部署Java应用需要使用包括特定平台的脚本、Make文件、不同的IDE以及手工操作等组成的大杂烩。 现在，几乎所有的开源Java项目都在使用Ant，许多公司的开发项目也在使用Ant。 Ant的大量使用，也自然带来了对总结Ant最佳实践的迫切需求。 本文总结了我喜好的Ant最佳实践，很多是从亲身经历的项目错误，或从其他开发者的“恐怖”故事中得到的灵感的。 比如，有人告诉我有个项目将XDoclet生成的代码放入锁定文件的版本控制工具中。 单开发者修改源代码时，他必须记住手工检出（Check out）并锁定所有将要重生成的文件。 然后，手工运行代码生成器，当他能够让Ant编译代码时，这一方法还存在一些问题生成的代码无法存储在版本控制系统中Ant（本案例中是Xdoclet）应该自动确定下一次构建涉及的源文件，而不应由程序员人工确定。 Ant的构建文件应该定义好正确的任务依赖关系，这样程序员不必按照特定顺序调用任务。 当我开始一个新项目时，我首先编写Ant构建文件。 文件定义构建的过程，并为团队中的每个程序员都使用。 本文所有的最佳实践假设Ant构建文件是一个必须精心编写的重要文件，它应在版本控制系统中得到维护，并定期进行重构。 下面是我的十五大Ant最佳实践。 1.采用一致的编码规范Ant用户不管是喜欢还是痛恨XML构建文件的语法，都愿意跳进这一迷人的争论中。 让我们先看一些保持XML构建文件简洁的方法。 首先，也是最重要的，化费时间格式化你的XML让它看上去很清晰。 不过XML是否美观，Ant都可以工作。 但是丑陋的XML很难读懂。 倘若你在任务之间留出空行，有规则的缩进，每行文字不超过90列，那么XML令人惊讶的易读。 再加上好的器或IDE高亮相应的语句，你就不会有如何阅读的麻烦。 同样，精选有意义明确、容易读懂的词汇来命名任务和属性。 比如，dir.reports就比rpts好。 并不需要特定的编码规范，只要有一种规范并坚持使用就好。 2.将build.xml放在项目根目录中Ant构建文件build.xml可以放在如何位置，但是放在项目顶层目录中可以保持项目简洁。 这是最普遍的规范，使开发者能够在根目录找到它。 同时，也能够容易了解项目中不同目录之间的逻辑关系。 以下是一个典型的项目层次root dir|build.xml+-src+-lib(包含第三方JAR包)+-build(由build任务生成)+-dist(由build任务生成)当build.xml在顶级目录时，倘若你在项目某个子目录中，只要输入ant-find pile命令，不需要改变工作目录就能够以命令行方式编译代码。 参数-find告诉Ant寻找存在于上级目录中的build.xml并执行。 3.使用单一构建文件有人喜欢将一个大项目分解到几个小的构建文件，每个构建文件分担整个构建过程的一小部分工作。 但是应该认识到，将构建文件分割会增加对整个构建过程的理解难度。 要注意在单一构建文件能够清楚表现构建层次的情况下，不要过工程化(over-engineer)。 即使你把项目划分为多个构建文件，也应使程序员能够在项目根目录下找到核心build.xml。 尽管该文件只是将实际构建工作委派给下级构建文件，也应保证该文件可用。 4.提供良好的帮助说明应尽量使构建文件自文档化。 增加任务描述是最简单的方法。 当你输入ant-projecthelp时，你就可以看到带有描述的任务清单。 比如，你可以这样定义任务最简单的规则是对所有你希望程序员通过命令行直接调用的任务都加上描述。 对于一般用来执行中间处理过程的内部任务，比如生成代码或建立输出目录等，就无法使用描述属性。 这时，可以通过在构建文件中加入XML注释来处理。 或者专门定义一个help任务，当程序员输入ant help时来显示详细的使用说明。 Detailed help.5.提供清空任务每个构建文件都应包含一个清空任务，删除所有生成的文件和目录，使系统回到构建文件执行前的初始状态。 执行清空任务后还存在的文件应处在版本控制系统的管理下。 比如除非是在产生整个系统版本的特殊任务中，否则不要自动调用clean任务。 当程序员仅仅执行编译任务或其他任务时，他们不需要构建文件事先执行即令人讨厌有没有必要的清空任务。 要相信程序员能够确定何时需要清空所有文件。 6.使用ANT管理任务从属关系假设你的应用由Swing GUI组件、Web界面、EJB层和公共应用代码组成。 在大型系统中，你需要清晰地定义Java包属于系统的哪一层。 否则如何一点修改都要重新编译成千上百个文件。 任务从属关系管理差会导致过度复杂而脆弱的系统。 改变GUI面板的设计不应造成Servlet和EJB的重编译。 当系统变得庞大后，稍不注意就可能将依赖于客户端的代码引入到服务端。 这是因为IDE在编译文件时使用单一的classpath。 Ant让你更有效地控制构建活动。 设计你的构建文件编译大型项目的步骤首先，编译公共应用代码，将编译结果打成JAR包文件。 然后，编译上一层的项目代码，编译时依靠第一步产生的JAR文件。 不断重复这一过程，直到最高层的代码编译完成。 分步构建强化了任务从属关系管理。 如果你工作在底层Java框架上，引用高层的GUI模板组件，这时代码不需要编译。 这是由于构建文件在编译底层框架时，在源路径中没有包含高层GUI面板组件的代码。 7.定义并重用文件路径如果文件路径在一个地方集中定义，并在整个构建文件中得到重用，那么构建文件更易于理解。 以下是这样做的一个例子.etc当项目不断增长，构建日益复杂时，这一技术越发体现出其价值。 你可能为编译不同层次的应用定义各自的文件路径，比如运行单元测试的、运行应用程序的、运行Xdoclet的、生成JavaDocs的等等不同路径。 这种组件化路径定义的方法比为每个任务单独定义路径要优越得多。 否则，很容易丢失任务任务从属关系的轨迹。 8.定义恰当的任务参数关系假设dist任务从属于jar任务，那么哪个任务从属于pile任务，哪个任务从属于prepare任务呢？Ant构建文件最终定义了任务的从属关系图，它必须被仔细地定义和维护。 应该定期检查任务的从属关系以保证构建工作得到正确执行。 大的构建文件随着时间推移趋向于增加更多的任务，所以到最后由于不必要的从属关系导致构建工作非常困难。 比如，你可能发现在程序员只是需要编译一些没有使用EJB的GUI代码时，重新生成EJB代码。 以“优化”的名义忽略任务的从属关系是另一种常见的错误。 这种错误迫使程序员为了得到恰当的结果必须记住并按照特定的顺序调用一串任务。 更好的做法是提供描述清晰的公共任务，这些任务包含正确的任务从属关系；另外提供一套“专家”任务让你能够手工执行个别的构建步骤，这些任务不提供完整的构建过程，但是让那些专家在快速而恼人的编码期间跳过某些步骤9.使用配置属性任何需要配置或可能发生变化的信息都应作为Ant属性定义下来。 对于在构建文件中多次出现的值也同样处理。 属性既可以在构建文件头部定义，也可以为了更好的灵活性而在单独的属性文件中定义。 以下是在构建文件中定义属性的样式etc.或者你可以使用属性文件etc.在属性文件perties中:dir.build=builddir.src=srcjdom.home=./java-tools/jdom-b8jdom.jar=jdom.jarjdom.jar.withpath=$jdom.home/build/$jdom.jar用一个独立的文件定义属性是有好处的，它可以清晰地定义构建中的可配置部分。 另外，在开发者工作在不同操作系统的情况下，你可以在不同的平台上提供该文件的不同版本。 10.保持构建过程独立为了最大限度的扩展性，不要应用外部路径和库文件。 最重要的是不要依赖于程序员的CLASSPATH设置。 取而代之的是，在构建文件中使用相对路径并定义自己的路径。 如果你引用了绝对路径如C:javatools，其他开发者未必使用与你相同的目录结构，所以就无法使用你的构建文件如果你部署开发源码项目，应该提供包括所有需要的JAR文件的发行版本，当然是在遵守许可协议的基础上。 对于内部项目，相关的JAR文件都应在版本控制系统的管理中，并捡出到大家都知道的位置。 当你不得不应用外部路径时，应将路径定义为属性。 使程序员能够涌适合他们自己的机器的参数重载这些属性。 你也可以使用以下语法引用环境变量11.使用版本控制系统构建文件是一个重要的文件，应该象代码一样进行版本控制。 当你标记你的代码时，也应用同样的标签标记构建文件。 这样当你需要回溯构建旧版本的软件时，能够使用相对应的旧版本构建文件。 除构建文件之外，你还应在版本控制中维护第三方JAR文件。 同样，这使你能够重新构建旧版本的软件。 这也能够更容易保证所有开发者拥有一致的JAR文件，因为他们都是同构建文件一起从版本控制系统中捡出的。 通常应避免在版本控制系统中存放构建输出品。 倘若你的源代码很好地得到了版本控制，那么通过构建过程你能够重新生成任何版本的产品。 12.把Ant作为“最小公分母”假设你的开发团队使用IDE，为什么要为程序员通过点击图标就能够构建整个应用而烦恼呢？IDE的问题在团队中是一个关于一致性和重现性的问题。 几乎所有的IDE设计初衷都是为了提高程序员的个人生产率，而不是开发团队的持续构建。 典型的IDE要求每个程序员定义自己的项目文件。 程序员可能拥有不同的目录结构，可能使用不同版本的库文件，还可能工作在不同的平台上。 这将导致出现这种情况在A那里运行良好的代码，到B那里就无法运行。 不管你的开发团队使用何种IDE，一定要建立所有程序员都能够使用的Ant构建文件。 要建立一个程序员在将新代码提交版本控制系统前必须执行Ant构建文件的规则。 这将确保代码是经过同一个Ant构建文件构建的。 当出现问题时，要使用项目标准的Ant构建文件，而不是通过某个IDE来执行一个干净的构建。 程序员可以自由选择任何他们习惯使用的IDE。 但是A