整合 PDE 建置與 p2

這個頁面說明已淘汰的整合 p2 的老方法。 請參閱「建置 p2 儲存庫和產品」頁面,取得以 p2 建置的建議方法。 以下所說明的內容是利用舊版相容性層來運作,不支援任何可能新增到 p2 發佈者中的新特性。

如需產生 p2 meta 資料的詳細資料,請參閱「平台外掛程式開發人員手冊」中的產生 p2 meta 資料頁面。自行產生 meta 資料不足以建立啟用 p2 的產品。要執行這項作業,您必須從產生的 meta 資料執行實際的 p2 安裝。如需如何從遠端控制 Script 執行這項安裝的詳細資料,請參閱 p2 Director 文件。

您可以在任何「PDE/建置」的自訂作業中,手動呼叫 p2 meta 資料產生器來產生 p2 meta 資料(請參閱自訂遠端控制建置)。 不過,「PDE/建置」已透過下列內容來整合 p2:

generate.p2.metadata
(已淘汰,改用 p2.gathering)如果設為 true,則會開啟產生 p2 meta 資料。 Ant Script 會根據是否存在此內容而不是根據值來進行。如果要關閉 meta 資料的產生,必須移除此內容,而不只是設為 false。
在建置 Script 中,如果執行建置的 Eclipse 中存在 p2 軟體組 org.eclipse.equinox.p2.metadata.generator 和其相依項目,則會產生 p2 目標的呼叫。 這些 p2 目標會根據 generate.p2.metadata 內容的條件而定。
p2.metadata.repo
p2.artifact.repo
指定 file: URI,以提供發佈時之目標 p2 meta 資料和構件儲存庫的位置。雖然不必要,但是構件儲存庫通常會與 meta 資料儲存庫使用相同的位置。
範例:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
選用性的項目。指定產生器 p2 儲存庫的名稱。
當您使用已存在的儲存庫時,儲存庫的現有名稱不會變更。 如果未指定,p2 會根據其位置來命名儲存庫。
p2.flavor
設定 p2 meta 資料的 flavor(特性)。在產生 Eclipse SDK 的 meta 資料時,會使用 "tooling" 特性。
p2.publish.artifacts
如果設為 true,則會將 JAR 發佈至構件儲存庫。如果設為 false,則會產生構件 meta 資料,但是 JAR 不會複製到構件儲存庫中。警告:如果設為 true,請確定 p2.artifact.repo 的位置與「PDE/建置」所使用的組合目錄不同,否則 JAR 最後可能會被刪除!
p2.root.name
p2.root.version
指定會包含已建置之所有項目之根 IU 的名稱和版本。
如果在建置中指定了 .product 檔,則會忽略這些內容。反之,如果有 .product 檔可用,則根目錄名稱和版本會是來自 .product 檔的產品 ID 和版本。請參閱以下說明以取得相關資訊。

產生產品的 meta 資料

在以最上層建置配置的 build.properties 檔中設定的產品檔來執行建置時(於使用 productBuild.xml 和 the normal build.xml 兩者的建置中),「PDE/建置」會自動產生該產品的 meta 資料。

除了對所有特性和軟體組建立「可安裝單元」之外,這也會建立下列產品「可安裝單元」:

藉由這些所有產生的「可安裝單元」,您可以使用 p2 來安裝儲存庫以外的完整產品。

詳細資料

「PDE/建置」基本上會在建置期間的某些時點,呼叫 p2 所提供的 meta 資料產生作業。在建置期間幾乎不會有於單一時間點發生所有建置構件都存在於磁碟上相同位置的情況。因此,您可能需要對最終保存檔呼叫 p2 meta 資料產生器;或者,為了達到最佳化,在整個建置中呼叫該產生器多次。

在整個組合和套裝階段,會產生 meta 資料。一般建置和套裝程式建置都是如此。為了說明使用 productBuild.xml 的產品建置,系統會產生下列 Script(假設為 configs=win32,win32,x86 & linux,gtk,ppc):

組合 Script 會收集隨關聯的根檔案建置的特性和外掛程式。套件 Script 會收集前置建置二進位特性和外掛程式。平台專用的 Script 會收集這些特定配置的片段,以及委任給每一個平台專用 Script 的「所有」Script。

發生 p2 產生呼叫的方式如下:

  1. 組合 win32.win32.x86:針對 Windows 已收集的特性和外掛程式產生 meta 資料。
  2. 組合 win32.win32.x86:針對 Windows 已收集的根檔案,第二次呼叫已產生的 meta 資料。
  3. 組合 linux.gtk.ppc:針對 Linux 已收集的特性和外掛程式產生 meta 資料。
  4. 組合 linux.gtk.ppc:針對 Linux 已收集的根檔案,第二次呼叫已產生的 meta 資料。
  5. 組合全部:如果未執行套裝程式:針對包含上述所有項目的根可安裝單元,產生 meta 資料。
  6. 套裝 win32.win32.x86:針對 Windows 已封裝的特性和外掛程式產生 meta 資料。
  7. 套裝 win32.win32.x86:針對從封裝 Windows 得來的 rootfile,第二次呼叫已產生的 meta 資料。
  8. 套裝 linux.gtk.ppc:針對 Linux 已套裝的特性和外掛程式產生 meta 資料。
  9. 套裝 linux.gtk.ppc:針對在 Linux 上從封裝得來的 rootfile,第二次呼叫已產生的 meta 資料。
  10. 套裝全部:針對包含上述所有項目的根可安裝單元,產生 meta 資料。

p2 meta 資料產生器作業支援漸進式產生,對產生的 p2 meta 資料所進行的每一個呼叫都會以 mode=incremental 執行,而產生根可安裝單元的最終呼叫則會以 mode="final" 執行