Options de compilateur
La génération PDE prend en charge plusieurs options permettant de contrôler le compilateur pour des plug-ins individuels. Pour des informations sur les paramètres liés aux niveaux source et cible et au chemin d'accès aux classes d'amorçage, voir "Configuration de l'environnement de compilation".
Avertissements et erreurs
La génération PDE permet la spécification d'avertissements et d'erreurs de compilation personnalisés dans le fichier build.properties. Ils peuvent être définis pour chaque bibliothèque (un plug-in peut contenir plusieurs bibliothèques jar) avec les options javacWarnings.<library> et javacErrors.<library>. La valeur de ces propriétés est indiquée dans
la section "-warn:..." sur la page Using the batch compiler du document Java development user guide.
Exemple :
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Avertissements et erreurs provenant des préférences de projet
Les préférences de projet JDT peuvent désormais être utilisées lors de la génération PDE. La génération PDE elle-même ne peut pas lire les fichiers de préférences mais peut les transmettre au compilateur JDT qui les comprend.
Pour ce faire, le plug-in doit spécifier la propriété javacProjectSettings dans son fichier build.properties. La valeur doit être la suivante :
- javacProjectSettings=true : utilisez le paramètre de projet spécifié dans le fichier de préférences .settings/org.eclipse.jdt.core.prefs par défaut.
- javacProjectSettings=path/to/jdt.prefs : utilisez le fichier de préférences spécifié.
Pour certains projets, il peut être judicieux d'utiliser différents paramètres d'avertissement et d'erreur dans l'espace de travail, comme dans une génération releng. Il est ainsi plus facile de spécifier ces paramètres par rapport à la propriété "javacWarnings.<library>".
Codage des fichiers
La génération PDE peut accepter des codages de fichier personnalisés pour chaque bibliothèque, dossier ou fichier.
- javacDefaultEncoding.<library> : définit le codage par défaut à utiliser lors de la compilation de la bibliothèque.
- javacCustomEncodings.<library> : liste de chemins et de codages séparés par une virgule à utiliser lors de la compilation de la bibliothèque. Dans le cas d'un dossier, le codage est utilisé pour l'intégralité de son contenu. Dans le cas d'un fichier, le codage est utilisé pour le fichier uniquement.
Exemple :
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Arguments de compilateur personnalisés
Vous pouvez désormais spécifier des arguments de compilateur personnalisés par regroupement avec la propriété compilerArg dans le fichier build.properties du regroupement. Cette propriété est similaire à la propriété compilerArg de la configuration de générateur sauf qu'elle n'a d'impact que sur le plug-in en question, et pas sur tous les plug-ins. Ici, les arguments spécifiques dépendent du compilateur utilisé. Les arguments du compilateur JDT sont répertoriés ici.
Priorité des options de compilateur
Vous pouvez spécifier les options de compilateur de différentes façons. En général, la priorité des options est la suivante :
- javacDefaultEncoding.<library> est prioritaire par rapport à une option de ligne de commande -encoding personnalisée.
- Dans le cas des options générales, une option qui apparaît plus tard sur la ligne de commande du compilateur remplace les options spécifiées en premier. Les options sont fournies aux outils de développement Java (JDT) dans l'ordre suivant :
- Propriété compilerArg provenant de la configuration du générateur. (Affecte tous les regroupements).
- Propriété compilerArg provenant du fichier build.properties de ce plug-in.
- Fichier de préférences du compilateur spécifié avec javacProjectSettings.
- Fichier d'arguments du compilateur généré (javaCompiler.<library>.args) contenant les codages de fichier, javacWarnings, javacErrors et des règles d'accès.
Utilisation d'un compilateur personnalisé
Un regroupement peut désormais utiliser un compilateur personnalisé via la définition de la propriété compilerAdapter. L'adaptateur de compilateur spécifié doit être disponible dans l'environnement ant. L'adaptateur de compilateur JDT utilisé par défaut est org.eclipse.jdt.core.JDTCompilerAdapter. Il est utile de spécifier un compilateur alternatif notamment pour les regroupements Aspect J et Groovy. Il se peut que les regroupements spécifiant un adaptateur de compilateur personnalisé doivent également spécifier certaines des propriétés suivantes :
- sourceFileExtensions : liste d'extensions devant être considérées comme une source (par exemple *.java, *.aj, *.groovy).
- compilerAdapter.useLog : indique si l'argument "-log" doit être transmis au compilateur ou non.
- compilerAdapter.useArgFile : indique si le fichier d'arguments javaCompiler.<library>.args généré doit être transmis ou non. (Il contient des règles d'accès, des codages de fichier et les niveaux avertissement/erreur).