Integração do Build do PDE com o p2

Esta página descreve uma forma antiga descontinuada de integração com o p2. Consulte a página "Construindo Repositórios e Produtos do p2" para obter os métodos recomendados para construção com o p2. As propriedades descritas a seguir funcionam usando uma camada de compatibilidade com as versões anteriores e não suportam nenhum novo recurso que possa ser incluído no publicador do p2.

Consulte a página Gerando Metadados p2 no Guia do Desenvolvedor de Plug-in de Plataforma para obter detalhes sobre a geração de metadados p2. Apenas a geração de metadados não é suficiente para criar um produto ativado por p2. Para fazer isso, você deve desempenhar uma instalação de p2 real por meio dos metadados gerados. Consulte a documentação do diretor do p2 para obter detalhes sobre como desempenhar essa instalação de um script headless.

É possível gerar metadados do p2 com chamadas manuais para o gerador de metadados do p2 em qualquer tarefa customizada do PDE/Build (consulteCustomizando um Build Headless). Entretanto o PDE/Build não fornece integração com p2 por meio das seguintes propriedades:

generate.p2.metadata
(DESCONTINUADO, em vez disso use p2.gathering) Configure como true para retornar à geração de metadados do p2. Os scripts ant baseiam-se na existência dessa propriedade e não no valor. Para desativar a geração de metadados, a propriedade deve ser removida e não apenas definida como false.
Nos scripts do build, as chamadas para os destinos do p2 são geradas quando o pacote configurável do p2 org.eclipse.equinox.p2.metadata.generator e suas dependências estão presentes no Eclipse que está executando o build. Esses destinos do p2 são condicionais na propriedade generate.p2.metadata.
p2.metadata.repo
p2.artifact.repo
Especifique um arquivo: URI que forneça o local dos repositórios p2 de metadados e artefatos no qual eles serão publicados. É comum, mas não necessário para o repositório do artefato, utilizar o mesmo local que o repositório de metadados.
Exemplo:
			p2.metadata.repo=file:${buildDirectory}/repository
			p2.artifact.repo=file:${buildDirectory}/repository
			
p2.metadata.repo.name
p2.artifact.repo.name
Opcional. Especifique os nomes para os repositórios do p2 do gerador.
ao utilizar um repositório que já existe, o nome do repositório existente não será alterado. Se não for especificado, o p2 nomeará os repositórios de acordo com seu local.
p2.flavor
Defina o tipo de metadados do p2. Quando os metadados são gerados para o Eclipse SDK, um tiop de "ferramentas" é utilizado.
p2.publish.artifacts
Defina como true para publicar jars no repositório de artefato. Se for definido como false, os metadados do artefato serão gerados, mas os jars não serão copiados para o repositório de artefato. AVISO: quando definido como true, certifique-se de que p2.artifact.repo não esteja no mesmo local que os diretórios de montagem utilizados pelo PDE/Build, caso contrário, os jars poderão ser excluídos!
p2.root.name
p2.root.version
Especifique o nome e a versão para a IU raiz que conterá tudo que foi construído.
Se um arquivo .product for especificado no build, essas propriedades serão ignoradas. Em vez disso, quando um arquivo .product ficar disponível, o nome raiz e a versão serão o id de produto e a versão do arquivo .product. Consulte abaixo para obter informações adicionais.

Geração de Metadados para Produtos

Ao executar um build com um arquivo de produto configurado no arquivo build.properties de configuração do build do nível superior (ambos os builds utilizando o productBuild.xml e build.xml normal), o PDE/Build gerará automaticamente os metadados para esse produto.

Além de criar Unidades Instaláveis para todos os recursos e pacotes configuráveis, isso também criará as seguintes Unidades Instaláveis do produto:

Com todas essas Unidades Instaláveis geradas, é possível utilizar o p2 para instalar o produto completo fora do repositório.

Os Detalhes

O PDE/Build está essencialmente chamando a tarefa de geração de metadados por p2 em determinados momentos durante o build. É provável que durante um build não exista nunca um único ponto no tempo em que todos os artefatos de build existam no disco no mesmo local. Portanto, seria necessário chamar o gerador de metadados do p2 nos archives finais ou, como uma otimização, chamá-lo várias vezes em todo o build.

A geração de metadados ocorrerá em todas as fases de montagem e empacotamento. Isso é verdadeiro para os builds normais e os builds empacotadores. Para ilustrar, para um build de produto utilizando o productBuild.xml, os seguintes scripts serão gerados(assumindo configs=win32,win32,x86 & linux,gtk,ppc):

Os scripts de montagem coletam recursos e plug-ins que foram construídos juntamente com os arquivos raiz. Os scripts de pacote coletam os recursos e os plug-ins binários pré-construídos. Os scripts específicos da plataforma coletam as partes dessas configurações em particular e "todos" os scripts delegam cada um dos scripts específicos da plataforma.

As chamadas de geração do p2 ocorrerão como segue:

  1. assemble win32.win32.x86 : Gerar metadados para recursos e plug-ins coletados para Windows.
  2. assemble win32.win32.x86 : Segunda chamada para metadados gerados para arquivos raiz coletados para Windows.
  3. assemble linux.gtk.ppc : Gerar metadados para recursos e plug-ins coletados para linux.
  4. assemble linux.gtk.ppc : Segunda chamada para metadados gerados para arquivos raiz coletados para linux.
  5. assemble all : Se o empacotador não estiver em execução: Gere metadados para uma unidade instalável raiz que inclua todos os anteriores.
  6. package win32.win32.x86 : Gerar metadados para recursos e plug-ins empacotados para Windows.
  7. package win32.win32.x86 : Segunda chamada para metadados gerados em arquivos raiz a partir de empacotamento para Windows.
  8. package linux.gtk.ppc : Gerar metadados para recursos e plug-ins empacotados para linux.
  9. package linux.gtk.ppc : Segunda chamada para gerar metadados em arquivos raiz a partir de empacotamento para linux.
  10. package all : Gerar metadados para uma unidade instalável que inclua todos os anteriores.

A tarefa do gerador de metadados do p2 suporta geração incremental, cada chamada para os metadados do p2 gerados é feita com mode=incremental, a chamada final para gerar a unidade instalável raiz executará com mode="final"