使用 p2 的產品建置

定義新內容:

p2.gathering = true

將使產品建置有一些變更。尤其,建置將產生適當安裝的 p2 完整啟用產品。

下列為相關內容的清單(新與舊):

p2.gathering設為 true,以開啟 p2 發佈者為基礎的建置。
p2.build.repo本端建置時期 p2 儲存庫的 URI,預設值是 file:${buildDirectory}/buildRepo。結果將從這裡鏡映到最終保存位置。
generate.p2.metadata這是舊的 meta 資料產生器整合的內容。當 p2.gathering=true 時,它沒有作用。
p2.metadata.repo
p2.artifact.repo
這些內容是 URI。依預設,產品建置的最終保存檔是已安裝的產品,而 meta 資料和構件則留在 ${p2.build.repo} 中。如果已定義 p2.metadata.repo 和 p2.artifact.repo,則產品的構件和 meta 資料將從建置儲存庫鏡映。
p2.metadata.repo.name
p2.artifact.repo.name
這是選用的,使用 p2.metadata.repo 和 p2.artifact.repo 時,這些內容將用來命名最終儲存庫。
p2.compress設為 true,將最終儲存庫 xml 壓縮成 jar。
p2.flavor產品的特性,作為產品配置 meta 資料的限定元使用。請參閱下面。
p2.product.qualifier在產品版本中取代"1.0.0.qualifier" 時使用的限定元。若未設定,限定元將根據 forceContextQualifier 或時間戳記。
p2.publish.artifacts當 p2.gathering=true(舊內容)時,沒有作用
p2.root.name
p2.root.version
當 p2.gathering=true(舊內容)時,沒有作用
p2.context.repos定義環境定義儲存庫。請參閱重複使用 meta 資料。
repoBaseLocation包含要使用 <p2.repo2runnable> 轉換的儲存庫之資料夾。另請參閱重複使用 meta 資料。
transformedRepoLocation包含 <p2.repo2runnable> 的輸出之資料夾。另請參閱重複使用 meta 資料。
p2.category.site用來定義種類的 site.xml 檔的 URL。
p2.category.definition用來定義種類的 category.xml 檔的 URL。
p2.category.prefix定義字首,以確保從不使用唯一名稱的 site/category 檔案產生之種類 IU 有唯一 ID。
skipMirroring略過從 ${p2.build.repo} 到 ${p2.metadata.repo} 的最終鏡映。
skipDirector略過對引導器的呼叫。將不會產生已安裝的產品。如果已定義 p2.metadata.repo 和 p2.artifact.repo,則那些儲存庫將包含產品 meta 資料和構件,否則 ${p2.build.repo} 將包含結果。
p2.director.log記載引導器呼叫結果的日誌檔之位置。
p2.director.profile用於引導器所建立之 p2 設定檔的名稱。一般而言,命名為與產品相關的名稱是一個好方法。預設值為 "profile"。
p2.director.extraArgs將傳送至目錄的額外引數。預設值為 "-profileProperties org.eclipse.update.install.features=true"。
鏡映內容當建置產品或特性時,「PDE/建置」會從環境定義儲存庫鏡映要併到建置中的相依關係。 這些內容用來控制哪些相依關係會併到這個作業中。 請參閱 p2.mirror Ant 作業,以取得詳細資料。
p2.mirror.raw預設值:false。設為 true 會重複使用來源儲存庫中的構件描述子。
p2.mirror.slicing.filter預設值是沒有過濾器。 請設定 IU 必須滿足才能併入的其他過濾器內容。
p2.mirror.slicing.followOnlyFilteredRequirements預設值是 false。 設為 true 會反轉過濾器,只會併入不符合的 IU。
p2.mirror.slicing.followStrict預設值是 false。 設為 true 只會併入已明確指定其版本的相依關係。
p2.mirror.slicing.includeFeatures預設值是 true。 是否併入特性。
p2.mirror.slicing.includeNonGreedy預設值是 false。 是否併入非窮盡相依關係。
p2.mirror.slicing.includeOptional預設值是 true,是否併入選用的相依關係。
p2.mirror.slicing.latestVersionOnly預設值是 false,當需求是包含多個版本的範圍時,是否只併入相依關係的最新版本。
p2.mirror.slicing.platformFilter預設值是沒有過濾器,"os,ws,arch" 三項值設為 IU LDAP 過濾器所要比對的平台。 不符合過濾器的 IU 不會鏡映。

產品特性

PDE/Build 會自動產生預設配置 meta 資料,以設定啟動層次和 config.ini 內容,這是產品建置的一部分。此 meta 資料一般稱為配置單元 (CU)。尤其,會針對要啟動的軟體組,在 IU 上使用 CU 片段設定啟動層次。 根據 IU 產生 CU 名稱時,會使用此特性作為限定元。

例如,使用 "p2.flavor = tooling" 時,'toolingwin32.win32.x86org.eclipse.core.runtime' 將是在視窗上配置 org.eclipse.core.runtime 軟體組的 CU 名稱。 根據產品 ID 使用特性是一個好方法,可避免與其他 meta 資料相衝突,尤其如果產品有關於啟動層次的特定需求時更是如此。

另請參閱配置產品頁面。

引導器呼叫

PDE/Build 包含 runDirector 目標,在產品建置期間呼叫此目錄可執行安裝。目前,這是新程序中的引導器應用程式的分出。 在更進階的 releng 實務中,可重複使用此作業來執行其他安裝。此作業需要定義建置器的 equinox 啟動程式的位置。範例呼叫看起來如下:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>