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:
jossa args on pilkuin eroteltu, seuraavassa kuvattujen avain/arvo-parien luettelo:
- tag: tarkistettava CVS-tunniste
- cvsRoot: CVS-yhteysmerkkijono
- path: valinnainen CVS-moduuli ja polku, jossa elementin sisältävä kansio sijaitsee. Oletusarvoisesti moduulin nimenä käytetään elementin nimeä
- prebuilt: valinnainen totuusarvo, joka osoittaa, onko ladattu elementti koottu ennalta. Oletusarvo on false
- cvsPassFile: valinnainen CVS-salasanatiedoston polku
- password: valinnainen salasana, jota käytetään muodostettaessa yhteys CVS-tietovarastoon
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:
- unpack: määritä arvoksi true, jos haluat määrittää ladatun elementin purettavaksi
- verbose: määritä arvoksi true, jos haluat tarkastella laajoja tilannetietoja latauksen aikana. Oletusarvo on false
- ignoreerrors: määritä arvoksi true, jos haluat kirjata siirron aikana ilmenevät virheet lokiin. Oletusarvo on false
- usetimestamp: toteuttaa paikallisen kopion aikaleimaan perustuvan ehdollisen tiedoston latauksen (vain http-URL-osoitteet), kun arvoksi on määritetty true. Oletusarvo on false
- username: http-perustodennuksen käyttäjätunnus
- password: salasana, jonka avulla lataus toteutetaan.
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
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>
- tunnus: asennettavan yksikön tunnus
- versio, asennettavan yksikön versio (valinnainen). Jos tätä ei määritetä, noudetaan suurin saatavilla oleva versio.
- tietovarasto: asennettavan yksikön sisältävän tietovaraston sijainti (URI-osoite).
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:
- Varmista, että järjestelmäsi hakupolussa on tiedosto cvs.exe.
(Lataa CVS täältä).
- Luo koontihakemistoon kansio nimeltä maps.
- Luo maps-kansioon tiedosto, jossa on .map-tunniste.
- Täytä kyseiseen vastaavuustiedostoon kaikki tietovarastosta noudettavat elementit.
- Muokkaa build.properties-tiedostoa kokoonpanokansiossa ja poista rivi skipFetch=true käytöstä lisäämällä siihen kommenttimerkinnät. Jos kyseinen ominaisuus on määritettynä, PDE-koonti ohittaa koko noutovaiheen. Jos haluat, että vastaavuustiedostoissa määritetty tunniste ohitetaan, voit määrittää ominaisuudelle fetchTag tietyn arvon. Tästä on hyötyä tehtäessä valvomattomia koonteja HEAD-osasta sen sijaan, että tehtäisiin koonti tunnisteellisista versioista.
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:
- skipMaps: Poista tämä ominaisuus käytöstä lisäämällä siihen kommenttimerkinnät. Jos kyseinen ominaisuus on määritettynä, PDE-koonti ei nouda vastaavuustiedostoja.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. CVS-tietovarasto, josta vastaavuustiedostot noudetaan.
- mapsRoot =
/path/to/maps. CVS-tietovaraston polku hakemistoon, joka sisältää vastaavuustiedostot.
- mapsCheckoutTag =
HEAD. CVS-tunniste, jonka avulla vastaavuustiedostot kuitataan ulos.
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ä.