DIV CSS 佈局教程網

用 Ant 自動化構建 JavaScript 元件
編輯:關於JavaScript     

這一期,我們要請 Ant 把先前整理好的程式碼檔,依指定順序合併成單一檔案,再順手壓縮它。這是建置 JavaScript 專案最基本的兩個步驟。Ant 是 Apache 的頂級開源專案,網路上關於它的介紹與安裝說明已經很多,這裡就不再重複。

好消息是,這一期的內容相當輕鬆:你只需要看懂幾個語法、寫幾行設定,就能讓系統按你預設的方式自動完成一連串工作。

先看看現有的檔案結構

smart-queue          // 元件根目錄
   +--- src           // JavaScript 原始檔目錄
          +--- lang.js         // 外部函式庫
          +--- smart-queue.js  // Smart Queue 主程式

把它補強成一個專業的專案

接著我們讓結構「豐滿」起來:

  • 根目錄新增:
    • README:元件說明
    • LICENSE:授權資訊
    • build.xml:Ant 的組態檔
  • 新增 lib 子目錄,存放建置過程要用的外部程式與函式庫,並放入 yuicompressor.jar。
  • 新增 test 子目錄,存放測試檔案(下一期會用到)。
  • 在 src 下新增 intro.js,放版本與說明資訊。

麻雀雖小,五臟俱全。現在它看起來就像個正經的 JavaScript 專案了:

smart-queue          // 元件根目錄
   +--- lib          // 外部程式與函式庫
   |      +--- yuicompressor.jar
   +--- test         // 測試檔案
   +--- src          // 原始檔
   |      +--- intro.js
   |      +--- lang.js
   |      +--- smart-queue.js
   +--- README
   +--- LICENSE

建置成果要放在根目錄下的 build 子目錄,而這個目錄需要由建置工具動態建立與清除。

看懂 build.xml 的基本結構

第一次寫之前,先參考官方範例抓一下規律:

<project name="MyProject" default="dist" basedir=".">
  <property name="src"   location="src" />
  <property name="build" location="build" />

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

  <target name="compile" depends="init">
    <javac srcdir="${src}" destdir="${build}"/>
  </target>

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

三個規律要記住:

  • project 的 default 屬性對應某個 target 的 name,也就是直接執行 ant 時會跑哪一項。
  • target 的 depends 屬性宣告它依賴哪些其他 target。
  • ${name} 可以引用 property 定義的值。

動手寫自己的 build.xml

先設定專案基本資訊、目錄名稱與編碼:

<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,負責建立 build 目錄:

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

然後是合併用的 concat,它會依序把三個 JS 檔接成一個。注意 files 屬性裡的順序是有意義的——intro.js 放最前面當開頭,之後才是函式庫與主程式:

  <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>

最後是壓縮。它依賴 concat,而 concat 又依賴 init——這種間接依賴不必顯式宣告,Ant 會自己處理:

  <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,產出的檔案就能部署上線了。最後補一個清理工作,讓你隨時能回到最初的狀態:

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

怎麼執行

以命令列進入 build.xml 所在目錄,然後:

  • ant concat:只合併,得到 ./build/smart-queue.source.js。
  • ant:執行 default 指定的 target(compress),得到未壓縮與壓縮兩個版本。
  • ant clean:刪除 build 目錄,回到初始狀態。

前提是 JDK 與 Ant 都已正確安裝設定。若有錯誤訊息,優先檢查這兩項環境變數。

一路看下来會發現,這一期的東西確實很簡單——但這正是建置工具該有的樣子。工具的價值在於提升生產力,如果維護設定檔本身要花掉大量時間,那就本末倒置了。更多玩法可以查 Ant 官方文件,裡面有不少有趣的 task 值得發掘。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved