Opções de compilador
O PDE/Build suporta um conjunto de opções para controlar o compilador de plug-ins individuais. Para definições relacionadas com níveis de origem e de destino e caminho de classe de arranque, consulte "Definir o ambiente de compilação".
Avisos e erros
PDE/Construção permite especificar avisos e erros de compilação personalizados no ficheiro build.properties. Esta personalização pode ser definida com base em bibliotecas (um único plug-in pode conter várias bibliotecas jar) com as opções de javacWarnings.<library> e de javacErrors.<library>. Os valores para estas propriedades
são fornecidos na secção "-warn:..." na página utilizando o compilador de lotes (a partir do manual de utilizador de programação Java).
Exemplo:
javacErrors.. = proibido, não recomendado,
javacWarnings.library.jar = desactualização, nullDereference
Avisos e erros das preferências de Projecto
As preferências de Projecto JDT podem também ser utilizadas durante o PDE/Build. O PDE/Build não é capaz de ler os ficheiros de preferências, mas pode transmiti-las para um compilador JDT, o qual pode compreendê-las.
Para utilizar esta opção, um plug-in deve especificar a propriedade javacProjectSettings no seu ficheiro build.properties. O valor deverá ser:
- javacProjectSettings=true : Utilizar a definição de projecto especificada no ficheiro de preferências predefinido .settings/org.eclipse.jdt.core.prefs.
- javacProjectSettings=path/to/jdt.prefs : Utilizar o ficheiro de preferências especificado.
Alguns projectos poderão pretender utilizar várias definições de avisos e erros no espaço de trabalho como acontece numa construção releng. Isto permite um método mais conveniente de especificação destas definições em comparação com a propriedade "javacWarnings.<library>".
Codificação do ficheiro
O PDE/Build pode aceitar codificações de ficheiro personalizadas com base em bibliotecas, pastas ou ficheiros.
- javacDefaultEncoding.<library> -
define a codificação predefinida para utilizar ao compilar a biblioteca em questão.
- javacCustomEncodings.<library> -
uma lista separada por vírgulas de caminhos e codificações a utilizar ao
compilar a biblioteca em questão. Ao especificar uma pasta, é utilizada a codificação para todos os conteúdos nessa pasta. Ao especificar um ficheiro, a codificação é utilizada apenas para esse ficheiro. Exemplo:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII],
src/org/foo/bar.java[ISO-8859-1]
Argumentos de compilador personalizados
Os argumentos de compilador personalizados podem agora especificados por lote utilizando a propriedade compilerArg no ficheiro de lote build.properties. Esta propriedade é semelhante à propriedade compilerArg na configuração do construtor, com excepção de que afecta somente um plug-in individual em vez de todos os plug-ins. Os argumentos específicos neste caso dependem do compilador que está a ser utilizado. Os argumentos do compilador de JDT são listados aqui.
Precedência de opções de compilador
Existem várias formas diferentes de especificar diferentes opções do compilador. Regra geral, a precedência de opções é como se segue:
- javacDefaultEncoding.<library> tem precedência sobre uma opção de linha de comandos -encoding personalizada.
- Para opções gerais, uma opção que apareça posteriormente na linha de comandos substitui opções anteriormente especificadas. As opções são fornecidas ao JDT pela seguinte ordem:
- A propriedade compilerArg da configuração do construtor. (Afecta todos os lotes).
- A propriedade compilerArg do build.properties deste plug-in.
- O ficheiro de preferências especificado com javacProjectSettings.
- O ficheiro de argumentos de compilador gerado (javaCompiler.<library>.args) que contém codificações de ficheiros, javacWarnings, javacErrors e regras de acesso.
Utilizar um compilador personalizado
Um lote pode agora utilizar um compilador personalizado através da definição da propriedade compilerAdapter. O adaptador de compilador especificado tem de estar disponível no ambiente de ant. O adaptador do compilador JDT utilizado por predefinição é o org.eclipse.jdt.core.JDTCompilerAdapter. Os lotes Aspect J ou Groovy são um motivo concreto para especificar um compilador alternativo. Os lotes que especifiquem um adaptador de compilador personalizado poderão precisar de especificar também algumas das seguintes propriedades:
- sourceFileExtensions : Uma lista de extensões que devem ser consideradas código fonte. (Por exemplo, *.java, *.aj, *.groovy).
- compilerAdapter.useLog : Se transmitir ou não argumentos "-log" ao compilador
- compilerAdapter.useArgFile : Se transmitir ou não o ficheiro de argumentos gerado javaCompiler.<library>.args. (Contém regras de acesso, codificações de ficheiros e níveis de avisos e erros).