可以使用多种方法来定制无头构建:
这些文件的内容的准确格式都是互相依赖的。因此,当使用 customTargets、allElements 或 customAssembly 定制时,建议您确保用于这些文件的模板全部都来自于同一版本的 PDE/构建。新版本的 PDE/构建与这些定制脚本的旧版本是向后兼容的。
在 templates/headless-build 文件夹下的 org.eclipse.pde.build 插件中提供了这些脚本的模板版本。要使用定制,只需将模板复制到构建配置目录中并编辑相应的目标。
customTargets.xml 脚本用于构建过程的顶级定制。它提供在构建的主要阶段中调用的 Ant 目标。在下列每个构建步骤中都提供了前后两个目标:
要使用 customTargets.xml 脚本,只需将它从 PDE/构建模板目录复制到构建配置目录中并编辑相应的 Ant 目标。无头构建将自动检测和使用该脚本。
对于每个构建阶段,customTargets.xml 脚本还对 allElements.xml 脚本提供授权。
allElements.xml 脚本是一种授权脚本,用来对给定元素(通常是一个功能部件)运行各种构建步骤。与 customTargets.xml 一样,要使用这些定制步骤,请将模板从 PDE/构建复制到构建配置目录中。在 Eclipse 3.4 中,可以在顶级构建配置 build.properties 文件中使用 topLevelElementType 和 topLevelElementId 属性来指定将构建的目标元素。elementType 应设置为 feature,elementId 应设置为您想要构建的功能部件标识。
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
allElements.xml 还提供在构建过程中的组装和打包阶段所使用的目标。将调用 defaultAssemble 目标以为所有平台组装归档。如果需要,可以为各个平台定义定制目标。
要使用给定平台的定制目标,请定义“assemble.<element-id>[.<config>]”属性和相应的目标。该属性让 PDE/构建知道应使用此定制目标而不使用缺省目标。然后,可以使用此定制目标来为归档给定一个定制名称,或者对此归档执行预处理或后处理。
示例:
<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
<target name="assemble.org.foo.feature.id.linux.gtk.x86">
<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
<-- custom pre assemble steps for linux.gtk.x86-->
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
<-- custom post assemble steps for linux.gtk.x86-->
</target>
customAssembly.xml 脚本是发行版 3.4 中的一个新增脚本。它提供在构建过程中的组装和打包阶段将调用的定制点。与 customTargets.xml 和 allElements.xml 一样,要使用这些定制,请将模板从 PDE/构建复制到构建配置目录中。
由 PDE/构建生成的组装和打包脚本将执行下列操作:
组装脚本将负责收集在构建期间已编译的功能部件和插件,打包脚本负责收集所有已预编译的二进制功能部件和插件。customAssembly.xml 脚本在执行上述每个步骤之前或之后将提供下列目标: