Controle de Versão bitbuchet & mercurial Thiago e Rafael

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 ...

Introdução O que é o programa de controle de versão Vantagens É 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.

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).

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

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

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

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ço Você vai precisar depois

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.

mercurial 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

mercurial 1.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.

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’

mercurial A seguir preencha os campos conforme abaixo: URL: https://seuUSERSERNAME@bitbuck et.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

Procedimento de uso Baixar uma versão mais nova Enviar alterações Resolvendo conflitos

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.

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.

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.

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.

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.

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

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