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ä.
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-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.
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.
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:
-buildfile=</path/to/build.xml>: Tämä on polku PDE-koonnin toimittamaan build.xml-tiedostoon. Se sijaitsee org.eclipse.pde.build/scripts-hakemistossa. Tämä on koko koontiprosessia ohjaava koontikomentosarja.-Dbuilder=</path/to/configuration folder>: Tämä on polku koontikokoonpanon kansioon.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).
Jos koontia pitää mukauttaa edelleen, esimerkiksi noutamalla kohteita tietovarastoista, lisätietoja on Kehittyneen PDE-koonnin ohjeaiheissa.