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ő:
ahol az args kulcs/érték párok vesszővel elválasztott
felsorolása, az alább leírtak szerint:
- tag, a kiiktatni kívánt CVS címke;
- cvsRoot, CVS csatlakozási karaktersorozat;
- path, választható CVS modul és útvonal, ahol az elemet
tartalmazó mappa található; Alapértelmezésben modulnévként az elemnév kerül felhasználásra;
- prebuilt, elhagyható logikai érték, ami azt
jelzi, hogy a letöltött elem előregyártott-e. Alapértelmezésben ez hamis;
- cvsPassFile, cvs átadó fájl útvonala (választható);
- jelszó, a CVS lerakathoz csatlakozás jelszava (választható);
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:
- unpack, igazra állítva jelzi, hogy a letöltött elemet
unzip segítségével ki kell csomagolni;
- verbose, igazra állítva a letöltéskor részletes
folyamatinformációk jeleníthetők meg. Az alapértelmezett érték a false (hamis);
- ignoreerrors, igazra állítva a szállítás során a hibák
naplózásra kerülnek. Az alapértelmezett érték a false (hamis);
- usetimestamp, fájl feltételes letöltése a helyi
példány időpecsétje alapján (csak http URL címek esetén), ha az értéke
igaz. Az alapértelmezett érték a false (hamis);
- username, az "ALAPVETŐ" http hitelesítés felhasználói neve;
- password, a letöltéshez használt jelszó.
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
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>
- id, a telepíthető egység azonosítója;
- version, a telepíthető egység verziószáma (nem kötelező). Ha
nincs megadva, akkor az elérhető legmagasabb verziószám lesz lehívva.
- repository, a lerakat helye (URI), ahol a telepíthető egység
megtalálható.
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:
- Győződjön meg róla, hogy van egy cvs.exe fájl a rendszer keresési
útvonalán.
(A CVS innen tölthető le).
- Hozzon létre egy maps nevű mappát az összeépítési könyvtárban.
- Hozzon létre egy .map kiterjesztésű fájlt a maps mappában.
- Töltse fel a leképezési fájlt az összes elemmel, amit le
szeretne hívni a lerakatból.
- Módosítsa a konfigurációs mappában lévő build.properties fájlt, és
alakítsa megjegyzéssé a skipFetch=true sort. Ha ez a
tulajdonság be van állítva, akkor a PDE összeépítés kihagyja a teljes
lehívási fázist. Ha figyelmen kívül akarja hagyni a leképezési
fájlokban megadott címkét, akkor beállíthatja a fetchTag
tulajdonságot egy adott értékre. Ez akkor hasznos, ha éjszakai
összeépítést végez a HEAD rendszerből a címkézett verziók helyett.
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:
- skipMaps: Alakítsa
megjegyzéssé ezt a tulajdonságot. Ha ez a tulajdonság be van
állítva, akkor a PDE összeépítés nem fogja lehívni a leképezési fájlokat.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. A CVS lerakat,
amelyről meg akarja szerezni a leképezési fájlokat.
- mapsRoot =
/path/to/maps. Az útvonal a CVS lerakatban a leképezési
fájlokat tartalmazó könyvtárhoz.
- mapsCheckoutTag =
HEAD. A leképezési fájlok kiiktatásához használt CVS címke.
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.