Kompilatoralternativer
PDE/Build støtter en rekke alternativer for å styre kompilatoren for de enkelte plugin-modulene. For innstillinger knyttet til
kilde- og målnivåer og bootclasspath, se "Definere kompileringsmiljøet.
Advarsler og feil
PDE/Build gjør det mulig å oppgi egendefinerte advarsler og feil i filen build.properties. Disse kan defineres per bibliotek (en enkelt plugin-modul kan
inneholde flere jar-biblioteker) med alternativene javacWarnings.<library> og javacErrors.<library>. Verdiene for disse egenskapene oppgis i seksjonen "-warn:..." på siden bruke satsvis kompilator (fra brukerveiledningen for Java-utvikling).
Eksempel:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Advarsler og feil fra prosjektpreferanser
JDT-prosjektpreferansene kan nå også brukes under PDE/Build. PDE/Build selv kan ikke lese preferansefilene, men kan sende dem til
JDT-kompilatoren, som forstår dem.
Hvis en plugin-modul skal bruke dette, må den oppgi egenskapen javacProjectSettings i filen build.properties. Verdien må være:
- javacProjectSettings=true: Bruk prosjektinnstillingen som er oppgitt i standard preferansefil .settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=path/to/jdt.prefs: Bruk oppgitt preferansefil.
Noen prosjekter kan ønske å bruke forskjellige innstillinger for advarsler og feil i arbeidsområdet enn for en utgaveutviklingsbygging. Dette er en mer egnet metode for å oppgi disse innstillingene sammenliknet med egenskapen "javacWarnings.<library>".
Filkoding
PDE/Build kan godta egendefinert filkoding per bibliotek, mappe eller fil.
- javacDefaultEncoding.<library>
- Definerer standardkodingen som skal brukes ved kompilering av det gitte biblioteket.
- javacCustomEncodings.<library>
- En kommadelt liste over baner og kodinger som skal brukes ved kompilering av det
gitte biblioteket. Når du oppgir en mappe, blir kodingen brukt for alt mappen inneholder. Når du oppgir en fil, blir kodingen brukt bare for den filen. Eksempel:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Argumenter for egendefinert kompilator
Du kan nå oppgi argumenter for egendefinert kompilator per bunt ved hjelp av egenskapen compilerArg i buntens build.properties-fil. Denne egenskapen tilsvarer egenskapen compilerArg i byggerkonfigurasjonen, bortsett fra at den bare påvirker en enkelt plugin-modul i stedet for
alle plugin-moduler. Argumentene er avhengig av hvilken kompilator du bruker. JDT-kompilatorargumentene er beskrevet her.
Prioritet for kompilatoralternativer
Du kan oppgi forskjellige kompilatoralternativer på flere måter. Generelt er prioriteten for alternativer følgende:
- javacDefaultEncoding.<library> har høyere prioritet enn et egendefinert -encodingkommandolinjealternativ.
- For generelle alternativer overstyrere et alternativ som er oppgitt senere på kompilatorkommandolinjen,
et alternativ som er oppgitt tidligere. Alternativene gis til JDT i følgende rekkefølge:
- compilerArg-egenskapen fra byggerkonfigurasjonen. (Påvirker alle bunter.)
- compilerArg-egenskapen fra denne plugin-modulens build.properties.
- Kompilatorpreferansefilen oppgitt med javacProjectSettings.
- Den genererte kompilatorargumentfilen (javaCompiler.<library>.args) som inneholder filkodinger, javacWarnings, javacErrors og tilgangsregler.
Bruke en egendefinert kompilator
En bunt kan nå bruke en egendefinert kompilator ved at egenskapen compilerAdapter defineres. Den oppgitte kompilatoradapteren må være tilgjengelig i ant-miljøet. JDT-kompilatoradapteren
som brukes som standard, er org.eclipse.jdt.core.JDTCompilerAdapter. En spesiell årsak til å oppgi en alternativ kompilator, er hensynet til Aspect J- eller Groovy-bunter. Bunter som oppgir en egendefinert
kompilatoradapter, må kanskje også oppgi noen av disse egenskapene:
- sourceFileExtensions: En liste over filtyper som skal anses som kilde (for eksempel *.java, *.aj, *.groovy).
- compilerAdapter.useLog: Oppgir om "-log"-argumentet skal sendes til kompilatoren.
- compilerAdapter.useArgFile: Oppgir om den genererte argumentfilen javaCompiler.<library>.args skal sendes. (Inneholder tilgangsregler, filkodinger og advarsels-/feilnivåer.)