Kompilatoralternativ
PDE/Build hanterar en rad alternativ som styr kompilatorn för enskilda insticksprogram. För inställningar för käll- och målnivån och bootclasspath, se "Ange kompileringsmiljön".
Varningar och fel
PDE/Build tillåter att du anger anpassade kompileringsvarningar och -fel i filen build.properties. Inställningar kan göras på biblioteksnivå (ett enstaka insticksprogram kan innehålla flera JAR-bibliotek) med alternativen javacWarnings.<library> och javacErrors.<library>. Värdena för dessa egenskaper anges i avsnittet "-warn:..." på sidan använda batchkompilatorn (från Java-utvecklingshandboken).
Exempel: javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Varningar och fel från projektinställningar
JDT-projektinställningarna kan nu också användas under PDE/Build. PDE/Build i sig kan inte läsa inställningsfiler men kan överföra dem till JDT-kompilatorn som förstår dem.
För att använda detta ska du ange egenskapen javacProjectSettings i filen build.properties i insticksprogrammet. Värdet ska vara följande:
- javacProjectSettings=true: Använd projektinställningen som angetts i egenskapsfilen .settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=path/to/jdt.prefs: Använd den angivna egenskapsfilen.
För vissa projekt kanske du vill använda andra varnings- och felinställningar i arbetsytan än för ett releng-bygge. Det ger en mer praktisk metod för att ange inställningar än egenskapen "javacWarnings.<library>". Filkodning
PDE/Build kan ta emot filkodningar som anpassats per bibliotek, mapp eller fil.
- javacDefaultEncoding.<library>
- standardkodning vid kompilering av det aktuella biblioteket.
- javacCustomEncodings.<library>
- en kommaavgränsad lista med sökvägar och kodningar som ska användas vid kompileringen av det aktuella biblioteket. När du anger en mapp används kodningen för allt som finns i den mappen. När du anger en fil används kodningen bara för den filen. Exempel:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Anpassade kompileringsargument
Anpassade kompileringsargument kan nu anges per paket med egenskapen compilerArg i filen build.properties för paketet. Egenskapen liknar egenskapen compilerArg i byggkonfigurationen med den skillnaden att den bara påverkar ett enda insticksprogram i stället för alla insticksprogram. De specifika argumenten här beror på den kompilator som används. JDT-kompilatorargumenten anges här.
Företrädesordning för kompileringsalternativ
Det finns flera sätt att ange kompileringsalternativ. Som allmän regel används följande företrädesordning:
- javacDefaultEncoding.<library> har företräde framför ett anpassat kommandoalternativ för -encoding.
- För allmänna alternativ ersätter ett alternativ som kommer senare i kommandoraden alternativ som angetts tidigare för kompileringen. Alternativen visas för JDT i följande ordning:
- Egenskapen compilerArg från byggkonfigurationen. (Påverkar alla paket.)
- Égenskapen compilerArg från insticksprogrammets build.properties.
- Den inställningsfil för kompileringen som anges med javacProjectSettings.
- Den genererade argumentfilen för kompileringen (javaCompiler.<library>.args) som innehåller filkodningar javacWarnings, javacErrors och åtkomstregler.
Använda en anpassad kompilator
Ett paket kan du använda en anpassad kompilator om du anger egenskapen compilerAdapter. Den angivna kompilatoradaptern måste vara tillgänglig i ant-miljön. JDT-kompilatoradaptern som används som standard är org.eclipse.jdt.core.JDTCompilerAdapter. En orsak för att ange en alternativ kompilator är för Aspect J- eller Groovy-paket. I paketen som anger en anpassad kompilatoradapter kan du också behöva ange vissa av följande egenskaper:
- sourceFileExtensions: En lista över tillägg som ska betraktas som källa. (t.ex. *.java, *.aj, *.groovy).
- compilerAdapter.useLog: Om argumentet "-log" ska överföras till kompilatorn.
- compilerAdapter.useArgFile: Om de genererade argumentfilen javaCompiler.<library>.args ska överföras. (Innehåller åtkomstregler, filkodningar och varnings-/felnivåer.)