Opties van het compileerprogramma
PDE Build ondersteunt een aantal opties voor het besturen van het compileerprogramma voor afzonderlijke plugins. Voor instellingen met betrekking tot bron- en doelniveaus en bootclasspath raadpleegt u "Compilatie-omgeving instellen".
Fouten en waarschuwingen
Met PDE/Build kunt u aangepaste compilatiewaarschuwingen en -foutberichten opgeven in het bestand build.properties. U kunt deze instellen per bibliotheek (een enkele plugin kan meerdere JAR-bibliotheken bevatten), met de opties javacWarnings.<bibliotheek> en javacErrors.<bibliotheek>. De waarden voor deze eigenschappen worden aangegeven in de sectie "-warn:..." op de pagina using the batch compiler (in de handleiding voor Java-ontwikkeling).
Voorbeeld:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Waarschuwingen en fouten van projectvoorkeuren
De JDT-projectvoorkeuren kunnen nu ook worden gebruikt voor PDE Build. PDE Build zelf is niet in staat de voorkeurenbestanden te lezen, maar kan deze wel doorgeven aan het JDT-compileerprogramma dat er wel mee om kan gaan.
Hiervoor moet voor een plugin de eigenschap javacProjectSettings zijn ingesteld in het bestand build.properties. De waarde moet zijn:
- javacProjectSettings=true : werken met de projectinstelling die is aangegeven in het standaard voorkeurenbestand .settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=path/to/jdt.prefs : werken met het opgegeven voorkeurenbestand.
Voor sommige projecten wordt in het werkgebied gewerkt met andere instellingen voor fouten en waarschuwingen dan voor een releng-build. Hierdoor kunt u deze instellingen makkelijker opgegeven dan met de eigenschap "javacWarnings.<library>".
Bestandscodering
PDE Build accepteert aangepaste bestandscoderingen, per bibliotheek, map of bestand.
- javacDefaultEncoding.<bibliotheek>: de standaardcodering voor het compileren van de opgegeven bibliotheek.
- javacCustomEncodings.<bibliotheek> - een door komma's gescheiden lijst van paden en coderingen voor het compileren van de opgegeven bibliotheek. Als u een map opgeeft, wordt de codering gebruikt voor alles wat in die map aanwezig is. Als u een bestand opgeeft, wordt de codering alleen gebruikt voor dat bestand. Voorbeeld:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Aangepaste compileerargumenten
Aangepaste compileerargumenten kunt u nu per bundel opgeven met de eigenschap compilerArg in het bestand build.properties van de bundel. Deze eigenschap komt overeen met de eigenschap compilerArg in de builderconfiguratie, met dit verschil dat deze werkt met een enkele plugin in plaats van met alle plugins. De specifieke argumenten zijn afhankelijk van het compileerprogramma dat wordt gebruikt. De argumenten voor het JDT-compileerprogramma vindt u hier.
Volgorde van compileeropties
Er zijn een aantal verschillende manieren om de verschillende compileeropties op te geven. In het algemeen worden opties in de volgende volgorde verwerkt:
- javacDefaultEncoding.<bibliotheek> heeft voorrang op een aangepaste -encoding opdrachtregeloptie.
- Voor algemene opties geldt dat een optie die later voorkomt op de opdrachtregel voor het compileerprogramma voorrang heeft op opties die eerder zijn opgegeven. De opties worden met de volgende volgorde aangeboden aan de de JDT:
- De compilerArg -eigenschap uit de builder-configuratie. (Heeft effect op alle bundels).
- De compilerArg -eigenschap uit build.properties van deze plugin.
- Het voorkeurenbestand van het compileerprogramma dat is opgegeven met javacProjectSettings.
- Het gegenereerde bestand met compileerargumenten (javaCompiler.<library>.args) met daarin de bestandscoderingen, javacWarnings, javacErrors en toegangsregels.
Werken met een aangepast compileerprogramma
Door de eigenschap compilerAdapter in te stellen kan een bundel nu werken met een compileerprogramma op maat. De opgegeven compileeradapter moet beschikbaar zijn in de Ant-omgeving. De JDT-compileeradapter die standaard wordt gebruikt, is org.eclipse.jdt.core.JDTCompilerAdapter. Eén reden in het bijzonder voor het opgeven van een ander compileerprogramma is voor Aspect J- of Groovy-bundels. Voor bundels die een aangepaste compileeradapter aangeven, moeten mogelijk ook enkele van de volgende eigenschappen worden opgegeven:
- sourceFileExtensions : Een lijst van extensies die kunnen worden beschouwd als bron. (bijv. *.java, *.aj, *.groovy).
- compilerAdapter.useLog : Of het argument "-log" al dan niet moet worden doorgegeven aan het compileerprogramma
- compilerAdapter.useArgFile : Of het gegenereerde argumentenbestand javaCompiler.<bibliotheek>.args al dan niet moet worden doorgegeven. (Bevat toegangsregels, bestandscoderingen en niveaus van waarschuwingen en fouten).