功能部件和插件定制构建步骤

在 V3.2 中新增了一项功能,即允许功能部件或插件在它自己的构建过程中添加定制步骤。这些定制步骤可用于完成诸如在编译后检查字节码、为文档的帮助文件建立索引以及将其他文件复制到捆绑软件之类的任务。 

要使用定制目标,功能部件或插件必须在它的 build.properties 文件中定义 customBuildCallbacks 属性;此属性值是包含定制目标的 XML 文件相对于该功能部件/插件的根的位置。在 org.eclipse.pde.build/templates/plugins 和 org.eclipse.pde.build/templates/features 中都提供了名为 customBuildCallbacks.xml 的模板,这些模板包含受支持的定制目标。您可以将这些模板复制到功能部件/插件中并根据需要进行修改。将使用设置了 failonerror="false" 的子 Ant 任务来调用定制目标。因此,即使定制 XML 文件未包含特定目标或者发生了错误,也将继续进行构建。

插件

生成的用于构建插件的 build.xml 包含几个用于执行特定任务的目标。“PDE 构建”允许插件提供完成特定任务之前和之后调用的定制前目标和后目标。除了任何已定义的 Ant 属性以外,还可以将几个特定的属性传递给每个定制目标。下列目标支持定制回调:

功能部件

为功能部件生成的 build.xml 只支持 gather.bin.parts 目标的定制构建回调。此目标将调用包括的所有功能部件和插件的该 gather.bin.parts 目标。它支持 pre.gather.bin.parts 和 post.gather.bin.parts。这两个目标都具有下列属性: