Usando o RapidSVN

Este tutorial irá auxiliá-lo a utilizar algumas funções básicas do client para Subversion, RapidSVN.

Para fazer o Checkout de arquivos:

1. Abra o RapidSVN;
2. Clique com o botão direito em Bookmarks, localizado no painel esquerdo, e então em Add Existing Working Copy…;
   1. Indique o diretório. Se o diretório não existir, o RapidSVN irá perguntar se deseja criá-lo;
   2. Isso irá criar um local de trabalho para um projeto do Subversion, chamado no RapidSVN de Bookmark.
3. Feito o bookmark, clique com o botão direito nele, e então Checkout New Working Copy..;
4. Na URL, indique o que se deseja baixar do Subversion. Em Destination Directory indique o local para onde os arquivos baixados irão;
   1. Se for solicitado, informe o seu usuário e senha do Subversion, e depois OK;

Com isso o Checkout já está pronto. Se quiser manter a sincronização com o Subversion (para, por exemplo, editar e executar “COMMIT” depois), então mantenha o bookmark. Caso contrário é recomendável apagá-lo. Veremos mais abaixo como apagar o Bookmark.

1. Clique com o botão direito no bookmark que se deseja apagar e escolha a opção Remove bookmark;
   1. Note que isso irá apagar apenas o bookmark dele no RapidSVN. Isso não irá apagar os arquivos que foram baixados nele.

O Lock e Unlock no RapidSVN não podem ser feitos recursivamente indicando apenas o diretório. Sendo assim, o Lock e Unlock devem ser feitos por arquivo.

Para fazê-lo:

1. Após realizar o Checkout, selecione o(s) arquivo(s) no painel da direita que deseja travar, e então execute o comando Lock;
2. Será solicitada uma descrição do porquê da trava. Essa descrição é opcional;
   1. Há também a opção Steal lock if it belongs to another user, que pode ser usada para “roubar” a trava. Isso pode ser útil para o caso de algum outro usuário ter travado o(s) arquivo(s) e esquecido de destravá-lo(s), ou mesmo se os arquivos foram excluídos antes de liberar a trava.

O comando Unlock tem o efeito inverso. Ele destrava um arquivo que esteja travado por você.

1. Para executá-lo, simplesmente clique no arquivo com o botão direito e execute o comando Unlock;
   1. Ao realizar o Unlock será apresentada uma tela de confirmação. Nessa mesma tela existe a opção Force unlocking even if you are not the lock owner. Essa opção executa o destravamento do(s) arquivo(s) mesmo que você não seja a pessoa quem o travou.

Se você fez o Checkout de algum projeto e manteve o bookmark, os arquivos do bookmark estarão visíveis no painel direito do RapidSVN.

Quando um arquivo é editado, o mesmo arquivo fica marcado com cor vermelha no RapidSVN, indicando que ele foi editado.

Veremos aqui mais detalhadamente como trabalhar com edições no projeto.

O commit é o comando que envia os arquivos e o projeto de volta para o Subversion, confirmando qualquer alteração que tenha sido feita nele.

No RapidSVN o commit pode ser feito individualmente por arquivo, ou então pelo bookmark, onde ele envia para o Subversion todos os arquivos que foram alterados naquele bookmark.

Para fazê-lo, clique com o botão direito sobre o bookmark ou o arquivo e execute o comando commit. Será apresentada uma tela para indicar a descrição daquele commit. Nessa mesma tela existe a opção Keep Locks, que mantém a(s) trava(s) feita(s) no(s) arquivo(s), se houver alguma.

Ao fazer o commit, na tela inferior do RapidSVN (A tela que indica os status e as operações) irão aparecer algumas informações. Uma das informações é a Committed revision que indica qual é o número da revisão que está indo no commit feito. Para esse parâmetro, o valor -1 indica que nada foi alterado, portanto, nenhuma revisão foi armazenada no Subversion.

Quando um arquivo é adicionado ao projeto, o ícone dele fica com um ponto de interrogação (?) no RapidSVN.

Este passo merece atenção, pois o RapidSVN não inclui arquivos para o controle de versão no Subversion automáticamente. Sendo assim, sempre que arquivos novos forem adicionados no projeto, é necessário adicioná-los no controle de versão manualmente.

Para fazê-lo, clique com o botão direito sobre o arquivo desejado, e então escolha a opção Add.

Do mesmo modo que o RapidSVN não adiciona arquivos ao projeto automáticamente, ele também não os exclui do projeto.

Quando um arquivo do projeto é apagado no HD do cliente, o mesmo fica com um ícone semelhante à um papel rasgado no RapidSVN e com o status de missing. Isso, no entanto, não quer dizer que irá apagá-lo do projeto no Subversion.

1. Para apagá-lo do projeto no Subversion, clique sobre o arquivo com o botão direito e escolha a opção Delete;
   1. Ao fazê-lo, aparecerá uma tela de confirmação com a opção Force removal. Se marcada, ao apagar do controle de versão do Subversion o arquivo também será apagado da máquina do cliente.