Tuotekoonnit p2-käyttöympäristön avulla

Uuden ominaisuuden määritys

p2.gathering = true

aiheuttaa joitakin muutoksia tuotekoonteihin. Erityisesti on huomattava, että koonnin tuloksena saadaan oikein asennettuja, täysin p2-käyttöympäristössä käytettäviksi sopivia tuotteita.

Seuraavassa on luettelo aiheeseen liittyvistä ominaisuuksista (vanhoista ja uusista):

p2.gatheringMääritä arvoksi true, jos haluat ottaa käyttöön p2-julkaisutoimintoon perustuvat koonnit.
p2.build.repoPaikallisen koonninaikaisen p2-tietovaraston URI-osoite. Oletusarvo on file:${buildDirectory}/buildRepo. Tulokset kahdennetaan tästä tietovarastosta lopulliseen arkistosijaintiin.
generate.p2.metadataTämä on vanhan metatietojen muodostustoiminnon integroinnin ominaisuus. Ominaisuudella ei ole vaikutusta, jos p2.gathering=true on määritetty.
p2.metadata.repo
p2.artifact.repo
Nämä oletusarvot ovat URI-osoitteita. Tuotekoonneissa lopulliset arkistot ovat oletusarvon mukaan asennettuja tuotteita. Metatiedot ja artefaktit jäävät ${p2.build.repo}-tietovarastoon. Jos ominaisuudet p2.metadata.repo ja p2.ct.repo on määritetty, tuotteen artefaktit ja metatiedot kahdennetaan koonnin tietovarastosta.
p2.metadata.repo.name
p2.artifact.repo.name
Näiden valinnaisten ominaisuuksien avulla voidaan nimetä lopullinen tietovarasto, kun ominaisuudet p2.metadata.repo ja p2.ct.repo ovat käytössä.
p2.compressMääritä ominaisuuden arvoksi true, jos haluat pakata tietovaraston lopullisen XML-tiedoston JAR-arkistoon.
p2.flavorTuotteen tyyppi, jota käytetään tuotteen kokoonpanon metatietojen tarkenteena. Lisätietoja on jäljempänä.
p2.product.qualifierTarkenne, jonka avulla tuotteen versionumeron kohta "1.0.0.tarkenne" korvataan. Jos ominaisuutta ei ole määritetty, tarkenne määritetään ominaisuuden forceContextQualifier tai aikaleiman perusteella.
p2.publish.artifactsOminaisuudella ei ole vaikutusta, jos asetus p2.gathering=true on määritetty (ominaisuus on vanha)
p2.root.name
p2.root.version
Ominaisuudella ei ole vaikutusta, jos asetus p2.gathering=true on määritetty (ominaisuus on vanha)
p2.context.reposMäärittää kontekstin tietovarastot. Lisätietoja on kohdassa Metatietojen käyttö uudelleen.
repoBaseLocationKansio, joka sisältää tehtävän <p2.repo2runnable> avulla muunnettavat tietovarastot. Lisätietoja on kohdassa Metatietojen käyttö uudelleen.
transformedRepoLocationTehtävän <p2.repo2runnable> tuloksen sisältävä kansio. Lisätietoja on kohdassa Metatietojen käyttö uudelleen.
p2.category.siteLuokkien määritykseen käytettävän site.xml-tiedoston URL-osoite.
p2.category.definitionLuokkien määritykseen käytettävän category.xml-tiedoston URL-osoite.
p2.category.prefixMäärittää etuliitteen, jonka avulla varmistetaan, että muista kuin yksilöllisiä nimiä käyttävistä site- tai category-tiedostoista muodostettujen luokkien asennettavien yksiköiden tunnukset ovat yksilöllisiä.
skipMirroringOhittaa kohteen ${p2.build.repo} lopullisen kahdennuksen kohteeseen ${p2.metadata.repo}.
skipDirectorOhittaa ohjaustoiminnon kutsun. Tuloksena ei ole asennettuja tuotteita. Jos ominaisuudet p2.metadata.repo ja p2.ct.repo on määritetty, kyseiset tietovarastot sisältävät tuotteen metatiedot ja artefaktit. Muussa tapauksessa tietovarasto ${p2.build.repo} sisältää tulokset.
p2.director.logSen lokitiedoston sijainti, johon ohjaustoiminnon kutsun tulokset kirjataan.
p2.director.profileOhjaustoiminnon luoman p2-profiilin yhteydessä käytettävä nimi. Yleisesti ottaen nimeksi kannattaa antaa jokin tuotteeseen liittyvä. Oletusnimi on profiili.
p2.director.extraArgsHakemistoon välitettävät lisäargumentit. Oletusarvo on -profileProperties org.eclipse.update.install.features=true.
Ominaisuuksien kahdennusTuotteita tai ominaisuuksia rakennettaessa PDE/koonti kahdentaa koontiin sisällytettävät kontekstin tietovarastojen riippuvuudet. Nämä ominaisuudet ohjaavat, mitä riippuvuuksia sisällytetään tähän toimintoon. Lisätietoja on ant-tehtävässä p2.mirror.
p2.mirror.rawOletusarvo on epätosi. Voit käyttää lähdetietovarastojen artefaktin kuvaajat uudelleen määrittämällä arvoksi true.
p2.mirror.slicing.filterOletusarvo on ei suodatusta. Asetettujen suodattimen lisäominaisuuksien asennettavien yksiköiden pitää olla voimassa.
p2.mirror.slicing.followOnlyFilteredRequirementsOletusarvo on false. Voit asettaa arvoksi true, jos haluat kääntää suodattimet ja sisällyttää ainoastaan ne asennettavat yksiköt, jotka eivät ole voimassa.
p2.mirror.slicing.followStrictOletusarvo on false. Aseta arvoksi true vain, jos haluat sisällyttää vain ne riippuvuudet, joiden versiot on määritetty.
p2.mirror.slicing.includeFeaturesOletusarvo on true (tosi). Määrittää, sisällytetäänkö tuoteominaisuudet.
p2.mirror.slicing.includeNonGreedyOletusarvo on false. Määrittää, sisällytetäänkö muita kuin greedy-riippuvuuksia.
p2.mirror.slicing.includeOptionalOletusarvo on true. Määrittää, sisällytetäänkö valinnaisia riippuvuuksia.
p2.mirror.slicing.latestVersionOnlyOletusarvo on false. Määrittää, sisällytetäänkö vain riippuvuuksien uusimmat versiot, kun vaatimus on arvoalue ja useita versioita on saatavilla.
p2.mirror.slicing.platformFilterOletusarvo on ei suodatusta. Kolmiosainen, "os,ws,arch"-muotoinen määritys, jonka avulla määritetään käyttöympäristö, jonka perusteella asennettavien yksiköiden LDAP-suodattimista etsitään vastineita. Muita kuin suodatinta vastaavia asennettavia yksiköitä ei kahdenneta.

