從儲存庫提取

「PDE 建置」所提供的基礎架構提供了一些步驟,可在建置程序的過程中從儲存庫中提取程式碼並預先建置外掛程式(請參閱 eclipse.fetch 作業和控制提取的內容)。 這有兩個可能性:讓「PDE 建置」自動提取程式檔,或手動提取原始碼。

自動化的首要步驟,對映檔

在取得需要建置之特性或外掛程式的 ID 之後,建置基礎架構就能夠從儲存庫提取所有併入的特性和外掛程式。

為了知道要從哪裡取得東西,PDE 會使用對映檔。 對映檔是一個將特性和外掛程式 ID 對映至儲存庫中之位置和標示的 Java 內容檔。 對映檔的格式是任意的,但 key 的部分則是由「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) 的 ID 與版本,以及用來尋找 IU 的儲存庫 URI。meta 資料與構件儲存庫會假設是放在相同位置。

透過 p2 提取內容的對映檔項目的格式如下:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
使用 p2 來提取特性

在 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 產生器延伸,您可以在對映檔項目中指定該儲存庫,並遵守延伸提供者所指定的格式,來使用該儲存庫。

設定提取 CVS 程式檔

如果要設定從 CVS 中提取程式檔,您應該執行下列動作:

從 CVS 中取得對映檔

對映檔通常儲存在儲存庫中。 「PDE 建置」會提供從 CVS 儲存庫中取得這些對映檔的預設基礎架構。 如果要啟用這個功能,請變更您的配置在配置目錄中之 build.properties 的下列內容: 在建置的「預先建置」階段中,會從 CVS 提取對映檔。 在建置的提取階段中,會產生和執行一些 Script,用來提取併入您在建置之特性的所有特性和外掛程式。 

自動從其他儲存庫中提取

如果您從儲存庫中自動提取對映檔,您必須將 org.eclipse.pde.build/templates/headless-build 中的 customTarget.xml 檔複製到配置目錄中。 目標 getMapFiles 用來提取對映檔,您應該加以修改,以便從您的儲存庫中提取。

手動取得原始碼

您可以撰寫自訂提取目標來擷取 customTargets.xml 檔中的 preSetup 或 postSetup 目標所能呼叫的外掛程式和特性。 特性和外掛程式應該分別提取到 ${buildDirectory}/features 和 ${buildDirectory}/plugins 中。