Nouto tietovarastoista

PDE-koonnin infrastruktuuri tuo käyttöön mahdollisuuden noutaa lähdekoodi ja esikootut lisäosat tietovarastosta osana koontiprosessia (lisätietoja on tehtävän eclipse.fetch ohjeissa sekä ohjeaiheessa noutoa ohjaavat ominaisuudet). Tämän voi tehdä kahdella tavalla: antaa PDE-koonnin noutaa lähdekoodin automaattisesti tai noutaa lähdekoodin itse manuaalisesti.

Automaation ensimmäinen vaihe, vastaavuustiedosto

Kun koonti-infrastruktuurille annetaan koottavan tuoteominaisuuden tai lisäosan tunnus, infrastruktuuri voi noutaa tietovarastosta kaikki sisältyvät tuoteominaisuudet ja lisäosat.

PDE-koonti käyttää vastaavuustiedostoja paikantamaan sijainnit, joista se noutaa kohteita. Vastaavuustiedosto on Java-ominaisuustiedosto, joka määrittää tuoteominaisuuksien ja lisäosien vastaavuuksia tiettyihin tietovaraston sijainteihin ja tunnisteisiin. Vastaavuustiedostojen muoto on avoin, mutta key-osa on PDE-koonnin kiinteäksi määrittämä:

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

jossa elementType on bundle, feature, plugin tai fragment jaelementId sekä elementVersion määrittävät elementin tiedot.

Vastaavuustiedoston merkintä CVS-tietovarastoa varten

Vastaavuustiedoston merkinnän muoto sisällön CVS-tietovarastosta noutoa varten on seuraavanlainen:
<key> = CVS, [,args]
jossa args on pilkuin eroteltu, seuraavassa kuvattujen avain/arvo-parien luettelo: Esimerkki:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Vanhan tyylin vastaavuusmerkinnät
Eclipse 3.2 -versiossa ja vanhemmissa versioissa CVS-vastaavuustiedostojen muoto oli seuraavanlainen:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Vaikka jokin valinnainen argumentti jäisi määrittämättä, pilkut ovat silti tarpeen seuraavien argumenttien erottamiseksi. Tätä muoto on pidettävä vanhentuneena, ja avain-/arvomuoto on suositeltava.

Vastaavuustiedoston merkintä Ant-tehtävää GET varten

Vastaavuustiedoston merkinnän muoto sisällön noutoa varten URL-osoitteesta, jota Ant-tehtävä GET tukee, on seuraavanlainen:

<key> = GET, <url> [,args]
jossa url on URL-osoite, josta tiedot noudetaan, ja args on valinnainen pilkuin eroteltu, seuraavassa kuvattujen avain/arvo-parien luettelo: Esimerkki:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Vastaavuustiedoston merkintä p2-noutoa varten

PDE/koontiin on lisätty uusi laajennus, jonka avulla käyttäjät voivat noutaa artefakteja p2-tietovarastoista. Voit nyt lisätä vastaavuustiedostoon merkinnän koonnin syötteitä varten, jolloin PDE/koonti noutaa artefaktin ja sisällyttää sen koontiin. Vastaavuustiedostoon on sisällytettävä asennettavan yksikön (IU) tunnus ja versio sekä sen tietovaraston URI-osoite, jossa asennettava yksikkö sijaitsee. Metatietojen ja artefaktien tietovarastojen oletetaan olevan samassa paikassa.

Vastaavuustiedoston merkinnän muoto noudettaessa sisältöä p2-järjestelmän avulla on seuraavanlainen:

<elementType>@<elementID> = p2IU, tunnus=<tunnus>, versio=<versio>, tietovarasto=<tietovarasto>
Tuoteominaisuuksien noutaminen p2-käyttöympäristön avulla

Helios-julkaisussa tuoteominaisuudet voidaan noutaa p2-käyttöympäristön avulla määrittämällä tuoteominaisuuden JAR-tiedostoa vastaava asennettava yksikkö. Tuoteominaisuuden metatiedot -sivulla on lisätietoja tuoteominaisuuksien p2-käyttöympäristön metatietojen rakenteesta.

Esimerkkejä:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Vastaavuustiedoston merkintä muita tietovarastoja varten

PDE-koonnissa on laajennuspiste, johon voi kytkeä noutokomentosarjojen muodostustoimintoja muista tietovarastoista noutoa varten. Jos Eclipse-asennuksesi sisältää resurssijoukon, jossa on komentosarjan muodostustoimintolaajennus eri lajin tietovarastoa varten, voit käyttää kyseistä tietovarastoa määrittämällä sen vastaavuustiedostojesi merkinnöissä ja noudattamalla laajennuksen toimittajan määrittämää muotoa.

Asetusten määritys CVS-tietovarastosta noutoa varten

Määritä asetukset lähteen CVS-tietovarastosta noutoa varten tekemällä seuraavat toimet:

Vastaavuustiedostojen nouto CVS-tietovarastosta

Vastaavuustiedostot on usein tallennettu tietovarastoon. PDE-koonnin oletusinfrastruktuurin avulla nämä vastaavuustiedostot voi noutaa CVS-tietovarastosta. Voit ottaa tämän toiminnon käyttöön muuttamalla seuraavia ominaisuuksia kokoonpanohakemistossa sijaitsevassa kokoonpanon build.properties-tiedostossa: Vastaavuustietojen nouto CVS-tietovarastosta tapahtuu koonnin esikoontivaiheessa.  Koonnin noutovaiheen aikana muodostetaan ja ajetaan kaikki koottavaan tuoteominaisuuteen sisältyvät lisäosat ja tuoteominaisuudet noutavat komentosarjat. 

Automaattinen nouto muista tietovarastoista

Jos  noudat vastaavuustiedostot automaattisesti tietovarastosta, kokoonpanohakemistoon on kopioitava tiedosto customTarget.xml sijainnista org.eclipse.pde.build/templates/headless-build.  Kohdetta  getMapFiles käytetään vastaavuustiedostojen noutoon, ja sitä tulee muuttaa niin, että nouto tehdään halutusta tietovarastosta.

Lähdekoodin nouto manuaalisesti

Voit kirjoittaa mukautettuja noutokohteita, jotka noutavat lisäosia ja tuoteominaisuuksia. Kyseiset kohteet voi kutsua customTargets.xml-tiedoston preSetup- tai postSetup-kohteista.  Tuoteominaisuudet ja lisäosat tulee noutaa hakemistoihin ${buildDirectory}/features ja ${buildDirectory}/plugins mainitussa järjestyksessä.