Etapas do Build Customizado de Recursos e Plug-ins

O que é novo no 3.2 é a capacidade de um recurso ou plug-in contribuir com destinos ant customizados para seu próprio build.  Essas etapas customizadas podem ser utilizadas para, por exemplo, instrumentar o byte-code após a compilação, indexar arquivos de ajuda para documentação ou copiar arquivos extras no pacote configurável. 

Para utilizar destinos customizados, um recurso ou plug-in deve definir a propriedade customBuildCallbacks em seu arquivo build.properties; o valor dessa propriedade é o local de um arquivo xml, relativo à raiz do recurso/plug-in, contendo os destinos customizados. Se o arquivo xml estiver localizado em qualquer outro lugar, utilize a propriedade customBuildCallbacks.buildpath para configurar o diretório a ser utilizado.

Os modelos denominados customBuildCallbacks.xml que contêm os destinos customizados suportados são fornecidos em org.eclipse.pde.build/templates/plugins e  org.eclipse.pde.build/templates/features.  Esses modelos podem ser copiados para seu recurso/plug-in e modificados conforme necessário.

Os destinos customizados serão chamados utilizando a tarefa subant; por padrão, failonerror é definido como false. Para alterar isso, defina a propriedade customBuildCallbacks.failonerror como true. Da mesma forma, o padrão do parâmetro inheritall é false. Defina a propriedade customBuildCallbacks.inheritall para alterar isso.

Plug-ins

O build.xml gerado que constrói um plug-in contém vários destinos que desempenham tarefas específicas.  O Build PDE permite que o plug-in forneça destinos pré e pós customizados que serão chamados antes e após tarefas específicas.  Além de quaisquer propriedades ant que possam já estar definidas, também é possível transmitir a cada destino customizado algumas propriedades específicas.  Os seguintes destinos suportam retornos de chamada:

Recursos

O build.xml gerado para recursos suporta apenas retornos de chamada do build customizado para o destino gather.bin.parts.  Esse destino chamará o destino gather.bin.parts de todos os recursos e plug-ins incluídos.  Ele suporta pre.gather.bin.parts e post.gather.bin.parts.  Ambos os destinos são fornecidos com as seguintes propriedades: