h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Controle de Versãobitbuchet & mercurial

Thiago e Rafael

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Sumàrio

• Introdução -- OK• O bitbucket -- OK• O mercurial -- OK• Procedimento de uso

– Baixar a última versão estável

– Enviando alterações

– Resolvendo conflitos

– ...

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Introdução• O que é o programa de controle de versão

– É um software com a finalidade de gerenciar diferentes versões no desenvolvimento de um documento qualquer. Esses sistemas são comumente utilizados no desenvolvimento de software para controlar as diferentes versões, histórico e desenvolvimento dos códigos-fontes e também da documentação

• Vantagens– Controle do histórico: facilidade em desfazer e possibilidade de analisar o histórico do

desenvolvimento, como também facilidade no resgate de versões mais antigas e estáveis. A maioria das implementações permitem analisar as alterações com detalhes, desde a primeira versão até a última.

– Trabalho em equipe: um sistema de controle de versão permite que diversas pessoas trabalhem sobre o mesmo conjunto de documentos ao mesmo tempo e minimiza o desgaste provocado por problemas com conflitos de edições. É possível que a implementação também tenha um controle sofisticado de acesso para cada usuário ou grupo de usuários.

– Marcação e resgate de versões estáveis: a maioria dos sistemas permite marcar onde é que o documento estava com uma versão estável, podendo ser facilmente resgatado no futuro.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Elementos do sistema de controle de versão• Repositório: armazena a informação de modo persistente num sistema de arquivos ou

num banco de dados qualquer.

• Cliente: Geralmente o acesso é feito pela rede (via socket).

– Cada desenvolvedor possui em sua máquina uma cópia local somente da última versão de cada documento.

–  A cada alteração relevante do desenvolvedor é necessário "atualizar" as informações do servidor submetendo (commit) as alterações. O servidor então guarda a nova alteração junto de todo o histórico mais antigo. Se o desenvolvedor quer atualizar sua cópia local é necessário atualizar as informações locais, e para isso é necessário baixar novidades do servidor (update).

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Introdução• Informações mais detalhadas sobre os sistemas de

controle de versão podem ser acessadas no link:http://pt.wikipedia.org/wiki/Sistema_de_controle_de_vers%C3%A3o

• Sistemas utilizados pelo grupo de pesquisa OTN/Padtec:– Repositório: bitbucket– Software Cliente: Mercurial

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

bitbucketÉ um site que oferece serviço de servidor repositório privado

online, onde a configuração e gestão de repositórios é facilitada.

Acesse o bitbucket e crie seu perfil: www bitbucket.org

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

bitbucket

• Após a conclusão da inscrição peça ao administrador de repositórios lhe enviar um convite de compartilhamento dos repositórios do projeto

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

bitbucket• Caso receba o email convite e ainda não tenha conta no

bitbucket será necessário criá-la.

• Após o login e permissão de acesso ao repositório OTN seu ambiente terá a seguinte aparência.

Guarde esse endereçoVocê vai precisar depois

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

mercurial

• Após o acesso ao repositório no bitbucket precisamos instalar a estação cliente.

• No eclipse/omnetpp temos a opção de instalar o aplicativo do mercurial de forma que o sistema de desenvolvimento e de controle de versões fiquem integrados, facilitando e agilizando a produção.

• Veremos a seguir o processo de instalação e utilização do ambiente mercurial.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

mercurial1. Instalando o plugin do mercurial

no eclipse/omnetpp

Entre no menu Help - Install New Software...

Abrirá a janela Install.

Clique no botão Add.

Adicionamos um nome arbitrário, por exemplo Mercurial

O site de repositório que deve ser http://cbes.javaforge.com/update

Confirme no botão OK

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

mercurial1.2 - Em "work with" selecionamos o item

adicionado:

Mercurial - http://cbes.javaforge.com/update

1.3 - Surge um campo pending... até aparecer os seguintes campos para instalação:

- codeBeamer Eclipse Studio- MercurialEclipse

Marcamos o segundo 'MercurialEclipse' por

default. Para usuários linux é necessário remover

o subitem 'Windows Binaries for Mercurial' em

'MercurialEclipse deixando somente o subitem

'MercurialEclipse'

