PDE Build-integrasjon med p2

Denne siden beskriver en foreldet metode for integrering med p2. Siden "Bygge p2-datalagre og -produkter" beskriver de anbefalte metodene for bygging med p2. Egenskapene som er beskrevet nedenfor, fungerer ved hjelp av et lag for tilbakekompatibilitet og støtter ikke nye funksjoner som kan være tilføyd til p2-publisereren.

Se siden Generere p2-metadata i håndboken for plugin-utvikling hvis du vil vite mer om generering av p2-metadata. Generering av metadata i seg selv er ikke tilstrekkelig til å opprette et p2-aktivert produkt. Hvis du vil gjøre det må du utføre en faktisk p2-installering fra de genererte metadataene. Se p2 director-dokumentasjonen hvis du vil vite mer om hvordan du utfører denne installeringen fra et headless-skript.

Det er mulig å generere p2-metadata med manuelle kall til p2-metadatageneratoren i en hvilken som helst av PDE/Builds tilpassede oppgaver (se Tilpasse et headless-bygg). PDE/Build tilbyr imidlertid ikke integrasjon med p2 via følgende egenskaper:

generate.p2.metadata
(FORELDET, bruk p2.gathering i stedet) Settes til sann ("true") for å slå på generering av p2-metadata. Ant-skriptene er basert på at denne egenskapen eksisterer, og ikke på verdien. Hvis du vil deaktivere metadatagenerering, må egenskapen fjernes og ikke bare settes til false ( "usann" ).
I byggeskriptene genereres kall til p2-mål når p2-bunten org.eclipse.equinox.p2.metadata.generator og dens avhengigheter er til stede i den Eclipse som utfører byggingen. Disse p2-målene er betinget av generate.p2.metadata-egenskapen.
p2.metadata.repo
p2.artifact.repo
Oppgi en file:-URI med plassering av p2-metadata og artefaktlagre for publisering. Det er vanlig, men ikke nødvendig, for artefaktlageret å bruke samme plassering som metadatalageret.
Eksempel:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
Valgfri. Oppgi navn for generatoren av p2-lagre.
Når du bruker et lager som allerede finnes, endres ikke eksisterende navn på lageret. Hvis det ikke oppgis, navngir p2 lagrene etter plassering.
p2.flavor
Definer flavor for p2-metadata. Når metadata genereres for Eclipse SDK, brukes en flavor kalt "tooling".
p2.publish.artifacts
Defineres til sann ("true") for publisering av JAR-filer til artefaktlager. Hvis den defineres til usann ("false"), genereres artefaktmetadata, men JAR-filene kopieres ikke til artefaktlageret. ADVARSEL: Når denne er definert til sann, må du passe på at p2.artifact.repo ikke er samme plassering som assemblerkatalogene som brukes av PDE/Build. Ellers kan du risikere at JAR-filene blir slettet.
p2.root.name
p2.root.version
Oppgi navn og versjon for rot-IU som skal inneholde alt som er bygd.
Hvis en .product-fil spesifiseres i bygget, blir disse egenskapene ignorert. Når en .product-fil er tilgjengelig, vil i stedet rotnavnet og versjonen være produkt-ID og versjon fra .product-filen. Du finner flere opplysninger nedenfor.

Generere metadata for produkter

Ved utføring av en bygging med en produktfil definert i build.properties-konfigurasjonsfilen på toppnivå (begge i bygg som bruker productBuild.xml og build.xml) vil PDE/Build automatisk generere metadata for produktet.

I tillegg til å opprette installerbare enheter (IUer) for alle funksjoner og bunter vil dette også opprette følgende installerbare enheter for produktet:

Med alle disse genererte installerbare enhetene er det mulig å bruke p2 til å installere hele produktet ut av datalageret.

Detaljer

PDE/Build kaller i grunnen opp oppgaven for å generere metadata fra p2 på visse punkter under byggingen. Det er sannsynlig at det under byggingen aldri forekommer ett enkelt tidspunkt da alle byggeartefakter finnes på disken på samme sted. Det vil derfor være nødvendig å kalle opp p2-metadatageneratoren på de endelige arkivene eller, som en optimalisering, kalle den opp flere ganger i løpet av byggingen.

Metadatagenerering vil skje gjennom hele assembler- og pakkefasene. Dette gjelder for både normale bygg og pakker-bygg. Dette kan illustreres for en produktbygging som brukes productBuild.xml, ved at følgende skript genereres (idet vi antar configs=win32,win32,x86 & linux,gtk,ppc):

Assemblerskript samler inn funksjoner og plugin-moduler som er bygd, sammen med tilknyttede rotfiler. Pakkeskript samler inn forhåndsbygde binærfunksjoner og plugin-moduler. Plattformspesifikke skript samler inn delene til disse bestemte konfigurasjonene og "all"-skriptene delegerer til hvert av de plattformspesifikke skriptene.

p2-genereringskall oppstår som følger:

  1. assemble win32.win32.x86: Genererte metadata for innsamlede funksjoner og plugin-moduler for Windows.
  2. assemble win32.win32.x86: Andre kall til genererte metadata for innsamlede rotfiler for Windows.
  3. assemble linux.gtk.ppc: Genererer metadata for innsamlede funksjoner og plugin-moduler for Linux.
  4. assemble linux.gtk.ppc: Andre kall til genererte metadata for innsamlede rotfiler for Linux.
  5. assemble all: Hvis ikke pakkeren kjøres: Genererer metadata for en rotinstallerbar enhet som inkluderer alt ovenfor.
  6. package win32.win32.x86: Genererer metadata for pakkede funksjoner og plugin-moduler for Windows.
  7. package win32.win32.x86: Andre kall til genererte metadata for rotfiler for pakking for Windows.
  8. package linux.gtk.ppc: Genererer metadata for pakkede funksjoner og plugin-moduler for Linux.
  9. package linux.gtk.ppc: Andre kall til genererte metadata for rotfiler for pakking for Linux.
  10. package all: Genererer metadata for en rotinstallerbar enhet som inkluderer alt ovenfor.

Oppgaven for p2-metadatageneratoren støtter trinnvis generering, idet hvert kall til de genererte p2-metadataene gjøres med mode=incremental, der det endelige kallet for å generere den rotinstallerbare enheten vil bli kjørt med mode="final"