Reutilizar Metadados de p2

Os metadados para uma determinada função ou lote podem ser diferentes dependendo de como foram gerados. Em particular quando personalizar metadados, ou quando as funções contribuírem ficheiros raiz.

Devido a isto, é sempre boa ideia reutilizar metadados quando possível em vez de os regenerar com base em funções e lotes binários de que poderá não ser proprietário.

A tarefa repo2runnable

Existe uma tarefa Ant <p2.repo2runnable> que vai transformar os artefactos da função e do lote no seu formato instalado. Em termos gerais, trata-se do formato necessário para os plug-ins se quisermos ter a possibilidade de compilar com eles. Esta tarefa permite reconsumir facilmente repositórios de outros projectos na sua própria construção. O PDE/Build tem integração incorporada com esta tarefa através das seguintes propriedades.

repoBaseLocationUma pasta que contém repositórios a transformar. Esta pasta pode conter repositórios compactados bem como subpastas que são repositórios.
transformedRepoLocationA pasta em que serão colocados os artefactos transformados. Esta pasta irá depois tornar-se um próprio repositório de p2.

Novidade na 3.5 são destinos personalizados preProcessRepos e postProcessRepos que ocorrem antes e depois da chamada de PDE/Build para <p2.repo2runnable>. Vai permitir a replicação automática ou o descarregamento de repositórios compactados:
build.properties:
	repoBaseLocation=${buildDirectory}/inputRepositories
	transformedRepoLocation=${buildDirectory}/transformedRepo
	
customTargets.xml:
<target name="preProcessRepos">
   <p2.mirror source="http://download.eclipse.org/releases/galileo" destination="file:${repoBaseLocation}/mirrored">
      <iu id="org.eclipse.equinox.p2.user.ui.feature.group" />
      <iu id="org.eclipse.cdt.feature.group"/>
   </p2.mirror>
   <property name="RCP.Repo-3.5RC3" value="http://download.eclipse.org/eclipse/downloads/drops/S-3.5RC3-200905282000/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <property name="Equinox.Repo-3.5RC3" value="http://download.eclipse.org/equinox/drops/S-3.5RC3-200905282000/equinox-SDK-3.5RC3.zip" />
   <get src="${RCP.Repo-3.5RC3" dest="${repoBaseLocation}/org.eclipse.rcp-p2repo-3.5RC3.zip" />
   <get src="${Equinox.Repo-3.5RC3" dest=""${repoBaseLocation}/eclipse-equinox-3.5RC3.zip" />
</target>
(No momento deste documento, a localização das compactações finais da 3.5 ainda não era conhecida, os URLs aqui servem como exemplo apenas e podem não existir posteriormente.)

O PDE/Build vai primeiro chamar o destino personalizadopreProcessRepos, depois vai chamar a tarefa ant repo2runnable para transformar os repositórios descarregados num formato que pode ser reutilizado pela construção.

A propriedade transformedRepoLocation que define a localização para a saída desta transformação também serve como repositório de contexto.

Repositórios de contexto

A propriedade p2.context.repos é uma lista separada por vírgulas de repositórios que servem como contexto para a construção.

Ao gerar metadados, a construção vai primeiro consultar os repositórios de contexto para ver se já existem metadados para a função ou plug-in. Se os metadados já existirem, serão copiados para o repositório local da construção (${p2.build.repo}) em vez da criação de novos metadados.

Além disso, se as funções, lotes ou produtos personalizaram os metadados para dependerem de algo que não estava incluído na construção, o PDE/Build vai executar uma replicação dos repositórios de contexto. Esta operação de replicação vai incluir as IUs que foram adicionadas aos metadados da função ou do plug-in.