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:
onde args é uma lista separada por vírgulas de pares chave/valor conforme se descreve a seguir:
- tag, o identificador CVS a verificar;
- cvsRoot, uma cadeia de ligação de CV;
- path, um módulo e caminho de CVS opcional onde pode ir buscar a pasta que contém o elemento. Por predefinição, o nome do elemento é utilizado como o nome do módulo;
- prebuilt, um valor booleano opcional que indica se o elemento transferido é pré-construído. Por predefinição, o valor é false (falso);
- cvsPassFile, um caminho de opção para um ficheiro de palavra-passe de CVS;
- password, uma palavra-passe opcional a utilizar para estabelecer ligação a CVS;
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:
- unpack, definido como true (verdadeiro) para indicar que o elemento transferido deverá ser descompactado;
- verbose, definido com true (verdadeiro) para mostrar as informações de progresso verbosas durante a transferência. O valor predefinido é false (falso);
- ignoreerrors, definido como true (verdadeiro) para registar os erros durante o transporte. O valor predefinido é false (falso);
- usetimestamp, transferir condicionalmente um ficheiro com base na marca de hora da cópia local (apenas para URLs http) quando a definição é true (verdadeiro). O valor predefinido é false (falso);
- username, o nome de utilizador para autenticação http "BASIC";
- password, a palavra-passe para executar a transferência.
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
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>
- id, o identificador da Unidade Instalável;
- version, a versão da Unidade Instalável (opcional). Se não for especificada, será obtida a versão mais recente disponível.
- repository, a localização (URI) do repositório em que estará localizada a IU.
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:
- 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 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:
- 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
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.