Buscando nos Repositórios

A infra-estrutura oferecida pelo Build PDE apresenta etapas para buscar o código-fonte e plug-ins de pré-construção em um repositório como parte do processo de construção (consulte a tarefa eclipse.fetch e as propriedades para controlar a busca). Duas possibilidades estão disponíveis: permitir ao build PDE buscar automaticamente a origem ou buscar manualmente o código-fonte.

Primeira etapa para automação, o arquivo de mapas

Dado o identificador de um recurso ou um plug-in que precisa ser construído, a infra-estrutura de construção é capaz de buscar em um repositório todos os recursos e plug-ins incluídos.

Para saber de onde é possível obter informações, o PDE utiliza arquivos de mapeamento. Um arquivo de mapeamento é um arquivo de propriedades Java que mapeia IDs de recurso e de plug-in para um local e uma tag em um repositório. O formato de arquivos de mapeamento é aberto, mas a parte chave é fixada pelo Build PDE:

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

em que elementType é um pacote configurável, recurso, plug-in ou fragmento, e elementId e elementVersion fornecem detalhes específicos do elemento.

Entrada do arquivo de mapeamento para CVS

O formato de uma entrada de arquivo de mapeamento para buscar conteúdo no CVS é o seguinte:
<key> = CVS, [,args]
em que args é uma lista separada por vírgula de pares de chave/valor descritos abaixo: Exemplo:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Entradas do Mapa de Estilo Antigo
No Eclipse 3.2 e anterior, o formato de arquivo de mapas para CVS era:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Se algum argumento opcional não for especificado, as vírgulas ainda são necessárias para delimitar qualquer argumentos que se segue. Esse formato deve ser considerado reprovado e o formato de chave/valor é preferido.

Entrada do arquivo de mapeamento para Ant GET

O formato de uma entrada do arquivo de mapeamento para buscar conteúdo em qualquer URL suportado por Ant GET é o seguinte:

<key> = GET, <url> [,args]
em que url é a url a partir do qual recuperar os dados e args é uma lista opcional separada por vírgula de pares de chave/valor descritos abaixo: Exemplo:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Entrada de arquivo de mapeamento para uma busca do p2

Uma nova extensão foi incluída no PDE/Build que permite que os usuários busquem artefatos de repositórios do p2. Agora é possível incluir uma entrada em seu arquivo de mapas para a entrada da construção e PDE/Build recuperará o artefato e o incluirá na construção. A entrada do arquivo de mapas precisa incluir o id e a versão da unidade instalável (UI) e a URI do repositório em que a IU pode ser encontrada. Presume-se que os repositórios de metadados e artefatos sejam co-localizados.

O formato de uma entrada de arquivo de mapeamento para buscar conteúdo por meio do p2 é o seguinte:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Buscando recursos com p2

No release Helios, os recursos podem ser buscados com p2 especificando a Unidade Instalável que representa o jar de recurso. Consulte a página metadados de recursos para obter detalhes sobre a estrutura de metadados p2 para recursos.

Exemplos:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Entrada do arquivo de mapeamento para outros repositórios

O Build PDE fornece um ponto de extensão no qual os geradores de script de busca para diferentes repositórios podem ser conectados. Quando a instalação do eclipse contiver um pacote configurável que fornece uma extensão do gerador de scripts para um tipo diferente de repositório, você poderá utilizar esse repositório especificando-o nas entradas do arquivo de mapeamento e aderindo ao formato especificado pelo provedor de extensão.

Configurando a Busca de Origem CVS

Para configurar a busca de sua origem a partir do CVS, você deve fazer o seguinte:

Obtendo os Arquivos de Mapeamento a partir do CVS

Os arquivos de mapeamento são geralmente armazenados em um repositório. O Build PDE oferece uma infra-estrutura padrão para obter esses arquivos de mapeamento a partir de um repositório CVS. Para permitir que isso funcione, altere as seguintes propriedades no build.properties de sua configuração a partir do diretório de configuração: A busca dos arquivos de mapeamento a partir do CVS ocorre durante a fase de Pré-Build.  Os scripts para buscar todos os recursos e plug-ins incluídos no recurso que você está construído serão gerados e executados durante a fase de busca do build. 

Busca Automática de Outros Repositórios

Se  você estiver buscando automaticamente os arquivos de mapeamento a partir do repositório, precisará copiar o arquivo customTarget.xml do org.eclipse.pde.build/templates/headless-build para seu diretório de configuração.  O destino  getMapFiles é utilizado para buscar os arquivos de mapeamento; isso deve ser modificado para busca a partir de seu repositório.

Obtendo Manualmente o Código-fonte

Você pode gravar destinos de busca customizada para recuperar seus plug-ins e recursos que podem ser chamados a partir dos destinos preSetup ou postSetup no arquivo customTargets.xml.  Os recursos e plug-ins devem ser buscados, respectivamente, para ${buildDirectory}/features e ${buildDirectory}/plugins.