“PDE 构建”提供了用于自动构建功能部件的基础结构。通过对“PDE 构建”提供的模板 build.properties 进行少量修改,可以完成此类构建所必须进行的大部分设置工作。下一节着重描述设置简单的构建。这里,我们假定所构建的功能部件中引用的所有插件和功能部件(既包括要构建的插件和功能部件也包括预先构建的插件和功能部件)都已在本地磁盘上。
在设置构建时,第一步是创建构建配置目录。用于控制和定制无头构建的文件保存在此目录中。
用于控制构建的主要文件是顶级构建配置 build.properties 文件。当设置新的构建时,从 Eclipse 安装中的 org.eclipse.pde.build bundle 中复制您将用来运行构建的模板文件。此模板文件位于 org.eclipse.pde.build/templates/headless-build/build.properties 下。
builder 属性将引用此目录,此目录通常是在 Ant 命令行上设置的。
buildDirectory 属性指定 PDE/构建将在其中生成脚本和执行实际构建的目录。应将所构建的插件和功能部件放入 ${buildDirectory}/plugins 和 ${buildDirectory}/features 子目录中。如果从存储库中访存了 bundle 和功能部件(请参阅访存存储库),那么它们也将被放入此处。
此目录可能与构建配置目录相同,或者可能是另一个目录。使用一个单独的目录可能更可取;如果构建配置保存在 CVS 中,而您又不想让已生成的构建工件与它混合在一起,那么更应这么做。
要设置基本功能部件构建,需要编辑构建配置 build.properties 文件并设置下列属性:
先前版本的 PDE/构建还需要 allElements.xml 文件,而发行版 3.4 中不再需要此文件。仍然可以使用 allElements.xml 文件,但是仅当您想定制构建的某些方面时才必须使用此文件。请参阅定制无头构建。
要运行构建,请使用 org.elipse.ant.core.antRunner 应用程序。在使用此应用程序来调用 Eclipse 以执行构建时,需要在命令行上设置两个参数:
-buildfile=</path/to/build.xml>:这是“PDE 构建”提供的
build.xml 的路径。此文件在 org.eclipse.pde.build/scripts 目录中。这是用于驱动整个构建过程的构建脚本。-Dbuilder=</path/to/configuration folder>:这是构建配置文件夹的路径。使用以下命令来运行 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 构建”主题以了解更多信息。