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