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 |
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 |
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 |
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. |
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.
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:
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"