A Construção de PDE inclui uma infra-estrutura para automatizar a construção de funções. Grande parte da configuração necessária para esta construção pode ser efectuada através de algumas modificações no modelo build.properties facultado pela construção PDE. A secção seguinte concentra-se na configuração de uma construção simples, pressupondo que todos os plug-ins e funções (para-construção e pré-construção)referidos na função a ser construída já estão disponíveis localmente no disco.
O primeiro passo para configurar uma construção é a criação de um directório de configuração da construção. Este é o directório no qual são mantidos os ficheiros que controlam e personalizam a construção sem cabeçalho.
O ficheiro principal de controlo da construção é o ficheiro build.properties de configuração de construção de nível superior. Ao configurar uma nova construção, copie o ficheiro modelo do lote org.eclipse.pde.build na instalação de Eclipse que irá utilizar para executar a construção. O ficheiro modelo localiza-se em org.eclipse.pde.build/templates/headless-build/build.properties.
Este directório é referido pela propriedade builder, que normalmente é definida na linha de comandos ant.
A propriedade buildDirectory especifica o directório no qual a Construção/PDE irá gerar scripts e executar a actual construção. Os plug-ins e as funções em construção devem ser colocados nos subdirectórios ${buildDirectory}/plugins e ${buildDirectory}/features. Se os agrupamentos e as funções estiverem a ser obtidos de um repositório (Consultar Obter de repositórios), também devem ser colocados aqui.
Este directório pode ser o mesmo da configuração de construção ou pode ser outro. Aconselha-se a utilização de um directório distinto, especialmente se a configuração de construção for mantida em CVS e o utilizador não pretender incluir artefactos construídos gerados no mesmo.
Para configurar uma construção de função básica, tem de editar o ficheiro build.properties de configuração de construção e definir as seguintes propriedades:
A versão anterior de Construção/PDE também requeria um ficheiro allElements.xml, mas deixou de ser necessário na versão 3.4. O allElements.xml pode ser igualmente utilizado, mas só é necessário se pretender personalizar determinados aspectos da construção. Consulte Personalizar uma construção sem cabeçalho.
Para executar a construção, irá utilizar a aplicação org.elipse.ant.core.antRunner. Ao invocar o eclipse com esta aplicação para executar uma construção, necessita de configurar dois argumentos na linha de comandos:
-buildfile=</path/to/build.xml>: Este é o
caminho para o build.xml facultado pela construção de pde. Está localizado no directório org.eclipse.pde.build/scripts. Este é o script de
construção que orienta todo o processo de construção.-Dbuilder=</path/to/configuration folder>:
Este é o caminho para a pasta de configuração de construção.Execute a aplicação antRunner através da utilização do seguinte comando:
java -jar
<eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar
-application org.eclipse.ant.core.antRunner -buildfile
<<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml>
-Dbuilder=<path to the build configuration folder>Quando a construção estiver concluída, pode obter o resultado no directório de construção numa pasta denominada I.TestBuild (este nome pode ser configurado ao definir a propriedade buildLabel).
Se necessitar de mais personalização da construção, por exemplo, buscar de um repositório, consulte os tópicos de Construção de PDE Avançada para mais informações.