Eclipse-komponenttien pakkaus

Eclipse-komponentit toimitetaan arkistotiedostoina. Kukin arkisto sisältää kokoelman tuoteominaisuuksia ja lisäosia. Tavallisesti arkistot sisältävät kaikki tietyn komponentin toiminnot. Usein kuluttajat tarvitsevat joko useamman kuin yhden komponentin tai vain osia joistakin komponenteista. Jos apua ei tarjota, kuluttajien tulee noutaa tarvitsemansa toiminnon ylijoukon sisältävät arkistot manuaalisesti ja tämän jälkeen poimia tarvittavat tuoteominaisuudet ja lisäosat manuaalisesti. Tämä voi olla työläs ja virheille altis prosessi.

PDE-koonti sisältää kuitenkin eräajoon perustuvan mekanismin, pakkausohjelman, josta on apua tällaisissa tapauksissa. Lyhyesti ilmaistuna pakkausohjelma vastaanottaa syötteinä luettelon arkistoista, jotka sisältävät tuoteominaisuuksia, sekä luettelon kiinnostavista tuoteominaisuuksista. Tämän jälkeen pakkausohjelma noutaa zip-tiedostot, poimii tuoteominaisuudet (sekä niiden lisäosat) ja pakkaa ne uudelleen zip-tulostiedostoon.

Pika-aloitus

Seuraavassa on kuvattu joukko perustoimia, joiden avulla pääsee alkuun pakkausohjelman käytössä.  On suositeltavaa koota Unix-pakettien kaltaisia paketteja Unix-koneen kaltaisella koneella. Näin varmistetaan tiedostojen käyttöoikeuksien säilyminen.

  1. Luo pakkauksen kokoonpanohakemisto ja kopioi siihen mallipohjatiedostot (packager.properties, packaging.properties ja customTargets.xml) sijainnista org.eclipse.pde.build/templates/packager.
  2. Muokkaa kopioitua packager.properties-tiedostoa ja määritä seuraavat ominaisuudet:
  3. Nouda pakkausohjelman vastaavuustiedostot.  Seuraavat ominaisuudet ohjaavat vastaavuustiedostojen latausta:
    Pakkausohjelman komentosarja liitostaa kaikki sijainnin ${downloadDirectory} *.map-tiedostot. Jos haluat ladata useamman kuin yhden vastaavuustiedoston tai noutaa ne CVS-tietovarastosta, muokkaa customTargets.xml-tiedostoa ja muuta getMapFiles-kohdetta.
  4. Aja pakkausohjelma seuraavan komennon avulla:
  5. java -jar <eclipse install>/startup.jar -application org.eclipse.ant.core.antRunner 
    -buildfile <<eclipse install>/plugins/org.eclipse.pde.build_<version>/scripts/package.xml>
    -DpackagingInfo=<pakkauskokoonpanohakemiston polku>

Pakkausohjelman vastaavuustiedoston muoto

Pakkausohjelman vastaavuustiedostoja käytetään kuvaamaan eri arkistoja, niiden sisältöä ja sijaintia, josta ne voi ladata.  Ne ovat samankaltaisia kuin koontiprosessissa resurssijoukkojen noutoon tietovarastoista käytettävät vastaavuustiedostot.  Pakkausohjelman vastaavuustiedostomerkinnän muoto on seuraavanlainen:
archiveName = url | [configList] | [directory] | contentDescription | componentName

Huomaa, että vaikka ominaisuudet configList ja directory ovat valinnaisia, on tärkeää, että käytetään oikeaa määrää "|"-erottimia.
Esimerkkejä:
eclipse-SDK-3.1-win32.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | win32,win32,x86 | | sdk | eclipse
eclipse-PDE-3.1.zip=http://download.eclipse.org/downloads/drops/R-3.1-200506271435/ | | | runtime | pde

Pakkausohjelman kokoonpanon ominaisuudet

