Productbuilds met p2

Met de nieuwe eigenschap definiëren:

p2.gathering = true

treden enkele wijzigingen op voor productbuilds. De build produceert vooral ju ist geïnstalleerde producten met p2 volledig ingeschakeld.

Het volgende is een lijst met gerelateerde eigenschappen (oud en nieuw):

p2.gatheringStel deze eigenschap in op true om builds op basis van p2-publisher in te schakelen.
p2.build.repoEen URI naar de p2-repository voor de lokale buildtijd; de standaardwaarde is file:${buildDirectory}/buildRepo. Resultaten worden gespiegeld van hier naar de definitieve archieflocatie.
generate.p2.metadataDit is de eigenschap voor de oude integratie van de generator voor metagegevens. Dit heeft geen effect in combinatie met p2.gathering=true.
p2.metadata.repo
p2.artifact.repo
Deze eigenschappen zijn URI's. Standaard zijn voor productbuild de definitieve archieven de geïnstalleerde producten en metagegevens en worden artefacten achtergelaten in de ${p2.build.repo}. Als p2.metadata.repo en p2.artifact.repo worden gedefinieerd, worden de artefacten en metagegevens voor het product gespiegeld vanuit de buildrepository.
p2.metadata.repo.name
p2.artifact.repo.name
Optioneel, deze eigenschappen worden gebruikt om de definitieve repository te benoemen wanneer p2.metadata.repo en p2.artifact.repo worden gebruikt.
p2.compressInstellen op true om de xml van de definitieve repository in een jar te comprimeren.
p2.flavorHet soort product, wordt gebruikt als kwalificatie in de metagegevens voor configuratie voor het product. Zie hieronder.
p2.product.qualifierDe kwalificatie die moet worden gebruikt bij het vervangen van "1.0.0.qualifier" in de versie van een product. Als dit niet is ingesteld, wordt de kwalificatie gebaseerd op forceContextQualifier of de tijdsaanduiding.
p2.publish.artifactsGeen effect wanneer p2.gathering=true (oude eigenschap)
p2.root.name
p2.root.version
Geen effect wanneer p2.gathering=true (oude eigenschap)
p2.context.reposContextrepository's definiëren. Zie metagegevens opnieuw gebruiken.
repoBaseLocationEen map met repository's om te converteren met <p2.repo2runnable>. Zie ook metagegevens opnieuw gebruiken.
transformedRepoLocationDe map met de uitvoer van <p2.repo2runnable>. Zie ook metagegevens opnieuw gebruiken.
p2.category.siteEen url naar een bestand site.xml dat wordt gebruikt om categorieën te definiëren.
p2.category.definitionEen url naar een bestand category.xml dat wordt gebruikt om categorieën te definiëren.
p2.category.prefixDefinieer een voorvoegsel zodat unieke ID's worden gemaakt voor IU's van categorieën die worden gegenereerd vanuit locatie-/categoriebestanden die geen unieke namen hebben.
skipMirroringDe definitieve spiegeling van ${p2.build.repo} to ${p2.metadata.repo} overslaan.
skipDirectorSla de oproep naar de director over. Er worden geen geïnstalleerde producten gemaakt. Als p2.metadata.repo en p2.artifact.repo zijn gedefinieerd, bevatten deze repository's metagegevens en artefacten, anders bevat ${p2.build.repo} de resultaten.
p2.director.logDe locatie van een logboekbestand om de resultaten van de aanroep van de director vast te leggen.
p2.director.profileDe naam die moet worden gebruikt voor het p2-profiel dat is gemaakt door de director. Meestal is het een goed idee om een naam te gebruiken die is gerelateerd aan het product. De standaardwaarde is "profiel".
p2.director.extraArgsAanvullende argumenten om door te geven aan de directory. De standaardwaarde is "-profileProperties org.eclipse.update.install.features=true".
SpiegelingseigenschappenBij het bouwen van producten of features, spiegelt PDE/Build de dependency's van de contextrepository's, om deze op te nemen in de build. Deze eigenschappen bepalen welke dependency's worden opgenomen in deze bewerking. Raadpleeg voor meer informatie Ant-taak p2.mirror.
p2.mirror.rawStandaardwaarde: 'false'. Stel deze eigenschap in op true om de artefactdescriptors uit de bronrepository's opnieuw te gebruiken.
p2.mirror.slicing.filterStandaard wordt er geen filter ingesteld. Stel aanvullende filtereigenschappen in waaraan IU's moeten voldoen om te worden opgenomen.
p2.mirror.slicing.followOnlyFilteredRequirementsDe standaardinstelling is 'false' (onwaar). Stel deze eigenschap in op true (waar) om de filters te inverteren en alleen IU's op te nemen die niet overeenkomen.
p2.mirror.slicing.followStrictDe standaardinstelling is onwaar. Stel deze eigenschap in op true om alleen dependency's op te nemen waarvoor de versies exact zijn opgegeven.
p2.mirror.slicing.includeFeaturesDe standaardinstelling is 'true' (waar). Features wel of niet opnemen.
p2.mirror.slicing.includeNonGreedyDe standaardinstelling is false. Deze eigenschap geeft aan of 'non-greedy' dependency's wel of niet moeten worden opgenomen.
p2.mirror.slicing.includeOptionalDe standaardwaarde is true. Deze geeft aan of optionele dependency's wel of niet moeten worden opgenomen.
p2.mirror.slicing.latestVersionOnlyDe standaardwaarde is false. Deze eigenschap geeft aan of al dan niet alleen de recentste versie van een dependency moet worden opgenomen, als de vereiste een bereik is en er meerdere versies beschikbaar zijn.
p2.mirror.slicing.platformFilterDe standaardwaarde is geen filter. Een drietal "os,ws,arch" om in te stellen als het platform waarmee IU LDAP-filters worden afgestemd. IU's die niet overeenkomen met het filter worden niet gespiegeld.

