p2-julkaisutyökalun PDE-koontilaajennukset

PDE-koonnissa on useita Ant-tehtäviä, jotka laajentavat p2-julkaisutyökalua. Näiden tehtävien avulla PDE-koonti voi julkaista metatiedot ja artefaktit suoraan p2-tietovarastoon.

Muodostetut koontikomentosarjat käyttävät kyseisiä tehtäviä täyden koonnin kontekstissa, jolloin esimerkiksi käännetään luokkatiedostoja ja korvataan versioita. Jotkin tehtävistä voivat tosin olla hyödyllisiä myös erityistapauksissa, joissa metatietoja halutaan julkaista suoraan ajamatta täyttä koontia.

eclipse.publish.featuresAndBundles

Tämä tehtävä muistuttaa p2-julkaisutyökalun p2.publish.featuresAndBundles-tehtävää. Tämä tehtävä julkaisee metatietoja sellaisille aiemmin luoduille binaarisille tuoteominaisuuksille ja lisäosille, joita ei koota lähteestä. Tehtävä julkaisee myös luokat annetun site.xml- tai category.xml-tiedoston perusteella.

Tämä tehtävä tukee seuraavia määritteitä:

metadataRepository Sen tietovaraston määrittävä URI-osoite, johon metatiedot julkaistaan.
artifactRepository Sen tietovaraston määrittävä URI-osoite, johon artefaktit julkaistaan.
repository Määrittää sekä metadataRepository- että artifactRepository-asetuksen.
site Luokkatiedot määrittävän site.xml-tiedoston URL-osoite.
category Luokkatiedot määrittävän category.xml-tiedoston URL-osoite.
siteQualifier Tarkenne, jonka avulla varmistetaan, että tuloksena olevien luokan asennettavien yksiköiden nimet ovat yksilöllisiä.
<features> Sisäkkäinen tiedostojoukkoelementti, joka määrittää julkaistavien binaaristen tuoteominaisuuksien sijainnit.
<bundles> Sisäkkäinen tiedostojoukkoelementti, joka määrittää julkaistavien binaaristen lisäosien sijainnit.
Esimerkki:
 <eclipse.publish.featuresAndBundles repository="file:C:/build/repository" category="file:C:/build/category.xml" >
     <features dir="C:\eclipse\features\" includes="org.eclipse.cvs_1.1.100.v20090514-7E79FEc9BJ99r9XGQ3CICF" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.cvs_1.0.300.v20090520.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.core_3.3.200.I20090430-0408.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh_3.2.100.I20090508-2000.jar" />

     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ssh2_3.2.200.I20090508-2000.jar" />
     <bundles dir="C:\eclipse\plugins" includes="org.eclipse.team.cvs.ui_3.3.200.I20090521-1750.jar" />
 </eclipse.publish.featuresAndBundles>

eclipse.gatherBundle

Julkaise lisäosa suoraan lähteestä. Kun resurssijoukon .class-tiedostot on käännetty, tämä tehtävä kerää kaikki binaarisen tuloksen muodostavat tiedostot ja julkaisee ne p2-artefaktina metatietojen kanssa. Tätä tehtävää käytetään publish.bin.parts-tehtävässä lisäosan luomassa build.xml-tiedostossa. Tämä tehtävä korvaa gather.bin.parts-tehtävän koottaessa p2-julkaisutyökalulla.

Tämä tehtävä tukee seuraavia määritteitä:

metadataRepository Sen tietovaraston määrittävä URI-osoite, johon metatiedot julkaistaan.
artifactRepository Sen tietovaraston määrittävä URI-osoite, johon artefaktit julkaistaan.
buildResultFolder Kansio, joka sisältää luodut .class-tiedostot, Manifest-tiedoston ja mahdolliset .api_description-tiedostot.
targetFolder Sisältö ajettaessa kohteella customBuildCallbacks.
baseDirectory Projektisijainti, josta sisältö kerätään, kun kohde customBuildCallbacks ei ole käytössä
unpack Määrittää, puretaanko lisäosa kansiomuotoon asennuksen yhteydessä.
gatheredSource Lähderesurssijoukkojen yhteydessä keräyslähteen sijainti.
<outputFolder> Sisäkkäiset elementit, jotka määrittävät vaihtoehtoisia sijainteja .class-tiedostojen noutoa varten. Käytetään käytettäessä .class-tiedostoja uudelleen työtilasta. Tämä on Ant-tiedostojoukko, jolla on ylimääräinen, luokkatiedostojen kirjaston määrittävä "library"-määrite
Esimerkki:
 <eclipse.gatherBundle metadataRepository="file:/build/repo" artifactRepository="file:/build/repo"
                       buildResultFolder="${basedir}" baseDirectory="${basedir}" unpack="true" >
     <outputFolder library="lib/pdebuild-ant.jar" dir="${basedir}" includes="bin_ant/**" />

     <outputFolder library="pdebuild.jar" dir="${basedir}" includes="bin/**" />
 </eclipse.gatherBundle>

eclipse.gatherFeature

Julkaise tuoteominaisuus suoraan lähteestä. Tämä tehtävä kerää kaikki tuoteominaisuuden jar-tiedoston muodostavat tiedostot ja julkaisee ne p2-artefaktina metatietojen kanssa. Tämä tehtävä myös julkaisee artefaktit, jotka sisältävät tämän tuoteominaisuuden lisäämiä juuritiedostoja. Jos tuoteominaisuus ei määritä bin.includes-ominaisuutta, tuoteominaisuuden jar-tiedostoa ei luoda, mutta juuritiedoston artefaktit ja tuoteominaisuusryhmän metatiedot ovat silti järjestelmässä.

Tämä tehtävä tukee seuraavia määritteitä:

metadataRepository Sen tietovaraston määrittävä URI-osoite, johon metatiedot julkaistaan.
artifactRepository Sen tietovaraston määrittävä URI-osoite, johon artefaktit julkaistaan.
buildResultFolder Kansio, joka sisältää muutetun feature.xml-tiedoston, jossa versiot on korvattu.
targetFolder Sisältö ajettaessa kohteella customBuildCallbacks.
baseDirectory Tuoteominaisuusprojektin sijainti
Esimerkki:
 <eclipse.gatherFeature
     metadataRepository="file:/build/repo"
     artifactRepository="file:/build/repo"
     buildResultFolder="${basedir}"
     baseDirectory="${basedir}"
 />


eclipse.brand.p2.artifacts

Tuotteista aloitustoiminnon artefaktit tuotetta varten ja julkaise ne uudelleen uudella nimellä sisällytettäviksi annettuun tuotteeseen.

Tämä tehtävä tukee seuraavia määritteitä:

metadataRepository Sen tietovaraston määrittävä URI-osoite, johon metatiedot julkaistaan.
artifactRepository Sen tietovaraston määrittävä URI-osoite, johon artefaktit julkaistaan.
config Kokoonpano, jota varten aloitustoimintoja käytetään. (esimerkki: "gtk.linux.x86")
iconsList Sijainnit, joista etsitään kuvakkeita, joilla ohjelmatiedosto tuotteistetaan.
tempDirectory Tilapäisen hakemiston sijainti.
productId Sen tuotteen tunnus, jota varten julkaistaan.
productVersion Sen tuotteen versio, jota varten julkaistaan.
launcherName Uuden aloitustoiminnon nimi.
launcherProvider Sen asennettavan yksikön nimi, joka toimittaa alkuperäiset aloitustoiminnon artefaktit. Oletusarvon mukaan nimi on "org.eclipse.equinox.executable". Tehtävä etsii artefakteja, joiden nimi on <launcherProvider>_root.<config>