一般来说,Ant 的构建文件默认为 build.xml,放在项目顶层目录中。然而,并没有限制构建文件必须命名为 bulid.xml,也并不限制放在项目顶层目录中。你可以将构建文件命名为其他名字,也可以将它放在项目的其他地方。
这个教程将以简单的方式向你展示如何利用 Apache Ant 来自动地构建和部署项目的过程。在完成本教程的学习以后,你将会发现你已经具备下一阶段学习 Apache Ant 中等水平的专业知识 。
例如:
<project name="Cesium" default="combine">
属性:
name : 项目名称
default:指定运行的target名称,没有指定时使用缺省的target;
basedir:基准路径,其他的相对路径都是基于这个基准路径的;
description:项目描述信息。
<target name="combine" depends="build,combineJavaScript" description="Combines all source files into a single stand-alone script." />
注意:一个target可以依赖于其他target。例如combine依赖于 build target 和 combineJaveScript target,ant 会按照 depends 中 target 出现的顺序依次执行,并且每个 target 只会被执行一次,即使有多个target依赖于他。
target有以下属性:
name:target名称,这个属性是必须的;
depends:依赖目标,非必须
if:当属性设置时才执行该target,非必须;
unless:当属性没有设置时才执行该target,非必须;
description:target的描述信息,非必须;
Task分为内置task和自定义task,每个task都是一段可执行的代码。
<copy file="${requirejsPath}/require.min.js" tofile="${cesiumViewerOutputDirectory}/require.js" />
<glslToJavascript minify="${build.minification}" minifystatefile="${buildDirectory}/minifyShaders.state">
<glslfiles dir="${shadersDirectory}" includes="**/*.glsl" />
<existingjsfiles dir="${shadersDirectory}" includes="**/*.js" excludes="*.profile.js" />
</glslToJavascript>
定义任务:<scriptdef name="glslToJavascript" language="javascript" src="${tasksDirectory}/glslToJavaScript.js" manager="bsf" classpathref="javascriptClassPath" loaderref="javascript.loader">
<attribute name="minify" />
<attribute name="minifystatefile" />
<element name="glslfiles" type="fileset" />
<element name="existingjsfiles" type="fileset" />
</scriptdef>
创建一个文件命名为 build.xml 的文件,存储在你电脑的任意地方 ,并包含以下的内容:
<?xml version="1.0"?>
<project name="Hello World Project" default="info">
<target name="info">
<echo>Hello World - Welcome to Apache Ant!</echo>
</target>
</project>