Budowanie składników

Środowisko PDE Build zawiera infrastrukturę niezbędną do automatyzacji procesu budowania składników. 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ższa sekcja koncentruje się za przygotowaniu prostego procesu budowania, przy założeniu, że na dysku lokalnym dostępne są wszystkie wtyczki i składniki, do których odwołuje się składnik (zarówno już skompilowane, jak i przeznaczone do kompilacji).

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". Folder składników powinien zawierać budowany składnik.

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:

Definiowanie budowanego produktu: plik allElements.xml

Skopiuj plik allElements.xml z katalogu org.eclipse.pde.build/templates/headless-build do katalogu configuration. Zawartość tego pliku informuje środowisko PDE, który składnik jest budowany. Plik ten zawiera dwa rodzaje celów: cel allElementsDelegator, który określa budowany składnik, oraz cele assemble, które są wywoływane do składania poszczególnych konfiguracji. Element allElementsDelegator dla składnika o nazwie org.foo.Feature wygląda następująco:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Cele assemble pozwalają określać nazwę ostatecznego archiwum dla każdej konfiguracji z osobna. Dla każdej budowanej konfiguracji powinien istnieć jeden cel. Na przykład podczas budowania składnika org.foo.Feature dla systemu Windows (czyli przy właściwości configs o wartości win32, win32, x86) cel powinien wyglądać następująco:
<!-- Cel przy konfiguracji os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
W przypadku budowania konfiguracji niezależnej od platformy (gdy właściwość configs nie jest ustawiona lub ma wartość *,*,*), należy podać cel następującej postaci:
<!-- Cel przy konfiguracji niezależnej od platformy -->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

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 <katalog Eclipse>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<katalog eclipse>/plugins/org.eclipse.pde.build_<wersja>/scripts/build.xml> -Dbuilder=<ścieżka do folderu konfiguracji budowania>
Wyniki procesu budowania są umieszczane w katalogu budowania directory w folderze I.TestBuild (nazwę tę można skonfigurować ustawiając wartość właściwości buildLabel).

Zaawansowane scenariusze

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.