建置特性

「PDE 建置」檢附了自動建置特性的基礎架構。 您只需要稍微修改 PDE 建置所提供的 build.properties 範本,便可以完成這類建置大部分必要的設定。 下一節的焦點是設定簡式建置,它假設本端磁碟提供了建置中的特性所參照的所有外掛程式和特性(即將建置和預先建置都包括在內)。

基本設定

設定建置的第一個步驟是建立執行建置的目錄。 這個目錄稱為建置目錄,它會包含即將建置的外掛程式和特性及所有產生的構件。 之後,再將外掛程式和特性分別複製到 "plugins" 和 "features" 子目錄中。 feature 資料夾預用來存放建置的特性。

設定建置的第二個步驟,是將 org.eclipse.pde.build/templates/headless-build 中的 build.properties 範本檔複製到將成為建置配置目錄的新目錄(也稱為配置目錄)中。 請編輯複製的 build.properties 檔,設定下列內容:

控制建置項目:allElements.xml

將 org.eclipse.pde.build/templates/headless-build 中的 allElements.xml 檔複製到配置目錄中。 這是告訴您要建置哪個特性的檔案。 這個檔案含有兩類目標:指定要建置之特性的 allElementsDelegator,以及呼叫來組合個別配置的組合目標。 名稱為 org.foo.Feature 之特性的 allElementsDelegator
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
組合目標可讓您在個別配置基礎上,控制最終保存檔的名稱。 您在建置的每個配置都應該有一個目標。 例如,當建置 Windows 的 org.foo.Feature(當 configs 設為 win32、win32、x86)時,您應該會有下列目標:
<!--Target for assembling  os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
當建置不關聯於特定平台的配置(未設定 configs,或設為 *,*,*)時,目標應該如下:
<!--The platform independent assemble target-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

執行建置

如果要執行建置,您將使用 org.elipse.ant.core.antRunner 應用程式。 當利用這個應用程式呼叫 Eclipse 來執行建置時,您必須在指令行設定兩個引數:
請利用下列指令來執行 antRunner 應用程式:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>
建置完成之後,您可以在名稱為 I.TestBuild(您可以設定 buildLabel 內容來配置這個名稱)之資料夾的建置目錄中取得結果。

進階實務

如果建置需要進一步的自訂,也就是從儲存庫中進行提取,請參閱各個「進階 PDE 建置」主題,以取得詳細資訊。