Obter a partir de Repositórios

A infra-estrutura fornecida pela Construção do PDE fornece os passos para obter o código-fonte e os plug-ins pré-construídos a partir de um repositório como parte do processo de construção (consulte a tarefa eclipse.fetch e propriedades para controlar obtenção). Estão disponíveis duas possibilidades: permitir que a construção de PDE obtenha automaticamente a origem ou obter o código fonte manualmente.

Primeiro passo da automatização, o ficheiro de correlações

Dado o identificador de uma função ou um plug-in que necessita ser construído, a infra-estrutura da construção é capaz de obter a partir de um repositório todas as funções e plug-ins incluídos.

De modo a saber onde poderá obter o que quer que seja necessário, o PDE utiliza ficheiros carregados em memória. Um ficheiro carregado em memória é um ficheiro de propriedades Java que correlaciona id de funções e de plug-ins com uma localização e com um identificador num repositório. O formato dos ficheiros de correlação é aberto mas a parte da chave é fixa pela Construção do PDE:

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

em que elementType é um dos seguintes, bundle, feature, plugin ou fragment e elementId e elementVersion consoante as especificidades do elemento.

Entrada de ficheiro de correlações para CVS

O formato de uma entrada de ficheiro de correlações para obter a partir de CVS é o seguinte:
<key> = CVS, [,args]
onde args é uma lista separada por vírgulas de pares chave/valor conforme se descreve a seguir: 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 de Correlação de estilo antigo
Em Eclipse 3.2 ou anterior, o formato do ficheiro de correlação para CVS era:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Se algum dos argumentos opcionais não for especificado, as vírgulas ainda são necessárias para delimitar quaisquer argumentos seguintes. Este formato deve ser considerado obsoleto e é preferível o formato chave/valor.

Entrada de ficheiro de correlações para Ant GET

O formato de uma entrada de ficheiro de correlações para obter o conteúdo de qualquer URL suportado por Ant GET é o seguinte:

<key> = GET, <url> [,args]
onde url é o url para recuperar os dados e args é uma lista opcional de pares chave/valor separados por vírgulas como se descreve a seguir: 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 ficheiro de correlações para uma busca p2

Foi adicionada uma nova extensão a PDE/Build que permite aos utilizadores buscar artefactos de repositórios de p2. Pode agora adicionar uma entrada no ficheiro de correlação para construir a entrada e PDE/Build vai obter o artefacto e incluí-lo na construção. A entrada do ficheiro de correlação tem de incluir o id e a versão da unidade de instalação (UI), e a URI do repositório onde se pode encontrar a UI. Os metadados e os repositórios de artefactos presume-se que sejam co-localizados.

O formato de uma entrada de ficheiro de mapa para buscar o conteúdo através de p2 é o seguinte:

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Funções de obtenção de informação com p2

Na edição Helios, as funções podem ser obtidas com p2 especificando a Unidade Instalável que representa a função jar. Consulte a página metadados de funções para obter detalhes sobre a estrutura de metadados de p2 para funções.

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 de ficheiro de correlações para outros repositórios

A construção do PDE fornece um ponto de extensão onde obter geradores de script para diferentes repositórios podem ser ligados. Quando a instalação do Eclipse contém um conjunto que fornece uma extensão de gerador de scripts para um tipo diferente de repositório, pode utilizar esse repositório especificando-o nas entradas do ficheiro de correlações e juntando-o ao formato especificado pelo fornecedor de extensões.

Configurar para busca de origem de CVS

Para configurar a busca da origem de CVS, deverá proceder da seguinte forma:

Obter os ficheiros de correlação de CVS

Os ficheiros de correlação são geralmente armazenados num repositório. A Construção de PDE oferece infra-estruturas predefinidas para obter esse ficheiro de correlações a partir de um repositório de CVS. Para activar esta função, altere as seguintes propriedades no seu ficheiro build.properties de configuração a partir do directório de configuração: A obtenção de ficheiros de correlações a partir do CVS ocorre durante a fase de Pré-construção. Os scripts utilizados para obter todas as funções e plug-ins incluídos na função que está a construir serão gerados e executados durante a fase de busca da construção. 

Busca automática de outros repositórios

Se estiver a obter os seus ficheiros de correlações automaticamente a partir do repositório, necessitará de copiar o ficheiro customTarget.xml a partir de org.eclipse.pde.build/templates/headless-build para o seu directório de configuração. O destino getMapFiles é utilizado para obter ficheiros de correlações. Este destino deverá ser alterado para obter a partir do repositório.

Obter código fonte manualmente

Pode gravar destinos de busca personalizados para obter plug-ins e funções que podem ser invocadas a partir de destinos preSetup ou postSetup no ficheiro customTargets.xml. As funções e os plug-ins deverão ser obtidos para ${buildDirectory}/features e ${buildDirectory}/plugins, respectivamente.