Ant 常用语法及选项

project

项目定义，一个ant文件就是一个 project，定义了项目名称，起始位置以及默认执行的 target。

<project name="Easily" basedir="." default="build">

property

属性定义，可以定义的属性包括：文件属性、字符串定义。

<property file="build.properties"/>

<property name="WIDTH" value="1200"/>

<property name="HEIGHT" value="750"/>

<property name="PROJECT_DIR" value="${basedir}/../"/>

<property name="SOURCE_DIR" value="${PROJECT_DIR}/src"/>

taskdef

任务定义，可以理解为具体执行的任务所需要的第三方库，比如编译 as3 就需要引入 flexTasks.jar ，比如在代码中需要用到 Math 的时候，需要引入 include Math，同样的道理。

<taskdef resource="flexTasks.tasks" classpath="${FLEX_HOME}/ant/lib/flexTasks.jar"/>

target

可以理解为 method，是 ant 执行的最小单位，每个 target 会有一个名称，可以主动的调用执行 。

<target name="build">

antcall

target 调用，用于执行 target 。

<antcall target="buildswf"/>

mxmlc

编译 as3 项目，生成 swf 文件，需要指定入口文件 file，输出文件 output 。

• incremental 是否增量编译
• define 编译参数
• load-config 项目配置文件，有需要的话可以自己编写，没有不声明也可以
• static-link-runtime-shared-libraries 运行时库是否静态链接
• compiler.debug 调试信息
• default-size 缺省尺寸
• compiler.include-libraries 将指定目录下的 swc 文件编译进目标文件，不管项目中是否引用
• compiler.library-path 将指定目录下的 swc 文件引入项目中，并将引用到的部分代码编译进目标文件
• compiler.external-library-path 将指定目录下的 swc 文件引入项目中，作为外部链接，注意，运行时如果没有找到相关定义会报错
• source-path 外部文件引用

<mxmlc file="${SOURCE_DIR}/Easily.as"

    output="${OUTPUT_DIR}/Easily.swf"

    show-actionscript-warnings="false" 

    actionscript-file-encoding="UTF-8" 

    keep-generated-actionscript="true"

    use-resource-bundle-metadata="true"

    incremental="false">



    <define name="CONFIG::debug" value="true"/>



    <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>

    <static-link-runtime-shared-libraries>true</static-link-runtime-shared-libraries>

    <compiler.debug>true</compiler.debug>



    <!-- Set size of output SWF file. -->

    <default-size width="${WIDTH}" height="${HEIGHT}"/>



    <!-- Include all these swcs -->

    <compiler.include-libraries dir="${LIBS_DIR}" append="true">

        <include name="*.swc" />

        <exclude name="data.swc"/>

    </compiler.include-libraries>    



    <!-- Include the useful swcs -->

    <compiler.library-path dir="${LIBS_DIR}" append="true">

        <include name="*.swc"/>

    </compiler.library-path>



    <!-- Reference the external swcs -->

    <compiler.external-library-path dir="${LIBS_DIR}" append="true">

        <include name="*.swc" />

    </compiler.external-library-path>



    <source-path path-element="F:/My Documents/SVN/Box2D/src"/>

</mxmlc>

compc

编译 as3 项目，输出 swc 库，大部分选项都同 mxmlc ，需要注意的是 include-classes ，这个参数需要指定哪些类需要编译进 swc 中，格式是以空格为分隔符的类的字符串列表，比如： org.easily.astar.AStar org.easily.astar.BinaryHeap org.easily.astar.Grid org.easily.astar.Node

<compc output="${OUTPUT_DIR}/easily.swc" 

    include-classes="${CLASSES}"

    optimize="true" 

    benchmark="true" 

    strict="true" 

    actionscript-file-encoding="utf-8"

    locale="en_US" 

    allow-source-path-overlap="true"

    use-resource-bundle-metadata="true"

    incremental="false">



    <static-link-runtime-shared-libraries>true</static-link-runtime-shared-libraries>

    <compiler.debug>false</compiler.debug>

    <show-actionscript-warnings>false</show-actionscript-warnings>



    <load-config filename="${FLEX_HOME}/frameworks/flex-config.xml"/>

    <source-path path-element="${SOURCE_DIR}"/>

    <library-path dir="${PROJECT_DIR}/libs" includes="*" append="true"/>

    <source-path path-element="F:/My Documents/SVN/Box2D/src"/>

</compc>

可以将类的定义放到另外一个文件中，比如 class.properties ，定义一个属性为 CLASSES=xx xx xx，ant 是有相关的 api 可以将相关的类定义找到并处理好，只是语法过于拧巴，我写了个 python 脚本来干这个事情：

import os



def findmatch(file_name, ext, excludes):

    for exclude in excludes:

        if file_name.find(exclude) != -1:

            return False

    return file_name.endswith(ext)



def list_file(dir_name, ext, excludes):

    result = []

    for root, dirs, files in os.walk(dir_name):

        result.extend(os.path.join(root, file_name) for file_name in files if findmatch(file_name, ext, excludes))

    return result



def list_class(root, root_sep, ext, excludes):

    return (format_name(root_sep, file_name, ext) for file_name in list_file(root, ext, excludes))



def format_name(root_sep, file_name, ext):

    return file_name.replace(ext, "").replace(root_sep, "").replace("\\", ".")



def export_file(root_list, ext, excludes, out_file):

    with open(out_file, "w") as f:

        f.write("CLASSES=")

        for root in root_list:

            f.writelines(class_name + " " for class_name in list_class(root, root + "\\", ext, excludes))



def main():

    root_list = [os.getcwd()+"\\..\\src"]

    ext = ".as"

    excludes = ["Test.as"]

    out_file = "class.properties"

    export_file(root_list, ext, excludes, out_file)



if __name__ == "__main__":

    main()

exec

执行脚本或者应用程序，可以指定应用程序和命令行参数。

<exec executable="/bin/sh">

    <arg line = "-c 'php ${basedir}/../xml.php'" />

</exec>