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 |
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 |
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 |
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. |
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.
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:
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"