“PDE 构建”提供的基础结构提供了一些步骤,允许在构建过程中访存存储库中的源代码和预先构建的插件(请参阅 eclipse.fetch 任务和用于控制访存的属性)。有两种可能:让“PDE 构建”自动访存源代码或者以手动方式访存源代码。
给定需要构建的功能部件的或插件的标识,构建基础结构能够从存储库中访存所包括的所有功能部件和插件。
为了确定内容的所在位置,PDE 使用了映射文件。映射文件是一个 Java 属性文件,它将功能部件标识和插件标识映射到存储库中的位置和标记。映射文件的格式是公开的,但关键部分带有“PDE 构建”前缀:
<elementType>@<elementID>[,<elementVersion>] = <repo specific content>
其中 elementType 是 bundle、feature、plugin 或 fragment,而 elementId 和 elementVersion 提供元素的具体信息。
<key> = CVS, [,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 所支持的任何 URL 访存内容的映射文件条目的格式如下所示:
<key> = GET, <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
已经向 PDE/构建添加了新的扩展,从而使用户能够访存 p2 存储库中的工件。现在,您可以为构件输入向映射文件中添加一个条目,而 PDE/构建将检索工件并将它包含在此构件中。 映射文件条目需要包含可安装单元(IU)的标识和版本,以及可以在其中找到此 IU 的存储库的 URI。 假定元数据和工件存储库位于同一位置。
要通过 p2 来访存内容的映射文件条目的格式为如下所示:
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
在 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 安装版本中包含的某个捆绑软件提供了用于另一存储库类型的脚本生成器扩展,那么可以通过在映射文件条目中指定该存储库并遵循扩展提供程序指定的格式来使用该存储库。
如果自动访存存储库中的映射文件,那么需要将 customTarget.xml 文件从 org.eclipse.pde.build/templates/headless-build 复制到配置目录中。目标 getMapFiles 用来访存映射文件,应该将其修改为访存存储库中的映射文件。