💻Olá, pessoal! Quem aí usa o TortoiseSVN para controlar seus projetos? Sinceramente não se a demanda é grande (muita gente já migrou para o GitHub, eu mesmo controlo muitos projetos com o GitHub agora). Mas aqui na empresa há um projeto em específico (o mais antigo de todos) que usa o TortoiseSVN. Como raramente preciso mapear ele de novo para poder trabalhar na codificação (acontece mais quando troca de equipamento ou quando, por algum motivo ou outro mudo minhas pastas de controle de projetos de um HD para outro) eu nunca me recordo de cara como se faz esse mapeamento, apesar de ser um processo bem simples. Resolvi então registrar aqui no Blog esse passo a passo e, se você, assim como eu, vive no VSCode e precisa lidar com projetos versionados no SVN (Subversion), este este passo a passo também é para você.
Esse guia é super didático e vai ajudar a lembrar como mapear um projeto SVN utilizando o TortoiseSVN diretamente no seu ambiente de trabalho local. Esqueça as complicações, vamos simplificar o controle de versão para otimizar seu fluxo de desenvolvimento! Porém, esse pequeno passo a passo parte do princípio que você já tem o SVN instalado na sua máquina e no servidor onde está o seu projeto principal (o repositório principal, por assim dizer), de modo que vou focar aqui apenas no processo de mapeamento em si.
Por que mapear um projeto SVN localmente?
No dia a dia, muitas empresas ainda utilizam o SVN para gerenciar o código fonte dos projetos. E, para nós que usamos o VSCode como editor principal, ter o projeto mapeado localmente é essencial para:
- Trabalhar offline: Mesmo sem conexão direta com o servidor SVN, você continua produtivo, com acesso total ao código.
- Performance: Acesso rápido aos arquivos, sem depender da velocidade da rede para cada alteração.
- Integração com VSCode: Aproveitar todos os recursos do VSCode, como IntelliSense, debug, e extensões, no seu projeto SVN.
- Facilidade de versionamento: Utilizar o TortoiseSVN, uma ferramenta gráfica e intuitiva, para realizar commits, updates, e outras operações SVN diretamente do Windows Explorer.
Mão na Massa: Mapeando seu Projeto SVN com TortoiseSVN Passo a Passo
Vamos ao que interessa! Siga este guia detalhado para mapear seu projeto SVN e começar a trabalhar no VSCode rapidinho:
1. Crie a Pasta Local do Projeto:
- Primeiro, escolha um lugar no seu computador onde você quer guardar a cópia local do projeto SVN. Pode ser na sua pasta "Documentos", na "Área de Trabalho", ou onde preferir.
- Crie uma nova pasta com o nome que desejar para o projeto. Exemplo: "Projeto_SVN_Local".
 |
| Captura de tela mostrando a criação da pasta 'Projeto_SVN_Local' no Windows Explorer. |
- Abra o Explorador de Arquivos do Windows e navegue até a pasta que você acabou de criar.
 |
| Captura de tela mostrando o Explorador de Arquivos aberto na pasta 'Projeto_SVN_Local |
3. Checkout SVN: O Coração do Mapeamento:
- Dentro da pasta vazia, clique com o botão direito do mouse em qualquer área livre.
- No menu de contexto, procure e clique em "SVN Checkout...". (Se não aparecer, verifique se o TortoiseSVN está instalado corretamente).
 |
| Captura de tela mostrando o menu de contexto com a opção 'SVN Checkout...' sendo selecionada |
4. Configurando o Checkout:
-
Uma janela do TortoiseSVN será aberta. É aqui que a mágica acontece!
-
"URL of repository:": Neste campo crucial, você precisa colocar o endereço do repositório SVN no servidor. Essa informação é fornecida pela equipe de TI ou administrador do SVN da sua empresa. Geralmente, começa com
svn://ouhttps://. No meu caso, o endereço do projeto que estou mapeando éfile://10.0.200.218/ti/2_SISTEMAS/Luft_V11. URLsfile://indicam que o repositório está em um servidor interno ou compartilhamento de rede. -
"Checkout directory:": Este campo já deve vir preenchido com o caminho da pasta que você criou no passo 1. Confirme se está correto. Se precisar mudar, clique em "Browse..." e selecione a pasta certa.
-
"Checkout Depth:": Deixe como "Fully recursive" para baixar o projeto completo.
-
"Revision:": Mantenha em "HEAD revision" para pegar a versão mais recente do projeto.
-
-
Confira a imagem abaixo para visualizar a tela de Checkout:
 |
| Captura de tela mostrando a janela de configuração do Checkout no TortoiseSVN. |
- Depois de conferir tudo, clique em "OK".
- O TortoiseSVN vai começar a baixar todos os arquivos do projeto do servidor SVN para a pasta local no seu computador. Aguarde o processo terminar (uma janela de progresso será exibida).
 |
| Captura de tela mostrando a janela de progresso do TortoiseSVN durante o download dos arquivos do repositório. |
- Após o checkout ser finalizado, feche a janela do TortoiseSVN.
- Abra o VSCode.
- Vá em "File" (Arquivo) > "Open Folder..." (Abrir Pasta...).
- Navegue até a pasta que você criou e onde fez o checkout (ex: "Projeto_SVN_Local") e clique em "Select Folder" (Selecionar Pasta).
Pronto! Seu projeto SVN está mapeado localmente e aberto no VSCode! Agora você pode codificar, editar arquivos e usar o TortoiseSVN para versionar suas alterações de forma fácil e visual, diretamente pelo Explorador de Arquivos do Windows.
Dicas Extras para Turbinar seu Workflow com TortoiseSVN e VSCode
- Botão Direito é seu Amigo: Para fazer commit, update, add, log e outras operações SVN, basta clicar com o botão direito em arquivos ou pastas dentro da pasta do seu projeto no Explorador de Arquivos e usar as opções do TortoiseSVN.
- Verifique o Status dos Arquivos: O TortoiseSVN usa ícones de status nos arquivos e pastas para indicar se eles foram modificados, adicionados, etc. Fique de olho nesses ícones para acompanhar as mudanças no seu projeto.
- Integração com VSCode (Opcional): Embora o VSCode tenha um controle de versão integrado, para projetos SVN eu prefiro usar o TortoiseSVN diretamente pelo Explorer, pois acho mais prático e visual. Você pode desabilitar o Git no VSCode para este workspace específico, como mostrei em outro post (link para o outro post, se existir, ou mencionar que pode pesquisar no blog).
Conclusão
Mapear projetos SVN com TortoiseSVN é um processo simples, mas fundamental para quem usa VSCode e precisa trabalhar com controle de versão SVN. Com este guia passo a passo, você vai conseguir configurar seu ambiente de desenvolvimento rapidinho e otimizar seu trabalho.
E aí, curtiu as dicas? Deixe seu comentário abaixo se tiver alguma dúvida ou sugestão! E continue acompanhando o blog para mais dicas e tutoriais para analistas de TI e desenvolvedores!
Comentários
Postar um comentário