p2 发布程序的 PDE 构建扩展

PDE 构建提供了多项用于扩展 p2 发布程序的 Ant 任务。这些任务允许 PDE 构建将元数据和工件直接发布到 p2 存储库中。

所生成的构建脚本在完全构建上下文中使用这些任务,诸如编译类文件和替换版本等事项就是在此上下文中完成的。在特殊情况下,某些任务可能对于直接发布元数据而不运行完全构建很有用。

eclipse.publish.featuresAndBundles

此任务与 p2 发布程序所提供的 p2.publish.featuresAndBundles 任务非常相似。此任务将发布预先存在的、不是从源构建的二进制功能部件和插件的元数据。此任务还将根据所提供的 site.xml 或 category.xml 文件来发布类别。

此任务支持下列属性:

metadataRepository 用于指定要发布至的元数据存储库的 URI
artifactRepository 用于指定要发布至的工件存储库的 URI
repository 同时设置 metadataRepository 和 artifactRepository。
site 用于指定类别信息的 site.xml 的 URL。
category 用于指定类别信息的 category.xml 的 URL。
siteQualifier 用来确保获得的类别 IU 具有唯一名称的限定符。
<features> 用于指定要发布的二进制功能部件所在位置的嵌套文件集元素。
<bundles> 用于指定要发布的二进制插件所在位置的嵌套文件集元素。
示例:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:\eclipse\features\" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

直接从源发布插件。一旦编译了捆绑软件的 .class 文件,此任务就会收集组成二进制结果的所有文件,并将它们作为具有元数据的 p2 工件来发布。在插件生成的 build.xml 中,此任务用于 publish.bin.parts 任务中;当您使用 p2 发布程序进行构建时,此任务将取代 gather.bin.parts 任务。

此任务支持下列属性:

metadataRepository 要发布至的元数据存储库的 URI。
artifactRepository 要发布至的工件存储库的 URI。
buildResultFolder 包含已构建的 .class 文件、清单和可能存在的 .api_description 文件的文件夹。
targetFolder 与 customBuildCallbacks 一起运行时的内容。
baseDirectory 未使用 customBuildCallbacks 时,要从其中收集内容的项目位置。
unpack 安装时,是否应将插件解包到文件夹表单中。
gatheredSource 对于源捆绑软件,这是收集源所在的位置。
<outputFolder> 用于指定要从其中获取 .class 文件的备用位置的嵌套元素,在工作空间中复用 .class 文件时使用这些元素。这是一个具有另外的“library”属性的 Ant 文件集,此属性指定这些类文件所属的库
示例:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

直接从源发布功能部件。此任务将收集组成功能部件 JAR 的所有文件,并将它们作为具有元数据的 p2 工件来发布。此任务还将发布包含此功能部件所提供的任何根文件的工件。如果功能部件未指定 bin.includes 属性,那么将不会生成功能部件 JAR,但是仍将具有根文件工件和功能部件组元数据。

此任务支持下列属性:

metadataRepository 要发布至的元数据存储库的 URI。
artifactRepository 要发布至的工件存储库的 URI。
buildResultFolder 包含一个已修改并且替换了版本的 feature.xml 的文件夹。
targetFolder 与 customBuildCallbacks 一起运行时的内容。
baseDirectory 功能部件项目位置。
示例:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

标记产品的启动程序工件,并使用新名称重新发布它们,以将它们包含在给定产品中。

此任务支持下列属性:

metadataRepository 要发布至的元数据存储库的 URI。
artifactRepository 要发布至的工件存储库的 URI。
config 将使用启动程序的配置。(例如,“gtk.linux.x86”)
iconsList 可找到用来标记可执行文件的图标的位置。
tempDirectory 可以使用的临时目录所在的位置。
productId 要发布的产品的标识。
productVersion 要发布的产品的版本。
launcherName 要为新的启动程序给定的名称。
launcherProvider 要提供原始启动程序工件的 IU 的名称。缺省情况下,此名称为“org.eclipse.equinox.executable”,此任务将查找名为 <launcherProvider>_root.<config> 的工件