Tuotetyyppi

PDE/koonti muodostaa automaattisesti tuotteen koonnin aikana aloitustasot ja config.ini-ominaisuuden määrittävät oletuskokoonpanon metatiedot. Kyseisistä metatiedoista käytetään yleensä nimitystä CU-yksiköt (kokoonpanoyksiköt). Käytännössä tämä merkitsee, että aloitustasot määritetään käyttämällä CU-yksiköitä aloitettavan resurssijoukon asennettavassa yksikössä (IU-yksikössä). Tyyppiä käytetään tarkenteena, kun CU-yksiköiden nimet muodostetaan IU-yksikön perusteella.

Esimerkiksi p2.flavor = tooling-määrityksessä toolingwin32.win32.x86org.eclipse.core.runtime on org.eclipse.core.runtime-resurssijoukon kokoonpanon Windowsissa määrittävän CU-yksikön nimi. Tyypit kannattaa muodostaa tuotteen tunnuksen perusteella, jotta vältyttäisiin ristiriidoilta muiden metatietojen kanssa. Tämä koskee erityisesti tuotteita, joissa on aloitustasoja koskevia erityisvaatimuksia.

Lisätietoja on Tuotteiden kokoonpanon määritys -sivulla.

Ohjaustoiminnon kutsu

PDE/koonti sisältää runDirector-kohteen, joka kutsutaan asennusten toteuttamista varten tuotteen koonnin aikana. Tällä hetkellä kohde on ohjaussovelluksen haarauma uudessa prosessissa. Yksityiskohtaisemmissa releng-skenaarioissa voidaan käyttää kyseistä tehtävää uudelleen lisäasennusten toteutukseen. Tehtävä edellyttää, että koontitoiminnon equinox-aloitustoiminnon sijainti on määritetty. Esimerkkikutsu voisi näyttää seuraavalta:
	<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>