「PDE 建置」所提供的基礎架構提供了一些步驟,可在建置程序的過程中從儲存庫中提取程式碼並預先建置外掛程式(請參閱 eclipse.fetch 作業和控制提取的內容)。 這有兩個可能性:讓「PDE 建置」自動提取程式檔,或手動提取原始碼。
在取得需要建置之特性或外掛程式的 ID 之後,建置基礎架構就能夠從儲存庫提取所有併入的特性和外掛程式。
為了知道要從哪裡取得東西,PDE 會使用對映檔。 對映檔是一個將特性和外掛程式 ID 對映至儲存庫中之位置和標示的 Java 內容檔。 對映檔的格式是任意的,但 key 的部分則是由「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) 的 ID 與版本,以及用來尋找 IU 的儲存庫 URI。meta 資料與構件儲存庫會假設是放在相同位置。
透過 p2 提取內容的對映檔項目的格式如下:
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
在 Helios 版本中,可以指定代表特性 JAR 的「可安裝單元」,利用 p2 來提取特性。如需特性 p2 meta 資料結構的詳細資料,請參閱特性 meta 資料頁面。
範例: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 建置」提供了一個延伸點,供您插入不同儲存庫的提取 Script 產生器。 如果 Eclipse 安裝包含的軟體組提供了可用於不同儲存庫類型的 Script 產生器延伸,您可以在對映檔項目中指定該儲存庫,並遵守延伸提供者所指定的格式,來使用該儲存庫。
如果您從儲存庫中自動提取對映檔,您必須將 org.eclipse.pde.build/templates/headless-build 中的 customTarget.xml 檔複製到配置目錄中。 目標 getMapFiles 用來提取對映檔,您應該加以修改,以便從您的儲存庫中提取。