Soort product

Als onderdeel van een productbuild genereert PDE/Build automatisch standaard metagegevens voor configuraties om startniveaus en de eigenschap config.ini in te stellen. Deze metagegevens worden meestal configuratie-eenheden (CU's) genoemd. Startniveaus worden vooral ingesteld door CU-fragmenten te gebruiken op de IU voor de bundel die wordt gestart. Het soort wordt gebruikt als kwalificatie bij het genereren van de naam van de CU op basis van de IU.

Bijvoorbeeld, met "p2.flavor = tooling" wordt 'toolingwin32.win32.x86org.eclipse.core.runtime' de naam van de CU die de bundel org.eclipse.core.runtime configureert in Windows. Het kan een goed idee zijn om een soort te gebruiken op basis van uw product-ID om conflicten met andere metagegevens te ontwijken, in het bijzonder als uw product bepaalde vereisten heeft met betrekking tot startniveaus.

Zie ook de pagina producten configureren.

De aanroep director

PDE/Build bevat een doel runDirector die wordt aangeroepen om installaties uit te voeren tijdens een productbuild. Momenteel is dit een vertakking van de directortoepassing in een nieuw proces. In meer geavanceerde scenario's voor release engineering is het mogelijk om deze taak opnieuw te gebruiken om aanvullende installaties uit te voeren. De taak vereist dat de locatie van het startprogramma van equinox voor de builder is gedefinieerd. Een voorbeeldaanroep ziet er ongeveer zo uit:
	<property name="equinoxLauncherJar" value="/builder/eclipse/plugins/org.eclipse.equinox.launcher_1.0.200.v20090520.jar"/>
	<ant antfile="${eclipse.pdebuild.scripts}/genericTargets.xml" target="runDirector" inheritAll="true">
		<property name="ws" value="gtk"/>
		<property name="os" value="linux"/>
		<property name="arch" value="x86"/>
		<property name="p2.director.installPath" value="${installFolder}"/>
		<property name="p2.repo" value="${p2.build.repo}"/>
		<property name="p2.director.iu" value="my.rcp.product"/>
		<property name="p2.director.version" value="1.0.0"/>
	</ant>