A PDE összeépítés infrastruktúrája automatizálja a szolgáltatások összeépítését. Az ilyen összeépítéshez szükséges beállítások nagy részét a PDE összeépítés által biztosított sablon build.properties fájl néhány módosításával elvégezheti. A következő szakasz egy egyszerű összeépítés beállítását írja le, azt feltételezve, hogy az összeépítendő szolgáltatás által hivatkozott minden bedolgozó és szolgáltatás (összeépítendő és előre összeépített) már helyben elérhető a lemezen.
Az első lépés egy összeépítés beállításakor az összeépítési konfiguráció könyvtárának létrehozása. Ez az a könyvtár, amely a megjelenítés nélküli összeépítés vezérlő és személyre szabó fájlokat tárolja.
Az összeépítést vezérlő fő fájl a felső szintű összeépítősi konfigurációs build.properties fájl. Egy új összeépítés beállításakor másolja át a fájlt az org.eclipse.pde.build kötegből az Eclipse telepítésbe, amelyet az összeépítés futtatásához fog használni. A sablon fájl az org.eclipse.pde.build/templates/headless-build/build.properties alatt található.
Erre a könyvtárra hivatkoznak builder tulajdonságok, amelyeket általában az ant parancssorból lehet beállítani.
A buildDirectory tulajdonság megadja a könyvtárat, amelybe a PDE összeépítés bedolgozó elő fogja állítani a parancsfájlokat és végrehajtja a tényleges összeépítést. Az összeépítés alatt álló bedolgozókat és szolgáltatásokat a ${buildDirectory}/plugins és ${buildDirectory}/features alkönyvtárakban kell elhelyezni. Ha a kötegek és szolgáltatások lehívása egy lerakatból történik (lásd: Lehívás lerakatokból), akkor ezek is ide fognak kerülni.
Ez a könyvtár megegyezhet az összeépítési konfiguráció könyvtárával, de lehet egy eltérő könyvtár is. Célszerű lehet egy másik könyvtárat használni, különösen akkor, ha az összeépítési konfigurációt egy CVS lerakatban tárolja, és nem kívánja teleszemetelni azt az előállított összeépítési műtermékekkel.
Egy alapszintű szolgáltatás összeépítés beállításához szerkesztenie kell az összeépítési konfiguráció build.properties fájlt, és be kell állítania a következő tulajdonságokat:
A PDE összeépítés bedolgozó korábbi változatában szükség volt egy allElements.xml fájlra - ez a 3.4 kiadásban már nem szükséges. Az allElements.xml fájlt továbbra is használhatja, de csak akkor kell megadni, ha személyre szeretné szabni az összeépítés bizonyos aspektusait. További részletekért tekintse meg a Megjelenítés nélküli összeépítés személyre szabása című részt.
Az összeépítés futtatásához az org.elipse.ant.core.antRunner alkalmazást fogja használni. Amikor az Eclipse rendszert ezzel az alkalmazással hívja meg összeépítéshez, akkor két paramétert kell beállítani a parancssorban:
-buildfile=</path/to/build.xml>: Ez a
PDE összeépítés bedolgozó által biztosított build.xml fájl elérési útja. A
fájl az org.eclipse.pde.build/scripts könyvtárban található. Ez az
összeépítési parancsfájl vezérli a teljes összeépítési folyamatot.-Dbuilder=</path/to/configuration folder>:
Ez az összeépítés konfigurációs mappájának elérési útja.Futtassa az antRunner alkalmazást a következő paranccsal:
java -jar
<eclipse_telepítés>/plugins/org.eclipse.equinox.launcher_<verziószám>.jar
-application org.eclipse.ant.core.antRunner -buildfile
<<eclipse_telepítés>/plugins/org.eclipse.pde.build_<verziószám>/scripts/build.xml>
-Dbuilder=<az összeépítési konfiguráció mappa útvonala>Az összeépítés befejeződése után az eredményt az I.TestBuild nevű mappa build könyvtárában találja (a mappa nevét a buildLabel tulajdonsággal állíthatja be).
Ha az összeépítést ennél jobban személyre szeretné szabni, például ha lerakatból kíván lehívni, akkor további információkért tanulmányozza a További PDE összeépítési témaköröket.