PDE 建置中的 p2 發佈者延伸

「PDE 建置」會提供幾項 ANT 作業來延伸 p2 發佈者。這些作業可讓「PDE 建置」直接將 meta 資料與構件發佈至 p2 儲存庫。

產生的建置 Script 在完整建置的環境定義中使用這些作業,該環境定義即是進行編譯類別檔及取代版本之類作業的地方。不過,有些作業在直接發佈 meta 資料而不執行完整建置的特殊情況下可能很有幫助。

eclipse.publish.featuresAndBundles

這項作業和 p2 發佈者提供的 p2.publish.featuresAndBundles 作業相當類似。這項作業會發佈不會從來源建置之既存二進位特性與外掛程式的 meta 資料。這項作業也會根據所提供的 site.xml 或 category.xml 檔,來發佈種類。

這項作業支援的屬性如下:

metadataRepository 指定發佈時之目標 meta 資料儲存庫的 URI。
artifactRepository 指定發佈時之目標構件儲存庫的 URI。
repository 同時設定 metadataRepository 和 artifactRepository。
site 指定種類資訊的 site.xml 的 URL。
category 指定種類資訊的 category.xml 的 URL。
siteQualifier 用來確定產生的種類 IU 使用唯一名稱的限定元。
<features> 指定要發佈之二進位特性位置的巢狀檔案集元素。
<bundles> 指定要發佈之二進位外掛程式位置的巢狀檔案集元素。
範例:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:\eclipse\features\" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

直接從來源發佈外掛程式。在編譯軟體組的 .class 檔之後,這項作業會收集所有構成二進位結果的檔案,並將它們當成一個內含 meta 資料的 p2 構件來發佈。這項作業用於針對外掛程式產生之 build.xml 中的 publish.bin.parts 作業內,而在您利用 p2 發佈者來建置時,這項作業會取代 gather.bin.parts 作業。

這項作業支援的屬性如下:

metadataRepository 發佈時之目標 meta 資料儲存庫的 URI。
artifactRepository 發佈時之目標構件儲存庫的 URI。
buildResultFolder 內含建置 .class 檔、資訊清單與潛在 .api_description 檔的資料夾。
targetFolder 當搭配 customBuildCallbacks 執行時要使用的內容。
baseDirectory 當不使用 customBuildCallbacks 時,要收集其中內容的專案位置
unpack 在安裝外掛程式時,是否應將它解壓縮成資料夾格式。
gatheredSource 就來源軟體組來說,這是收集來源的位置。
<outputFolder> 這些巢狀元素用來指定要從中取得 .class 檔的替代位置,當從工作區重複使用 .class 檔時就會用到這些元素。這是一個 ANT FileSet,其中含有一個額外的 "library" 屬性,用來指定類別檔所隸屬的程式庫
範例:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

直接從來源發佈特性。這項作業會收集所有構成特性 JAR 的檔案,並將它們當成一個內含 meta 資料的 p2 構件來發佈。這項作業也會發佈內含由這項特性所提供之任何根檔案的構件。如果特性沒有指定 bin.includes 內容,就不會產生特性 JAR,但是仍會有根檔案構件與特性群組 meta 資料。

這項作業支援的屬性如下:

metadataRepository 發佈時之目標 meta 資料儲存庫的 URI。
artifactRepository 發佈時之目標構件儲存庫的 URI。
buildResultFolder 這個資料夾含有一個已更換版本的已修改 feature.xml。
targetFolder 當搭配 customBuildCallbacks 執行時要使用的內容。
baseDirectory 特性專案的位置
範例:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

為產品設定啟動程式構件的品牌,並使用新名稱重新發佈它們,以併入至給定產品中。

這項作業支援的屬性如下:

metadataRepository 發佈時之目標 meta 資料儲存庫的 URI。
artifactRepository 發佈時之目標構件儲存庫的 URI。
config 將採用啟動程式的配置。(例如 "gtk.linux.x86")
iconsList 要從中尋找作為執行檔品牌圖示的位置。
tempDirectory 可供使用的暫存目錄的位置。
productId 發佈時所針對之產品的 ID。
productVersion 發佈時所針對之產品的版本。
launcherName 要提供給新啟動程式的名稱。
launcherProvider 將提供原始啟動程式構件的 IU 名稱。依預設,這是 "org.eclipse.equinox.executable",作業將會搜尋名稱為 <launcherProvider>_root.<config> 的構件