PDE-buildintegratie met p2

Deze pagina beschrijft een verouderde manier om te integreren met p2. Zie de pagina "Bouwen van p2-repository's en producten" voor de aanbevolen methoden voor het bouwen met p2. De hieronder beschreven eigenschappen werken met behulp van een laag voor achterwaartse compatibiliteit en bieden geen ondersteuning voor nieuwe features die aan de p2-publisher kunnen worden toegevoegd.

Raadpleeg de pagina Genereren van p2-metagegevens in de Platform Plugin-in Developer Guide voor meer informatie over het genereren van p2-metagegevens. Alleen metagegevens genereren is niet voldoende om een product te maken waarvoor p2 is ingeschakeld. Om dit te doen, moet u een p2-installatie uitvoeren met behulp van de gegenereerde metagegevens. Raadpleeg de documentatie over de p2-director voor meer informatie over het uitvoeren van deze installatie met behulp van een naamloos script.

Het is mogelijk p2-metagegevens te genereren met handmatige aanroepen naar de p2-metagegevensgenerator in elke aangepaste taak van PDE/Build (raadpleeg Een naamloze build aanpassen). PDE/Build biedt echter integratie met p2 via de volgende eigenschappen:

generate.p2.metadata
(GEDEPRECIEERD, gebruik in plaats hiervan p2.gathering) Stel deze eigenschap in op true om het genereren van p2-metagegevens in te schakelen. De Ant-scripts zijn gebaseerd op het bestaan van deze eigenschap en niet de waarde. Om het genereren van metagegevens uit te schakelen moet de eigenschap worden verwijderd en niet alleen worden ingesteld op false.
In de buildscripts worden aanroepen van p2-doelen gegenereerd als de p2-bundel org.eclipse.equinox.p2.metadata.generator en de bijbehorende dependency's aanwezig zijn in de Eclipse die de build uitvoert. Deze p2-doelen zijn voorwaardelijk in de eigenschap generate.p2.metadata.
p2.metadata.repo
p2.artifact.repo
Geef een file:-URI op van de locatie van de p2-metagegevens en artefactrepository's waarnaar moet worden gepubliceerd. De artefactrepository gebruikt doorgaans dezelfde locatie als de repository voor metagegevens, maar dit is niet vereist.
Voorbeeld:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
Optioneel. Geef namen op voor de repository's van de p2-generator.
Als u een repository gebruikt die al bestaat, wordt de bestaande naam van de repository niet gewijzigd. Als geen naam wordt opgegeven, geeft p2 de repository's een naam op grond van hun locatie.
p2.flavor
Stel de methode in voor de p2-metagegevens. Als metagegevens worden gegenereerd voor Eclipse SDK, wordt de methode "tooling" gebruikt.
p2.publish.artifacts
Stel deze eigenschap in op true om JAR-bestanden in de artefactrepository te publiceren. Als deze eigenschap is ingesteld op false worden artefactmetagegevens gegenereerd maar worden de JAR-bestanden niet gekopieerd naar de artefactrepository. WAARSCHUWING: Als u deze eigenschap instelt op true, moet u ervoor zorgen dat de p2.artifact.repo niet dezelfde locatie is als de assemblagedirectory's die worden gebruikt door PDE/Build, omdat dit verwijdering van JAR-bestanden tot gevolg kan hebben.
p2.root.name
p2.root.version
Geef de naam en versie op voor de hoofd-IU die alles bevat wat is gebouwd.
Als een .product-bestand wordt opgegeven in de build worden deze eigenschappen genegeerd. Als een .product-bestand echter beschikbaar is, zijn de naam van de hoofdmap en de versie, het product-ID en de versie van het .product-bestand. Zie hieronder voor meer informatie.

Genereren van metagegevens voor producten

Als u een build uitvoert en een productbestand is ingesteld in het buildconfiguratiebestand build.properties op het hoogste niveau (zowel in builds die de productBuild.xml gebruiken als de normale build.xml), genereert PDE/Build automatisch metagegevens voor dat product.

Hierdoor worden installeerbare eenheden voor alle features en bundels gemaakt en ook de onderstaande installeerbare eenheden van het product:

Bij al deze gegenereerde installeerbare eenheden is het mogelijk p2 te gebruiken om het volledige product te installeren vanuit de repository.

De details

PDE/Build roept de door p2 geboden taak voor het genereren van metagegevens aan op bepaalde punten tijdens de build. Waarschijnlijk is er tijdens een build nooit één moment waarop alle buildartefacten bestaan op schijf op dezelfde plaats. Daarom is het noodzakelijk om de p2-metagegevensgenerator aan te roepen voor de uiteindelijke archieven of, als een optimalisatie, deze meerdere malen aan te roepen tijdens de build.

Het genereren van metagegevens vindt plaats gedurende de fasen waarin de build wordt geassembleerd en in een pakket wordt opgenomen. Dit geldt zowel voor normale builds als voor packager-builds. Voor een product-build waarbij productBuild.xml wordt gebruikt, worden bijvoorbeeld de onderstaande scripts gegenereerd (uitgaande van configs=win32,win32,x86 & linux,gtk,ppc):

Assemblagescripts verzamelen features en plugins die samen met bijbehorende hoofdbestanden zijn gebouwd. Pakketscripts verzamelen vooraf gebouwde binaire features en plugins. De platform-specifieke scripts verzamelen de stukken voor die bepaalde configuraties en de "all"-scripts delegeren naar elk van de platform-specifieke scripts.

Aanroepen voor p2-generatie vinden als volgt plaats:

  1. assemble win32.win32.x86: Metagegevens genereren voor verzamelde features en plugins voor Windows.
  2. assemble win32.win32.x86: Tweede aanroep van gegenereerde metagegevens voor verzamelde hoofdbestanden voor Windows.
  3. assemble linux.gtk.ppc: Metagegevens genereren voor verzamelde features en plugins voor Linux.
  4. assemble linux.gtk.ppc: Tweede aanroep van gegenereerde metagegevens voor verzamelde hoofdbestanden voor Linux.
  5. assemble all: Als de packager niet wordt uitgevoerd: Metagegevens genereren voor een installeerbare hoofdeenheid waarin al het bovenstaande is opgenomen.
  6. package win32.win32.x86: Metagegevens genereren voor in pakketten opgenomen features en plugins voor Windows.
  7. package win32.win32.x86: Tweede aanroep van gegenereerde metagegevens voor in pakketten opgenomen hoofdbestanden voor Windows.
  8. package linux.gtk.ppc: Metagegevens genereren voor in pakketten opgenomen features en plugins voor Linux.
  9. package linux.gtk.ppc: Tweede aanroep van gegenereerde metagegevens voor in pakketten opgenomen hoofdbestanden voor Linux.
  10. package all: Metagegevens genereren voor een installeerbare hoofdeenheid waarin al het bovenstaande is opgenomen.

De p2-taak voor het genereren van metagegevens ondersteunt incrementele generatie; elke aanroep van de gegenereerde p2-metagegevens vindt plaats in mode=incremental. De laatste aanroep om de installeerbare hoofdunit te genereren wordt uitgevoerd in mode="final".