Construir funções

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.

Configuração Básica

O directório de configuração de construção

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.

Propriedade buildDirectory

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.

Propriedades iniciais

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.

Executar a construção

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:

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).

Cenários avançados

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.