Ant 脚本通常是使用“插件开发环境”(PDE)生成的,但是也可以手工或者从其它脚本来生成 Ant 脚本。
实际上 PDE 公开 Ant 任务以生成各种构建脚本。构建脚本生成工具驻留在下列任务中。还列示了每项任务的自变量。
elements:将要访存的条目。期望的格式是目录文件格式中指定的 type@id。
buildDirectory:将在其中生成访存脚本而且功能部件和插件项目将检出到其中的目录;
directory:指向目录文件的路径;
children:(可选)指定是否应调用所包含的插件和段的脚本生成。缺省值设置为 true;
cvspassfile:(可选)CVS 密码文件的名称;
fetchTag:(可选)用给定的值覆盖目录文件中提供的标记;
configInfo:(可选)指示目标配置的用 & 符号分隔的配置列表。缺省值设置为独立于平台;
recursiveGeneration:(可选)指定是否应该为嵌套的功能部件生成访存脚本。缺省值设置为 true。
elements:要从存储库中访存的条目。条目的格式应该为目录文件格式中指定的 type@id;
buildDirectory:要构建的功能部件和插件所在的目录;
children:(可选)指定是否应调用所包含的插件和段的脚本生成。缺省值设置为 true;
recursiveGeneration:(可选)指定是否应调用所包含的功能部件的脚本生成。缺省值设置为 true;
devEntries:(可选)要指定给编译类路径的以逗号分隔的目录列表;
buildingOSGi:(可选)指示目标是 3.x 还是 2.1;
baseLocation:(可选)指示包含已安装功能部件和文件夹的文件夹;
configInfo:(可选)用来指示目标配置的用 ampersand 符号分隔的配置列表。缺省值设置为独立于平台;
pluginPath:(可选)指向已安装插件的用逗号分隔的 URL 列表。如果指定此项,则此列表必须包括要编译的插件的完整列表;
archivesFormat:(可选)配置以及每个配置的预期输出格式的 & 符号分隔列表。格式为使用连字符(-)与配置分隔开。支持的值是:folder、tar、zip 和 antZip,它们分别表示不压缩、使用 tar 来创建归档、使用平台上提供的信息 zip 的版本以及使用 ant zip。缺省值是 antZip。
product:(可选)所构建的 RCP 产品的位置的路径,此路径使用“/”作为路径分隔符。路径的第一段必须引用包含 .product 文件的插件的插件标识。
signJars:(可选)指示生成的脚本是否必须对功能部件和插件的 jar 进行签名。缺省值为 false。签名任务的参数是由下列 ant 属性控制的:sign.alias、sign.keystore 和 sign.storepass,它们分别被传递给 ant signJar 任务的 alias、keystore 和 storepass 参数。缺省值为 false。
generateJnlp:(可选)指示是否应该为正在构建的所有功能部件生成 jnlp 文件。
outputUpdateJars:(可选)当设置了此项时,将使用更新站点格式来生成插件和功能部件。缺省值为 false。注意,既不生成也不更新 site.xml。
forceContextQualifier:(可选)使用给定的值来替换插件和功能部件的限定符。
<eclipse.fetch elements="bundle@org.eclipse.osgi" buildDirectory="c:\toBuild" directory="directory.txt" configInfo="win32,win32,x86 & linux, motif, x86" /> <eclipse.buildScript elements="bundle@org.eclipse.osgi" buildDirectory="c:\toBuild" archivesFormat="macosx, carbon, ppc - tar"/>
仅当 Eclipse 正在运行时,先前描述的任务才能工作。在使用 Eclipse 任务执行 Ant 脚本的特定方案中,必须使用“Eclipse Ant 运行程序”应用程序来运行脚本。此特定情况的命令行如下所示:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
注意,出现在应用程序后面的参数就是传递给 Ant 的参数。