Beolvasás lerakatokból

A PDE összeépítés által nyújtott infrastruktúra lehetőséget biztosít arra, hogy a forráskódot és az előregyártott bedolgozókat lerakatból hívja le, az összeépítési folyamat részeként (lásd: eclipse.fetch feladat és lehívást vezérlő tulajdonságok). Két lehetőség van: hagyja, hogy a PDE összeépítés automatikusan lehívja a forrást, vagy manuálisan hívja le a forráskódot.

Az automatizálás első lépése a leképezésfájl

Az összeépíteni kívánt szolgáltatás vagy bedolgozó azonosítója alapján az összeépítési infrastruktúra le tudja hívni a lerakatból az összes tartalmazott szolgáltatást és bedolgozót.

A PDE leképezési fájlokat használ annak meghatározásához, hogy mit hol talál. A leképezési fájl egy Java tulajdonságfájl, ami a szolgáltatások és bedolgozók azonosítóját egy helyre és egy címkére képezi le a lerakatban. A leképezésfájlok formátuma nyitott, de a kulcs részt a PDE összeépítés rögzíti:

<elemTípus>@<elemAzonosító>[,<elemVerzió>] = <lerakat-specifikus tartalom>

ahol az elemTípus köteg, szolgáltatás, bedolgozó vagy töredék lehet, az elemAzonosító és az elemVerzió pedig az elem jellemzőit adják meg.

CVS leképezésfájl bejegyzés

A leképezésfájl bejegyzés formátuma, amellyel CVS lerakatból tartalom hívható le, a következő:
<key> = CVS, [,args]
ahol az args kulcs/érték párok vesszővel elválasztott felsorolása, az alább leírtak szerint: Példa:
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

Régi stílusú leképezés bejegyzések
Az Eclipse 3.2 és korábbi változataiban a CVS leképezési fájlok formátuma a következő volt:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Ha az elhagyható argumentumok bármelyike nincs megadva, a vesszőket továbbra is ki kell tenni a következő argumentumok elválasztásához. Ez a formátum elavultnak tekintendő, és helyette a kulcs/érték formátumot kell használni.

Ant GET leképezésfájl bejegyzése

A leképezésfájl bejegyzés formátuma, amellyel az Ant GET metódust támogató tetszőleges URL címről tartalom kérhető le, a következő:

<key> = GET, <url> [,args]
ahol az url az az URL cím, ahonnan az adatokat le kell kérni, az args pedig kulcs/érték párok veszővel elválasztott elhagyható felsorolása, az alább leírtak szerint: Példa:
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

Leképezési fájl bejegyzés p2 lehíváshoz

A PDE összeépítéshez hozzá lett adva egy új kiterjesztés, amely lehetővé teszi a felhasználók számára résztermékek lehívását p2 lerakatból. Hozzáadhat egy bejegyzést az összeépítés bemenetének leképezési fájljához, és a PDE összeépítés lekéri a részterméket és belefoglalja az összeépítésbe. A leképezési fájlnak tartalmaznia kell a telepíthető egység (IU) azonosítóját és verziószámát, valamint a telepíthető egységet tároló lerakta URI azonosítóját. A program feltételezi, hogy a metaadat és termék lerakatok egy helyen vannak.

A leképezésfájl bejegyzés formátuma, amellyel p2 lerakatból tartalom hívható le, a következő:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Szolgáltatások lehívása p2-vel

A Helios kiadásban a szolgáltatások lehívhatók a p2-vel is, ha megadja a szolgáltatás jar fájlját képviselő telepíthető egységet. A p2 szolgáltatások metaadatainak szerkezetével kapcsolatos részleteket a szolgáltatás metaadatai oldalon találhatja.

Példák:
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

Egyéb lerakatokra vonatkozó leképezésfájl bejegyzések

A PDE összeépítés biztosít egy kiterjesztési pontot, ahová különböző lerakatokhoz tartozó lehívási parancsfájl előállítók csatlakoztathatók. Ha az Eclipse telepítés olyan köteget tartalmaz, amely parancsfájl előállító kiterjesztést biztosít egy másik típusú lerakathoz, akkor használhatja azt a lerakatot, ha megadja a leképezési fájl bejegyzésekben és ragaszkodik a kiterjesztésszolgáltató által megadott formátumhoz.

Beállítás CVS forráslehíváshoz

Ha a forrás CVS lerakatból szeretné lehívni, akkor a következőket kell tennie:

Leképezési fájlok megszerzése a CVS lerakatból

A leképezési fájlok általában egy lerakatban vannak tárolva. A PDE összeépítés alapértelmezett infrastruktúrát biztosít a leképezési fájlok megszerzéséhez a CVS lerakatokból. A funkció engedélyezéséhez módosítsa a következő tulajdonságokat a konfigurációs könyvtárban található build.properties fájlban: A leképezési fájlok lehívása a CVS lerakatból az összeépítés előkészületi fázisában történik.  Az összeépíteni kívánt szolgáltatásban tartalmazott összes szolgáltatás és bedolgozó lehívására használt parancsfájlok az összeépítés lehívási szakaszában jönnek létre és futnak le. 

Automatikus lehívás más lerakatokból

 Ha automatikusan hívja le a leképezési fájlokat a lerakatból, akkor át kell másolnia a customTarget.xml fájlt az org.eclipse.pde.build/templates/headless-build könyvtárból a konfigurációs könyvtárba.  A  cél getMapFiles hívja le a leképezési fájlokat, ezt kell módosítani a lerakatból történő lehíváshoz.

Forráskód manuális megszerzése

A bedolgozók és szolgáltatások lekéréséhez készíthet egyéni lehívási célokat, amiket a meghívhat a preSetup vagy postSetup célból hívhat meg a customTargets.xml fájlban.  A szolgáltatásokat és a bedolgozókat az ${összeépítési_könyvtár}/features és ${összeépítési_könyvtár}/plugins könyvtárakba kell lehívni.