Načítání z úložišť
Infrastruktura nabízená sestavením PDE poskytuje jako součást procesu kroky pro načítání zdrojového kódu a předem připravených modulů plug-in z úložiště (viz úloha eclipse.fetch a
vlastnosti pro řízení načítání).
K dispozici jsou dvě možnosti: Nechat sestavení PDE načíst zdroj automaticky, nebo načíst zdrojový kód ručně.
První krok automatizace, mapovací soubor
Pro daný identifikátor funkce nebo modul plug-in, které je třeba sestavit, je infrastruktura schopná načíst z úložiště 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 mapovacích souborů je otevřený a až na část
klíče je pevně dán sestavením PDE:
<elementType>@<elementID>[,<elementVersion>] = <repo specifický obsah>
kde elementType je balík, funkce,
modul plug-in nebo fragment a elementId a elementVersion udávají specifické charakteristiky prvku.
Položka mapovacího souboru pro CVS
Formát položky mapovacího souboru pro načítání obsahu z CVS je následující:
Kde args je seznam níže popsaných dvojic klíč/hodnota, oddělený čárkou:
- tag, značka CVS k zapůjčení.
- cvsRoot, řetězec pro připojení CVS.
- path, nepovinný modul CVS a cesta, kde lze najít složku obsahující prvek. Jako název modulu se při výchozím nastavení používá název prvku.
- prebuilt, nepovinná logická hodnota označující, zda je načítaný prvek předem připraven. Ve výchozím nastavení má hodnotu false.
- cvsPassFile, volitelná cesta k souboru cvs pass.
- password, nepovinné heslo použité pro připojení k CVS.
Příklad:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true
| Položky mapy starého stylu |
V platformě Eclipse verze 3.2 a starších byl formát mapovacího souboru pro CVS:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
I pokud není jakýkoli z nepovinných argumentů zadán, čárky oddělují jakékoli následné argumenty jsou stále povinné. Tento formát je považován za zamítnutý a nyní je upřednostňován formát klíč/hodnota.
|
Položka mapovacího souboru pro Ant GET
Formát položky mapovacího souboru pro načítání obsahu z libovolné adresy URL, kterou podporuje Ant GET, je následující:
<key> = GET, <url> [,argumenty]
kde url je adresa url, z níž se načtou data, a argumenty je nepovinný seznam níže popsaných dvojic klíč/hodnota, oddělený čárkou:
- unpack, při nastavení na hodnotu true označuje, že se má stažený prvek rozbalit.
- verbose, při nastavení na hodnotu true se zobrazují podrobné informace o postupu stahování. Výchozí hodnota je false.
- ignoreerrors, při nastavení na hodnotu true se protokolují chyby při přenosu. Výchozí hodnota je false.
- usetimestamp, při nastavení na hodnotu true bude soubor podmínečně stažen na základě hodnoty časového razítka lokální kopie (pouze pro adresy http URL). Výchozí hodnota je false.
- username, uživatelské jméno pro ověřování "BASIC" http.
- password, heslo pro stažení.
Příklad:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true
Do Sestavení PDE bylo přidáno nové rozšíření, pomocí kterého mohou uživatelé
načítat artefakty z úložišť p2. Nyní můžete přidat do vašeho mapovacího souboru
položku pro vstup sestavení a Sestavení PDE načte artefakt a zahrne jej do sestavení. Položka mapového souboru potřebuje zahrnout id a verzi instalovatelné jednotky (IU)
a identifikátor URI úložiště, ve kterém se instalovatelná jednotka nachází. Úložiště
metadat a artefaktů jsou pokládána za spoluumístěná.
Formát položky mapovacího souboru pro načtení obsahu prostřednictvím p2:
<typ_prvku>@<ID_prvku> = p2IU,
id=<ID>,
version=<verze>, repository=<úložiště>
- ID je identifikátor instalovatelné jednotky.
- Verze je verze instalovatelné jednotky
(volitelná). Není-li zadána, načte se nejvyšší dostupná
verze.
- Úložiště je umístění (URI) úložiště, v němž se nalézá IU.
Načítání funkcí pomocí p2
Ve verzi produktu Helios mohou být funkce načítány pomocí p2 určením instalovatelné
jednotky reprezentující soubor JAR funkce. Podrobné informace o struktuře metadat p2
pro funkce naleznete na stránce metadata funkce.
Příklady:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo
Položka mapovacího souboru pro další úložiště
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 a dodržíte formát specifikovaný poskytovatelem rozšíření.
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 specifickou 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á k zapůjčení mapovacích souborů.
Při sestavování dochází k načtení mapovacích souborů z CVS během fáze před sestavením. 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šť
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.