访存存储库

“PDE 构建”提供的基础结构提供了一些步骤,允许在构建过程中访存存储库中的源代码和预先构建的插件(请参阅 eclipse.fetch 任务和用于控制访存的属性)。有两种可能:让“PDE 构建”自动访存源代码或者以手动方式访存源代码。

自动化第一步 - 映射文件

给定需要构建的功能部件的或插件的标识,构建基础结构能够从存储库中访存所包括的所有功能部件和插件。

为了确定内容的所在位置,PDE 使用了映射文件。映射文件是一个 Java 属性文件,它将功能部件标识和插件标识映射到存储库中的位置和标记。映射文件的格式是公开的,但关键部分带有“PDE 构建”前缀:

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

其中 elementType 是 bundle、feature、plugin 或 fragment,而 elementId 和 elementVersion 提供元素的具体信息。

CVS 的映射文件条目

要从 CVS 中访存内容的映射文件条目的格式如下所示:
<key> = CVS, [,args]
其中 args 是一组以逗号分隔的键/值对,如下所述: 示例:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

旧样式映射条目
在 Eclipse 3.2 和更低版本中,CVS 的映射文件格式为:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
如果未指定任何可选参数,那么仍然需要使用逗号为下列任何参数定界。应将此格式考虑为不推荐使用的格式,首选键/值格式。

Ant GET 的映射文件条目

要从 Ant GET 所支持的任何 URL 访存内容的映射文件条目的格式如下所示:

<key> = GET, <url> [,args]
其中 url 是从中检索数据的 URL,args 是一组以逗号分隔的可选键/值对,如下所述: 示例:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

p2 访存的映射文件条目

已经向 PDE/构建添加了新的扩展,从而使用户能够访存 p2 存储库中的工件。现在,您可以为构件输入向映射文件中添加一个条目,而 PDE/构建将检索工件并将它包含在此构件中。 映射文件条目需要包含可安装单元(IU)的标识和版本,以及可以在其中找到此 IU 的存储库的 URI。 假定元数据和工件存储库位于同一位置。

要通过 p2 来访存内容的映射文件条目的格式为如下所示:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
使用 p2 访存功能部件

在 Helios 发行版中,可通过指定表示功能部件 JAR 的可安装单元使用 p2 访存功能部件。请参阅功能部件元数据页面以了解有关功能部件的 p2 元数据结构的详细信息。

示例:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

其他存储库的映射文件条目

“PDE 构建”提供了一个扩展点,您可以在此扩展点插入不同存储库的访存脚本生成器。如果 Eclipse 安装版本中包含的某个捆绑软件提供了用于另一存储库类型的脚本生成器扩展,那么可以通过在映射文件条目中指定该存储库并遵循扩展提供程序指定的格式来使用该存储库。

进行设置以访存 CVS 中的源代码

要进行设置以访存 CVS 中的源代码,应该执行下列操作:

从 CVS 中获取映射文件

映射文件通常存储在存储库中。“PDE 构建”提供了用于从 CVS 存储库中获取那些映射文件的缺省基础结构。要启用此功能,请在配置目录中的配置 build.properties 文件中更改下列属性: 将在构建过程中的预构建阶段从 CVS 中访存映射文件。在构建过程中的访存阶段,将生成并运行用于访存所构建的功能部件中包括的所有功能部件和插件的脚本。 

自动访存其他存储库

如果自动访存存储库中的映射文件,那么需要将 customTarget.xml 文件从 org.eclipse.pde.build/templates/headless-build 复制到配置目录中。目标 getMapFiles 用来访存映射文件,应该将其修改为访存存储库中的映射文件。

以手动方式获取源代码

您可以编写定制访存目标以检索插件和功能部件,接着,可以从 customTargets.xml 文件中的 preSetup 或 postSetup 目标中调用那些定制访存目标。应该将功能部件和插件分别存储到 ${buildDirectory}/features 和 ${buildDirectory}/plugins 目录中。