PDE-koonnin p2-integrointi

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
p2.artifact.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
p2.artifact.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
p2.root.version
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ä.

Tuotteiden metatietojen muodostus

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.

Tiedot

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:

  1. assemble win32.win32.x86: Luo kerätyille Windows-tuoteominaisuuksille ja -lisäosille metatiedot.
  2. assemble win32.win32.x86: Toinen kutsu muodostetuille metatiedoille kerättyjä Windows-juuritiedostoja varten.
  3. assemble linux.gtk.ppc: Muodostaa metatiedot kerätyille linux-tuoteominaisuuksille ja -lisäosille.
  4. assemble linux.gtk.ppc: Toinen kutsu muodostetuille metatiedoille kerättyjä linux-juuritiedostoja varten.
  5. assemble all: Jos pakkaustoimintoa ei ajeta, luo metatiedot juureen asennettavalle yksikölle, joka sisältää kaiken edellä mainitun.
  6. package win32.win32.x86: Luo metatiedot pakatuille Windows-tuoteominaisuuksille ja -lisäosille.
  7. package win32.win32.x86: Toinen kutsu muodostetuille metatiedoille Windows-pakkauksen juuritiedostoissa.
  8. package linux.gtk.ppc: Muodostaa metatiedot pakatuille linux-tuoteominaisuuksille ja -lisäosille.
  9. package linux.gtk.ppc: Toinen kutsu muodostetuille metatiedoille linux-pakkauksen juuritiedostoissa.
  10. package all: Muodostaa metatiedot juureen asennettavalle yksikölle, joka sisältää kaiken edellä mainitun.

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"