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

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

要使用定制目标,功能部件或插件必须在它的 build.properties 文件中定义 customBuildCallbacks 属性;此属性值是包含定制目标的 XML 文件相对于该功能部件/插件的根的位置。如果该 XML 文件在别的位置,请使用 customBuildCallbacks.buildpath 属性来设置要使用的目录。

在 org.eclipse.pde.build/templates/plugins 和 org.eclipse.pde.build/templates/features 中都提供了名为 customBuildCallbacks.xml 的模板,这些模板包含受支持的定制目标。您可以将这些模板复制到功能部件/插件中并根据需要进行修改。

将使用子 Ant 任务来调用定制目标;缺省情况下,failonerror 设置为 false。要进行更改,请将 customBuildCallbacks.failonerror 属性设置为 true。同样,inheritall 参数的缺省值为 false。要进行更改,请设置 customBuildCallbacks.inheritall 属性。

插件

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

功能部件

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