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