《編寫可維護的 JavaScript》讀書筆記第14章：Ant

1. 安裝

運行 Ant 須要 Java 環境。

Windows 下的安裝過程很是簡單：

• 下載 Ant 壓縮包

• 解壓縮到某個目錄

• 配置環境變量，將 {Ant 安裝目錄}\bin 路徑存在 PATH 中，用分號與其餘路徑隔開

進入 CMD，輸入：ant -version。若是出現 Ant 的版本信息（目前最新版本是 Ant 1.9.3），說明安裝配置成功。

2. 配置文件

運行 Ant 時，默認會尋找當前目錄下的 build.xml 文件，這是使用 Ant 進行構建的配置文件，一般放在項目的根目錄下。

Ant 構建系統有三個基本組成部分：

• 任務（task）

• 目標（target）

• 項目（project）
  

示例（build.xml）：

<project name="maintainablejs" default="hello">
    <target name="hello">
        <echo>Hello world!</echo>
    </target>
</project>

3. 執行構建

打開命令行進入 build.xml 所在目錄，輸入：

ant

就能夠看到執行結果了。也能夠指定要執行的目標：

ant hello

4. 目標操做的依賴

一個要執行的目標可能依賴另外一個目標，這須要使用 depends 屬性指定，多個依賴之間用半角逗號隔開，先執行的目標要放在前面，這樣它纔會被先執行。例如：

<project name="maintainablejs" default="hello">
    <target name="hello">
        <echo>Hello world!</echo>
    </target>
    <target name="goodbye" depends="hello">
        <echo>Goodbye!</echo>
    </target>
</project>

執行 ant goodbye 會先執行 hello 目標。

5. 屬性

使用 property 標籤訂義屬性。例如：

<project name="maintainablejs">
    <property name="version" value="0.1.0"/>
</project>

下面就可以以 ${version} 來引用 version 的值了。

也能夠把屬性定義在外部的 Java 屬性文件中，而後加載到 Ant 裏。例如：

version = 0.1.0
copyright = Copyright 2012 Nicholas C. Zakas. All rights reserved.

使用 loadproperties 元素能夠加載屬性文件：

<project name="maintainablejs" default="version">
    <loadproperties srcfile="build.properties"/>
    <target name="version">
        <echo>Version is ${version}</echo>
        <echo>${copyright}</echo>
    </target>
</project>

建議聲明幾個用於整個項目的屬性，例如：

• src.dir —— 源代碼根目錄

• build.dir —— 構建目錄

• lib.dir —— 依賴文件目錄
  

6. Buildr 項目

Buildr（https://github.com/nzakas/buildr ）囊括了全部可能在 Ant 腳本中使用到的各類工具，而且都封裝成了任務。

下載源碼後，須要導入全部任務：

<import file="/path/to/buildr/buildr.xml"/>