SVN-BUILDPACKAGE(1)

Referência de comando

SVN-BUILDPACKAGE(1)

NOME¶

svn-buildpackage - constrói pacotes Debian a partir de repositório SVN

SINOPSE¶

svn-buildpackage [[ OPÇÕES... ] [ OPÇÕES para o dpkg-buildpackage ]]

DESCRIÇÃO¶

Constrói um pacote Debian a partir de um repositório Subversion. O repositório de código fonte tem de estar no formato criado pelo svn-inject, e este script tem de ser executado no directório de trabalho (trunk/pacote).

Por predefinição, o directório de trabalho é usado como o directório de fonte principal (assumindo que toda a fonte original está armazenada no repositório). A alternativa é o chamado "modo merge". Com este método, apenas o directório debian (e talvez outros ficheiros modificados) são armazenados no repositório. Durante a construção, o conteúdo do trunk svn é copiado para o conteúdo do tarball extraído (e pode sobrescrever partes dele). Para escolher este modelo de trabalho, defina a propriedade mergeWithUpstream do svn no directório debian.

$ svn propset mergeWithUpstream 1 debian

mergeWithUpstream requer que o sistema possa preparar um tarball, usando tipicamente make dist e autotools. Todos os pacotes da origem irão ter alguma forma de suporte a criação de tarball e os pacotes nativos que usam autotools ou têm suporte de tarball interno podem usar mergeWithUpstream para lidar com os ficheiros gerados que são necessários para construir o pacote mas não estão presentes no SVN. Veja o guia HOWTO para exemplos de como isto pode ser feito. Os pacotes nativos que não usam autotools e não têm suporte de tarball interno podem ainda adicionar os ficheiros gerados ao tarball do pacote fonte usando o useNativeDist ao alvo do Makefile de nível de topo. Este alvo personalizado tem de ser idempotente e apenas modificar / gerar os ficheiros desejados usando apenas a fonte SVN exportada e as dependências de construção. Para permitir ao svn-buildpackage usar um alvo make native-dist no seu Makefile de nível de topo, regule a propriedade useNativeDist no directório ./debian/:

$ svn propset useNativeDist 1 debian

O comportamento predefinido do svn-buildpackage é o seguinte:

Verifica o directório de trabalho, queixa-se de ficheiros não submetidos (veja também --svn-ignore-new)

Copia o tarball de origem para a área de construção se necessário (veja também --svn-no-links)

Extrai o tarball (em modo de fusão) ou exporta o directório de trabalho do svn para o directório de construção (veja também em baixo e --svn-no-links)

Constrói com o dpkg-buildpackage (veja também --svn-builder, --svn-lintian, etc.)

Cria um entrada no registo de alterações para a versão futura

OPÇÕES¶

svn-buildpackage aceita as seguintes opções na linha de comandos:

--svn-builder=COMANDO

Especifica um comando de construção alternativo em vez de dpkg-buildpackage, ex. debuild, pdebuild, etc. Cada parâmetro que o svn-buildpackage não conhece (--svn-*) é passado para COMMAND. Não existe diferença entre os parâmetros de linha de comandos e ficheiro de configuração. Eles são usados ao mesmo tempo.

AVISO: as regras de cotação da shell não se aplicam completamente aqui, é melhor usar wrappers para construções complexas. Usar esta opção pode quebrar a funcionalidade de --svn-lintian e --svn-move. Algumas funções podem ser desactivadas quando é usado um comando de construção personalizado porque a localização do ficheiro resultante não é previsível.

Predefinição: usa dpkg-buildpackage.

--svn-ignore-new | --svn-ignore

Não pára em conflitos do svn ou ficheiros novos/alterados. Para definir este comportamento para ficheiros únicos defina a propriedade deb:ignoreM para 1 neles. Veja também a documentação da propriedade svn:ignore no livro do SVN.

Predefinição: Pára em conflitos ou ficheiros novos/alterados.

--svn-dont-clean

Não corre a limpeza de debian/rules.

Predefinição: primeiro limpa.

--svn-no-links

Não use links de ficheiro mas tente exportá-los ou fazer cópias físicas do directório de trabalho. Isto é útil se o seu pacote falhar na construção devido a alguns ficheiros, directórios vazios, links quebrados... não poderem ser transportados no modo link-copy predefinido.

Predefinição: usa os links onde possível.

--svn-dont-purge

Não remove o directório de construção quando a construção está pronta.

Predefinição: remove após construção com sucesso.

--svn-reuse

Se possível, reutilize um directório de construção existente nas construções subsequentes. O directório de construção não é purgado após a construção, não é renomeado quando uma construção começa e os ficheiros são apenas copiados para ele. Útil em modo mergeWithUpstream como pacotes grandes.

Predefinição: o directório de construção é removido.

--svn-rm-prev-dir

Se for encontrado um directório de construção anterior, remove-o antes da construção em vez de o renomear. Se --svn-reuse for também fornecido na mesma linha, o corre o comportamento de reutilização.

Predefinição: renomeia os directórios antigos com o sufixo 'obsolete'.

--svn-export

Apenas exporta o directório de trabalho e faz as operações de fusão de código necessárias, e depois termina.

Predefinição: Desligado.

--svn-tag

Construção final: Etiqueta, exporta, constrói com limpeza & cria nova entrada no registo de alterações.

Predefinição: Desligado.

--svn-tag-only | --svn-only-tag

Não constrói o pacote, apenas faz a cópia da etiqueta.

Predefinição: Desligado.

--svn-retag

Se um directório alvo existente foi encontrado durante a tentativa de criação da cópia de etiqueta, primeiro remove o directório alvo.

Predefinição: Desligado.

--svn-noautodch

Nenhuma entrada no registo de alterações Debian é adicionada automaticamente.

Predefinição: Uma nova entrada no registo de alterações UNRELEASED é definida via dch.

--svn-lintian

Corre o lintian no ficheiro de alterações resultante quando pronto.

Predefinição: Desligado.

--svn-move

Quando pronto, move os ficheiros criados (como listado em .changes) para o directório pai, relativo àquele onde o svn-buildpackage foi iniciado.

Predefinição: Desligado.

--svn-move-to=...

Especifica o directório alvo para onde mover os ficheiros gerados.

Predefinição: Desligado. (Os ficheiros são deixados onde o comando de construção os colocou.)

--svn-pkg=nome_de_pacote

Sobrepõe o nome de pacote detectado. Use com cuidado porque pode ser definido tarde demais durante o processamento (ex. ainda ter o valor antigo quando expandir variáveis da shell).

Predefinição: Desligado.

--svn-arch=ARQUITECTURA

Permite especificar a arquitectura de construção (ex. construir para i386 numa máquina amd64).

Predefinição: Desligado.

--svn-override=var=valor,anothervar=valor

Sobrepõe qualquer variável de configuração que tenha sido auto-detectada ou encontrada em .svn/deb-layout.

Predefinição: Desligado.

--svn-prebuild | --svn-postbuild | --svn-pretag | --svn-posttag

Comandos (hooks) a serem executados antes/após as invocações dos comandos de construção/etiquetagem, ex. para descarregar os tarballs de origem a partir do arquivo. Aqui pode ser incluído código de shell apesar de não ser recomendado. Várias variáveis de ajuda estão disponíveis no ambiente, veja VARIÁVEIS DE AMBIENTE em baixo para uma explicação detalhada.

Por favor note que os hooks prebuild e postbuild substituem as acções prebuild e postbuild normais do svn-buildpackage. Para prebuild, isto significa que as dependências de construção não serão verificadas. Para postbuild, isto significa que os ficheiros resultantes não serão movidos, e o lintian não será executado.

Predefinição: Desligado.

--svn-noninteractive

Com este parâmetro o svn-buildpackage não irá interagir com o utilizador.

Predefinição: Desligado.

--svn-savecfg

Por predefinição, o svn-buildpackage costumava criar .svn/deb-layout a cada invocação. Desde a versão 0.6.22 que este comportamento está descontinuado.

Com este parâmetro o svn-buildpackage irá (parcialmente) replicar o comportamento antigo. Em contraste com o comportamento descontinuado, o .svn/deb-layout é reconhecido como uma sobreposição local; o comportamento antigo simplesmente ignorava qualquer informação de disposição com versão se encontrasse .svn/deb-layout.

Esta opção foi disponibilizada porque pode ser útil quando se cria um ficheiro de sobreposição local.

Predefinição: Desligado.

--svn-download-orig

Esta opção faz com que o svn-buildpackage tente descarregar o tarball da origem usando apt e uscan.

Predefinição: Desligado.

--svn-verbose

Saída do programa mais detalhada.

Predefinição: Desligado.

-h | --help

Mostra a mensagem de ajuda.

EXEMPLOS¶

Para informação mais detalhada de como usar o svn-buildpackage, veja o HOWTO. http://svn-bp.alioth.debian.org/[1].

Para começar a trabalhar com um pacote Debian nativo existente a partir de um ficheiro *.dsc, importe-o para o repositório com o comando:

svn-inject package_0.1.dsc svn://host/debian/devel/packages

Para começar a trabalhar com um pacote da origem existente em Debian a partir de um ficheiro *.dsc, importe-o para o repositório com o comando:

svn-inject -o package_0.1-2.dsc svn://host/debian/devel/packages

Antes de construir um pacote da origem, certifique-se que a fonte original está disponível, ex. se o uscan está a funcionar:

svn mkdir ../tarballs
svn propset svn:ignore "*" ../tarballs
uscan --force-download --destdir ../tarballs

Para uma construção teste do pacote a partir de repositório SVN, use o comando abaixo. Use referências do manual do dpkg-buildpackage(1) para as opções -us etc.

svn-buildpackage --svn-lintian -us -uc -rfakeroot

Para verificar que o pacote constrói num estado limpo, teste-o com pbuilder(1):

svn mkdir ../build-area  # Para armazenar resultados
svn propset svn:ignore "*" ../build-area
svn-buildpackage --svn-ignore-new --svn-builder=pdebuild

Quando um novo lançamento da origem está disponível, submete todas as alterações e tem a árvore de trabalho num estado limpo. Depois usa o svn-upgrade(1) para importar o novo lançamento.

svn status   # Verifica que não há alterações não submetidas
svn-upgrade --verbose ../package-2.0.tar.gz

FICHEIRO DE CONFIGURAÇÃO¶

O comportamento do svn-buildpackage pode ser modificado usando o ficheiro ~/.svn-buildpackage.conf. Podem ser adicionadas partes adicionais em cada directório de trabalho de pacote usando o ficheiro .svn/svn-buildpackage.conf. É essencialmente uma lista de opções longas de linha de comandos (sem os sinais menos iniciais), um argumento por linha (sem citações envolvendo os argumentos de múltiplas palavras). As variáveis são expandidas com a shell do sistema se lá existirem variáveis de shell. Evite o sinal ~ porque não é expansão de confiança: É melhor usar antes $HOME. Exemplo:

svn-builder=debuild -EPATH
svn-no-links
svn-override=origDir=$HOME/debian/upstream/$PACOTE
# svn-ignore-new
#svn-lintian

MANUSEAMENTO DA DISPOSIÇÃO DO DIRECTÓRIO¶

Por predefinição, o svn-buildpackage espera um ficheiro de configuração com declaração de caminho/url, .svn/deb-layout. Os valores de lá podem ser sobrepostos com a opção --svn-override, veja em cima. Se um ficheiro de configuração não pode ser encontrado, as definições são auto-detectadas seguindo as deduções normais acerca de directórios locais e disposição do repositório. Adicionalmente, o conteúdo de um ficheiro personalizado debian/svn-deblayout será importado durante a configuração inicial. Os responsáveis pelo pacote podem armazenar este ficheiro no repositório para passar predefinições correctas aos novos utilizadores do svn-buildpackage. O formato é o mesmo que no ficheiro .svn/deb-layout. Como uma alternativa ao ficheiro debian/svn-deblayout, os responsáveis podem definir as propriedades do Subversion para o directório debian/, quaisquer propriedades de debian/ que tenham um nome no formato svn-bp:PROP serão a fonte da definição PROP a qual tem o valor indicado pela primeira linha do valor da propriedade. Se não for fornecido um URL de svn completo, o repositório raiz irá ser precedido para este valor.

VARIÁVEIS DE AMBIENTE¶

As seguintes variáveis de ambiente são exportadas pelo svn-buildpackage e podem ser usadas em hook a comandos ou ao sistema de construção de pacotes.

PACOTE, pacote

O nome do pacote fonte.

SVN_BUILDPACKAGE

Versão do svn-buildpackage.

TAG_VERSION, debian_version

A string de versão Debian completa, também usada para a copia de etiqueta.

non_epoch_version

O mesmo que debian_version mas sem strings de época.

upstream_version

O mesmo que debian_version mas sem extensões Debian

guess_loc

Nome do pacote fonte da origem adivinhado na pool, algo como libm/libmeta-html-perl_3.2.1.0.orig.tar.gz

DIFFSRC

(experimental) mostra a localização do ficheiro diff gerado

Todas as propriedades de disposição são também exportadas para o ambiente. As seguintes têm significado para o svn-buildpackage.

buildArea

a localização do directório de área de construção

trunkUrl

o URL do directório trunk para o pacote actual.

tagsUrl

o URL do directório base de etiquetas para o pacote actual.

origDir

o directório local onde o tarball original deve estar colocado.

origUrl

o URL de onde pode ser puxado o tarball original do pacote actual.

As seguintes variáveis são compreendidas pelo svn-buildpackage:

FORCETAG

Ignora os sinais de um registo de alterações incompleto e etiqueta o repositório mesmo assim.

FORCEEXPORT

Exporta a fonte da origem a partir do repositório mesmo que a propriedade mergeWithUpstream esteja definida.

DEBIAN_FRONTEND

Se DEBIAN_FRONTEND estiver definida para 'noninteractive', --svn-noninteractive é chamado em silêncio.

RECOMENDAÇÕES¶

Usa nomes alternativos de shell. Aqui estão alguns exemplos para Bash:

alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
alias svn-br="svn-b --svn-dont-purge --svn-reuse"
alias svn-bt="svn-buildpackage --svn-tag -rfakeroot"

Esses comandos têm significados respectivos: construir independentemente de ficheiros novos ou alterados; construir independentemente de ficheiros novos ou alterados e reutiliza o directório de construção; construir e etiquetar (para upload).

SSH é o modo mais fácil de aceder a repositórios remotos, apesar de geralmente requerer a entrada da palavra passe com mais frequência com o svn-buildpackage. Meios de contornar incluem usar uma chave ssh com uma frase passe (apesar de isto ser inseguro e mesmo assim relativamente lento), ou a funcionalidade de cache da ligação SSH presente nas versões recentes do SSH. Para mais detalhes, veja o manual do svn-buildpackage.

Outro modo de obter uma ligação remota é usar o módulo DAV do Subversion (com SSL e autenticação do utilizador do Apache), veja o manual HOWTO do svn-buildpackage para mais detalhes.