Eclipse összetevők csomagolása

Az Eclipse összetevők terjesztése archív fájlokban történik. Mindegyik archívum szolgáltatások és bedolgozók gyűjteményét tartalmazza. Az archívum jellemzően tartalmazza az összes funkciót, ami az adott összetevő kínál. A felhasználóknak általában több összetevőre van szükségük, és/vagy néhány összetevőnek csak egyes részeire van szükségük. Segítség nélkül a felhasználóknak manuálisan kellene lehívniuk a szükséges funkciókat is tartalmazó archívumokat, majd kézzel kellene kibontaniuk a szükséges szolgáltatásokat és bedolgozókat. Ez nagyon munkaigényes folyamat, és nagy a hibalehetőség is.

Szerencsére a PDE tartalmaz egy kötegorientált mechanizmust - a csomagolót -, ami segítséget nyújt ebben. Röviden, a csomagoló bemenetként átveszi a szolgáltatásokat tartalmazó archívumok listáját és az érdekes szolgáltatások listáját. Azután lehívja a zip fájlokat, kibontja a szolgáltatásokat (és a hozzájuk tartozó bedolgozókat), majd újracsomagolja őket egy kimeneti zip fájlba.

Gyors kezdés

A következőkben a csomagoló használatának megkezdéséhez szükséges alapvető lépésekről olvashat.   Javasoljuk, hogy *nix csomagokat építsen összes egy *nix gépen, hogy a fájlengedélyek megmaradjanak.

  1. Hozzon létre egy csomagolási konfigurációs könyvtárat, és másolja át ide a sablonfájlokat (packager.properties, packaging.properties és customTargets.xml) az org.eclipse.pde.build/templates/packager könyvtárból.
  2. Szerkessze az átmásolt packager.properties fájlt és állítsa be a következő tulajdonságokat:
  3. Szerezze meg a csomagoló leképezési fájljait.  A következő tulajdonságok vezérlik a leképezési fájlok letöltését:
    A csomagoló parancsfájl összefűzi a ${letöltési_könyvtár} könyvtárban található összes *.map fájlt. Ha több leképezési fájlt szeretne letölteni, vagy CVS lerakatból akarja letölteni őket, akkor módosítsa a customTargets.xml fájlban a getMapFiles célt.
  4. Futtassa a csomagolót a következő paranccsal:
  5. java -jar <eclipse install>/startup.jar -application org.eclipse.ant.core.antRunner 
    -buildfile <<eclipse install>/plugins/org.eclipse.pde.build_<version>/scripts/package.xml>
    -DpackagingInfo=<a csomagolási konfigurációs könyvtár elérési útja>

Csomagoló leképezési fájl formátuma

A csomagoló leképezési fájlok leírják a különféle archívumokat, azok tartalmát és hogy honnan tölthetők le.   Hasonlítanak azokhoz a leképezési fájlokhoz, amiket az összeépítési folyamat során a kötegek lerakatból történő lehívásához használnak.   A csomagoló leképezési fájl bejegyzéseinek formátuma:
archiveName = url | [configList] | [directory] | contentDescription | componentName

Ne feledje, hogy a configList és a directory megadása nem kötelező, de mindig a megfelelő számú "|" elválasztót kell használni.
Példák:
eclipse-SDK-3.1-win32.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | win32,win32,x86 | | sdk | eclipse
eclipse-PDE-3.1.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | | | runtime | pde

Csomagoló konfigurációs tulajdonságai

A következő tulajdonságokat lehet beállítani a csomagoló konfiguráció packager.properties fájljában:
baseDirectory
A könyvtár, amelyben a csomagolás meg fog történni.
workingDirectory
Az a könyvtár, amelyben a parancsfájlok létre lesznek hozva.   Az értéke a sablonban: ${baseDirectory}/workingPlace
downloadDirectory
A mappa, amelyikbe az archívumok le lesznek töltve.   Az értéke a sablonban: ${baseDirectory}/toPackage
tempDirectory
A mappa, amelyikbe az archívumok ki lesznek bontva.   Az értéke a sablonban: ${baseDirectory}/temp
featurePaths
A letöltött archívumok gyökerének a neve.   Az értéke a sablonban: eclipse.
featureList
Az újracsomagolni kívánt szolgáltatás azonosítók vesszővel elválasztott listája.
componentFilter
Azon összetevők vesszővel elválasztott listája, amelyekből a featureList tulajdonságban megadott szolgáltatások megtalálhatók.   Ez szűri az elérhető archívumokat, és lehetővé teszi, hogy a csomagoló optimalizálja a letöltött fájlok halmazát.
contentFilter
A lehívandó tartalomtípusok vesszővel elválasztott listája.   Ez szűri az elérhető archívumokat, és lehetővé teszi, hogy a csomagoló optimalizálja a letöltött fájlok halmazát.
config
Az újracsomagolni kívánt konfigurációk (vesszővel elválasztott, operációs rendszert, ablakkezelő rendszert és architektúrát tartalmazó hármasok) "&" jellel elválasztott listája.   (például: win32, win32, x86 & linux, gtk, x86)
archivesFormat
Az archívumok formátuma.   Konfiguráció - formátum "&" jellel elválasztott listája.   (például: win32, win32, x86 - antZip & linux, gtk, ppc - tar).  Ha egy adott konfigurációhoz nincs megadva az archívum formátuma, akkor az alapértelmezett formátum az antZip.
zipargs
A zip programnak átadni kívánt további paraméterek.
unzipargs
Az unzip programnak átadni kívánt további paraméterek.
archivePrefix
A keletkező archívum(ok) előtagja.
collectingFolder
A keletkező archívum gyökérmappájának a neve.
buildId
Az összeépítés azonosítóját vezérli az archívum alapértelmezett nevében.
buildType
Az összeépítés típusa, ami az összeépítés kimenetének elnevezésekor kerül felhasználásra.   Értéke általában: I, N, M, S, ...
buildLabel
Az összeépítés címkéje.   A sablon értéke: ${buildType}.${buildId}
archiveNamePrefix
A keletkező archívum nevét vezérli.   Alapértelmezett értéke: ${buildId}
packagingProperties
A fájl relatív elérési útja, amelyik a csomagolási tulajdonságokat tartalmazza.   Alapértelmezésben a packaging.properties fájlra mutat.
deltaPack
Megadja, hogy különbségcsomagot kell-e előállítani.   Ez ki fogja hagyni a platformfüggetlen részeket, és az összes konfigurációt egyetlen archívumba csoportosítja.

Csomagolási gyökérfájlok

A csomagoló konfiguráció packager.properties fájljában a packagingProperties tulajdonság egy tulajdonságfájlra mutat, amely megadja a csomagolandó gyökérfájlokat.   Ez alapértelmezésben a packaging.properties fájl.

A tulajdonságfájlnak tartalmaznia kell a szükséges gyökérfájlokat megadó tulajdonságokat.   A gyökértulajdonságokról a Szolgáltatás specifikus tulajdonságok oldalon talál további részleteket.