Balení komponent Eclipse

Komponenty Eclipse jsou dodávány jako archivní soubory. Každý archiv obsahuje kolekci funkcí a modulů plug-in. Typicky archivy obsahují všechny funkce, které konkrétní komponenta nabízí. Často jde o případ, kdy konzumenty chtějí buď více než jednu komponentu, anebo potřebují pouze části některých komponent. Bez asistence by konzumenty musely ručně načíst archivy obsahující nadmnožinu potřebných funkcí a poté ručně extrahovat požadované funkce a moduly plug-in. To však může být pracný proces, při kterém může docházet k chybám.

Naštěstí PDE obsahuje dávkově orientovaný mechanizmus, balíčkovací program, který může pomoci. Ve zkratce, balíčkovací program bere za vstup seznam archivů obsahujících funkce a seznam zajímavých funkcí. Poté načte soubory zip, extrahuje funkce (a jejich moduly plug-in) a znovu je zabalí do výstupního souboru zip.

Jak rychle začít

Níže je sada základních kroků pro rychlý začátek s balíčkovacím programem.  Na strojích s *nix se doporučuje pro zajištění zachování oprávnění k souborům sestavit balíčky *nix.

  1. Vytvořte adresář konfigurace balení a zkopírujte do něj soubory se šablonami (packager.properties, packaging.properties a customTargets.xml) z org.eclipse.pde.build/templates/packager.
  2. Upravte zkopírované soubory packager.properties a nastavte následující vlastnosti:
  3. Získání mapovacích souborů balíčkovacího programu.  Následující vlastnosti řídí stahování mapovacích souborů:
    Skript balíčkovacího programu složí všechny *.map soubory nalezené v ${downloadDirectory}. Pro stažení více než jednoho mapovacího souboru nebo jejich načtení z CVS, upravte soubor customTargets.xml a změňte cíl getMapFiles.
  4. Spusťte balíčkovací program pomocí následujícího příkazu:
  5. java -jar <eclipse install>/startup.jar -application org.eclipse.ant.core.antRunner 
    -buildfile <<eclipse install>/plugins/org.eclipse.pde.build_<version>/scripts/package.xml>
    -DpackagingInfo=<cesta k vašemu adresáři konfigurace balení>

Formát mapovacích souborů balíčkovacího programu

Mapovací soubory balíčkovacího programu se používají k popisu různých archivů, jejich obsahu a odkud mohou být staženy.  Jsou podobné mapovacím souborům používaných v procesu sestavení pro načtení balíků z úložišť.  Formát položky mapovacího souboru balíčkovacího programu je následující:
archiveName = url | [configList] | [directory] | contentDescription | componentName

Uvědomte si, že configList a directory jsou volitelné, je důležité, aby byl přesto použit příslušný počet oddělovačů "|".
Příklady:
eclipse-SDK-3.1-win32.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | win32,win32,x86 | | sdk | eclipse
eclipse-PDE-3.1.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | | | runtime | pde

Vlastnosti konfigurace balíčkovacího programu

Následující vlastnosti mohou být nastaveny v konfiguračním souboru balíčkovacího programu packager.properties:
baseDirectory
Adresář, ve kterém bude probíhat veškeré balení
workingDirectory
Adresář, ve kterém budou generovány skripty.  Hodnota v šabloně je ${baseDirectory}/workingPlace
downloadDirectory
Složka, do které budou archivy staženy.  Hodnota v šabloně je ${baseDirectory}/toPackage
tempDirectory
Složka, do které budou archivy extrahovány.  Hodnota v šabloně je ${baseDirectory}/temp
featurePaths
Název kořenového adresáře stažených archivů.  Hodnota v šabloně je eclipse.
featureList
Čárkami oddělovaný seznam identifikátorů funkcí, které chcete znovu zabalit.
componentFilter
Čárkami oddělovaný seznam komponent, podle kterého mohou být funkce ze seznamu featureList nalezeny.  Tím se filtrují dostupné archivy, a umožňuje se tak balíčkovacímu programu optimalizovat množinu stažených souborů.
contentFilter
Čárkami oddělený seznam typů obsahu, které mají být načteny.  Tím se filtrují dostupné archivy, a umožňuje se tak balíčkovacímu programu optimalizovat množinu stažených souborů.
config
"&"oddělený seznam konfigurací (čárkami oddělené trojice operačního systém, systému oken a architektury), které mají být znovu zabaleny.  (Např.: win32, win32, x86 & linux, gtk, x86)
archivesFormat
Formáty archivů.  "&" Oddělený seznam konfigurace - formát.  (Např.: win32, win32, x86 - antZip & linux, gtk, ppc - tar).  Pokud není pro danou konfiguraci zadaný žádný formát, výchozí formát je antZip.
zipargs
Další argumenty předané zipu
unzipargs
Další argumenty předané unzipu
archivePrefix
Předpona výsledného archivu(ů)
collectingFolder
Název kořenové složky výsledného archivu.
buildId
Řídí ID sestavení ve výchozím názvu archivu.
buildType
Typ sestavení, použitý při pojmenování výstupního sestavení.  Zpravidla jedno z I, N, M, S, ...
buildLabel
Štítek sestavení.  Hodnota šablony je ${buildType}.${buildId}
archiveNamePrefix
Řídí název výsledného archivu.  Výchozí hodnota je ${buildId}
packagingProperties
Relativní cesta k souboru obsahujícího kořenové soubory vlastností balení.  Ve výchozím nastavení ukazuje na packaging.properties.
deltaPack
Zda se má nebo nemá generovat balík rozdílových dat.  To vyloučí platformově nezávislé kusy a seskupí všechny konfigurace do jednoho archivu.

Balení kořenových souborů

Vlastnost packagingProperties v konfiguračním souboru balíčkovacího programu packager.properties ukazuje na soubor vlastností, který udává kořenové soubory, které musí být znovu zabaleny.  Ve výchozím nastavení je to soubor packaging.properties.

Tento soubor vlastností by měl obsahovat vlastnosti určující nezbytné kořenové soubory.  Podrobnosti o vlastnostech kořenových souborů viz téma Vlastnosti konkrétních funkcí.