Pakkausohjelman packager.properties-kokoonpanotiedostossa voi määrittää seuraavat ominaisuudet:
baseDirectory
Hakemisto, jossa pakkaus tapahtuu.
workingDirectory
Hakemisto, johon komentosarjat muodostetaan.  Ominaisuuden arvo mallipohjassa on ${baseDirectory}/workingPlace
downloadDirectory
Kansio, johon arkistot ladataan.  Ominaisuuden arvo mallipohjassa on ${baseDirectory}/toPackage
tempDirectory
Kansio, johon arkistot poimitaan.  Ominaisuuden arvo mallipohjassa on ${baseDirectory}/temp
featurePaths
Ladattujen arkistojen juuren nimi.  Ominaisuuden arvo mallipohjassa on eclipse.
featureList
Pilkuin erotettu luettelo uudelleen pakattavista tuoteominaisuuksien tunnuksista.
componentFilter
Pilkuin erotettu luettelo komponenteista, joissa featureList-luettelon tuoteominaisuudet sijaitsevat.  Tämä ominaisuus suodattaa käytettävissä olevia arkistoja, ja sen avulla pakkausohjelma voi optimoida ladattavan tiedostojoukon.
contentFilter
Pilkuin erotettu luettelo noudettavista sisällön lajeista.  Tämä ominaisuus suodattaa käytettävissä olevaa arkistojoukkoa, ja sen avulla pakkausohjelma voi optimoida ladattavan tiedostojoukon.
config
Merkein "&" erotettu luettelo uudelleen pakattavista kokoonpanoista (pilkuin erotetuista käyttöjärjestelmää, ikkunointijärjestelmää tai arkkitehtuuria kuvaavista kolmen merkinnän sarjoista).  Esimerkiksi: win32, win32, x86 & linux, gtk, x86.
archivesFormat
Arkistojen muodot.  Merkein "&" erotettu kokoonpano-muoto-luettelo.  Esimerkiksi: win32, win32, x86 - antZip & linux, gtk, ppc - tar.  Jos tietylle kokoonpanolle ei määritetä arkiston muotoa, oletusmuoto on antZip.
zipargs
Zip-komennolle välitettävät lisäargumentit.
unzipargs
Unzip-komennolle välitettävät lisäargumentit.
archivePrefix
Tuloksena olevien arkistojen etuliite.
collectingFolder
Tuloksena olevan arkiston juurikansion nimi.
buildId
Määrittää koontitunnuksen arkiston oletusnimeen.
buildType
Koonnin laji. Tämän ominaisuuden avulla nimetään koonnin tulos.  Tavallisesti jokin seuraavista: I, N, M, S, ...
buildLabel
Koonnin nimiö.  Tämän ominaisuuden arvo mallipohjassa on${buildType}.${buildId}.
archiveNamePrefix
Määrittää tuloksena olevan arkiston nimen.  Tämän ominaisuuden oletusarvo on ${buildId}.
packagingProperties
Juuritiedostojen pakkausominaisuudet sisältävän tiedoston suhteellinen polku.  Oletusarvoisesti tämä ominaisuus osoittaa tiedostoon packaging.properties.
deltaPack
Määrittää, muodostetaanko delta-paketti.  Delta-paketin muodostus sulkee pois käyttöympäristöstä riippumattomat osat ja ryhmittää kaikki kokoonpanot yhteen arkistoon.

Juuritiedostojen pakkaus

Pakkausohjelman packager.properties-kokoonpanotiedostossa ominaisuus packagingProperties osoittaa ominaisuustiedostoon, joka määrittää pakattavat juuritiedostot.  Oletusarvoisesti kyseinen tiedosto on packaging.properties.

Tämän ominaisuustiedoston tulee sisältää edellytetyt juuritiedostot määrittävät ominaisuudet.  Lisätietoja juuriominaisuuksista on Tuoteominaisuuden erityisominaisuudet -sivulla.