P2-metatietojen käyttö uudelleen

Tietyn tuoteominaisuuden tai resurssijoukon metatiedot voivat vaihdella tietojen muodostustavan mukaan. Tämä pätee erityisesti, kun metatietoja on mukautettu tai kun tuoteominaisuudet toimittavat juuritiedostoja.

Tämän takia metatietoja kannattaa mahdollisuuksien mukaan käyttää uudelleen aina, kun se on mahdollista, sen sijasta, että metatiedot muodostettaisiin uudelleen sellaisen binaaristen tuoteominaisuuksien ja resurssijoukkojen perusteella, joita et itse omista.

Tehtävä repo2runnable

Järjestelmässä on ant-tehtävä <p2.repo2runnable>, joka muuntaa tuoteominaisuuksien ja resurssijoukkojen artefaktit asennettuun muotoon. Yleisesti ottaen tällä tarkoitetaan muotoa, jossa lisäosien on oltava, jotta niiden perusteella voisi kääntää koodia. Tämän tehtävän avulla voit kuluttaa muissa projekteissa käytettyjä tietovarastoja helposti omissa koonneissasi. PDE/koonnissa on tämän tehtävän sisäinen integrointi, joka toteutetaan seuraavien ominaisuuksien avulla:

repoBaseLocationMuunnettavat tietovarastot sisältävä kansio. Kansio voi sisältää pakattuja tietovarastoja ja alikansioita, jotka ovat tietovarastoja.
transformedRepoLocationKansio, johon muunnetut artefaktit sijoitetaan. Kansiosta itsestään tulee p2-tietovarasto.

Version 3.5 uusia ominaisuuksia ovat mukautetut kohteet preProcessRepos ja postProcessRepos, jotka ilmenevät ennen PDE/koonnin tekemää tehtävän <p2.repo2runnable> kutsua ja sen jälkeen. Tämän ansiosta pakatut tietovarastot voidaan kahdentaa tai ladata automaattisesti:
build.properties:
	repoBaseLocation=${buildDirectory}/inputRepositories
	transformedRepoLocation=${buildDirectory}/transformedRepo
	
customTargets.xml:
<target name="preProcessRepos">
   <p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
      <iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
      <iu id="org.eclipse.cdt.feature.group"/>
   </p2.mirror>
   <property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
   <get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
</target>
    
(Tätä ohjetta laadittaessa 3.5-version lopullisten ZIP-tiedostojen sijainti ei ollut vielä tiedossa. Edellä mainitut URL-osoitteet on annettu vain esimerkkeinä, eikä niitä välttämättä ole järjestelmässä myöhemmin.)

PDE/koonti kutsuu ensin mukautetun kohteen preProcessRepos. Tämän jälkeen kutsutaan ant-tehtävä repo2runnable, joka muuntaa kyseiset ladatut tietovarastot muotoon, jota koonti voi käyttää uudelleen.

Ominaisuutta transformedRepoLocation, joka määrittää kyseisten muunnosten sijainnin, käytetään myös kontekstin tietovarastona.

Kontekstin tietovarastot

Ominaisuus p2.context.repos on pilkuin erotettu luettelo tietovarastoista, joita käytetään koonnin kontekstina.

Kun koonti muodostaa metatietoja, se käsittelee ensin kontekstin tietovarastot ja tarkistaa, sisältävätkö ne aiemmin luotuja tuoteominaisuuden tai lisäosan metatietoja. Jos metatiedot ovat jo järjestelmässä, ne kopioidaan koonnin paikalliseen tietovarastoon (${p2.build.repo}) sen sijasta, että muodostettaisiin uudet metatiedot.

Jos vastaavasti tuoteominaisuudet, resurssijoukot tai tuotteet sisältävät mukautettuja metatietoja, jotka riippuvat muista kuin koontiin sisällytetyistä tekijöistä, PDE/koonti toteuttaa kahdennuksen kontekstin tietovarastoista. Kahdennustoiminto sisällyttää kaikki tuoteominaisuuden tai lisäosan metatietoihin lisätyt asennettavat yksiköt.