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:
em que args é uma lista separada por vírgula de pares de chave/valor descritos abaixo:
- tag, a tag CVS para registro de saída;
- cvsRoot, uma cadeia de conexão do CVS;
- path, um módulo opcional do CVS e um caminho onde obter a pasta que contém o elemento. Por padrão, o nome do elemento é utilizado como o nome do módulo;
- prebuilt, um booleano opcional que indica se o elemento transferido por download é pré-construído. Por padrão, ele é false;
- cvsPassFile, um caminho de opção para um arquivo de passagem do cvs;
- password, uma senha opcional a ser utilizada para conectar ao 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 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:
- unpack, definido como true, indica que o elemento transferido por download deve ser descompactado;
- verbose, definido como true para mostrar informações do progresso detalhado ao transferir por download. O valor padrão é false;
- ignoreerrors, definido como true para registrar erros durante o transporte. O valor padrão é false;
- usetimestamp, transfere por download condicionalmente um arquivo baseado no registro de data e hora da cópia local (somente para URLs http) quando definido como true. O valor padrão é false;
- username, o nome do usuário para autenticação http "BASIC";
- password, a senha para fazer o download.
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
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>
- id, o identificador da Unidade Instalável;
- version, a versão do Instalável (opcional). Se não for especificada, a versão mais alta disponível será buscada.
- repository, o local (URI) do repositório em que a IU será encontrada.
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:
- Certifique-se de que exista um cvs.exe no caminho da procura do sistema.
(Faça download do CVS aqui).
- Crie uma pasta chamada mapas no diretório de build.
- Crie um arquivo com a extensão .map na pasta mapas.
- Preencha esse arquivo de mapeamento com todos os elementos que precisam ser
buscados a partir de um repositório.
- Edite o arquivo build.properties a partir da pasta de configuração e
inclua um indicador de comentário na linha skipFetch=true. Se essa propriedade
for configurada, o build PDE ignorará a fase inteira de busca. Se você
desejar que a tag especificada nos arquivos de mapeamento seja ignorada, poderá
configurar a propriedade fetchTag para um valor específico. Isso será útil ao
fazer um build noturno a partir de HEAD em vez das versões rotuladas com tags.
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:
- skipMaps: Inclua um indicador
de comentário para esta propriedade. Se essa propriedade for configurada, o build PDE
não buscará os arquivos de mapeamento.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. O repositório CVS
a partir do qual os arquivos de mapeamento serão obtidos.
- mapsRoot =
/path/to/maps. O caminho no repositório CVS para o diretório
que contém os arquivos de mapeamento.
- mapsCheckoutTag =
HEAD. A tag CVS a ser utilizada para efetuar o registro de saída dos arquivos de mapeamento.
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.