构建功能部件

“PDE 构建”提供了用于自动构建功能部件的基础结构。通过对“PDE 构建”提供的模板 build.properties 进行少量修改,可以完成此类构建所必须进行的大部分设置工作。下一节着重描述设置简单的构建。这里,我们假定所构建的功能部件中引用的所有插件和功能部件(既包括要构建的插件和功能部件也包括预先构建的插件和功能部件)都已在本地磁盘上。

基本设置

构建配置目录

在设置构建时,第一步是创建构建配置目录。用于控制和定制无头构建的文件保存在此目录中。

用于控制构建的主要文件是顶级构建配置 build.properties 文件。当设置新的构建时,从 Eclipse 安装中的 org.eclipse.pde.build bundle 中复制您将用来运行构建的模板文件。此模板文件位于 org.eclipse.pde.build/templates/headless-build/build.properties 下。

builder 属性将引用此目录,此目录通常是在 Ant 命令行上设置的。

buildDirectory

buildDirectory 属性指定 PDE/构建将在其中生成脚本和执行实际构建的目录。应将所构建的插件和功能部件放入 ${buildDirectory}/plugins 和 ${buildDirectory}/features 子目录中。如果从存储库中访存了 bundle 和功能部件(请参阅访存存储库),那么它们也将被放入此处。

此目录可能与构建配置目录相同,或者可能是另一个目录。使用一个单独的目录可能更可取;如果构建配置保存在 CVS 中,而您又不想让已生成的构建工件与它混合在一起,那么更应这么做。

初始属性

要设置基本功能部件构建,需要编辑构建配置 build.properties 文件并设置下列属性:

先前版本的 PDE/构建还需要 allElements.xml 文件,而发行版 3.4 中不再需要此文件。仍然可以使用 allElements.xml 文件,但是仅当您想定制构建的某些方面时才必须使用此文件。请参阅定制无头构建。

运行构建

要运行构建,请使用 org.elipse.ant.core.antRunner 应用程序。在使用此应用程序来调用 Eclipse 以执行构建时,需要在命令行上设置两个参数:

使用以下命令来运行 antRunner 应用程序:


java -jar <eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>

完成构建后,结果包含在构建目录中名为 I.TestBuild(可以通过设置 buildLabel 属性来配置此名称)的文件夹中。

高级方案

如果要对构建进行进一步的定制,例如访存存储库,请参阅“高级 PDE 构建”主题以了解更多信息。