Construir Repositórios e Produtos p2

O PDE/Build incorporou suporte para publicar metadados p2 utilizando o novo p2 Publisher. Integração ao estilo 3.4 com o antigo gerador de metadados ainda funciona, mas não suporta funções mais recentes como personalização de metadados.

A nova integração do editor reúne as funções e lotes da origem e publica-os directamente num repositório p2. Para utilizar a nova funcionalidade, o construtor deve definir a propriedade:

p2.gathering = true

Definir esta propriedade vai alterar a construção de forma significativa:

Consulte as páginas de ajuda da função separada e de construção do produto para mais detalhes sobre esses tipos de construções.

Descrição geral das alterações

O repositório local da construção

Durante a construção, todos os metadados e artefactos serão publicados num repositório de construção definido pela propriedade p2.build.repo. Esta propriedade deve especificar uma URI, o valor predefinido é file:${buildDirectory}/buildRepo.

Assim que todos os metadados e artefactos sejam publicados neste repositório, o conjunto final e os scripts da embalagem vão replicar e/ou ser instalados deste repositório nas localizações que se vão tornar os arquivos produzidos pela construção. Esta replicação e instalação final pode ser ignorada utilizando as propriedades skipMirroring e skipDirector, em qualquer dos casos os resultados da construção estariam todos apenas no repositório da construção.

build.xml gerado: recolher vs publicar

No build.xml gerado para funções e plugins existe um destinogather.bin.parts que for responsável pela recolha do conteúdo da função/plug-in e de as copiar para um directório final para ser jar (ou não) e incluído nos resultados da construção. Ao utilizar p2.gathering=true, publicamos em vez disso a função/plug-in directamente num repositório p2. Ou seja, estamos a utilizar p2 para recolher os artefactos binários directamente da origem (é onde tem origem o nome da propriedade).

isto acontece utilizando um novo destino designado publish.bin.parts que utiliza uma nova tarefa ant contribuída por PDE/Build. Em construções de estilo antigo, chamargather.bin.parts foi efectuado através da delegação pela estrutura da função. Chamar publish.bin.parts em vez disso é feito directamente de um novo script p2 do conjunto que é gerado.

Rootfiles contribuídos pelas funções

As integrações ao estilo antigo agruparam todos os rootfiles contribuídos por todas as funções na construção numa única unidade instalável e artefacto num único ficheiro (que pode ter sido nomeado para um produto). Com o novo suporte de publicação, os ficheiros root são, em vez disso, associados à função que os contribuiu. Consulte a página esquema de metadados da função para mais detalhes.

Os scripts de conjunto

A integração ao estilo antigo foi efectuada através da chamada do gerador de metadados nos resultados binários durante o processo de montagem e embalagem. Ao utilizar p2.gathering=true existe um novo scriptassemble.<feature>.p2.xml.

Este script vai invocar publish.bin.parts para todas as funções e lotes que estão a ser construídos. Também vai publicar metadados para todas as funções binárias pré-existentes e plug-ins, bem como a publicação de metadados para produtos.

No final do script do conjunto p2, antes de serem chamados os script s do pacote e do conjunto restantes, termos um repositório completo com os resultados totais da construção. Os scripts do pacote e do conjunto restantes estão simplesmente a dividir o repositório e/ou a executar instalações utilizando o director p2 para criar os arquivos finais que são os resultados da construção.