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:

Ří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:
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.