1.4 - Seguir a instalação 'Next'>>'Next'>>'Finish' esperar instalar e aceitar os 'Dialogs' reiniciando o Eclipse/Omnetpp.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

mercurial• 2 - Clonando o projeto existente para seu Workspace.

no menu 'File' >> 'New' >> 'Other' aparecerá uma janela e no item 'Mercurial' selecionamos o subitem 'Clone Existing Mercurial Repository’

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

mercurial• A seguir preencha os campos

conforme abaixo:

URL: https://seuUSERSERNAME@bitbucket.org/Labtel/projeto_otn

Username: seuUSERNAME

Password: suaSENHA

• seguir 'Next' > Seleciona o ultimo repositório postado e 'Finish'. Pronto! A última versão do projeto deve aparecer.

PS.: Repita o passo 2 para baixar o INETFiles apenas trocando 'projeto_otn' por 'inetfiles'.

Endereço guardado do repositório do bitbucket

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Procedimento de uso

• Baixar uma versão mais nova• Enviar alterações• Resolvendo conflitos

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Baixar uma versão mais nova• Para baixar uma versão mais nova do repositório do Bitbuket

para o seu repositório local, você deve primeiro sincronizar e logo após efetuar um pull.

– Clique com o botão direito na sua pasta de reposição no Project Explorer e escolha a opção team->Synchronise

– Espere que os dados sejam carregados completamente na sincronização.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Baixar uma versão mais nova• Clique com o botão direito na sua pasta de reposição no Project Explorer

e escolha a opção team->Pull...

• Selecionadas as opções apresentadas uma tela de opções aparecerá. Provavelmente os dados do repositório, usuário e senha já estarão preenchidos corretamente, caso contrário atualize os campos com os dados corretos.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Baixar uma versão mais nova• Selecione a versão a ser baixada e clique no botão Finish.

• Pronto agora é só aguardar a transferência ser concluída e verificar se o código da sua versão está de acordo com a importada do repositório do bitbucket.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Enviar alterações• Para enviar suas alterações para o repositório do Bitbucket

inicialmente você deve limpar seu código retirando os arquivos de compilação e os logs de teste.

– Clique em Project->Clean...

Logo após você deverá sincronizar seu repositório com o repositório do bitbucket.

– Clique com o botão direito na sua pasta de reposição no Project Explorer e escolha a opção team->Synchronise

– Espere que os dados sejam carregados completamente na sincronização.

Caso você não tenha a ultima versão do código você primeiro deverá realizar um backup das suas alterações e baixar a versão mais recente do código realizando os procedimentos apresentados na sessão Baixar uma versão mais nova.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Enviar alterações• O próximo passo para criar uma versão para envio é “commitar”. Essa

operação criará uma nova versão que estará em seu repositório local.– Clique com o botão direito na sua pasta de reposição no Project Explorer e

escolha a opção team->Commit.

Na página de configuração que aparece descreva as alterações realizadas de forma que os demais desenvolvedores do sistema possam acompanhar a evolução do projeto.

Selecione os arquivos que deseja que sejam atualizados para sua nova versão

Logo após clique em Ok.

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Enviar alterações• Realizados os procedimentos listados você deverá enviar sua versão do

repositório local para o repositório do bitbucket.– Clique com o botão direito na sua pasta de reposição no Project Explorer e

escolha a opção team->Push...

Selecionadas as opções apresentadas uma tela de opções aparecerá. Provavelmente os dados do repositório, usuário e senha já estarão preenchidos corretamente, caso contrário atualize os campos com os dados corretos

h

ttp

://w

ww

.lab

tel.ele

.ufe

s.b

r

Enviar alterações• Caso você já esteja com a versão mais recente do repositório, selecione a

versão commitada e finalize o envio.Se tudo ocorrer bem você poderá visualizar sua nova versão no topo da linha de desenvolvimento no site repositório do bitbucket.

Caso a sua versão corrente não seja a última versão presente no bitbucket você pode ainda forçar o envio e criar uma nova linha de desenvolvimento escolhendo a opção Force Push na janela anterior. Essa opção não é aconselhável pois requer a necessidade de junção posterior que pode acarretar perdas de dados seus e de outros desenvolvedores