Existem vários métodos para customizar um build sem periféricos:
O formato exato do conteúdo desses arquivos todos depende um dos outros. Portanto, ao utilizar customizações customTargets, allElements ou customAssembly, recomenda-se certificar-se de que os modelos utilizados para esses arquivos todos sejam provenientes da mesma versão de PDE/Construir. As novas versões de PDE/Construir são compatíveis com versões anteriores desses scripts de customização.
As versões de modelo desses scripts estão disponíveis no plug-in org.eclipse.pde.build na pasta templates/headless-build. Para utilizar a customização, simplesmente copie o modelo em seu diretório de configuração de build e edite os destinos apropriados.
O script customTargets.xml destina-se à customização de nível superior do processo de build. Fornece destinos ant que são chamados entre as principais fases do build. Existem pré e pós-destinos disponíveis em torno de cada uma das seguintes etapas de build:
Para utilizar o script customTargets.xml, simplesmente copie-o do diretório de modelos PDE/Construir no diretório de configuração de build e edite os destinos ant apropriados. O script será automaticamente detectado e utilizado pela build sem periféricos.
O script customTargets.xml também fornece delegação para o script allElements.xml para cada uma das fases de build.
O script allElements.xml é um tipo de script de delegação utilizado para executar diversas etapas de build em um determinado elemento (geralmente um recurso). Assim como com o customTargets.xml, para utilizar as etapas de customização, copie o modelo de PDE/Construir para seu diretório de configuração de build. No Eclipse 3.4, o elemento de destino que será construído pode ser especificado no arquivo build.properties de configuração de build de nível superior que utiliza as propriedades topLevelElementType e topLevelElementId. O elementType deve ser configurado como feature e o elementId deve ser configurado como o feature-id que você deseja construir.
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
O allElements.xml também fornece destinos utilizados durante a montagem e a fase de pacote do build. O destino defaultAssemble será chamado para montar os archives para todas as plataformas. Se desejado, os destinos customizados podem ser definidos para plataformas individuais.
Para utilizar um destino customizado para uma determinada plataforma, defina uma propriedade "assemble.<element-id>[.<config>] e um destino correspondente. A propriedade informa ao PDE/Construir para utilizar este destino customizado em vez do destino padrão. Este destino customizado pode então ser utilizado para fornecer ao archive um nome customizado ou executar o pré ou o pós-processamento no archive.
Exemplo:
<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
<target name="assemble.org.foo.feature.id.linux.gtk.x86">
<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
<-- custom pre assemble steps for linux.gtk.x86-->
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
<-- custom post assemble steps for linux.gtk.x86-->
</target>
O script customAssembly.xml é novo no 3.4. Ele fornece pontos de customização que serão chamados durante as fases de montagem e compactação do build. Como com customTargets.xml e allElements.xml, para utilizar essas customizações, copie o modelo de PDE/Construir em seu diretório de configuração de build.
Os scripts de montagem e compactação gerados por PDE/Construir executam as seguintes ações:
Os scripts de montagem tratam da coleta de recursos e plug-ins que foram compilados durante o build e os scripts de pacote tratam da coleta de quaisquer recursos e plug-ins binários pré-compilados. O script customAssembly.xml fornece os seguintes destinos antes ou depois de cada uma das etapas acima: