Ez az oldal a p2-vel végzett integráció régi, elavult módját írja le. A p2-vel végzett összeépítés ajánlott módszereit a "P2 lerakatok és termékek összeépítése" oldal mutatja be. Az alább leírt tulajdonságok egy visszamenőleges kompatibilitási réteget használnak, és nem támogatják a p2 kiadóhoz időközben esetleg hozzáadott új szolgáltatásokat.
A p2 metaadatok előállításával kapcsolatban tekintse meg a Platform bedolgozó fejlesztői kézikönyv P2 metaadatok előállítása oldalát. A metaadatok előállítása önmagában nem elegendő egy p2-képes termék létrehozásához. Ehhez végre kell hajtani egy tényleges p2 telepítést az előállított metaadatokból. A p2 irányító dokumentáció részletes információkat tartalmaz ez ilyen telepítések végrehajtásának módjáról egy megjelenítés nélküli parancsfájlból.
A p2 metaadatokat a PDE összeépítési bedolgozó egyéni feladataiban található p2 metaadat előállító kézi meghívásaival is elő lehet állítani (lásd: Megjelenítés nélküli összeépítés személyre szabása). A PDE összeépítés bedolgozó azonban biztosítja a p2 integrációját a következő tulajdonságokon keresztül:
generate.p2.metadata |
(ELAVULT, használja helyette a
p2.gathering tulajdonságot) Állítsa be
true értékre a p2 metaadatok előállításának bekapcsolásához. Az ant
parancsfájlok ennek a tulajdonságnak a létezésén alapulnak, nem pedig az
értéken. A metaadatok előállításának kikapcsolásához a tulajdonságot el
kell távolítani, nem elég false értékre beállítani. Az összeépítési parancsfájlokban a p2 célokra irányuló hívások akkor lesznek előállítva, ha az org.eclipse.equinox.p2.metadata.generator p2 köteg és a függőségei szerepelnek az összeépítést futtató Eclipse telepítésben. Ezek a p2 célok a generate.p2.metadata tulajdonság feltételei. |
p2.metadata.repo |
Adjon meg egy file: előtagot egy URI értékkel, amely a
közzétételhez használni kívánt p2 metaadat és műtermék lerakatoknak a
helyét határozza meg. Szokásos, de nem szükségszerű, hogy a műtermék
lerakat és a metaadat lerakat egyazon helyet használja. Példa:
p2.metadata.repo=file:${buildDirectory}/repository
p2.artifact.repo=file:${buildDirectory}/repository
|
p2.metadata.repo.name |
Elhagyható. Adja meg az előállító p2 lerakatok nevét. Már létező lerakat használatakor a lerakat meglévő neve nem lesz módosítva. Ha nincs megadva, akkor a p2 a hely neve alapján nevezi el a lerakatokat. |
p2.flavor |
Állítsa be a p2 metaadatok stílusát. Ha az Eclipse SDK-hoz állítja elő a metaadatokat, akkor a "tooling" (eszközkészlet) stílus kerül felhasználásra. |
p2.publish.artifacts |
Állítsa be true (igaz) értékre a jar archívumok közzétételéhez a műtermék lerakatban. Ha false (hamis) értékre állítja be, akkor a műtermékek metaadatai elő lesznek állítva, de a jar fájlok nem lesznek átmásolva a műtermék lerakatba. Figyelmeztetés: Ha true értékre állítja be, akkor győződjön meg róla, hogy a p2.artifact.repo nem a PDE összeépítés bedolgozó által használt összeállítási könyvtárakkal megegyező helyen van, máskülönben a Jar fájlok végül törölve lehetnek. |
p2.root.name |
Adja meg a gyökér felhasználói felület nevét és verziószámát, amely
az összes összeépített elemet tartalmazni fogja. Ha az összeépítésben meg van adva egy .product fájl, akkor ezek a tulajdonságok figyelmen kívül maradnak. Ha elérhető egy .product fájl, akkor ehelyett .product fájlból származó gyökérnév és verziószám lesz a termék azonosítója és verziószáma. További információkat alább találhat. |
Amikor egy build.properties felső szintű összeépítési konfigurációs fájlban található termékfájlkészlettel rendelkező összeépítést futtat (a productBuild.xml és a normál build.xml fájlokat használó összeépítésekben egyaránt), akkor a PDE összeépítés bedolgozó automatikusan elő fogja állítani az adott termék metaadatait.
Az összes szolgáltatás és köteg telepíthető egységeinek létrehozásán túl ez a termékhez tartozó következő telepíthető egységeket is létre fogja hozni:
Az összes ilyen előállított telepíthető egységgel már lehetséges a p2 használata a teljes termék lerakaton kívüli telepítéséhez.
A PDE összeépítés bedolgozó lényegében a p2 által biztosított metaadatokat előállító feladatot hívja meg az összeépítés bizonyos pontjain. Egy összeépítés során valószínűleg nincs olyan időpillanat, amikor az összes összeépítési műtermék egyazon helyen létezne a lemezen. Ezért a p2 metaadat előállító feladatot vagy a végső archívumokhoz kell meghívni, vagy pedig - optimalizálásként - több alkalommal kell meghívni az összeépítés során.
A metaadatok előállítása az összeállítási és csomagolási fázisok alatt zajlik. Ez a normál és csomagoló összeépítések esetén egyaránt igaz. Egy productBuild.xml fájlt használó termék összeépítés esetén például a következő parancsfájlok lesznek előállítva (a configs=win32,win32,x86 & linux,gtk,ppc konfigurációkat feltételezve):
Az összeállító parancsfájlok összegyűjtik a társított gyökérfájlokkal együtt összeépített szolgáltatásokat és bedolgozókat. A csomagoló parancsfájlok összegyűjtik az előre összeépített bináris szolgáltatásokat és bedolgozókat. A platform specifikus parancsfájlok összegyűjtik az adott konfigurációk részleteit, és az "all" parancsfájlok delegálják az egyes platform specifikus parancsfájloknak.
A p2 előállítási hívások az alábbiak szerint történnek:
A p2 metaadat előállító feladat támogatja a növekményes előállítást, az előállított p2 metaadatok minden hívása a mode=incremental beállítással történi, a végső hívás a gyökér telepíthető egység előállításához a mode="final" beállítással fog futni.