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:
- baseLocation: położenie instalacji produktu Eclipse zawierającej wszystkie wymagane fabrycznie zbudowane składniki i wtyczki w podkatalogach features/ i plugins/.
- baseos: system operacyjny (os) instalacji produktu Eclipse wskazanej przez właściwość baseLocation.
- basews: system okienkowy (ws) instalacji produktu Eclipse wskazanej przez właściwość baseLocation.
- basearch: architektura (arch) instalacji produktu Eclipse wskazanej przez właściwość baseLocation.
- buildDirectory: katalog, w którym będzie miało miejsce budowanie. Należy go ustawić jako pełną ścieżkę do utworzonego wcześniej katalogu budowania.
- configs: lista konfiguracji, dla których składnik ma zostać zbudowany. Można usunąć znaki komentarza dla dostarczonych konfiguracji (należy uważać na kontynuację w nowym wierszu). Jeśli budowany składnik jest niezależny od platformy, właściwość tę można pominąć lub można podać dla niej wartość *,*,*.
- archivePrefix: nazwa katalogu na dysku, do którego składnik zostanie rozpakowany.
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:
-buildfile=</ścieżka/do/build.xml>
: ścieżka do pliku build.xml dostarczonego przez środowisko PDE Build. Plik ten znajduje się w katalogu org.eclipse.pde.build/scripts. Jest to plik budowania sterujący całym procesem budowania.
-Dbuilder=</sciezka/do/folderu konfiguracji>
: jest to ścieżka do folderu konfiguracji budowania.
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.