ANT十五大最佳实践

下一页 1 2 3 4 5 6 

  作者： Eric M. Burke, coauthor of Java Extreme Programming Cookbook
  原文：http://www.onjava.com/pub/a/onjava/2003/12/17/ant_bestpractices.html
  译者：stonexu
  QQ:19722707
  MSN:xt121@hotmail.com

  在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任务生成)

原文转自：http://www.ltesting.net