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: |
(可选)指示目标是否为 V3.x 或 V2.1。缺省值为 true。 |
baseLocation: |
(可选)指定一个文件夹,该文件夹包含带有 features/ 和 plugins/ 子目录的目标 Eclipse 安装版本。 |
configInfo: |
(可选)用 & 符分隔的配置列表,指示目标配置。缺省值设置为独立于平台。 |
pluginPath: |
(可选)平台文件分隔符分隔的位置列表,将在那些位置中查找其他插件。 |
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: |
(可选)使用给定的值来替换插件和功能部件的限定符。(另请参阅版本限定符) |
generateFeatureVersionSuffix: | (可选)是否生成功能部件版本后缀。 |
groupConfiguration: |
(可选)是否将所构建的所有配置分组到单一归档中。 |
generateVersionsLists: |
(可选)是否生成属性文件来列示已构建的功能部件和插件版本。 |
featureId: |
对生成的功能部件指定的标识。 |
buildDirectory: |
要包括的功能部件和插件所在的目录(它们分别在 /features 和 /plugins 子目录中)。生成的功能部件将放在 /features 子目录中。 |
baseLocation: |
(可选)指示已安装的功能部件和插件所在的文件夹。 |
productFile: |
(可选)生成的功能部件所基于的产品文件。 |
verify: |
是否使用解析器来验证所提供的插件和功能部件是否可用。此参数还确定该功能部件能否正确地处理要进行
JAR 归档的特定于平台的段和插件。如果所有要包括在功能部件中的元素都在本地,则应该将 verify 设置为
True。如果需要获取资源库中的元素,请将 verify 设置为 False 并使用生成的功能部件来访存所需的插件和功能部件,然后在指定 verify = True 的情况下重新生成容器功能部件。 |
pluginPath: |
(可选)平台文件分隔符分隔的位置列表,将在那些位置中查找其他插件。 |
configInfo: |
(可选)用 & 符分隔的配置列表,指示目标配置。缺省值设置为独立于平台。 |
pluginList: |
(可选)在生成的功能部件中要包括的插件标识的逗号分隔列表。 |
featureList: |
(可选)在生成的功能部件中要包括的功能部件标识的逗号分隔列表。 |
fragmentList: |
(可选)在生成的功能部件中要包括的段标识的逗号分隔列表。 |
<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 的参数。