Propriedades de Configuração de Construção de Recurso e Plug-in
O mecanismo de construção é conduzido por uma configuração de construção. A
configuração de construção para um plug-in, fragmento ou recurso individual
está localizada em um arquivo build.properties do elemento correspondente.
Os assistentes para criação de projetos PDE geram o arquivo build.properties quando
os projetos de plug-in são criados. O arquivo contém informações sobre a compilação das pastas de origem em
JARs. Essas informações podem ser atualizadas indiretamente, na página de Tempo de Execução do
editor de manifest. Também podem ser modificadas diretamente, utilizando o editor apropriado.
O PDE fornece um editor simples para build.properties que possui exibições de formulário e de origem.
O próprio arquivo segue o formato de propriedades Java. É necessário fornecer um número de chaves e seus valores correspondentes. Os valores múltiplos são separados utilizando uma vírgula como delimitador.
Propriedades comuns
- bin.includes - lista os arquivos que serão incluídos na versão binária do plug-in que está sendo construído;
- bin.excludes - lista os arquivos a serem excluídos da construção binária;
- qualifier - quando o número da versão do elemento termina com .qualifier isso indica por qual valor ".qualifier" deve ser substituído. O valor da propriedade pode ser context, <value> ou none. O contexto irá gerar uma data de acordo com a data do sistema ou utilizar marcações CVS quando a construção for automatizada. O valor é um valor real. Nenhum
(none) removerá ".qualifier". Se a propriedade for omitida, o contexto será utilizado. (Consulte Qualificações de Versão.)
- custom=true - indica que o script de construção é feito manualmente em oposição à geração automática. Portanto, nenhoutro valor é consultado.
- customBuildCallbacks - indica um arquivo
xml contendo destinos customizados a serem utilizados ao usar esse recurso/plug-in.
(Consulte Etapas de Construção Customizada de
Recurso e Plug-in)
- customBuildCallbacks.failonerror -
define o parâmetro failonerror da tarefa subant. O padrão é "false".
- customBuildCallbacks.buildpath -
define o parâmetro buildpath da tarefa subant. Utilize quando o local do arquivo de retorno de chamada customizada não for relativo à raiz do plug-in.
- customBuildCallbacks.inheritall - define o parâmetro inheritall da tarefa subant. O padrão de Ant é false.
Propriedades Específicas do Plug-in
- source.<library> - lista as pastas de origem a serem compiladas (por exemplo, source.xyz.jar=src/, src-ant/). Se a biblioteca for especificada no plug-in.xml ou no manifest.mf, o valor deverá
corresponder a ele;
- output.<library> - lista a pasta de saída que está recebendo o resultado da compilação;
- exclude.<library> - lista os arquivos que não deverão ser copiados na biblioteca pelo compilador;
- extra.<library> - caminhos de classe extra utilizados para executar a construção automatizada. Os caminhos de classe podem ser caminhos relativos ou
URLs de plataforma para plug-ins e fragmentos de seu ambiente de desenvolvimento (por exemplo, ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
As urls da plataforma são recomendadas sobre caminhos relativos;
- manifest.<biblioteca> - indica o arquivo que será utilizado como manifesto para a biblioteca. O arquivo deve estar localizado em uma das pastas de origem
que estão sendo utilizadas como entrada do jar.
- src.includes - lista os arquivos a serem incluídos na construção de origem;
- src.excludes - lista os arquivos a serem excluídos da construção de origem;
- jars.extra.classpath - (desaprovado) mesmo efeito que extra.<library> exceto se as entradas forem aplicadas a todas as bibliotecas;
- jars.compile.order - define a ordem na qual os jars devem ser compilados (no caso de haver várias bibliotecas).
Opções relacionadas ao compilador. Consulte também as páginas Controlando o Ambiente de Compilação e Opções do Compilador.
- jre.compilation.profile - configure o
Ambiente utilizado para compilar esse pacote configurável.
- javacSource - configure o nível de
compatibilidade de origem para compilar esse pacote configurável.
Substitui jre.compilation.profile.
- javacTarget - configure o nível de
compatibilidade .class de destino para compilar esse pacote configurável.
Substitui jre.compilation.profile.
- bootClasspath - configure o caminho de
classe de inicialização junto ao qual compilar esse pacote configurável. Substitui
jre.compilation.profile.
- javacWarnings.<library>
- configure as opções de aviso para transmitir ao compilador. Consulte a opção -warn em
Usando o compilador de lotes
no guia do usuário de desenvolvimento Java.
- javacErrors.<library>
- configure as opções de erro para transmitir ao compilador. Consulte a opção -err em
Usando o compilador de lotes no guia do usuário de desenvolvimento Java.
- 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. Exemplo:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
- javacProjectSettings - Um caminho relativo a um arquivo de preferência que especifica propriedades para o Compilador JDT. Configure como true para usar o padrão ".settings/org.eclipse.jdt.core.prefs".
- compilerArg - especifica argumentos customizados do compilador
- compilerAdapter - especifica um adaptador customizado do compilador para usar no lugar do padrão org.eclipse.jdt.core.JDTCompilerAdapter
- compilerAdapter.useLog - true/false: se o adaptador customizado do compilador deverá ou não receber o argumento -log.
- compilerAdapter.useArgFile - true/false: se o adaptador customizado do compilador deverá ou não receber o arquivo do argumento javaCompiler.<library>.args gerado.
- sourceFileExtensions - uma lista de extensões (*.java, *.aj) que deve ser considerada como origem ao usar um adaptador customizado do compilador.
Os valores definidos para essas chaves terminadas com "inclui" ou "exclui" são expressos como "padrões" Ant. Os formatos padrão fornecem os resultados esperados.
Por exemplo, "*.jar" indica todos os arquivos jar no diretório de nível superior. Os padrões não são profundos, por padrão. Por exemplo, se você desejar
descrever todos os arquivos Java, deverá utilizar o padrão "**/*.java".
O padrão "**" corresponde qualquer número de níveis de diretório.
De modo semelhante, para descrever as subárvores inteiras, utilize "xyz/".
Propriedades Específicas do Recurso
- root - Liste os arquivos e as pastas que devem ser incluídas na raiz do produto. Consulte a Página de Ajuda de Arquivos Raiz para obter detalhes adicionais, incluindo as seguintes propriedades adicionais:
- root.<config>: segundo arquivos raiz de configuração.
- root.folder : arquivos raiz colocados em subpastas.
- root.permissions : execute chmods em arquivos raiz.
- root.link : gere softlinks para arquivos raiz.
- root.<config> - lista os arquivos e pastas que devem ser incluídos na raiz do produto quando ele é construído para a configuração especificada. config é composto de três (3) segmentos de uma configuração separada por um ponto;
- root.permissions.<permissionValue> - lista os arquivos e pastas para chmod para o valor fornecido. A referência às pastas deve terminar com um '/';
- root.permissions.<config>.<permissionValue> - lista os arquivos e pastas para chmod para o valor fornecido para uma configuração específica. A referência às pastas deve terminar com um '/';
- root.link - lista por pares (separados por vírgula) os arquivos e pastas que precisam ser vinculados simbolicamente. A primeira entrada indica a origem (destino na terminologia unix) e a segunda entrada o nome do link;
- root.link.<config> - uma lista separada por vírgula de pares de arquivos e pastas que precisam ser vinculados simbolicamente para uma configuração específica. A primeira entrada indica a origem (destino na terminologia unix) e a segunda entrada o nome do link;
- generate.feature@<featureId> - indica que o recurso de origem featureId será o recurso de origem para o recurso indicado como valor desta propriedade. Os valores listados após a primeira coluna indicam elementos a serem buscados no
repositório; (Consulte Geração de Plugin e
Recurso de Origem)
- generate.plugin@<pluginId> - indica que o plug-in de origem pluginId será o plug-in de origem para o valor indicado dessa propriedade.
- significantVersionDigits
- O número de dígitos significativos utilizados ao gerar sufixos de versão de
recurso (Consulte Qualificadores de Versão)
- generatedVersionLength -
O comprimento do sufixo de versão de recurso gerado.
Os exemplos a seguir foram extraídos do build.properties do recurso org.eclipse.platform.
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,configuration/
root.permissions.755=eclipse
root.linux.motif.x86=../../plugins/platform-launcher/bin/linux/motif,linux.motif
root.linux.motif.x86.link=libXm.so.2.1,libXm.so.2,libXm.so.2.1,libXm.so
root.linux.motif.x86.permissions.755=*.so*