Tato stránka popisuje zamítnutý starý způsob integrace s p2. Doporučené metody sestavení s p2 viz stránka "Sestavení úložišť p2 a produktů". Níže popsané vlastnosti pracují pomocí vrstvy zpětné kompatibility a nepodporují nové funkce, které mohou být do vydavatele p2 přidány.
Podrobnosti o generování metadat p2 najdete na stránce Generování metadat p2 v Příručce vývojáře modulů plug-in platformy. Samotné vygenerování metadat není dostatečné k vygenerování produktu p2. Abyste tak učinili, musíte provést skutečnou instalaci p2 z vygenerovaných metadat. Podrobnosti o tom, jak tuto instalaci provést ze sestavení bez hlavičky, viz dokumentace p2 director.
Je možné vygenerovat metadata p2 ručním voláním generátoru metadat p2 v libovolném vlastním volání Sestavení PDE (viz Přizpůsobení sestavení bez hlavičky). Sestavení PDE ovšem poskytuje integraci s p2 pomocí následujících vlastností:
generate.p2.metadata |
(ZAMÍTNUTO, místo toho použijte p2.gathering) Nastavte na hodnotu true, abyste povolili generování metadat p2. Skripty Ant spočívají na existenci této vlastnosti, nikoli na její hodnotě. Chcete-li generování metadat vypnout, musíte vlastnost odebrat. Nepostačí nastavení hodnoty false. Ve skriptech sestavení se volání do cílů p2 generují, když jsou balík p2 org.eclipse.equinox.p2.metadata.generator a jeho závislosti přítomny v platformě Eclipse, v níž je sestavení spuštěno. Tyto cíle p2 jsou podmíněny vlastností generate.p2.metadata. |
p2.metadata.repo |
Zadejte soubor: URI poskytující umístění metadat p2 a úložišť artefaktů pro publikování. Běžné, ale nikoli nezbytné je použít pro úložiště artefaktů stejné umístění jako pro úložiště metadat. Příklad:
p2.metadata.repo=file:${buildDirectory}/repository
p2.artifact.repo=file:${buildDirectory}/repository
|
p2.metadata.repo.name |
Volitelné. Určuje názvy pro úložiště generátoru p2. Při použití úložiště, které již existuje, nebude stávající název úložiště změněn. Není-li zadáno, p2 nazve úložiště podle jejich umístění. |
p2.flavor |
Nastavuje provedení pro metadata p2. Jsou-li metadata generována pro Eclipse SDK, použije se provedení "nástroje". |
p2.publish.artifacts |
Nastavuje se na hodnotu true pro publikování souborů jar do úložiště artefaktů. Je-li nastaveno na hodnotu false, pak jsou metadata artefaktu vygenerována, ale soubory jar nejsou zkopírovány do úložiště artefaktů. VAROVÁNÍ: Je-li nastaveno na hodnotu true, ujistěte se, že p2.artifact.repo není stejné umístění jako adresáře sestavení, které používá Sestavení PDE, jinak mohou být soubory jar smazány! |
p2.root.name |
Určuje název a verzi pro kořenovou instalovatelnou jednotku, která bude obsahovat všechno, co bylo sestaveno. Je-li v sestavení zadán soubor .product, pak budou tyto vlastnosti ignorovány. Když je soubor .product dostupný, názvem a verzí kořene bude ID a verze produktu ze souboru .product. Další informace viz níže. |
Při spuštění sestavení se souborem produktu nastaveným v souboru konfigurace sestavení nejvyšší úrovně build.properties (jak v sestaveních používajících productBuild.xml, tak i běžný build.xml), potom Sestavení PDE automaticky vygeneruje metadata pro tento produkt.
Kromě vytvoření instalovatelných jednotek pro všechny funkce, a balíky se tím také vytvoří následující instalovatelné jednotky produktu:
Se všemi těmito instalovatelnými jednotkami je možné použít p2 k instalaci celého produktu z úložiště.
Sestavení PDE v podstatě volá úlohu generování metadat, kterou poskytuje p2, v určitých bodech během sestavení. Je pravděpodobné, že během sestavení nikdy neexistuje jediný okamžik, kdy všechny sestavené artefakty existují na stejném místě na disku. Proto bude nutné buďto zavolat generátor metadat p2 u finálních archivů, nebo jako optimalizaci jej volat během celého sestavení vícekrát.
Generování metadat se uskuteční během fází sestavování a zabalení. To je pravda pro běžná sestavení a také pro zabalená sestavení. Pro ilustraci bude pro sestavení produktu pomocí productBuild.xml vygenerovány následujíc skripty (za předpokladu configs=win32,win32,x86 & linux,gtk,ppc):
Skripty sestavování shromažďují funkce a moduly plug-in, které byly sestaveny spolu s přidruženými kořenovými soubory. Skripty balíků shromažďují předem sestavené binární funkce a moduly plug-in. Platforma specifikuje skripty, které shromáždí části těchto konkrétních konfigurací a skripty "všichni" delegují na každý ze skriptů specifických pro platformu.
Volání generování p2 se uskuteční takto:
Úloha generátoru metadat p2 podporuje přírůstkové generování, každé volání do vygenerovaných metadat p2 se provede pomocí mode=incremental, konečné volání pro generování kořene, který bude nainstalovatelná jednotka spouštět, pomocí mode="final"