Opções do Compilador
O PDE/Build suporta um número de opções para controlar o compilador para plug-ins individuais. Para configurações relacionadas aos níveis de origem e de destino e a bootclasspath, consulte "Configurando o Ambiente de Compilação".
Avisos e Erros
O PDE/Build permite a especificação de avisos e erros de compilação customizados no arquivo build.properties. Eles podem ser configurados por biblioteca (um único plug-in pode conter várias bibliotecas jar) com as opções javacWarnings.<library> e javacErrors.<library>. Os valores para essas propriedades são especificados na seção "-warn:..." na página usando compilador de lotes (a partir do guia do usuário de desenvolvimento Java).
Exemplo:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
Avisos e Erros de Preferências de Projeto
As preferências do projeto JDT agora também podem ser usadas durante o PDE/Build. O PDE/Build em si não consegue ler os arquivos de preferências, mas consegue transmiti-los ao compilador JDT que os entende.
Para usar isso, um plug-in deve especificar a propriedade javacProjectSettings em seu arquivo build.properties. O valor deve ser:
- javacProjectSettings=true : Use a configuração do projeto especificada no arquivo de preferências .settings/org.eclipse.jdt.core.prefs padrão.
- javacProjectSettings=path/to/jdt.prefs : Use o arquivo de preferências especificado.
Alguns projetos podem desejar usar configurações diferentes de avisos e erros na área de trabalho, em comparação com uma construção releng. Isso permite um método mais conveniente de especificar essas configurações em comparação com a propriedade "javacWarnings.<library>".
Codificação do Arquivo
O PDE/Build pode aceitar codificações de arquivo customizado por biblioteca, pasta ou arquivo.
- javacDefaultEncoding.<library>
- configura a codificação padrão a ser utilizada ao compilar a biblioteca determinada.
- javacCustomEncodings.<library>
- uma lista de caminhos e codificações separados por vírgula para uso ao compilar a
biblioteca determinada. Ao especificar uma pasta, a codificação é usada para tudo o que está contido nessa pasta. Ao especificar um arquivo, a codificação é usada para tudo o que está contido nesse arquivo. Exemplo:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Argumentos de Compilador Customizados
Os argumentos de compilador customizados agora podem ser especificados por pacote configurável usando a propriedade compilerArg no arquivo build.properties do pacote configurável. Essa propriedade é similar
à propriedade compilerArg na configuração do construtor, exceto que ela afeta apenas um só plug-in, em vez de todos os plug-ins. Os argumentos específicos aqui dependem do compilador que está sendo usado. Os argumentos do compilador JDT são listados aqui.
Precedência de Opção do Compilador
Há várias maneiras diferentes de especificar opções de compilador diferentes. Como regra geral, a precedência de opção é a seguinte:
- javacDefaultEncoding.<library> tem precedência sobre uma opção da linha de comandos -encoding customizada.
- Para opções gerais, uma opção que aparece depois da linha de comandos do compilador substitui as opções especificadas anteriormente. As opções são fornecidas ao JDT na seguinte ordem:
- A propriedade compilerArg da configuração do construtor. (Afeta todos os pacotes configuráveis).
- A propriedade compilerArg deste build.properties do plug-in.
- O arquivo de preferências do compilador especificado com javacProjectSettings.
- O arquivo de argumentos do compilador gerado (javaCompiler.<library>.args) que contém codificações de arquivo, javacWarnings, javacErrors e regras de acesso.
Usando um Compilador Customizado
Um pacote configurável agora pode usar um compilador customizado configurando a propriedade compilerAdapter. O adaptador do compilador especificado deve estar disponível no ambiente Ant. O adaptador do compilador JDT usado por padrão é org.eclipse.jdt.core.JDTCompilerAdapter. Uma razão específica para indicar um compilador alternativo é devido aos pacotes configuráveis Aspect J ou Groovy. Os pacotes configuráveis que especificam um adaptador de compilador customizado podem precisar também especificar algumas das seguintes propriedades:
- sourceFileExtensions : Uma lista de extensões que devem ser consideradas origem. (Por exemplo: *.java, *.aj, *.groovy).
- compilerAdapter.useLog : se o argumento "-log" deve ou não ser passado para o compilador
- compilerAdapter.useArgFile : se deve ou não passar o arquivo de argumento <library>.args gerado. (Contém regras de acesso, codificações de arquivo e níveis de aviso/erro).