從產品配置檔建置 RCP 應用程式

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

基本設定

設定建置的第一個步驟是建立執行建置的目錄。 這個目錄稱為建置目錄,它會包含即將建置的外掛程式和特性及所有產生的構件。 之後,再將外掛程式和特性分別複製到 "plugins" 和 "features" 子目錄中。 您的產品配置檔預定是在其中一個外掛程式/特性之中。

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

目錄結構的概觀

<buildDirectory>/
plugins/
pluginToBuildA
pluginToBuildB
myProduct.product
...
features/
featureToBuild
...

<buildConfiguration>/
build.properties

<baseLocation>
plugins/
org.eclipse.core.runtime
org.eclipse.ui
...
features/
org.eclipse.rcp
org.eclipse.platform.launchers
...

執行建置

如果要執行建置,您將使用 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/productBuild/productBuild.xml> -Dbuilder=<path to the build configuration folder>

進階實務

這項設定會在幕後產生一項包含您的產品配置檔所指定之外掛程式或特性的特性。 之後,會利用這個產生的特性來驅動以無監視器型建置為基礎的正常特性。 如果建置需要進一步的自訂,也就是從儲存庫中進行提取,請參閱各個「進階 PDE 建置」主題,以取得詳細資訊。