Compileroptionen
PDE/Build unterstützt eine Reihe von Optionen zur Steuerung des Compilers für einzelne Plug-ins. Informationen zu Einstellungen im Zusammenhang mit
Quellen- und Zielebenen sowie dem Bootklassenpfad finden Sie im Abschnitt 'Kompilierungsumgebung konfigurieren'.
Warnungen und Fehler
PDE/Build ermöglicht das Angeben von angepassten Compilerwarnungen und -fehler in der Datei 'build.properties'. Diese können pro Bibliothek konfiguriert werden
(ein einzelnes Plug-in kann mehrere JAR-Bibliotheken enthalten), indem Sie die Optionen
javacWarnings.<bibliothek> und javacErrors.<bibliothek> verwenden. Die Werte für diese Eigenschaften werden im Abschnitt '-warn:...' auf der Seite Verwendung des Stapelcompilers (in der Veröffentlichung 'Java-Entwicklung - Benutzerhandbuch') angegeben.
Beispiel:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Warnungen und Fehler aus Benutzervorgaben für Projekte
Die Benutzervorgaben für JDT-Projekte können jetzt auch mit PDE/Build verwendet werden. PDE/Build selbst ist nicht in der Lage, die Benutzervorgabendateien
zu lesen, kann sie aber an den JDT-Compiler übergeben, der mit ihnen umgehen kann.
Hierzu muss ein Plug-in die Eigenschaft javacProjectSettings in seiner Datei 'build.properties' angeben. Der Wert sollte wie folgt aussehen:
- javacProjectSettings=true : Verwendet die Projekteinstellung, die in der standardmäßigen Benutzervorgabendatei
.settings/org.eclipse.jdt.core.prefs angegeben ist.
- javacProjectSettings=pfad/zu/jdt.prefs : Verwendet die angegebene Benutzervorgabendatei.
Bei einigen Projekten ist es unter Umständen wünschenswert, andere Einstellungen für Warnungen und Fehler im Arbeitsbereich zu verwenden als in einem
RelEng-Build. Im Vergleich zur Eigenschaft 'javacWarnings.<bibliothek>' ermöglicht dies ein komfortableres Verfahren zum Angeben dieser Einstellungen.
Dateicodierung
PDE/Build kann angepasste Dateicodierungen pro Bibliothek, pro Ordner oder pro Datei akzeptieren.
- javacDefaultEncoding.<library> - Legt die Standardcodierung fest, die zum Kompilieren der angegebenen Bibliothek verwendet werden soll.
- javacCustomEncodings.<library> - Eine durch Kommas getrennte Liste der Pfade und Codierungen, die zum Kompilieren der angegebenen Bibliothek verwendet werden soll. Bei Angabe eines Ordners
wird die Codierung für den gesamten Inhalt des Ordners verwendet. Bei Angabe einer Datei wird die Codierung lediglich für die betreffende Datei verwendet. Beispiel:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Angepasste Compilerargumente
Angepasste Compilerargumente können jetzt pro Produktpaket angegeben werden. Hierfür wird die Eigenschaft compilerArg in der Datei 'build.properties' des
betreffenden Produktpakets verwendet. Diese Eigenschaft ähnelt der Eigenschaft
compilerArg in der Builderkonfiguration mit der Ausnahme, dass sie sich lediglich auf ein einzelnes Plug-in und
nicht auf alle Plug-ins auswirkt. Die jeweiligen Argumente hier hängen davon ab, welcher Compiler verwendet wird. Die Argumente des JDT-Compilers werden hier aufgelistet.
Vorrangstellung bei den Compileroptions
Die verschiedenen Compileroptionen können auf unterschiedliche Weise angegeben werden. Generell gilt für Optionen die folgende Rangordnung:
- 'javacDefaultEncoding.<bibliothek>' hat Vorrang vor einer angepassten Befehlszeilenoption des Typs -encoding.
- Bei allgemeinen Optionen überschreibt eine Option, die später in der Compilerbefehlszeile angegeben wird, die früher angegebenen Optionen. Die Optionen werden
dem JDT in der folgenden Reihenfolge bereitgestellt:
- Die Eigenschaft compilerArg aus der Builderkonfiguration. (Wirkt sich auf alle Produktpakete aus.)
- Die Eigenschaft compilerArg aus der Datei 'build.properties' dieses Plug-ins.
- Die Benutzervorgabendatei für Compiler, die mit javacProjectSettings angegeben wird.
- Die generierte Compilerargumentdatei (javaCompiler.<bibliothek>.args) mit den Dateicodierungen, javacWarnings, javacErrors und Zugriffsregeln.
Angepassten Compiler verwenden
Ein Produktpaket kann jetzt einen angepassten Compiler verwenden, indem die Eigenschaft compilerAdapter gesetzt wird. Der angegebene
Compiler-Adapter muss in der Ant-Umgebung verfügbar sein. Der standardmäßig verwendete JDT-Compiler-Adapter ist
org.eclipse.jdt.core.JDTCompilerAdapter. Ein besonderer Grund für die Angabe eines alternativen Compilers ist beispielsweise die Verwendung von
Aspect J- oder Groovy-Produktpaketen. Produktpakete, in denen ein angepasster Compiler-Adapter angegeben wird, müssen möglicherweise auch einige der folgenden
Eigenschaften angeben:
- sourceFileExtensions : Eine Liste der Erweiterungen, die als Quelle gelten sollen (z. B. *.java, *.aj, *.groovy).
- compilerAdapter.useLog : Angabe, ob das Argument '-log' an den Compiler übergeben werden soll oder nicht.
- compilerAdapter.useArgFile : Angabe, ob die generierte Argumentdatei 'javaCompiler.<bibliothek>.args' übergeben werden soll oder
nicht. (Diese Datei enthält Zugriffsregeln, Dateicodierungen und Warn-/Fehlerstufen.)