Szolgáltatások összeépítése

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.

Alapszintű beállítás

Az összeépítés beállításának első lépése a könyvtár létrehozása, ahol az összeépítés történni fog. Ezt a könyvtárat összeépítési könyvtárnak nevezik, és ez fogja tartalmazni az összeépítendő bedolgozókat és szolgáltatásokat, valamint az összes előállított műterméket. Ezután másolja át a bedolgozókat és a szolgáltatásokat a "plugins" és "features" alkönyvtárakba. A szolgáltatás mappájának tartalmaznia kell az összeépíteni kívánt szolgáltatást.

Az összeépítés beállításának második lépése a sablon build.properties fájl átmásolása az org.eclipse.pde.build/templates/headless-build könyvtárból egy új könyvtárba, ami az összeépítés konfigurációs könyvtára lesz (más néven konfigurációs könyvtár). Szerkessze az átmásolt build.properties fájlt és állítsa be a következő tulajdonságokat:

Az összeépítendő elemek vezérlése: allElements.xml

Másolja át az allElements.xml fájlt az org.eclipse.pde.build/templates/headless-build könyvtárból a konfigurációs könyvtárba. Ez a fájl mondja meg a PDE összeépítésnek, hogy melyik szolgáltatást kívánja összeépíteni.   A fájl kétféle célt tartalmaz:   az allElementsDelegator célt, ami az összeépíteni kívánt szolgáltatást adja meg, és az összeállítási célokat, amelyeket az egyes konfigurációk összeállításához kell meghívni.   Az allElementsDelegator értéke az org.foo.Feature szolgáltatáshoz:
 	<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="feature" />
<property name="id" value="org.foo.Feature" />
</ant>
</target>
Az összeállítási célok segítségével konfigurációnként megadhatja a végleges archívum nevét.   Mindegyik összeépített konfigurációhoz külön cél szükséges.   Ha például az org.foo.Feature szolgáltatást építi össze Windows rendszerhez (a configs értéke win32, win32, x86), akkor a következő célt kell megadni:
<!--Target for assembling  os=win32, ws=win32, arch=x86 -->
<target name="assemble.org.foo.Feature.win32.win32.x86">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}/">
</target>
Platformfüggetlen konfiguráció összeépítése esetén (a configs nincs beállítva, vagy értéke *,*,*) a következőhöz hasonló célt kell megadni:
<!--The platform independent assemble target-->
<target name="assemble.org.foo.Feature">
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
</target>

Az összeépítés futtatása

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:
Futtassa az antRunner alkalmazást a következő paranccsal:
java -jar <eclipse_telepítés>/startup.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipse_telepítés>/plugins/org.eclipse.pde.build_<verzió>/scripts/build.xml> -Dbuilder=<az összeépítés konfigurációs mappájának elérési útja>
Az összeépítés befejeződése után az eredményt az összeépítési könyvtárban találja az I.TestBuild nevű mappában (a nevet a buildLabel tulajdonsággal állíthatja be).

Speciális példahelyzetek

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.