复用 p2 元数据

所给定的功能部件或捆绑软件的元数据随其生成方式不同而不同。在定制元数据时或者在功能部件提供根文件时更是如此。

因此,最好是尽可能复用元数据,而不根据您可能并不拥有的二进制功能部件和捆绑软件来重新生成元数据。

repo2runnable 任务

有一项 Ant 任务 <p2.repo2runnable>,它会将功能部件和捆绑软件工件变换为它们的已安装形式。通常,如果我们希望能够编译插件,那么这些插件需要处于这种形式。 此任务使我们很容易在自己的构建中的其他项目中重复使用存储库。PDE/构建已经通过下列属性内置了与此任务的集成:

repoBaseLocation一个文件夹,它包含要变换的存储库。此文件夹可以包含已压缩的存储库以及作为存储库的子文件夹。
transformedRepoLocation将用于存放已变换的工件的文件夹。然后,此文件夹将成为 p2 存储库。

Eclipse 3.5 中新增了定制目标 preProcessRepos 和 postProcessRepos,它们分别出现在 PDE/构建调用 <p2.repo2runnable> 之前和之后。这允许自动镜像或下载已压缩的存储库:
build.properties:
	repoBaseLocation=${buildDirectory}/inputRepositories
	transformedRepoLocation=${buildDirectory}/transformedRepo
	
customTargets.xml:
<target name="preProcessRepos">
   <p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
      <iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
      <iu id="org.eclipse.cdt.feature.group"/>
   </p2.mirror>
   <property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
   <get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
      </target>
(在编写本文档时,尚不知道 Eclipse 3.5 的最终 zip 文件所在的位置,此处提供的 URL 只是充当一个示例,在以后的任何日期都有可能不存在。)

PDE/构建将首先调用 preProcessRepos 定制目标,然后它将调用 Ant 任务 repo2runnable,从而将已下载的那些存储库变换为可供构建复用的形式。

用于定义此变换的输出位置的 transformedRepoLocation 属性还充当上下文存储库。

上下文存储库

p2.context.repos 属性是用逗号分隔的存储库列表,它充当构建的上下文。

在生成元数据时,构建首先将查阅上下文存储库,以了解功能部件或插件是否已经具有元数据。 如果已存在元数据,那么会将它复制到构建的本地存储库(${p2.build.repo}),而不是生成新的元数据。

此外,如果功能部件、捆绑软件或产品已经将它们的元数据定制为依赖于构建中尚不包含的某个对象,那么 PDE/构建将在上下文存储库外部执行镜像。此镜像操作将包含已添加至功能部件或插件元数据的任何 IU。