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:
- baseLocation: egy eclipse
telepítés helye, amely tartalmazza az összes előre összeépített
szolgáltatást és bedolgozót a features/ és plugins/
alkönyvtárakban.
- baseos: adja meg a baseLocation által
megadott eclipse operációs rendszerét.
- basews: adja meg a baseLocation által
megadott eclipse ablakkezelő rendszerét.
- basearch: adja meg a baseLocation által
megadott eclipse architektúráját.
- buildDirectory: a
könyvtár, amelyikben az összeépítés történni fog. Állítsa be a
korábba létrehozott összeépítési könyvtár teljes elérési útját.
- configs: sorolja fel a
konfigurációkat, amelyekhez össze kívánja építeni a szolgáltatást.
Eltávolíthatja a megadott konfigurációk megjegyzésjelét (ügyeljen a
sortörésekre). Ha az összeépíteni kívánt szolgáltatás platformfüggetlen,
akkor ezt a tulajdonságot nem kell beállítani, vagy beállítható
*,*,* értékre.
- archivePrefix: a könyvtár
neve, amelyikbe a szolgáltatás ki lesz csomagolva a lemezen.
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:
-buildfile=</path/to/build.xml>
: Ez a
PDE összeépítés á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 fá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>/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.