PDE-byggintegrering med p2

På sidan beskrivs ett avvecklat sätt att intgrera med p2. På sidan "Bygga p2-lager och -produkter" finns rekommendationer om metoder för att bygga med p2. De egenskaper som beskrivs nedan fungerar genom att använda ett bakåtkompatibelt lager och hanterar inte nya funktioner som kan läggas till p2-publiceringen.

Information om generering av p2-metadata finns på sidan Generera p2-metadata i guiden för utveckling av plattformsinsticksprogram. Att generera metadata för sig själv räcker inte för att skapa en p2-aktiverad produkt. Om du ska göra det måste du utföra en verklig p2-installation från de genererade metadata. Information om hur installationen utförs från ett konsollöst skript finns i dokumentationen för p2-styrning.

Det går att generera p2-metadata med manuella anrop till p2-metadatagenereringsfunktionen i någon av PDE/Builds anpassade uppgifter (se Anpassa ett konsollöst bygge). Men PDE/Build tillhandahåller inte integrering med p2 via följande egenskaper:

generate.p2.metadata
(AVVECKLAD. Använd i stället p2.gathering) Ange värdet true för att aktivera p2-metadatagenereringen. Ant-skripten baseras på att egenskapen finns, inte dess värde. Om du vill avaktivera metadatagenerering måste egenskapen tas bort - det räcker inte med att ange värdet till false.
I byggskripten genereras anropen till p2-mål när p2-paketet org.eclipse.equinox.p2.metadata.generator och dess beroenden presenteras i den Eclipse-tillämpning som kör bygget. Dessa p2-mål är villkorade på för egenskapen generate.p2.metadata.
p2.metadata.repo
p2.artifact.repo
Ange en fil: webbadressen som anger platsen där p2-metadata- och artefaktlager ska publiceras. Det är vanligt men inte nödvändigt att artefaktlagret använder samma plats som metadatalagret.
Exempel:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
Valfritt. Ange namn för genereringsfunktions p2-lager.
När ett lager som redan finns används, ändrads inte lagrets befintliga namn. Om inget namn är angivet, namnger p2 lagren i enlighet med deras plats.
p2.flavor
Ange smaken för p2-metadata. När metadata genereras för Eclipse SDK, används en smak av "verktyg".
p2.publish.artifacts
Ange värdet true för att publicera JAR-filer i artefaktlagret. Om värdet false anges, genereras metadata men JAR-filerna kopieras inte till artefaktlagret. VARNING! När värdet är true, måste du kontrollera att p2.artifact.repo inte är samma plats som de assembly-kataloger som används av PDE/Build. Annars raderas JAR-filerna!
p2.root.name
p2.root.version
Ange namnet och versionen för den rot-IU som kommer att innehålla allt som byggs.
Om en .product-fil specificeras i bygget, ignoreras dessa egenskaper. När en .product-fil är tillgänglig kommer rotnamnet och versionen i stället att vara .product-filens produkt-ID och version. Mer information nedan.

Generering av metadata för produkter

När ett bygge körs med en produktfil som angetts på översta nivån i byggkonfigurationens build.properties-fil (både i byggen som använder productBuild.xml och en vanliga build.xml) genererar PDE/Build automatiskt metadata för produkten.

Förutom att skapa installerbara enheter för alla funktioner och paket, skapas också följande produktinstallerbara enheter:

Med alla dessa genererade installerbara enheter går det att använda p2 för att installera den fullständiga produkten från lagret.

Detaljerna

PDE/Build anropar i huvudsak p2s uppgift för metadatagenerering vid vissa punkter under bygget. Under ett bygge finns det troligen aldrig i tid en enskild punkt där alla byggartefakter finns på disk på samma plats. Därför är det nödvändigt att antingen anropa p2-metadatagenereringsfunktionen för de slutliga arkiven, eller som optimering anropa den flera gånger under bygget.

Metadatagenerering sker under hela bygg- och paketeringsfaserna. Det gäller både vanliga byggen och paketerarbyggen. Följande skript genereras t.ex. för ett produktbygge som använder productBuild.xml (förutsatt configs=win32,win32,x86 & linux,gtk,ppc):

Byggskript samlar funktioner och insticksprogram som byggdes tillsammans med associerade rotfiler. Paketskript samlar in i förväg byggda binära funktioner och insticksprogram. De plattformsspecifika skripten samlar in delarna för dessa speciella konfigurationer och "alla" skripten delegerar till vart och ett av de plattformsspecifika skripten.

p2-genereringsanrop sker enligt följande:

  1. assemble win32.win32.x86 : Genererar metadata för insamlade funktioner och insticksprogram för Windows.
  2. assemble win32.win32.x86 : Ett andra anrop för att generera metadata för insamlade rotfiler för Windows.
  3. assemble linux.gtk.ppc : Genererar metadata för insamlade funktioner och insticksprogram för Linux.
  4. assemble linux.gtk.ppc : Ett andra anrop för att generera metadata för insamlade rotfiler för Linux.
  5. assemble all : Om paketeringsfunktionen inte körs: Genererar metadata för en rotinstallerbar enhet som inkluderar allt ovan.
  6. package win32.win32.x86 : Genererar metadata för paketerade funktioner och insticksprogram för Windows.
  7. package win32.win32.x86 : Ett andra anrop för att generera metadata på rotfiler från paketering för Windows.
  8. package linux.gtk.ppc : Genererar metadata för paketerade funktioner och insticksprogram för Linux.
  9. package linux.gtk.ppc : Ett andra anrop för att generera metadata på rotfiler från paketering för Linux.
  10. package all : Genererar metadata för en rotinstallerbar enhet som inkluderar allt ovan.

Genereringsfunktionen för p2-metadata kan utföra inkrementell generering. Varje anrop till genererade p2-metadata utförs med mode=incremental och slutanropet för generering av den rotinstallerbara enheten körs med mode="final"