這期，我們會使用 Ant 將上期編寫、整理的代碼文件按指定的先后順序合并成單一的源文件，然后壓縮這個文件。這是構(gòu)建 JavaScript 項(xiàng)目的基本步驟。Ant 是 Apache 的一個頂級開源項(xiàng)目，網(wǎng)上對它的介紹和安裝，已經(jīng)有很多文章，這里就不再贅述了。在構(gòu)建之前，我們先來看看已有的文件布局：

 smart-queue // 組件的根目錄
  +--- src // JavaScript源文件目錄
    +--- lang.js // 前文提到的“外部文件”
    +--- smart-queue.js // Smart Queue 主文件

現(xiàn)在，我們要讓它“豐滿”起來：

組件根目錄下添加：
- README: 介紹 Smart Queue 組件
- LICENSE: 組件的授權(quán)信息
- build.xml: Ant 使用的配置文件
組件根目錄下添加 lib 子目錄：存放構(gòu)建過程中需要使用的外部程序和庫文件
- lib 子目錄下添加 yuicompressor.jar: 我們用 YUI Compressor 壓縮 JavaScript
組件根目錄下添加 test 子目錄：存放測試組件所需的文件（下期介紹）
src 目錄下添加 intro.js: 介紹組件的版本及說明信息

麻雀雖小，五臟俱全。現(xiàn)在 Smart Queue 看上去像是比較專業(yè)的 JavaScript 項(xiàng)目了：

 smart-queue // 組件的根目錄
  +--- lib // JavaScript外部程序和庫文件目錄
    +--- yuicompressor.jar // YUI Compressor
  +--- test // 測試文件目錄
  +--- src // JavaScript源文件目錄
    +--- intro.js // 介紹和版本信息
    +--- lang.js // 前文提到的“外部文件”
    +--- smart-queue.js // Smart Queue 主文件
  +--- README // 組件自述文件
  +--- LICENSE // 組件授權(quán)信息

我們計(jì)劃將構(gòu)建出來的文件存放到組件根目錄下的 build 子目錄，還要通過構(gòu)建工具創(chuàng)建并銷毀它。首次嘗試構(gòu)建前，建議先大概了解一下 Ant 的配置文件——build.xml 的結(jié)構(gòu)：

<project name="MyProject" default="dist" basedir=".">
  <description>
    simple example build file
  </description>
 <!-- set global properties for this build -->
 <property name="src" location="src"/>
 <property name="build" location="build"/>
 <property name="dist" location="dist"/>

 <target name="init">
  <!-- Create the time stamp -->
  <tstamp/>
  <!-- Create the build directory structure used by compile -->
  <mkdir dir="${build}"/>
 </target>

 <target name="compile" depends="init"
    description="compile the source " >
  <!-- Compile the java code from ${src} into ${build} -->
  <javac srcdir="${src}" destdir="${build}"/>
 </target>

 <target name="clean"
    description="clean up" >
  <!-- Delete the ${build} and ${dist} directory trees -->
  <delete dir="${build}"/>
  <delete dir="${dist}"/>
 </target>
</project>

仔細(xì)觀察一下，除了 name, description 這些名字都很容易理解外，其他可以看到的規(guī)律包括：

project 元素的 default 屬性值對應(yīng)某個 target 元素的 name 屬性；
target 元素的 depends 屬性值對應(yīng)其他某些 target 元素的 name 屬性；
${somename} 可以引用 property 中定義的值。

下面我們開始寫自己的 build.xml.

首先，配置項(xiàng)目的基本信息，以及相關(guān)目錄名稱，將要使用的編碼等等：

<project name="Smart Queue" default="compress" basedir=".">
  <description>Build file for Ant</description>
  <property name="src" location="src" />
  <property name="build" location="build" />
  <property name="lib" location="lib"/>
  <property name="inputencoding" value="utf-8"/>
  <property name="outputencoding" value="gbk"/>

接著，定義一個用于初始化的 target, 它負(fù)責(zé)創(chuàng)建 build 子目錄：

  <target name="init">
    <mkdir dir="${build}"/>
  </target>

然后定義名為 concat 的 target, 負(fù)責(zé)將 src 里的 3 個 JavaScript 文件按先后順序連接起來。運(yùn)行它要先運(yùn)行前面定義的 init:

  <target name="concat" depends="init">
    <concat destfile="${build}/smart-queue.source.js" encoding="${inputencoding}" outputencoding="${outputencoding}">
      <filelist dir="${src}" files="intro.js, lang.js, smart-queue.js" />
    </concat>
  </target>

這樣，就可以得到一個可以工作的 JavaScript 文件，下面的 target 負(fù)責(zé)壓縮這個文件，顯然它依賴于 concat, 也依賴于 init, 但是不必顯式指定對 init 的依賴——Ant 能處理這種依賴關(guān)系。這里調(diào)用 YUI Compressor 并傳入適當(dāng)?shù)膮?shù)：

  <target name="compress" depends="concat">
    <java jar="${lib}/yuicompressor.jar" fork="true">
      <arg line="--type js --charset utf-8 -o ${build}/smart-queue.js ${build}/smart-queue.js"/>
    </java>
  </target>

大功告成，compress 處理后的文件就可以部署到生產(chǎn)系統(tǒng)上去了。最后我們做一下清理工作，使你在生成文件后還可以回到最初的狀態(tài):

  <target name="clean">
    <delete dir="${build}"/>
  </target>

到此可以說基本的配置就寫完了。怎么使用它呢？以命令行方式進(jìn)入到組件根目錄（或者說 build.xml 所在的目錄），然后：

運(yùn)行 ant concat, 將得到 ./build/smart-queue.source.js
運(yùn)行 ant, 將選擇 <project> 中 default 引用的那個 target, 即 compress, 所以會得到 ./build 下的 smart-queue.source.js 和 smart-queue.js
運(yùn)行 ant clean, 將刪除 ./build 目錄，回到最初的狀態(tài)