Opciones de compilador
La Construcción PDE soporta varias opciones para controlar el compilador para plug-ins individuales. Para valores relacionados con los niveles origen y destino y
la vía de acceso de clases de arranque, consulte "Establecer el entorno de compilación.
Avisos y errores
La Construcción PDE permite especificar avisos y errores de compilación personalizados
en el archivo build.properties. Estos se pueden establecer por biblioteca (un sólo plug-in puede contener varias bibliotecas jar) con las opciones
javacWarnings.<biblioteca> y javacErrors.<biblioteca>. Los
valores de estas propiedades se proporcionan en la sección
"-warn:..." de la página
Utilizar
el compilador de lotes (en la guía del usuario de desarrollo de Java).
Ejemplo:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Preferencias de proyecto de avisos y errores
Las preferencias de proyecto de JDT se pueden utilizar ahora durante la Construcción PDE. La Construcción PDE no puede
leer los archivos de preferencias pero puede pasarlos al compilador JDT que los entiende.
Para utilizar esto, un plug-in debe especificar la propiedad javacProjectSettings en su archivo
build.properties. El valor debe ser:
- javacProjectSettings=true: utilizar el proyecto especificado en el archivo de preferencias
.settings/org.eclipse.jdt.core.prefs predeterminado.
- javacProjectSettings=path/to/jdt.prefs: utilizar el archivo de preferencias especificado.
Algunos proyectos utilizarán diferentes valores de aviso y error en el espacio de trabajo, en comparación con una
construcción releng. Esto proporciona un método de especificación de estos valores más conveniente que la propiedad
"javacWarnings.<biblioteca>".
Codificación de archivos
La Construcción de PDE puede aceptar las codificaciones de archivo personalizadas por biblioteca, carpeta o archivo.
- javacDefaultEncoding.<biblioteca>
- establece la codificación predeterminada que debe utilizarse al compilar la biblioteca
dada.
- javacCustomEncodings.<biblioteca>
- una lista separada por comas de las vías de acceso y codificaciones que deben
utilizarse al compilar la biblioteca dada- Cuando se especifica una carpeta, la codificación se utilizara para todo lo
contenido en esa carpeta. Cuando se especifica un archivo, la codificación se utiliza justo para ese archivo.
Ejemplo:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Argumentos de compilador personalizado
Los argumentos de compilador personalizado se pueden especificar ahora por paquete mediante la propiedad
compilerArg en el archivo build.properties del paquete. Esta propiedad se parece a la propiedad
compilerArg en la configuración del constructor excepto en que afecta
sólo a un plug-in individual en lugar de a todos los plug-ins. Los argumentos específicos de aquí dependen del
compilador que se utiliza. Los argumentos del compilador JDT figuran
aquí.
Precedencia de opciones de compilador
Hay varias formas de especificar opciones de compilador diferentes. Como regla general, la precedencia de opciones es
la siguiente:
- javacDefaultEncoding.<biblioteca> tiene precedencia sobre una opción de línea de mandatos -encoding personalizada.
- Para opciones generales, una opción que aparezca más tarde en la línea de mandatos del compilador altera
temporalmente las opciones especificadas anteriormente. Las opciones se proporcionan al JDT por el orden siguiente:
- La propiedad compilerArg de la configuración de constructor. (Afecta a todos los paquetes).
- La propiedad compilerArg del build.properties de este plug-in.
- El archivo de preferencias de compilador especificado con javacProjectSettings.
- El archivo de argumentos de compilador generado (javaCompiler.<biblioteca>.args) que contiene codificaciones de archivo, javacWarnings, javacErrors y reglas de acceso.
Utilizar un compilador personalizado
Un paquete puede utilizar ahora un compilador personalizado estableciendo la propiedad compilerAdapter. El
adaptador del compilador especificado debe estar disponible en el entorno Ant. El adaptador del compilador JDT
utilizado de forma predeterminada es org.eclipse.jdt.core.JDTCompilerAdapter. Una razón determinada para
especificar un compilador alternativo puede ser para paquetes Aspect J o Groovy. Los paquetes que especifican un
adaptador de compilador personalizado también deberán especificar algunas de las propiedades siguientes:
- sourceFileExtensions: una lista de extensiones que se deben considerar de código fuente (p. ej. *.java, *.aj, *.groovy).
- compilerAdapter.useLog: si se va a pasar o no el argumento "-log" al compilador
- compilerAdapter.useArgFile: si se va a pasar o no el archivo de argumentos javaCompiler.<biblioteca>.args generado. (Contiene reglas de acceso, codificaciones de archivo y niveles de aviso/error)