Funkce sestavení

Sestavení PDE nabízí infrastrukturu pro automatizaci funkcí sestavení. 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é sestavením 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í

Adresář konfigurace sestavení

Prvním krokem vytvoření sestavení je vytvoření adresáře konfigurace sestavení. To je adresář, v němž se uchovávají soubory, které řídí a upravují sestavení bez hlavičky.

Hlavním souborem pro řízení sestavení je konfigurační soubor sestavení nejvyšší úrovně build.properties. Při vytváření nového sestavení zkopírujte soubor se šablonou z balíku org.eclipse.pde.build do instalace eclipse, kterou budete používat pro spuštění sestavení. Soubor se šablonou se nachází v adresáři org.eclipse.pde.build/templates/headless-build/build.properties.

Na tento adresář odkazují vlastnosti builder, který je zpravidla nastaven na příkazovém řádku ant.

Adresář sestavení buildDirectory

Vlastnost buildDirectory specifikuje adresář, v němž PDE/Build vygeneruje skripty a provede skutečné sestavení. Moduly plug-in a funkce, které jsou sestavovány, by měly být umístěny v podadresářích ${buildDirectory}/plugins a ${buildDirectory}/features. Jsou-li balíky a funkce načítány z úložiště (viz Načítání z úložiště), pak zde budou umístěny také.

Tento adresář může být stejný jako adresář konfigurace sestavení, nebo to může být jiný adresář. Může být žádoucí použít oddělený adresář, zejména pokud je konfigurace sestavení uchovávána v CVS a nechcete do ní vnést generované artefakty sestavení.

Počáteční vlastnosti

Abyste vytvořili základní sestavení funkce, musíte upravit konfigurační soubor sestavení build.properties a nastavit následující vlastnosti:

Předchozí verze PDE/Build také vyžadovaly soubor allElements.xml, ve verzi 3.4 to již není nutné. Soubor allElements.xml může být i nadále používán, ale je požadován pouze tehdy, pokud chcete upravit určité aspekty sestavení. Viz Přizpůsobení sestavení bez hlavičky.

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>/plugins/org.eclipse.equinox.launcher_<verze>.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 upravení sestavení, například načítání z úložiště, další informace najdete v tématu Rozšířené sestavení PDE.