Budowanie aplikacji RCP z pliku konfiguracyjnego produktu

Środowisko PDE Build jest dostarczane z infrastrukturą umożliwiającą zbudowanie kompletnej aplikacji RCP z pliku konfiguracyjnego produktu. Większość konfiguracji wymaganej do takiego budowania można wykonać, wprowadzając pewną ilość modyfikacji do szablonu build.properties dostępnego w środowisku PDE Build. Poniższe sekcje koncentrują się na konfigurowaniu budowania prostego produktu przy założeniu, że wszystkie wtyczki i składniki (do zbudowania i gotowe), do których odwołuje się plik produktu, są dostępne na dysku lokalnym.

Podstawowa konfiguracja

Pierwszym krokiem w konfiguracji budowania jest utworzenie katalogu, w którym budowanie będzie miało miejsce. Będzie on nosił nazwę katalogu budowania i zawierał wtyczki oraz składniki do zbudowania, a także wygenerowane artefakty. Następnie należy skopiować wtyczki i składniki odpowiednio do podkatalogów "plugins" i "features". Plik konfiguracyjny produktu powinien znajdować się w jednym z tych katalogów.

Następnie należy skopiować plik szablonu build.properties z katalogu org.eclipse.pde.build/templates/headless-build do nowego katalogu, który będzie katalogiem konfiguracji budowania (zwanym także katalogiem konfiguracji). Edytując skopiowany plik build.properties, należy ustawić następujące właściwości:

Przegląd struktury katalogów

<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
...

Uruchamianie budowania

Aby uruchomić budowanie, należy użyć aplikacji org.elipse.ant.core.antRunner. Wywołując za pomocą tej aplikacji program Eclipse w celu wykonania budowania, należy w wierszu komend podać dwa argumenty:
Uruchom aplikację antRunner za pomocą następującej komendy:
java -jar <eclipseInstall>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<KatalogInstalacyjnyEclipse>/plugins/org.eclipse.pde.build_<wersja>/scripts/productBuild/productBuild.xml> -Dbuilder=<ścieżka do folderu konfiguracji budowania>

Zaawansowane scenariusze

Konfiguracja ta wygeneruje w tle składnik zawierający wtyczki lub składniki określone w pliku konfiguracyjnym produktu.  Ten wygenerowany składnik zostanie następnie użyty do sterowania normalnym budowaniem w środowisku nienadzorowanym w oparciu o składniki. Jeśli wymagane jest dalsze dostosowanie budowania, np. pobieranie z repozytorium, więcej informacji można uzyskać w sekcji Zaawansowane tematy dotyczące środowiska PDE Build.