Integração de Compilação PDE com p2

Esta página descreve uma forma antiga obsoleta de integrar com p2. Consulte a página "Construir repositórios e produtos de p2" para os métodos recomendados para construir com p2. As propriedades descritas em baixam funcionam utilizando o nível de retro-compatibilidade e não suportam quaisquer novas funções que possam ser adicionadas ao publicador p2.

Consulte a página Criação de Metadados p2 no Manual de Programador de Plugin-in de Plataforma (Platform Plugin-in Developer Guide) para obter detalhes sobre a criação de metadados p2. A criação de metadados por si só não é suficiente para criar um produto com capacidade para p2. Para o fazer, tem de executar uma instalação de p2 efectiva dos metadados criados. Consulte a documentação de director p2 para obter detalhes sobre como executar esta instalação a partir de um script sem cabeçalho.

É possível criar metadados p2 com chamadas manuais para o criador de metadados de p2 em qualquer uma das tarefas personalizadas de PDE/Build (consulte Personalizar uma Compilação sem Cabeçalho). No entanto, PDE/Build faculta integração com p2 através das propriedades seguintes:

generate.p2.metadata
(OBSOLETO, utilize antes p2.gathering) Definir para true para ligar a criação de metadados de p2. Os scripts ant baseiam-se na existência desta propriedade e não no valor. Para desactivar a criação de metadados, a propriedade tem de ser removida e não apenas definida como false.
Nos scripts de compilação, as chamadas para destinos de p2 são criadas quando o agrupamento de p2 org.eclipse.equinox.p2.metadata.generator e as respectivas dependências estão presentes no Eclipse que está a ser executado na compilação. Estes destinos de p2 estão dependentes da propriedade de generate.p2.metadata.
p2.metadata.repo
p2.artifact.repo
Especifique uma URI de file: dando a localização dos repositórios de metadados e artefactos p2 onde publicar. É habitual, mas não é necessário que o repositório de artefactos use a mesma localização do 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. Especifica um nome para os repositórios geradores de p2.
Ao usar um repositório que já existe, o nome existente de repositório não será alterado. Se não for especificado, o p2 irá dar um nome aos repositórios de acordo com as respectivas localizações.
p2.flavor
Defina o tipo para os metadados de p2. Quando são gerados metadados para o Eclipse SDK, é usado um tipo de "ferramentas".
p2.publish.artifacts
Defina como verdadeiro (true) para publicar jars no repositório de artefactos. Se for definido como falso (false), são gerados metadados de artefactos, mas os jars não são copiados para o repositório de artefactos. AVISO: quando está definido como verdadeiro, certifique-se de que p2.artifact.repo não tem a mesma localização dos directórios de montagem usados por PDE/Build; caso contrário, os jars podem ser eliminados!
p2.root.name
p2.root.version
Especifique o nome e a versão para o IU de raiz que irá conter tudo o que foi compilado.
Se um ficheiro de .product for especificado na compilação, essas propriedades serão ignoradas. Ao contrário, quando um ficheiro .product está disponível. o nome de raiz e a versão serão o id de produto e a versão do ficheiro .product. Consulte o que se segue para mais informações.

Geração de Metadados para Produtos

Ao executar uma compilação com um ficheiro de produto definido no ficheiro build.properties de configuração de compilação de nível superior (quer nas compilações que usem productBuild.xml quer no build.xml normal),o PDE/Build irá gerar automaticamente metadados para esse produto.

Para além de criar Unidades Instaláveis para todas as funções e agrupamentos, esta acção também irá criar as Unidades Instaláveis de produto que se seguem:

Com todas estas Unidades Instaláveis geradas, é possível usar p2 para a instalação do produto completo fora do repositório.

Os Detalhes

O PDE/Build resume-se essencialmente a chamar a tarefa de criação de metadados facultados por p2 em determinados pontos durante a compilação. É provável que, durante uma compilação nunca surja uma única ocasião em que todos os artefactos de compilação existam num disco ao mesmo tempo. Por isso, seria necessário chamar o criador de metadados p2 nos arquivos finais ou, como forma de optimização, chamá-lo várias vezes ao longo da compilação.

A criação de metadados irá ocorrer ao longo das fases de montagem e de empacotamento. Esta afirmação é verdadeira quer para compilações normais quer para compilações de empacotadores. Para ilustrar, para um produto compilado com productBuild.xml, serão gerados os scripts que se seguem (partindo do princípio que configs=win32,win32,x86 & linux,gtk,ppc):

Os scripts de montagem recolhem funções e plug-ins que foram construídos com os ficheiros root associados. Os scripts de pacote recolhem funções binárias de pré-construção e plug-ins. Os scripts específicos à plataforma recolhem os pedaços para essas configurações em particular e os scripts "all" delegam para cada um dos scripts específicos à plataforma.

As chamadas de criação de p2 irão ocorrer da seguinte forma:

  1. assemble win32.win32.x86 : Gerar metadados para funções recolhidas e plug-ins para windows.
  2. assemble win32.win32.x86 : Segunda chamada para criação de metadados para ficheiro root recolhidos para windows.
  3. assemble linux.gtk.ppc : Gerar metadados para funções recolhidas e plug-ins para linux.
  4. assemble linux.gtk.ppc : Segunda chamada para criação de metadados para ficheiro root recolhidos para linux.
  5. assemble all : Se o empacotador não estiver em execução: Gerar metadados para uma unidade instalável de raiz que inclui tudo o que foi referido acima.
  6. package win32.win32.x86 : Gerar metadados para funções empacotadas e plug-ins para windows.
  7. package win32.win32.x86 : Segunda chamada para criação de metadados em ficheiros root de empacotamento para windows.
  8. package linux.gtk.ppc : Gerar metadados para funções empacotadas e plug-ins para linux.
  9. package linux.gtk.ppc : Segunda chamada para criação de metadados em ficheiros root de empacotamento para linux.
  10. package all : Gerar metadados para uma unidade instalável raiz que inclua tudo o que foi referido acima.

A tarefa do criador de metadados p2 suporta criação incremental, cada chamada gerada para os metadados p2 é feita com mode=incremental, a última chamada para criar a unidade instalável raiz será executada com mode="final"