PDE 构建与 p2 集成

此页面描述不推荐使用的与 p2 进行集成的旧方法。请参阅“构建 p2 存储库和产品”页面以了解使用 p2 进行构建的建议方法。下面所描述的属性使用向后兼容层,并不支持可能添加至 p2 发布程序的任何新功能。

有关如何生成 p2 元数据的详细信息,请参阅“平台插件开发者指南”中的生成 p2 元数据页面。如果由它自己生成元数据,那么将不足以创建一个支持 p2 的产品。为此,必须从已生成的元数据执行实际的 p2 安装。有关如何从无头脚本执行此安装的详细信息,请参阅 p2 控制器文档。

通过在任何 PDE/构建的定制任务中手动调用 p2 元数据生成器,就可以生成 p2 元数据(请参阅定制无头构建)。但是,PDE/构建可以通过下列属性来实现与 p2 集成:

generate.p2.metadata
(不推荐使用,改为使用 p2.gathering)如果设置为 true,那么将生成 p2 元数据。Ant 脚本基于此属性存在并且不是一个值。要关闭元数据生成,必须除去此属性,而不仅仅是设置为 false。
在构建脚本中,当正在运行构建的 Eclipse 中存在 p2 捆绑软件 org.eclipse.equinox.p2.metadata.generator 及其依赖项时,就会调用 p2 目标。这些 p2 目标取决于 generate.p2.metadata 属性。
p2.metadata.repo
p2.artifact.repo
指定 file: URI 会给出要发布至的 p2 元数据和工件存储库的位置。通常,工件存储库与元数据存储库位于同一位置,但是它们并不是必须位于同一位置。
示例:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
可选。指定生成器 p2 存储库的名称。
使用一个已存在的存储库时,该存储库的现有名称将不会更改。如果未指定名称,那么 p2 将根据存储库所在的位置来为它们命名。
p2.flavor
设置 p2 元数据的版本风格。为 Eclipse SDK 生成元数据时,将使用“工具”版本风格。
p2.publish.artifacts
如果设置为 true,那么会将 JAR 发布到工件存储库中。如果设置为 false,那么会生成工件元数据,但是不会将 JAR 复制到工件存储库中。警告:当设置为 true 时,应确保 p2.artifact.repo 与 PDE/构建所使用的组装目录不位于同一位置,否则 JAR 最终可能会被删除!
p2.root.name
p2.root.version
指定将包含已构建的每个对象的根 IU 的名称和版本。
如果在构建中指定了 .product 文件,那么将忽略这些属性。但是,当 .product 文件可用时,根名称和版本将是该 .product 文件中的产品标识和版本。有关更多信息,请参阅下面的内容。

为产品生成元数据

在产品文件集位于顶级构建配置 build.properties 文件中的情况下运行构建时(它们都位于使用 productBuild.xml 和 normal build.xml 的构建中),PDE/构建将自动为该产品生成元数据。

此操作除了为所有功能部件和捆绑软件创建“可安装单元”(IU)以外,还将创建下列产品“可安装单元”(IU):

借助所有这些已生成的“可安装单元”(IU),可以使用 p2 在存储库外部安装整个产品。

详细信息

PDE/构建实质上是在构建期间在某些位置调用由 p2 提供的元数据生成任务。在构建期间,所有构建工件可能从不存在于磁盘上的同一位置。因此,需要对最终归档调用 p2 元数据生成器,或者在整个构建过程中多次调用 p2 元数据生成器(这是一项优化措施)。

将在组装和打包阶段生成元数据。对于正常构建和打包程序构建都是如此。为了说明这一点,对于使用 productBuild.xml 的产品构建,将生成下列脚本(假定 configs=win32,win32,x86 & linux,gtk,ppc):

组装脚本将收集与相关联的根文件一起构建的功能部件和插件。打包脚本将收集预构建的二进制功能部件和插件。特定于平台的脚本将收集特定配置的片段以及委托给特定于平台的每个脚本的“所有”脚本。

将按如下所示进行 p2 生成调用:

  1. assemble win32.win32.x86:对于为 Windows 收集的功能部件和插件生成元数据。
  2. assemble win32.win32.x86:对于为 Windows 收集的根文件生成的元数据再次进行调用。
  3. assemble linux.gtk.ppc:对于为 linux 收集的功能部件和插件生成元数据。
  4. assemble linux.gtk.ppc:对于为 linux 收集的根文件生成的元数据再次进行调用。
  5. assemble all:如果未运行打包程序:为包含上所有何内容的根可安装单元生成元数据。
  6. package win32.win32.x86:对于为 Windows 打包的功能部件和插件生成元数据。
  7. package win32.win32.x86:对于为 Windows 打包的根文件生成的元数据再次进行调用。
  8. package linux.gtk.ppc:对于为 linux 打包的功能部件和插件生成元数据。
  9. package linux.gtk.ppc:对于为 linux 打包的根文件生成的元数据再次进行调用。
  10. package all:为包含上所有何内容的根可安装单元生成元数据。

p2 元数据生成器任务支持以增量方式生成元数据,每次通过 mode=incremental 来调用生成的 p2 元数据,最后一次进行调用以生成根“可安装单元”(IU)时将通过 mode="final" 来运行。