Integrace sestavení PDE s p2

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
p2.artifact.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
p2.artifact.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
p2.root.version
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.

Generování metadat pro produkty

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ě.

Podrobnosti

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:

  1. assemble win32.win32.x86 : Generování metadat pro shromážděné funkce a moduly plug-in pro windows.
  2. assemble win32.win32.x86 : Druhé volání generovaných metadat pro shromážděné kořenové soubory pro windows.
  3. assemble linux.gtk.ppc : Generování metadat pro shromážděné funkce a moduly plug-in pro linux.
  4. assemble linux.gtk.ppc : Druhé volání generovaných metadat pro shromážděné kořenové soubory pro linux.
  5. assemble all : Pokud není spuštěn balicí program: Generování metadat pro kořen nainstalované jednotky, který obsahuje všechno.
  6. package win32.win32.x86 : Generování metadat pro zabalenou funkci a moduly plug-in pro windows.
  7. package win32.win32.x86 : Druhé volání pro generovaná metadata z oken balení.
  8. package linux.gtk.ppc : Generování metadat pro zabalené funkce a moduly plug-in pro linunx.
  9. package linux.gtk.ppc : Druhé volání pro generování metadat v kořenových souborech z balení pro Linux.
  10. package all : Generování metadat pro kořen nainstalované jednotky, který obsahuje všechno výše uvedené .

Ú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"