自訂遠端控制建置

自訂遠端控制建置有多種方法:

這些檔案內容的確實格式全都彼此相依。因此,當您使用 customTargets、allElements 或 customAssembly 自訂項目時,建議您確定用於這些檔案的範本全都來自相同版本的「PDE/建置」。新版的「PDE/建置」會與這些自訂 Script 的舊版本相容。

這些 Script 的範本版本位於 templates/headless-build 資料夾下的 org.eclipse.pde.build 外掛程式中。如果要使用自訂項目,您只要將範本複製到建置配置目錄中,然後編輯適當的目標即可。

customTargets.xml

customTargets.xml Script 用於建置程序的最上層自訂作業。其提供了可在建置的主要階段之間呼叫的 Ant 目標。下列每一個建置步驟前後都有前置和後置目標:

如果要使用 customTargets.xml Script,您只要將它從「PDE/建置」的 templates 目錄複製到建置配置目錄中,然後編輯適當的 Ant 目標即可。遠端控制建置即會自動偵測並使用該 Script。

customTargets.xml Script 也可在每一個建置階段委派給 allElements.xml Script。

allElements.xml

allElements.xml Script 是一種委派 Script,用來對給定的元素(通常是特性)執行各種不同的建置步驟。如果要利用 customTargets.xml 來使用這些自訂步驟,請將範本從「PDE/建置」複製到建置配置目錄中。在 Eclipse 3.4 中,您可以在最上層的建置配置 build.properties 檔中,利用 topLevelElementType 和 topLevelElementId 內容來指定會建置的目標元素。elementType 應該設為 feature,而 elementId 應該設為您要建置的特性 ID。

 	<target name="allElementsDelegator">
 		<ant antfile="${genericTargets}" target="${target}">
	 		<property name="type" value="${topLevelElementType}" />
	 		<property name="id" value="${topLevelElementId}" />
 		</ant>
	</target>

allElements.xml 也會提供在建置的組合和封裝階段期間,所要使用的目標。系統會呼叫 defaultAssemble 目標來組合所有平台的保存檔。如有需要,您可以對個別平台定義自訂目標。

如果要使用給定平台的自訂目標,請定義 "assemble.<element-id>[.<config>] 內容和對應的目標。該內容會告知「PDE/建置」使用這個自訂目標,而非使用預設的目標。接著這個自訂目標可以用來提供自訂名稱給保存檔,或是對保存檔執行前置或後置處理。

範例:

	<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
 	<target name="assemble.org.foo.feature.id.linux.gtk.x86">
 		<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
 		<-- custom pre assemble steps for linux.gtk.x86-->
 		<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
 		<-- custom post assemble steps for linux.gtk.x86-->
	</target>

customAssembly.xml

customAssembly.xml Script 是 3.4 中的新項目。其提供了在建置的組合和套裝階段期間,會呼叫的自訂點。如果要利用 customTargets.xml 和 allElements.xml 來使用這些自訂項目,請將範本從「PDE/建置」複製到建置配置目錄中。

「PDE/建置」所產生的組合和封裝 Script 會執行下列動作:

組合 Script 會收集在建置期間已編譯的特性和外掛程式,而封裝 Script 則會收集任何經過前置編譯的二進位特性和外掛程式。customAssembly.xml Script 在上述每一個步驟前或後提供了下列目標: