访存资源库
“PDE 构建”提供的基础结构允许在构建过程中访存资源库中所要构建的源代码。有两种可能:让“PDE 构建”自动访存源代码或者以手工方式访存源代码。
自动访存 CVS 中的源代码
给定所需构建的功能部件的标识,构建基础结构能够从 CVS 中访存所包括的所有功能部件和插件。
为了确定内容的所在位置,PDE 使用了映射文件。映射文件是一个
Java 属性文件,它将功能部件标识和插件标识映射到资源库中的位置和标记。用于访存 CVS 的映射文件条目的格式为:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
其中 elementType 是 bundle、feature、plug-in 或
fragment。如果未指定路径,则将使用元素名作为 CVS 模块,例如:
plugin@org.foo.bar=CVS,v20060501,:pserver:anonymous@cvs.example.org:/cvsroot/foo
将访存 cvs.eclipse.org/cvsroot/foo/org.foo.bar 中的标记 v20060501
所标记的插件 org.foo.bar。
进行设置以访存 CVS 中的源代码
要进行设置以访存 CVS 中的源代码,应该执行下列操作:
- 确保 cvs.exe 在系统搜索路径中。(可以从这里下载 CVS)。
- 在构建目录中创建名为 maps 的文件夹。
- 在 maps 文件夹中创建扩展名为 .map 的文件。
- 在此映射文件中填写所有要在资源库中访存的元素。
- 编辑配置文件夹中的 build.properties 文件,注释掉 skipFetch=true
所在的那一行。如果设置了该属性,“PDE 构建”就会跳过整个访存阶段。如果要忽略映射文件中指定的标记,可将
fetchTag 属性设置为特定的值。如果要在夜间根据 HEAD 执行构建,而不是根据所标记的版本执行构建,此功能就非常有用。
从 CVS 中获取映射文件
映射文件通常存储在资源库中。“PDE 构建”提供了用于从 CVS 资源库中获取那些映射文件的缺省基础结构。要启用此功能,请在配置目录中的配置 build.properties 文件中更改下列属性:
- skipMaps:注释掉此属性。如果设置了此属性,“PDE 构建”就不访存映射文件。
- mapsRepo = :pserver:anonymous@example.com/path/to/repo:CVS 资源库,将从此资源库中获取映射文件。
- mapsRoot = /path/to/maps:CVS 资源库中映射文件所在目录的路径。
- mapsCheckoutTag = HEAD:用于检出映射文件的 CVS 标记。
将在构建过程中的预构建阶段从 CVS 中访存映射文件。在构建过程中的访存阶段,将生成并运行用于访存所构建的功能部件中包括的所有功能部件和插件的脚本。
自动访存其他资源库
“PDE 构建”提供了一个扩展点,您可以在此扩展点插入不同资源库的访存脚本生成器。如果 Eclipse 安装版本中包含的某个捆绑软件提供了用于另一资源库类型的脚本生成器扩展,则可以通过在映射文件条目中指定该扩展来使用它:
<elementType>@<elementID> = <REPOSITORY>, <TAG>, [...]
TAG 后面的映射条目格式随扩展的不同而有所变化。
如果自动访存资源库中的映射文件,则需要将 customTarget.xml 文件从 org.eclipse.pde.build/templates/headless-build
复制到配置目录中。目标 getMapFiles 用来访存映射文件,应该将其修改为访存资源库中的映射文件。
以手工方式获取源代码
您可以编写定制访存目标以检索插件和功能部件,接着,可以从 customTargets.xml 文件中的 preSetup 或 postSetup
目标中调用那些定制访存目标。应该将功能部件和插件分别存储到 ${buildDirectory}/features 和
${buildDirectory}/plugins 目录中。