Tällä sivulla kuvataan vanhentunut tapa integroida p2. Suositeltavia tapoja käyttää p2-käyttöympäristöä on sivulla "P2-tietovarastojen ja -tuotteiden koonti". Alla kuvatut ominaisuudet käyttävät yhteensopivuuskerrosta, eivätkä ne tue mitään uusia ominaisuuksia, jotka on mahdollisesti lisätty p2-julkaisutyökaluun.
Lisätietoja p2-metatietojen muodostuksesta on Eclipse-ympäristön lisäosan sovelluskehittäjän oppaan ohjeessa P2-metatietojen muodostus. Metatietojen muodostus ei sinänsä riitä siihen, että tuotteessa olisi p2-käyttömahdollisuus. Tätä varten on toteutettava p2-asennus muodostetuista metatiedoista. Lisätietoja tämän asennuksen toteutuksesta näyttöpäätteettömästä komentosarjasta on p2 director-ohjeissa.
p2-metatietoja on mahdollista luoda manuaalisilla kutsuilla p2-metatietojen luontitoimintoon missä tahansa PDE:n/koonnin mukautetussa tehtävässä (katso kohta Näyttöpäätteettömän koonnin mukautus). PDE/koonti sisältää kuitenkin p2-integroinnin seuraavien ominaisuuksien kautta:
generate.p2.metadata |
(VANHENTUNUT, käytä p2.gathering-määritystä) Voit ottaa p2-metatietojen muodostuksen käyttöön määrittämällä arvoksi true. Ant-komentosarjat perustuvat kyseisen ominaisuuden olemassaoloon, eivät sen arvoon. Jos haluat poistaa metatietojen muodostuksen käytöstä, ominaisuus on poistettava. Ei riitä, että ominaisuuden arvoksi määritetään false. Koontikomentosarjoissa muodostuu kutsuja p2-kohteisiin, kun p2-resurssijoukko org.eclipse.equinox.p2.metadata.generator ja sen riippuvuudet ovat koontia ajavassa Eclipse-järjestelmässä. Nämä p2-kohteet ovat riippuvaisia generate.p2.metadata-ominaisuudesta. |
p2.metadata.repo |
Määritä file:-URI-osoite, joka ilmaisee p2-metatietojen ja artefaktivarastojen julkaisusijainnin. On tavallista, mutta ei välttämätöntä käyttää artefaktivarastolle samaa sijaintia kuin metatietovarastolle. Esimerkki:
p2.metadata.repo=file:${buildDirectory}/repository
p2.artifact.repo=file:${buildDirectory}/repository
|
p2.metadata.repo.name |
Valinnainen. Määritä nimet muodostustoiminnon p2-varastoille. Käytettäessä aiemmin luotua tietovarastoa sen nykyinen nimi ei muutu. Jos nimeä ei määritetä, p2 nimeää tietovarastot niiden sijainnin perusteella. |
p2.flavor |
Määritä p2-metatietojen tyyppi. Kun metatiedot muodostetaan Eclipse SDK:lle, käytetään työkalutyyppiä. |
p2.publish.artifacts |
Voit julkaista jar-tiedostoja artefaktivarastoon määrittämällä arvoksi true. Jos arvoksi määritetään false, artefaktien metatiedot muodostetaan, mutta jar-tiedostot eivät kopioidu artefaktivarastoon. VAROITUS: Kun arvona on true, varmista, että p2.artifact.repo ei ole sama sijainti kuin PDE:n/koonnin käyttämillä koontihakemistolla, koska muutoin jar-tiedostot voivat kadota! |
p2.root.name |
Määritä sen juuren asennettavissa olevan yksikön nimi ja versio, joka sisältää kaikki kootut kohteet. Jos koonnissa on määritetty .product-tiedosto, nämä ominaisuudet ohitetaan. Kun .product-tiedosto on käytettävissä, juuren nimenä ja versiona ovat sen sijaan .product-tiedostossa olevat tuotetunnus ja versio. Lisätietoja on jäljempänä. |
Kun koonti ajetaan tuotetiedostolla, joka on määritetty ylimmän tason koontikokoonpanon build.properties-tiedostossa (sekä productBuild.xml- tiedostoa että tavallista build.xml-tiedostoa käyttävissä koonneissa), PDE/koonti muodostaa kyseisen tuotteen metatiedot automaattisesti.
Kaikille tuoteominaisuuksille ja resurssijoukoille luodaan asennettavissa olevat yksiköt. Lisäksi luodaan seuraavat tuotteen asennettavissa olevat yksiköt:
Näiden muodostettujen asennettavissa olevien yksiköiden avulla on mahdollista asentaa koko tuote p2:n avulla tietovarastosta.
PDE/koonti kutsuu p2:n sisältämää metatietojen muodostustehtävää tietyissä vaiheissa koonnin aikana. On todennäköistä, että koonnin aikana ei ole koskaan yhtä ajankohtaa, jolloin kaikki koontiartefaktit ovat levyssä samassa paikassa. Tämän vuoksi on tarpeen joko kutsua p2-metatietojen luontitoimintoa lopullisista arkistoista tai kutsua sitä useita kertoja koko koonnin ajan.
Metatietoja muodostetaan koonti- ja pakkausvaiheiden ajan. Tämä koskee sekä tavallisia koonteja että pakkausohjelmakoonteja. Esimerkiksi tuotteen koonnissa productBuild.xml-tiedoston avulla muodostetaan seuraavat komentosarjat (olettaen, että configs=win32,win32,x86 & linux,gtk,ppc):
Assemble-komentosarjat keräävät tuoteominaisuudet ja lisäosat, jotka on koottu liittyvien juuritiedostojen mukana. Package-komentosarjat keräävät valmiiksi kootut binaariset tuoteominaisuudet ja lisäosat. Käyttöympäristökohtaiset komentosarjat keräävät kyseisten kokoonpanojen osat, ja all-komentosarjat delegoivat tehtävän kullekin käyttöympäristökohtaiselle komentosarjalle.
p2-muodostuskutsut toteutuvat seuraavasti:
p2-metatietojen muodostustehtävä tukee täydentävää muodostusta. Jokainen muodostettu p2-metatietojen kutsu tapahtuu asetuksella mode=incremental, viimeinen juureen asennettavan yksikön muodostuskutsu ajetaan asetuksella mode="final"