Tuoteominaisuuksien koonti

PDE-koonnissa on infrastruktuuri, jonka avulla tuoteominaisuuksien koonti voidaan automatisoida. Suurimman osan tällaisen koonnin edellyttämistä asetuksista voi määrittää tekemällä muutamia muutoksia PDE-koonnin mukana toimitettuun build.properties-mallipohjaan. Seuraavassa osiossa käsitellään yksinkertaisen koonnin asetusten määritystä, jossa oletetaan, että kaikki koottavasta tuoteominaisuudesta käsin viitattavat lisäosat ja tuoteominaisuudet (sekä koottavat että ennalta kootut) ovat jo paikallisesti käytettävissä levyllä.

Perusasetukset

Koonnin kokoonpanohakemisto

Ensimmäinen vaihe koonnin asetusten määrityksessä on koonnin kokoonpanohakemiston luonti. Tämä on hakemisto, jossa näyttöpäätteetöntä koontia ohjaavia ja mukauttavia tiedostoja säilytetään.

Koonnin ohjauksen päätiedosto on ylimmän tason koontikokoonpanon build.properties-tiedosto. Kun haluat määrittää uuden koonnin asetukset, kopioi mallipohjatiedosto org.eclipse.pde.build-resurssijoukosta eclipse-asennukseen, jossa ajat koonnin. Mallipohjatiedoston polku on org.eclipse.pde.build/templates/headless-build/build.properties.

Tähän hakemistoon viitataan builder-ominaisuuksissa, jotka määritetään yleensä ant-komentorivillä.

buildDirectory

buildDirectory-ominaisuus ilmaisee hakemiston, jossa PDE/koonti luo komentosarjat ja toteuttaa itse koonnin. Koottavat lisäosat ja tuoteominaisuudet on sijoitettava alihakemistoihin ${buildDirectory}/plugins ja ${buildDirectory}/features. Jos resurssijoukkoja ja tuoteominaisuuksia noudetaan tietovarastosta (katso kohta Nouto tietovarastoista), myös ne sijoitetaan näihin alihakemistoihin.

Tämä hakemisto voi olla sama kuin koonnin kokoonpanohakemisto tai jokin muu hakemisto. Voi olla hyödyllistä käyttää erillistä hakemistoa erityisesti, jos koontikokoonpanoa säilytetään CVS-muodossa eikä siihen haluta sekoittaa luotuja koontikohteita.

Alkuperäiset ominaisuudet

Voit määrittää perustuoteominaisuuden koonnin muokkaamalla koontikokoonpanon build.properties-tiedostoa ja määrittämällä seuraavat ominaisuudet:

Edellinen PDE-/koontiversio edellytti myös allElements.xml-tiedostoa, jota ei enää tarvita versiossa 3.4. allElements.xml-tiedostoa voi edelleen käyttää, mutta sitä tarvitaan vain mukautettaessa koonnin tiettyjä osia. Katso kohta Näyttöpäätteettömän koonnin mukautus.

Koonnin ajo

Koonti ajetaan org.elipse.ant.core.antRunner-sovelluksen avulla. Kun Eclipse-ympäristö kutsutaan tämän sovelluksen avulla koonnin suoritusta varten, komentorivillä on määritettävä seuraavat kaksi argumenttia:

Aja antRunner-sovellus seuraavan komennon avulla:


java -jar <eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>

Kun koonti on valmis, saat tuloksen koontihakemiston kansioon I.TestBuild (kyseisen nimen kokoonpanon voi määrittää määrittämällä buildLabel-ominaisuuden).

Kehittyneet skenaariot

Jos koontia pitää mukauttaa edelleen, esimerkiksi noutamalla kohteita tietovarastoista, lisätietoja on Kehittyneen PDE-koonnin ohjeaiheissa.