Fordító beállítások
A PDE összeépítés számos beállítást támogat a fordító vezérléséhez az
egyéni bedolgozókhoz. A forrás- és célszintek, valamint a
rendszerbetöltési osztályútvonal (bootclasspath) beállításaival
kapcsolatban tekintse meg a
"Fordítási környezet beállítása"
című részt.
Figyelmeztetések és hibák
A PDE összeépítés lehetővé teszi egyéni fordítási figyelmeztetések és hibák megadását a build.properties fájlban. Ezek függvénytáranként
állíthatók be (egy bedolgozó több jar függvénytárat is tartalmazhat), a
javacWarnings.<library> és
javacErrors.<library> beállításokkal. E tulajdonságok értékei a "-warn:..." szakaszban adhatók meg a Kötegelt fordító használata oldalon (a Java fejlesztés felhasználói kézikönyvéből).
Példa:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Figyelmeztetések és hibák a projekt beállításaiból
A JDT projekt beállításai most felhasználhatók a PDE összeépítés során
is. Maga a PDE összeépítés nem tudja olvasni a beállítási fájlokat,
de képes átadni azokat a JDT fordítónak, ami viszont megérti őket.
Ennek használatához a bedolgozónak a build.properties fájlban meg kell
határoznia a javacProjectSettings tulajdonságot. Az érték a
következő lehet:
- javacProjectSettings=true : Az alapértelmezett
.settings/org.eclipse.jdt.core.prefs beállítási fájlban
megadott projekt beállítások használata.
- javacProjectSettings=path/to/jdt.prefs : A megadott
beállítási fájl használata.
Elképzelhető, hogy bizonyos projektek más figyelmeztetési és hiba
beállításokat szeretnének használni a munkaterületen, mint egy releng
összeépítésben. Ez lehetővé tesz egy sokkal kényelmesebb
módszert a beállítások megadásához, mint a "javacWarnings.<library>"
tulajdonság.
Fájlkódolás
A PDE összeépítés függvénytáranként, mappánként vagy fájlonként
egyéni fájlkódolásokat képes fogadni.
- javacDefaultEncoding.<library>
- beállítja az adott könyvtár fordításakor használandó alapértelmezett kódolást.
- javacCustomEncodings.<library> - az adott könyvtár
fordításakor használandó elérési utak és kódolások vesszővel elválasztott listája. Ha
egy mappát ad meg, akkor a kódolás az adott mappában található minden
elemre vonatkozik. Ha egy fájlt ad meg, akkor a kódolás csak az adott
fájlra érvényes.
Példa:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-2]
Egyéni fordító argumentumok
A köteg build.properties fájljában található compilerArg
tulajdonsággal most kötegenként adhatók meg egyéni fordító
beállítások. Ez a tulajdonság az összeépítő konfigurációban lévő
compilerArg
tulajdonsághoz hasonló, kivéve, hogy csak egyetlen bedolgozóra
vonatkozik, nem az összesre. Az itt megadott argumentumok a használt
fordítótól függnek. A JDT fordító argumentumainak listáját
itt
tekintheti meg.
Fordító beállítások elsőbbsége
A fordító beállításait több módon is megadhatja. Általános szabályként a
beállítások elsőbbségi sorrendje az alábbiak szerint alakul:
- A javacDefaultEncoding.<library> elsőbbséget élvez egy egyéni
-encoding parancssori paraméterrel szemben.
- Általános paraméterek esetén a fordító parancssorában később
megjelenő paraméter felülbírálja a korábban megadott paramétert. A JDT
számára megadott paraméterek sorrendje a következő:
- A compilerArg tulajdonság az összeépítő
konfigurációjából. (Minden kötegre érvényes.)
- A compilerArg tulajdonság a bedolgozó build.properties
fájljából.
- A javacProjectSettings beállítással megadott fordító beállítási
fájl.
- Az előállított fordító argumentum fájl
(javaCompiler.<library>.args), amely a fájlkódolásokat,
javacWarnings, javacErrors tulajdonságokat és hozzáférési
szabályokat tartalmazza.
Egyéni fordító használata
A compilerAdapter tulajdonság beállításával megadható, hogy
egy köteg egy egyéni fordítót használjon. A megadott fordító adapternek elérhetőnek kell lennie az Ant környezetben. Az alapértelmezésben használt JDT fordító az org.eclipse.jdt.core.JDTCompilerAdapter. Az
Aspect J vagy Groovy kötegekhez például indokolt egy alternatív
fordító megadása. Az egyéni fordító adaptert megadó kötegekhez szükség
lehet az alábbi tulajdonságok némelyikének megadása is:
- sourceFileExtensions : A forrásként tekintendő kiterjesztések
listája (például *.java, *.aj, *.groovy).
- compilerAdapter.useLog : A "-log" paramétert át kell-e adni a
fordítónak
- compilerAdapter.useArgFile : Az előállított
javaCompiler.<library>.args argumentum fájlt át kell-e adni. (Ez
tartalmazza a hozzáférési szabályokat, a fájlkódolásokat és
figyelmeztetési/hiba szinteket).