Fordítási környezet beállítása

Alapértelmezésben a kötegek az összeépítés futtatásához használt JRE környezettel lesznek lefordítva, és a forrás és cél szintek 1.3 és 1.2 szintre lesznek beállítva.

A PDE összeépítés kötegenként be tudja állítani a fordítás során használt JRE környezetet.   Ennek kihasználása érdekében először meg kell adni a PDE összeépítésnek, hogy milyen JRE környezetek érhetők el.   Az összeépítési konfiguráció build.properties fájljában állítson be a telepített JRE környezetekre mutató tulajdonságokat.  Az org.eclipse.pde.build/templates/headless-build könyvtárban található sablon build.properties fájl tartalmazza a környezetek listáját, ami megjegyzéssé van alakítva.   Egyszerűen csak távolítsa el azoknak a tulajdonságoknak a megjegyzésjelét, amelyekhez rendelkezik JRE környezettel, és az értékükben állítsa be a betöltési osztályútvonalon lévő jar fájlokat.   Például a következő tulajdonság beállítása esetén:

J2SE-1.5=C:/Java/1.5/jre/lib/rt.jar;C:/Java/1.5/jre/lib/jsse.jar

Ez Java 1.5 környezetet igénylő kötegeket fog fordítani az rt.jar és jsse.jar fájlokkal.  A tulajdonságok neveinek meg kell egyezni a környezetek neveivel, amiket a PDE összeépítés ismer.    PDE összeépítés automatikusan beállítja a forrás és cél szintet mindegyik környezethez.   A PDE összeépítés által ismert környezetek és a hozzájuk társított forrás/cél szintek:

Környezet
Forrás
Cél
CDC-1.0/Foundation-1.0
1.3
1.1
CDC-1.1/Foundation-1.1
1.3
1.2
OSGi/Minimum-1.0
1.3
1.1
OSGi/Minimum-1.1
1.3
1.2
JRE-1.1
1.1
1.1
J2SE-1.2
1.2
1.1
J2SE-1.3
1.3
1.1
J2SE-1.4
1.3
1.2
J2SE-1.5
1.5
1.5
JavaSE-1.6
1.6
1.6
PersonalJava-1.1
1.1
1.1
PersonalJava-1.2
1.1
1.1
CDC-1.0/PersonalBasis-1.0
1.3
1.1
CDC-1.0/PersonalJava-1.0
1.3
1.1
CDC-1.1/PersonalBasis-1.1
1.3
1.2
CDC-1.1/PersonalJava-1.1
1.3
1.2

Környezet kiválasztása a csomaghoz

Két beállítás van hatással a csomag fordításához használt környezetre.   Az egyik a Bundle-RequiredExecutionEnvironment leíró fejléc.   A fejléc azon környezetek listája, amelyek alatt a csomag futni képes.  A csomagnak csak olyan metódusokat szabad használnia, amelyek a felsorolt környezetekben érvényesek.  A fordítási környezetnek a lehető legjobban meg kell egyeznie a futtatási környezettel.

A második beállítás a jre.compilation.profile tulajdonság a csomag build.properties fájljában.  A tulajdonság értékének a csomag fordításához használandó preferált környezetet kell megadni, ha a Bundle-RequiredExecutionEnvironment lista nem megfelelő.

A két beállítás együttesen egy listát alkot, amely előbb a jre.compilation.profile tulajdonságban megadott környezeteket tartalmazza, azután pedig a Bundle-RequiredExecutionEnvironment fejlécben megadottakat.  A csomag fordításához a listában szereplő első elérhető környezet kerül felhasználásra.

Például:
<buildDirectory>/plugins/bundleA/
META-INF/manifest.mf: Bundle-RequiredExecutionEnvironment: CDC-1.0/Foundation-1.0, J2SE-1.3
build.properties:  jre.compilation.profile=J2SE-1.4

<buildConfiguration>/
build.properties:  J2SE-1.3=C:/Java1.3/jre/lib/rt.jar;C:/Java1.3/jre/lib/i18n.jar
J2SE-1.4=C:/Java1.4/jre/lib/rt.jar;C:/Java1.4/jre/lib/jsse.jar

A fenti beállításban a figyelembe vett környezetek (sorrendben): J2SE-1.4,  CDC-1.0/Foundation-1.0, J2SE-1.3.  A csomag futtatható CDC/Foundation és J2SE-1.3 környezetben, de valami miatt  J2SE-1.4 környezetben kell fordítani.  Ebben az esetben a J2SE-1.4 környezetet kell beállítani az összeépítési konfigurációban, hogy az legyen az első a környezetek listájában, és azzal legyen lefordítva a csomag.   A példában használt forrás és cél szintek 1.3 és 1.2.  Ha az összeépítési konfiguráció a J2SE-1.4 helyett csak a J2SE-1.3 környezetet határozná meg, akkor a J2SE-1.3 lenne az egyetlen környezet a listában, amelyikhez rendelkezésre áll JRE, ezért az kerülne felhasználásra a köteg fordításához.   Ebben az esetben a forrás és cél szint 1.3 és 1.1 lenne.

Fordítási értékek explicit beállítása

Ha valamiért a környezetek használata fent vázolt módon nem a kívánt eredményt hozza, akkor lehetőség van arra, hogy egy köteghez explicit módon felsorolja a beállításokat.   Például egy J2SE-1.4 környezet használó köteg esetén a forrás és a cél szintnek is 1.4-nek kell lennie az alapértelmezett 1.3 és 1.2 helyett.

A Java forrás és cél szintek explicit beállításához a kötegnek a javacSource és javacTarget tulajdonságokat kell beállítania a build.properties fájljában.   Ezek a tulajdonságok felül fogják bírálni a környezeti beállításokból származtatott beállításokat.

Hasonlóképp, a bootClasspath tulajdonság beállítása a köteg build.properties fájljában felül fogja bírálni a jar fájlokat, amelyekkel a köteg fordítása történik.