Funkce sestavení
Sestavení PDE nabízí infrastrukturu pro automatizaci sestavení funkcí.
Většinu nezbytných nastavení v rámci takovéhoto sestavení lze provést
prostřednictvím několika úprav šablony build.properties poskytnuté v sestavení PDE. Následující oddíl se zaměřuje na nastavení jednoduchého sestavení. Předpokládejme, že všechny moduly plug-in a funkce (k sestavení i předem sestavené) odkazované ze sestavované funkce jsou již lokálně dostupné na disku.
Základní nastavení
Prvním krokem vytvoření sestavení je vytvoření adresáře, ve kterém bude sestavení probíhat. Tento adresář budeme nazývat adresář sestavení a bude obsahovat moduly plug-in a funkce, které mají být sestaveny, a také všechny generované artefakty.
Dále zkopírujte moduly plug-in respektive funkce do podadresářů "plugins" respektive "features".
Očekává se, že složka funkcí bude obsahovat sestavovanou funkci.
Druhým krokem je zkopírování souboru build.properties z
org.eclipse.pde.build/templates/headless-build do nového adresáře, který bude adresářem konfigurace sestavení
(také nazýván jako adresář konfigurace). Upravte zkopírovaný soubor build.properties a nastavte následující vlastnosti:
- baseLocation: Umístění instalace Eclipse
obsahující všechny předem sestavené funkce a moduly plug-in v podadresářích
features/ a plugins/.
- baseos: Označuje os Eclipse zadané pomocí baseLocation.
- basews: Označuje ws Eclipse zadané pomocí baseLocation.
- basearch: Označuje arch Eclipse zadané pomocí baseLocation.
- buildDirectory: Adresář, ve kterém bude sestavení probíhat. Nastavte na úplnou cestu adresáře sestavení, který jste předtím vytvořil.
- configs: Seznam konfigurací,
pro které chcete sestavit vaši funkci. Můžete odstranit značky komentářů poskytnutých konfigurací (pozor na pokračování řádků). Pokud je sestavovaná funkce nezávislá na platformě, nemusí být tato vlastnost nastavena, nebo může být nastavena na *,*,*.
- archivePrefix:
Název adresáře, do kterého bude vaše funkce rozbalena na disk.
Řízení obsahu sestavení: allElements.xml
Zkopírujte soubor allElements.xml z org.eclipse.pde.build/templates/headless-build do vašeho konfiguračního adresáře. Je to soubor, který říká PDE, kterou funkci sestavujete. Tento
soubor obsahuje dva druhy cílů: allElementsDelegator,
který určuje sestavovanou funkci, a
cíle typu assemble, které jsou volány za účelem sestavení jednotlivých konfigurací.
allElementsDelegator pro funkci s názvem org.foo.Feature
je:
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Cíle typu assemble vám umožňují řídit název konečného archivu na bázi jedné konfigurace. Pro každou sestavovanou konfiguraci byste měli mít jeden cíl. Například,
sestavujete-li
org.foo.Feature
pro Windows (tj. configs je nastaven na win32, win32, x86), měli byste mít následující cíl:
<!--Cíl pro sestavení os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
Sestavujete-li konfiguraci nezávislou na platformě (configs není nastaven nebo je nastaven na*,*,*), měli byste mít nějaký takovýto cíl:
<!--Cíl typu assemble nezávislý na platformě-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>
Spuštění sestavení
Pro spuštění sestavení použijte aplikaci org.elipse.ant.core.antRunner. Při vyvolání Eclipse touto aplikací pro provedení sestavení musíte nastavit na příkazovém řádku dva argumenty:
-buildfile=</cesta/k/build.xml>
: Cesta
k build.xml poskytnutému sestavením PDE. Je umístěn v adresáři
org.eclipse.pde.build/scripts. Jde o soubor sestavení, který řídí
celý proces sestavení.
-Dbuilder=</path/to/configuration folder>
:
To je cesta ke složce konfigurace sestavení.
Spusťte aplikaci antRunner pomocí následujícího příkazu:
java -jar
<eclipseInstall>/startup.jar
-application org.eclipse.ant.core.antRunner -buildfile
<<eclipseInstall>/plugins/org.eclipse.pde.build_<verze>/scripts/build.xml>
-Dbuilder=<cesta ke složce konfigurace sestavení>
Jakmile bude sestavení dokončeno, výsledek najdete v adresáři sestavení, ve složce s názvem I.TestBuild
(tento název lze konfigurovat nastavením vlastnosti buildLabel).
Pokročilé scénáře
Pokud vyžadujete více přizpůsobení sestavení, například načítání z úložiště, další informace najde na stránce Pokročilé téma sestavení PDE.