Da Wikipedia:
“Subversion (SVN) é um sistema de controle de versão iniciado em 2000 pela CollabNet Inc. É utilizado para manter um histórico de versões de arquivos como código fonte, páginas web e documentação.
Seu objetivo é ser um sucessor inteiramente compatível ao amplamente utilizado Concurrent Versions System (CVS).”
Resumo
O SVN é muito utilizado pela comunidade open-source onde os desenvolvedores trabalham no mesmo projeto de forma distribuída ao redor do globo.
Ele funciona em uma arquitetura cliente servidor onde todos os arquivos de um projeto ficam em um servidor SVN e os desenvolvedores mantém uma cópia de trabalho local em seus próprios micros, sincronizando com o servidor através de um software cliente SVN.
Assim, quando um desenvolvedor realiza uma modificação na árvore do projeto, como por exemplo alterar o conteúdo de um arquivo, ele deve informar o servidor SVN para que este mantenha-se atualizado. Dessa forma, outros desenvolvedores que se conectarem ao servidor saberão que existem modificações nos arquivos do projeto em relação a sua cópia de trabalho local.
Cada modificação tem um histórico/log, onde o desenvolvedor digita um texto sobre o que foi alterado.
Cada vez que a árvore do projeto for modificada, não importa se houve alteração em um único arquivo, o projeto ganha um novo número de revisão.
O SVN é considerado uma “máquina do tempo” pois permite que você restaure versões antigas dos arquivos e examine o histórico/log de como e quando os dados foram alterados e quem os alterou.
Existem muitas funcionalidades no SVN e com o tempo adquire-se prática na utilização delas.
O servidor SVN é um servidor de arquivos?
Apesar do funcionamento do servidor SVN ser parecido com um servidor de arquivos tradicional existem algumas diferenças.
Não é possível baixar os arquivos que nele estão sem utilizar um software cliente SVN ou ferramentas específicas.
Isso acontece porque o servidor SVN mantém árvores de projetos em um formato próprio, mantendo um controle do que foi alterado de uma revisão para outra.
É por isso que a cada nova revisão do projeto, não há duplicação de todo o conteúdo. Apenas o que foi alterado de uma revisão para outra é que fica armazenado.
Como servidor SVN, utilizamos o gratuito VisualSVN.
O que é um cliente SVN?
O cliente SVN é o software que se comunica com o servidor SVN permitindo funcionalidades como baixar a revisão mais atual do projeto, atualizar arquivos no servidor, reverter arquivos da cópia de trabalho local ao estado anterior, etc…
Existem 3 tipos de clientes:
1. Linha de comando (prompt);
2. Integrado ao Explorer do Windows;
3. Plugin para IDEs (Eclipse, Visual Studio, etc…);
Os tipos 2 e 3 são os mais práticos de utilizar.
O TortoiseSVN
O cliente SVN que escolhemos para utilizar pode ser baixado aqui: http://tortoisesvn.net/downloads
TortoiseSVN é um cliente gratuito open-source prático, basta clicar com o botão da direita sobre uma pasta ou arquivo para ver as funcionalidades do SVN no menu de contexto.
Importante:
- O TortoiseSVN requer BOOT DO SISTEMA do sistema pois fica integrado ao Windows Explorer.
- Existe versão específica para Windows 64 bit pois a versão 32 bit não funciona corretamente neste sistema operacional.
Depois de instalar o TortoiseSVN em seu sistema, você pode instalar também o pacote para a língua portuguesa no mesmo local onde baixou o executável Tortoise.
Subversion em ação
Chamamos de repositório o local no servidor SVN que armazena os projetos e seus arquivos.
Este repositório que está no servidor é acessado pelo cliente SVN utilizando um URL parecido com:
https://IP_do_Servidor_SVN:8443/svn/nome_do_projeto/trunk
O trunk “tronco” nada mais é do que os arquivos principais do projeto pois o SVN também nos dá a possibilidade de criar ramificações “branches” do projeto sem alterar os arquivos principais. Isto é útil em casos como por exemplo o desenvolvimento de uma nova versão de teste de um determinado software.
Cópia de trabalho é uma pasta comum no seu micro que contém uma cópia dos arquivos do projeto (que está no servidor) entretanto é sua área privativa e o SVN não irá incorporar nesta cópia as mudanças que outros desenvolvedores fizeram sem sua expressa solicitação.
Da mesma forma, o SVN não disponibilizará a outros desenvolvedores as modificações que você fez até você solicitar.
Depois que você fizer algumas modificações nos arquivos da sua cópia de trabalho, o SVN te dará no menu de contexto do Windows Explorer comandos para publicar suas mudanças no servidor SVN para que outros desenvolvedores trabalhando com você tenham acesso a estas modificações. Por isso as modificações devem ser testadas antes de serem enviadas ao servidor.
Se outros desenvolvedores publicarem suas próprias modificações (no servidor SVN) nestes mesmos arquivos antes que você tenha publicado então estas mudanças entrarão em conflito com as suas e o cliente SVN te dará comandos no menu para mesclar tais mudanças na sua cópia de trabalho manualmente. Uma vez resolvidos estes conflitos, você deve realizar esta publicação. Mais sobre isso abaixo.
Testando
Consideramos que você já tenha baixado e instalado o software cliente TortoiseSVN e que tenha um servidor SVN com um repositório chamado “teste” para realizar o teste abaixo.
- Escolha uma pasta onde armazenará os fontes dos projetos
- Dentro desta pasta crie uma pasta “teste”
- Clique com o botão da direita sobre a pasta teste e escolha a opção SVN Obter (Checkout)
- Na caixa de diálogo, digite o URL do repositório acima e clique no botão OK
Digite seu login e senha se for a primeira vez que acessa o servidor e salve-o.
Se tudo ocorreu como esperado, o Tortoise obterá do servidor SVN a última revisão do projeto teste salvando os arquivos e pastas no seu diretório local “teste”. Observe a janela para relata o processo.
Experimente criar um novo arquivo neste diretório “teste” com seu nome e extensão .txt, por exemplo “seunome.txt”. Note que ao fazer isso aparecerá um ícone de interrogação sobrepondo o ícone do arquivo. Isso significa que o arquivo não está sob controle de versão.
Abaixo um resumo dos ícones do SVN que aparecem em sua pasta “teste” no Windows Explorer.
Significado dos ícones:
Foi obtida uma cópia “fresca” do arquivo/pasta e este ícone significa que o estado é normal.
Assim que você começa a editar um arquivo, seu estado muda para modificado (modified) e o ícone se torna um exclamação vermelho. Você pode ver facilmente quais arquivos foram alterados desde que você modificou sua cópia de trabalho e que devem ser atualizados no servidor.
Se durante uma atualização ocorrer um conflito (conflict) então o ícone se torna um exclamação amarelo.
Se você travar um arquivo somente para leitura, o SVN faz aquele arquivo ficar somente para leitura até que você destrave.
Se você manter uma trava em um arquivo e o estado SVN dele for normal, este ícone te lembrará que você deve destravá-lo se não estiver mais utilizando-o para permitir que outros desenvolvedores atualizem as modificações que fizeram neste arquivo.
Este ícone mostra que alguns arquivos ou pastas dentro da pasta atual foram marcados para serem deletados do controle de versão ou um arquivo com controle de versão está faltando dentro de uma pasta.
O sinal de adição indica que um arquivo ou pasta foi marcado para ser adicionado ao controle de versão.
Este ícone de barra diz que um arquivo ou pasta é ignorado para propósitos de controle de versão.
Este ícone mostra arquivos e pastas que não estão sob controle de versão mas não foram ignorados.
Menus de contexto
Abaixo um resumo dos principais comandos utilizados do menu de contexto do TortoiseSVN no Windows Explorer.
Importar (Import):
Envia o conteúdo de uma pasta local para um repositório no servidor SVN. Normalmente é utilizado pelo responsável pelo repositório ou projeto para preparar o servidor para o trabalho em equipe. Utilize com cuidado.
Antes de importar você deve remover todos os arquivos que não são necessários para construir/compilar o projeto (por exemplo arquivos temporários, arquivos objeto, etc…).
Para importar, selecione a pasta de nível superior da estrutura de diretório do seu projeto no Windows Explorer e clicando com o botão da direita selecione TortoiseSVN->Importar. Digite a URL do repositório para onde quer enviar seu projeto.
Obter (Checkout):
Obtém do repositório (no servidor SVN) uma cópia de trabalho local do projeto.
Selecione uma pasta no Windows Explorer onde você quer colocar sua cópia de trabalho. Clique com o botão da direita no menu de contexto e selecione TortoiseSVN->Obter.
Submeter (Commit):
Enviar as modificações que você realizou na sua cópia de trabalho é conhecido como submeter (commit). Antes de você submeter, você deve ter certeza que sua cópia de trabalho está atualizada. Você deve utilizar a opção TortoiseSVN->Atualizar (Update) ou TortoiseSVN->Verificar alterações (Check for Modifications).
Se a sua cópia de trabalho está atualizada e não há conflitos, você está pronto para submeter suas modificações para o repositório. Selecione qualquer arquivo e/ou pasta que você quer submeter e selecione TortoiseSVN->Submeter (Commit) no menu de contexto do Windows Explorer.
A caixa de diálogo de submeter mostrará todos os arquivos modificados incluindo arquivos adicionados, deletados e sem controle de versão. Se não quiser submeter um arquivo desmarque a caixa correspondente. Se quiser adicionar um arquivo sem controle de versão selecione a caixa correspondente para submetê-lo.
Ao submeter, você deve digitar uma mensagem de histórico/log que descreve as modificações que você realizou. Este é um grande benefício do SVN e ajudará em outras ocasiões se bem utilizado.
Atualizar (Update):
Periodicamente você deve se certificar que as modificações realizadas por outros desenvolvedores sejam incorporadas na sua cópia de trabalho local. Este processo de baixar as modificações do servidor para sua cópia local é chamado de atualização. Esta atualização pode ser feita com arquivos individuais, um conjunto de arquivos ou recursivamente em toda hierarquia de diretório.
Para atualizar, selecione os arquivos e/ou pastas que você quer e clique com o botão da direita selecionando TortoiseSVN->Atualizar (Update) no menu de contexto. Uma janela exibirá o progresso. As modificações realizadas por outros serão mescladas aos seus arquivos, mantendo quaisquer modificações que você tenha realizado nos mesmos arquivos num formato próprio para resolução de conflitos. Mais sobre isso abaixo.
O repositório não é afetado por uma atualização pois os arquivos e pastas saem do servidor em direção a sua cópia de trabalho local.
A atualização padrão não tem opções e apenas atualiza sua cópia de trabalho para a revisão HEAD que é a mais recente.
Se você quer mais controle sobre o processo de atualização pode utilizar a opção TortoiseSVN->Atualizar para Revisão (Update to Revision). Isto permite que você atualize sua cópia de trabalho para uma revisão específica e não necessariamente a mais recente.
Comparar (Diff):
Um dos requisitos mais comuns no desenvolvimento de projeto é ver o que foi alterado. Você pode querer ver as diferenças entre duas revisões do mesmo arquivo ou a diferença entre dois arquivos separados.
Para ver quais modificações você fez na sua cópia de trabalho simplesmente utilize o menu de contexto do Windows Explorer e selecione TortoiseSVN->Comparar (Diff).
Se você quiser ver a diferença entre uma revisão em particular e sua cópia de trabalho utilize TortoiseSVN->Comparar com revisão anterior (Diff with previous version).
Resolvendo Conflitos
Possivelmente haverá conflitos quando você atualizar/mesclar seus arquivos com o repositório. Existem dois tipos de conflitos:
- conflitos de arquivos
- conflitos de árvore
Um conflito de arquivo ocorre quando dois (ou mais) desenvolvedores modificaram as mesmas linhas de um arquivo. Quando isso ocorre, você deve abrir o arquivo em questão e procurar pelas linhas que começam com <<<<<<<. A área de conflito é marcada assim:
<<<<<<<< nomedoarquivo
suas modificações
=======
código mesclado do repositório
>>>>>>> revisão
Além disso para cada arquivo com conflito Subversion coloca três arquivos no seu diretório:
nomedoarquivo.ext.mine
Este é seu arquivo como existia na sua cópia de trabalho antes de você efetuar uma atualização com o servidor, ou seja, sem os marcadores de conflito. Este arquivo possui suas últimas modificações.
nomedoarquivo.ext.rREVANTIGA
Este é o arquivo base da revisão, antes de você atualizar sua cópia de trabalho, ou seja, este arquivo que você obteve antes de efetuar suas modificações.
nomedoarquivo.ext.rREVNOVA
Este é o arquivo que seu cliente SVN acabou de receber do servidor quanto você efetuou uma atualização da sua cópia de trabalho. Este arquivo corresponde à revisão HEAD do repositório, ou seja, a revisão mais recente que possui as modificações recentes de outros desenvolvedores.
Você pode lançar um ferramenta externa de edição de conflito com a opção TortoiseSVN->Editar Conflitos (Edit Conflicts) ou você pode manualmente resolver o conflito. Você deve decidir como o código deve ser, fazer as modificações necessárias e salvar no arquivo .mine.
Depois que fizer isto, execute o comando TortoiseSVN->Resolvido (Resolved) e submeta suas modificações para o repositório. Note que o comando Resolvido não resolve o conflito, ele apenas remove os arquivos nomedoarquivo.ext.mine, nomedoarquivo.ext.rRAVANTIGA e nomedoarquivo.ext.rREVNOVA permitindo que você execute o TortoiseSVN->Submeter (Commit) para aí sim, subir para o repositório suas modificações.
Se você tiver problemas com arquivos binários, Subversion não tentará mesclar os arquivos ele próprio. O arquivo local permanecerá o mesmo e você terá os arquivos da revisão antiga e da nova como o exemplo acima. Se você quiser descartar suas modificações e manter a versão do repositório, então apenas utilize o commando Reverter (Revert) do menu. Se você quiser manter sua versão e sobrepor a versão do repositório, utilize o comando Resolvido (Resolved) e submeta sua versão.
Você pode utilizar o comando Resolvido (Resolved) para vários arquivos se você clicar na pasta superior e selecionar TortoiseSVN->Resolvido. Isto exibirá uma caixa de diálogo listando todos os arquivos conflitantes naquela pasta e você poderá selecionar quais estão resolvidos.
Antes de utilizar o comando Resolvido, verifique se você mesclou corretamente suas modificações com as de outros desenvolvedores pois ao efetuar em seguida um Submeter, suas modificações serão salvas sobre o que já existe no repositório.
Um conflito de árvore ocorre quando um desenvolvedor move/renomeia/deleta um arquivo ou pasta, que outro desenvolvedor também tenha movido/renomeado/deletado ou apenas modificado. Existem várias situações que podem resultar num conflito de árvore e requerem formas diferentes de resolver.
Quando um arquivo é deletado localmente no Subversion, o arquivo também é deletado do sistema de arquivos local, então mesmo que seja parte de um conflito de árvore ele não pode exibir um estado de conflito e você não pode clicar com o botão da direita nele para resolver o conflito. Ao invés disso, utilize Verificar Modificações (Check for Modifications) para acessar a opção Editar conflitos (Edit conflicts).
O TortoiseSVN pode ajudar a encontrar o local certo para mesclar as modificações mas pode haver trabalho adicional necessário para acertar os conflitos. Lembre-se que depois de uma atualização a BASE de trabalho terá sempre a revisão de cada item como era no repositório no momento da atualização. Se você reverter uma modificação depois de atualizar, ela voltará ao estado do repositório e não como era quando você começou a fazer modificações locais.
Estas são as funcionalidades básicas do SVN, para mais informações você pode consultar também o manual do usuário em: