从命令行生成 Ant 脚本
Ant 脚本通常是使用“插件开发环境”(PDE)生成的,但是也可以手工或者从其它脚本来生成 Ant 脚本。
实际上 PDE 公开 Ant 任务以生成各种构建脚本。构建脚本生成设施驻留在下列任务中。还列示了每个任务的自变量。
- eclipse.fetch:生成从 CVS 资源库中取装内容的 Ant 脚本。Eclipse 取装是由一个文件驱动的(在下面描述了该文件的格式)(参见目录文件格式)。
elements:将取装的用逗号隔开的条目列表。期望各个条目具有象在目录文件格式中指定的格式 type@id;
install:功能部件和插件项目将检出到的目录;
directory:目录文件的名称;
scriptname:生成的脚本的名称;
children:(可选)指定是否应调用所包含的插件和段的脚本生成。缺省值设置为 true;
cvspassfile:(可选)CVS 密码文件的名称。
- eclipse.buildScript:为给定的元素生成 build.xml 文件。
elements:将构建的用逗号分隔的条目列表。期望各个条目具有象在目录文件格式中指定的格式 type@id;
install:要构建的功能部件和插件所在的目录;
children:(可选)指定是否应调用所包含的插件和段的脚本生成。缺省值设置为 true;
devEntries:(可选)要给予编译类路径的用逗号分隔的目录列表。
pluginPath:(可选)指向已安装插件的用逗号分隔的 URL 列表。如果指定此项,则此列表必须包括要编译的插件的完整列表。
示例
<eclipse.fetch elements="plugin@org.eclipse.core.boot"
install="c:\toBuild"
directory="directory.txt"
scriptname="fetch.xml"/>
<eclipse.buildScript elements="plugin@org.eclipse.core.boot"
install="c:\toBuild"/>
目录文件格式
目录文件用来指示插件和功能部件所在的位置,并指示应当取装哪个版本。它是一个 Java 属性文件,其行格式为“type@id=version, repositoryLocation, password”。
- type
:用来描述元素类型的字符串。它必须是下列项之一:插件、段和功能部件;
- id
:元素所在的 CVS 模块的名称。注意,feature/plugin/fragment.xml 必须位于此模块的根目录中;
- version
:资源库中的现有版本标记;
- repositoryLocation
:CVS 资源库位置;
- password
:(可选)连接至此资源库的密码。
目录文件的示例
feature@org.eclipse.jdt.source=v20030114, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
plugin@org.eclipse.core.boot=v20021215a, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
plugin@org.eclipse.core.resources=v20030114, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
fragment@org.eclipse.core.resources.win32=v20020911, :pserver:anonymous@dev.eclipse.org:/home/eclipse,
使用目标
仅当 Eclipse 正在运行时先前描述的任务才能工作。在使用
Eclipse 任务执行 Ant 脚本的特定方案中,必须使用“Eclipse Ant 运行程序”应用程序来运行脚本。此特定情况的命令行为如下所示:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
注意,出现在应用程序后面的参数就是传递给 Ant 的参数。