Construindo Repositórios e Produtos do p2

O PDE/Build foi construído no suporte para publicação de metadados do p2 usando o novo Publicador do p2. A integração do estilo 3.4 com o gerador de metadados antigo ainda funciona, mas não suporta os recursos mais recentes, como a customização de metadados.

A nova integração do publicador reúne seus recursos e pacotes configuráveis a partir da origem e os publica diretamente em um repositório do p2. Para usar a nova funcionalidade, o construtor deve definir a propriedade:

p2.gathering = true

Configurar essa propriedade alterará a construção de maneira significativa:

Consulte as páginas de ajuda da construção de produto e de recurso separadas para obter mais detalhes sobre esses tipos de construções.

Visão geral das alterações

O repositório local da construção

Durante a construção, todos os metadados e artefatos serão publicados em um repositório de construção definido pela propriedade p2.build.repo. Esta propriedade deve especificar um URI, o valor padrão para ela é file:${buildDirectory}/buildRepo.

Depois que todos os metadados e artefatos forem publicados nesse repositório, os scripts finais de montagem e de empacotamento serão espelhados e/ou instalados a partir desse repositório nos locais em que se tornarão os archives produzidos pela construção. Esse espelhamento e instalação finais podem ser ignorados usando as propriedades skipMirroring e skipDirector e, nesse caso, os resultados de construção estariam todos no repositório de construção.

build.xml gerado: coleta vs publicação

No build.xml gerado para recursos e plug-ins, há um gather.bin.parts de destino o qual foi responsável por reunir o conteúdo do recurso/plug-in e copiá-lo em um diretório final para ser gravado em Java (ou não) e incluído nos resultados de construção. Ao usar p2.gathering=true, nós, então, publicamos o recurso/plug-in diretamente em um repositório do p2. Ou seja, estamos usando o p2 para reunir os artefatos binários diretamente da origem (ou seja, de onde o nome da propriedade é proveniente).

Isso é feito usando um novo destino chamado publish.bin.parts que usa novas tarefas ant contribuídas por PDE/Build. Nas construções do estilo antigo, a chamada de gather.bin.parts era feita por delegação por meio da estrutura do recurso. Em vez disso, a chamada publish.bin.parts é feita diretamente de um novo script do p2 de montagem que é gerado.

Arquivos raiz contribuídos por recursos

As integrações do estilo antigo agrupavam todos os arquivos raiz contribuídos por todos os recursos de construção em uma única unidade e artefato instalável do arquivo raiz (que pode ter sido denominada para um produto). Com o novo suporte de publicação, os arquivos raiz são então associados ao recurso que contribuiu com eles. Consulte a página layout de metadados do recurso para obter mais detalhes.

Scripts de montagem

A integração do estilo antigo era feita chamando o gerador de metadados nos resultados binários durante o processo de montagem e de empacotamento. Ao usar p2.gathering=true, há um novo script assemble.<feature>.p2.xml.

Esse script invocará o publish.bin.parts para todos os recursos e pacotes configuráveis que estão sendo construídos. Ele também publicará metadados para todos os recursos binários e plug-ins pré-existentes, bem como publicará metadados para produtos.

No final do script de montagem do p2, antes dos scripts de montagem e de empacotamento restantes serem chamados, temos um repositório completo com os resultados completos da construção. Os scripts de montagem e de empacotamento restantes estão simplesmente dividindo o repositório e/ou executando instalações usando o p2 director para criar os arquivos finais que são os resultados da construção.