Načítání z úložišť
Infrastruktura nabídnutá sestavením PDE nabízí jako součást procesu kroky pro načítání zdrojového kódu pro sestavení z úložiště. K dispozici jsou dvě možnosti: Nechat sestavení PDE načíst zdroj automaticky, nebo načíst zdrojový kód ručně.
Automatické načítání zdrojového kódu z CVS
Pro daný identifikátor funkce, která potřebuje být sestavena, je infrastruktura schopná načíst z CVS všechny zahrnuté funkce a moduly plug-in.
Aby bylo jasné, odkud co získat, používá PDE mapovací soubory. Mapovací soubor je soubor vlastností Java, který mapuje identifikátory funkcí a modulů plug-in na umístění a značku v úložišti. Formát položky mapovacího souboru pro načítání z CVS je:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Kde telementType je jeden z bundle, feature,
plug-in nebo fragment.
Pokud není cesta specifikována, bude název prvku použit jako modul CVS, například:
plugin@org.foo.bar=CVS,v20060501,:pserver:anonymous@cvs.example.org:/cvsroot/foo
načte modul plug-in org.foo.bar označený značkou v20060501 z cvs.eclipse.org/cvsroot/foo/org.foo.bar
Nastavování načítání zdroje CVS
Pro nastavení načítání vašeho zdroje z CVS udělejte následující:
- Ujistěte se, že máte cvs.exe ve vaší systémové cestě pro vyhledávání.
(Stáhnout CVS odsud).
- V adresáři sestavení vytvořte složku nazvanou maps.
- Ve složce maps vytvořte soubor s příponou .map.
- Do tohoto mapovacího souboru napište všechny prvky, které mají být načteny z úložiště.
- Ve složce konfigurace upravte soubor build.properties a řádek skipFetch=true označte jako komentář. Když je tato vlastnost nastavena, sestavení PDE vynechá celou fázi načtení. Pokud si přejete, aby byla značka uvedená v mapovacím souboru ignorována, nastavte vlastnost fetchTag na konkrétní hodnotu. To je užitečné při provádění sestavení každou noc z hlavičky (HEAD) místo sestavení ze značených verzí.
Získání mapovacích souborů z CVS
Mapovací soubory jsou obvykle uloženy v úložišti. Sestavení PDE nabízí výchozí
infrastrukturu pro jejich získání z úložiště CVS.
Pro povolení této funkce změňte následující vlastnosti v souboru build.properties ve vašem adresáři konfigurace:
- skipMaps: Označte vlastnost jako komentář. Když je tato vlastnost nastavena, sestavení PDE mapovací soubory nenačte.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. Úložiště CVS, ze kterého se mají získat mapovací soubory.
- mapsRoot =
/path/to/maps. Cesta v úložišti CVS k adresáři, který obsahuje mapovací soubory.
- mapsCheckoutTag =
HEAD. Značka CVS použitá ke kontrole mapovacích souborů.
Při sestavování dochází k načtení mapovacích souborů z CVS během fáze předsestavení. Při sestavování budou během fáze načítání vytvořeny a spuštěny skripty, které zajistí načtení všech funkcí a modulů plug-in zahrnutých v právě sestavované funkci.
Automatické načítání z jiných úložišť
Sestavení PDE nabízí bod rozšíření, do kterého mohou být zapojeny generátory skriptů pro různá úložiště. Pokud vaše instalace platformy Eclipse obsahuje balík, který poskytuje rozšíření generátoru skriptů pro jiný typ úložiště, můžete toto úložiště použít tím, že ho uvedete v položkách vašeho mapovacího souboru:
<elementType>@<elementID> = <REPOSITORY>, <TAG>, [...]
Formát mapovací položky po značce závisí na příponě.
Pokud načítáte mapovací soubory automaticky z úložiště, budete muset zkopírovat soubor customTarget.xml z adresáře org.eclipse.pde.build/templates/headless-build do vašeho adresáře konfigurace. Cílový soubor getMapFiles se používá k načtení mapovacích souborů a měl by být změněn tak, aby se načtení provedlo z vašeho úložiště.
Získání zdrojových kódů ručně
Můžete napsat vlastní cíle načítání, a tím načíst své moduly plug-in a funkce, které mohou být vyvolány z cílů preSetup nebo postSetup v souboru customTargets.xml.
Funkce a moduly plug-in by měly být načteny do
${buildDirectory}/features, respektive ${buildDirectory}/plugins.