《编写可维护的 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"/>