重複使用 p2 meta 資料

給定的特性或軟體組的 meta 資料可能不同,視其產生方式而定。尤其當自訂 meta 資料或當特性提出根檔案時。

因此,可能的話,一律重複使用 meta 資料,而不要根據您未擁有的二進位特性和軟體組重新產生它。

repo2runnable 作業

有一項 Ant 作業叫做 <p2.repo2runnable>,它將特性和軟體組構件轉換成其已安裝的形式。一般而言,如果想要能夠編譯外掛程式,則這就是我們需要的外掛程式形式。 這項作業可讓我們輕易地從我們自己的建置中的其他專案重新使用儲存庫。PDE/Build 透過下列內容與這項作業之間有內建整合:

repoBaseLocation包含要轉換的儲存庫的資料夾。此資料夾可包含壓縮的儲存庫以及本身是儲存庫的子資料夾。
transformedRepoLocation將放置所轉換之構件的資料夾。此資料夾將變成 p2 儲存庫本身。

3.5 版的一項新增特性為自訂目標 preProcessRepos 和 postProcessRepos,它們出現在 PDE/Build 的<p2.repo2runnable> 呼叫之前和之後。這可自動鏡映或下載壓縮的儲存庫:
build.properties:
	repoBaseLocation=${buildDirectory}/inputRepositories
	transformedRepoLocation=${buildDirectory}/transformedRepo
	
customTargets.xml:
<target name="preProcessRepos">
   <p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
      <iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
      <iu id="org.eclipse.cdt.feature.group"/>
   </p2.mirror>
   <property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
   <get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
	</target>
(在撰寫本文件時,還不知道 3.5 版最終壓縮檔的位置,因此這裡的 URL 只作為範例之用,以後不會存在)。

PDE/Build 會先呼叫 preProcessRepos 自訂目標,然後呼叫 repo2runnable ant 作業,將那些已下載的儲存庫轉換成可供建置重複使用的表單。

定義此轉換之輸出位置的 transformedRepoLocation 內容也會作為 context repository。

環境定義儲存庫

p2.context.repos 內容是一份逗點區隔清單,包含作為建置的 context 的儲存庫。

產生 meta 資料時,建置會先諮詢環境定義儲存庫,看看該特性或外掛程式是否已有現存的 meta 資料。 如果 meta 資料已存在,則它將複製到建置本端儲存庫 (${p2.build.repo}),而不是所產生的新 meta 資料。

同樣地,如果特性、軟體組或產品已自訂其 meta資料依賴建置所不包含的項目,則 PDE/Build 將從環境定義儲存庫中執行鏡映。此鏡映作業將包含已新增至特性或外掛程式 meta 資料的任何 IU。