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í:
<key> = CVS, [,args]
Kde args je seznam níže popsaných dvojic klíč/hodnota, oddělený čárkou: 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: 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

Položka mapovacího souboru pro načtení p2

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ě>
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í:

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