Existem vários métodos para personalizar uma construção sem cabeçalho:
Os formatos exactos dos conteúdos destes ficheiros dependem uns dos outros. Por isso, ao usar personalizações customTargets, allElements ou customAssembly, recomenda-se que se certifique de que os modelos usados para estes ficheiro provêm todos da mesma versão de PDE/Build. As novas versões de PDE/Build são retrocompatíveis com versões antigas destes scripts de personalização.
As versões de modelos destes scripts estão disponíveis no plug-in org.eclipse.pde.build na pasta templates/headless-build. Para usar a personalização, basta copiar o modelo para o directório de configuração da construção e editar os destino adequados.
O script de customTargets.xml destina-se à personalização de nível superior do processo de construção. Faculta destinos ant que são chamados entre as fases mais importantes da construção. Existem destinos prévios e posteriores disponíveis em cada um dos passos de construção que se seguem:
Para usar o script customTargets.xml, basta copiá-lo do directório de modelos PDE/Build para o directório de configuração de construção e editar os destinos ant adequados. O script será detectado automaticamente e usado pela construção sem cabeçalho.
O script customTargets.xml também faculta delegação ao script allElements.xml para cada uma das fases de construção.
O script allElements.xml é um tipo de script de delegação usado para executar os vários passos de construção num determinado elemento (normalmente uma função). Tal como para customTargets.xml, para usar estes passos de personalização, copie o modelo de PDE/Build para o directório de configuração de construção. No Eclipse 3.4, o elemento destino que irá ser construído poderá ser especificado no ficheiro build.properties de configuração da construção de nível superior, usando as propriedades topLevelElementType e topLevelElementId. O elementType deverá ser definido como feature (função) e o elementId deverá ser definido como o ID de função que pretende 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 faculta destinos durante a fase de montagem e empacotamento da construção. O destino defaultAssemble será chamado para reunir os arquivos para todas as plataformas. Se pretender, os destinos personalizados podem ser definidos para plataformas individuais.
Para usar um destino personalizado para um determinada plataforma, defina uma propriedade "assemble.<element-id>[.<config>] e um destino correspondente. A propriedade indica ao PDE/Build que deve usar este destino personalizado e não o destino predefinido. Este destino personalizado poderá ser usado para dar ao arquivo um nome personalizado ou pré- ou pós-processamento no arquivo.
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 na 3.4. Faculta pontos de personalização que serão solicitados durante as fases de montagem e empacotamento da construção. Tal como com customTargets.xml e allElements.xml, para usar esta personalização, copie o modelo de PDE/Build para o directório de configuração de construção.
Os scripts de montagem e de empacotamento gerados pelo PDE/Build executam as acções seguintes:
Os scripts de montagem tratam da recolha de funções e plug-ins que foram compilados durante a construção e os scripts de pacote tratam da recolha das funções binárias pré-compiladas e plug-ins que existam. O script customAssembly.xml faculta os destinos seguintes antes ou após cada um dos passos descritos acima: