Como colaborar no desenvolvemento de software de código aberto usando Bazaar

Bazaar (ou bzr) é un proxecto de Canónico para levar a cabo o control de versións no desenvolvemento de software de código aberto de xeito sinxelo. É a ferramenta empregada en Launchpad para a xestión de revisión de paquetes. En Launchpad almacénanse moitos proxectos de código aberto pero non todos; polo que este tutorial só che servirá para colaborar no desenvolvemento das aplicacións alí almacenadas. Se nunca creou un proxecto en Launchpad porque o atopaches moi complicado, este artigo interesarache.

introdución

Para comezar, tes que instalar bzr:

sudo apt-get install bzr

Bazaar confía en claves SSH para transferir ficheiros á túa conta de Launchpad. Se non tes unha clave SSH, podes seguir as instrucións seguintes para obter a túa clave SSH desde Launchpad. Se xa o tes, podes saltar esta parte e ir directamente á sección "Usando Bazar".

Tecla Launchpad / SSH

Para crear a túa clave SSH:

ssh-keygen -t dsa

Responda á primeira pregunta coa opción predeterminada premendo Intro e logo introduza unha "frase de acceso" ou "frase de acceso" para a súa clave SSH. Cando rematei, corrín:

cat ~ / .ssh / id_dsa.pub

Copia a túa clave pública, que se amosou no paso anterior, e vai a Launchap e edita a túa clave SSH:

https://launchpad.net/~username/+editsshkeys

Non esquezas cambiar o nome de usuario x o teu nome e editsshkeys x a túa clave SSH.

Pega a clave en "Engadir unha clave SSH" e fai clic en "Importar clave pública".

Usando Bazaar

Digamos que atopou un proxecto en Launchpad no que quere colaborar ou quizais quere descargar o seu código fonte para adaptalo ás súas necesidades. Supoñamos tamén que este proxecto é perlbot. Nese caso, tería que ir a:

https://code.launchpad.net/~drsmall/perlbot/trunk

Podes ver o directorio con todos os ficheiros ("tronco") e tamén ver as revisións do proxecto.

Se queres descargar unha copia do "maleteiro" no teu disco duro, só tes que executar:

bzr pull lp: perlbot

Este comando descargará o código fonte de perlbot a ~ / perlbot no seu disco duro. Podes modificalo e enviar as modificacións ao maleteiro (cos permisos necesarios).

Entón, supoña que desexa iniciar a súa propia versión (ou "sucursal"), onde pode almacenar e compartir as modificacións que fixo ao programa, ou tamén pode ser algo creado por vostede e que desexa desenvolver en equipo . Para iso, reúne todos os ficheiros colocados na túa "sucursal" en Launchpad e colócaos nun directorio local. Despois executa:

inicio bzr

Isto converte ese directorio nunha rama. Se te tomas o problema de ver, verás que agora hai un novo directorio chamado .bzr dentro do teu directorio. É aí onde se gardan todas as revisións e ficheiros para que os use bzr. Agora, engade todos os ficheiros á rama:

bzr engadir *

É unha boa idea tomar o costume de executar o seguinte comando para comprobar se hai cambios entre a versión máis recente e a actual. Non debes facelo a primeira vez.

bzr diff

Co seguinte paso, imos comprometer as nosas modificacións coa nova revisión. É unha boa idea comentar as súas críticas con profusión.

bzr commit -m "Comentario da revisión XX"

Agora poderás subir a túa opinión á túa "filial" en Launchpad. Se a rama aínda non existe, crearase. Podes ter varias ramas, polo que recomendo que as nomes correctamente. Este comando pode levar uns minutos, pero ten en conta que debe crear a "rama", cargar os teus ficheiros, crear as revisións, etc.

bzr push lp: ~ usuario / nome do proxecto / nome da sucursal

Outros comandos útiles:

Crear unha sucursal:

inicio bzr

Descargar unha sucursal:

tirar bzr 

Actualizar unha sucursal:

empuxe bzr 

Engade ficheiros á túa sucursal:

bzr engadir 

Comprobe a diferenza entre as revisións:

bzr diff

Realiza a revisión:

bzr commit -m "Comentario de revisión"

Podes atopar o resto dos comandos básicos executando:

home bzr