Tutorial sobre Subversion - Parte 2: Criando uma Cópia de Trabalho Local e Comandos Básicos do Dia-a-Dia

No post anterior, aprendemos a como configurar um repositório Subversion (SVN) em um servidor. Clique aqui para maiores detalhes.

Criando uma Cópia de Trabalho na Máquina Local

Para criar uma cópia de trabalho, utilize o comando:

svn checkout file:///c:/repositorio/trunk c:/copia1 (Win)
svn checkout file:///repositorio/trunk c:/copia1 (Linux)

Obs1: o diretório copia1 não deve existir previamente.

Obs2: o protocolo file:/// deve ser usado quando o repositório Subversion e a cópia de trabalho local estão na mesma máquina; caso as máquinas sejam diferentes (repositório Subversion em uma e cópia de trabalho em outra) o checkout deve ser utilizado o protocolo svn:// da seguinte forma

svn checkout svn:///repositorio/trunk c:/copia1 (Win)
svn checkout svn:///repositorio/trunk c:/copia1 (Linux)

No tutorial será usado o protocolo file:///, caso você esteja em máquinas diferentes (repositório Subversion e cópia de trabalho local), basta substituir pelo protocolo svn:// como acima.

Obs3: o checkout deve ser feito em cima da pasta trunk, que é a linha principal de desenvolvimento do projeto.

Sincronizando a Cópia de Trabalho com o Repositório Subversion

Para atualizar sua cópia de trabalho com os arquivos que estão no repositório Subversion, execute o comando:

svn update c:/copia1 (Win)
snv update /copia1 (Linux)

Marcando um Arquivo para Versionamento na Cópia de Trabalho

Para marcar um arquivo para versionamento na cópia de trabalho, use o comando:

svn add c:/copia1/teste.txt (Win)
svn add /copia/teste.txt (Linux)

Obs1: considera-se aqui que você criou um arquivo teste.txt no diretório copia1.

Enviando as Alterações da Cópia Local para o Repositório Subversion

Para enviar as alterações que você realizou em sua cópia local (nesse caso, somente a adição de um arquivo, mas o comando serve para qualquer tipo de alteração da cópia local), utilize o comando:

svn commit c:/copia1 -m "Adicao do arquivo teste.txt." (Win)
svn commit /copia1 -m "Adicao do arquivo teste.txt." (Linux)

Removendo um Arquivo Versionado

Para remover um arquivo versionado, não basta excluí-lo via o sistema operacional, pois a próxima vez que um update for executado na cópia de trabalho local, o arquivo será restaurado. Dessa forma, para excluí-lo locamente, mas também no repositório Subversion, use o comando:

svn delete c:/copia1/teste.txt
svn delete /copia1/teste.txt

Obs1: o comando delete afeta o repositório Subversion somente após a execução do comando commit.

Referências

- Documentação do Subversion (é automaticamente instalada junto com o Subversion);

Glossário

• cópia de trabalho: estrutura de diretórios, em uma máquina local, que corresponde a um projeto armazenado em um repositório Subversion (este último localizado em um servidor).