Reutilizando Metadados do p2

Os metadados de um determinado recurso ou pacote configurável podem ser diferentes, dependendo de como eles foram gerados. Particularmente, ao customizar metadados ou quando os recursos contribuem para arquivos raiz.

Por essa razão, é sempre uma boa ideia reutilizar metadados quando possível, em vez de gerá-los novamente com base em recursos binários e pacotes configuráveis que talvez você não possua.

Tarefa repo2runnable

Existe uma tarefa Ant <p2.repo2runnable> que transformará artefatos do recurso e do pacote configurável no formato instalado. De modo geral, esse é o formato que os plug-ins devem ter se desejarem poder ser compilados em relação a eles. Essa tarefa permite que reutilizemos repositórios de outros projetos em nossa própria construção. O PDE/Build possui integração integrada a esta tarefa por meio das seguintes propriedades:

repoBaseLocationUma pasta contendo repositórios para transformação. Essa pasta pode conter repositórios compactados, bem como subpastas que sejam repositórios.
transformedRepoLocationA pasta em que os artefatos transformados serão colocados. Essa pasta se tornará o próprio repositório do p2.

Novo no 3.5, são os destinos customizados, preProcessRepos e postProcessRepos, que ocorrem antes e após a chamada do PDE/Build para <p2.repo2runnable>. Isso permite espelhar ou fazer download automaticamente 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 desta gravação, o local dos zips finais da 3.5 ainda não era conhecido, as URLs aqui servem como exemplo apenas e podem não existir em alguma data posterior).

O PDE/Build primeiro chamará o destino customizado preProcessRepos, em seguida, chamará a tarefa ant repo2runnable para transformar esses repositórios transferidos por download em um formato que possa ser reutilizado pela construção.

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

Repositórios de Contexto

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

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

Também, se recursos, pacotes configuráveis ou produtos tiverem customizado seus metadados para depender de algo que não foi incluído na construção, o PDE/Build executará um espelhamento fora dos repositórios de contexto. Essa operação de espelhamento conterá todas as UIs que foram incluídas nos metadados do recurso ou do plug-in.