Obter a partir de Repositórios
A infra-estrutura oferecida pela Construção de PDE faculta passos para obter o
código fonte para construir a partir de um repositório como parte do processo de construçã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.
Obter código fonte automatizado a partir de CVS
Dado o identificador de uma função que necessita de ser construída, a
infra-estrutura de construção conseguirá obter todas as funções e plug-ins incluídos a partir de CVS.
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 de uma entrada de ficheiro carregado em memória para obter a partir
de CVS é:
<elementType>@<elementID> = CVS, <TAG>,
<CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
em que elementType é um dos agrupamentos, funções,
plug-ins ou fragmentos. Se o caminho não estiver
especificado, o nome do elemento será utilizado como módulo de CVS, como por
exemplo:
plugin@org.foo.bar=CVS,v20060501,:pserver:anonymous@cvs.example.org:/cvsroot/foo
irá obter o plug-in org.foo.bar que foi identificado com o
identificador v20060501 do cvs.eclipse.org/cvsroot/foo/org.foo.bar
Configurar para busca de origem de CVS
Para configurar a busca da origem de CVS, deverá proceder da seguinte forma:
- Certifique-se que tem um cvs.exe no caminho de procura do sistema.
(Descarregue o CVS a partir de aqui).
- Crie uma pasta denominada correlações no directório de construção.
- Crie um ficheiro com a extensão .map na pasta correlações.
- Preencha este ficheiro de correlações com todos os elementos que
necessitam de ser obtidos a partir do repositório.
- Edite o ficheiro build.properties da pasta de configuração e torna
comentário a linha skipFetch=true. Se esta propriedade estiver
definida, a construção de PDE irá ignorar completamente a fase de busca.
Se pretende que o identificador esteja especificado nos ficheiros de
correlações que deverão ser ignorados, poderá definir a propriedade
fetchTag com um valor específico. Esta acção é útil ao proceder a uma
construção efectuada durante a noite a partir de HEAD e não de versões identificadas.
Obter os ficheiros de correlação de CVS
Os ficheiros de correlação são geralmente armazenadas num repositório. A
Construção de PDE oferece infra-estruturas predefinidas para obter esse
ficheiros de correlação 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:
- skipMaps: Tornar esta propriedade comentário.
Se esta propriedade estiver definida, a construção de PDE não irá obter
os ficheiros de correlações.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. O repositório de CVS a partir do qual se obtêm ficheiros de correlações.
- mapsRoot =
/path/to/maps. O caminho no repositório de CVS para o directório que contém ficheiros de correlação.
- mapsCheckoutTag = HEAD. O
identificador de CVS utilizado para dar saída aos ficheiros de correlações.
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
A Construção de PDE faculta um ponto de extensão em que são conectados os
geradores de scripts de busca de repositórios diferentes. Quando a
instalação do eclipse contém um agrupamento que faculta uma extensão de gerador
de scripts para um tipo de repositórios diferente, pode utilizar esse
repositório ao especificá-lo nas entradas do ficheiro de correlações:
<elementType>@<elementID> = <REPOSITORY>, <TAG>,
[...]
O formato da entrada da correlação após o TAG irá depender da extensão.
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.