Adicionar arquivos ao servidor

Adicionar um arquivo ao controle de versão é geralmente automático quando você usa o Gerenciador de Soluções e seu projeto está sob o controle da versão. No entanto, em alguns casos, você precisa seguir algumas etapas adicionais para adicionar o projeto ao controle de versão.

Dica

Antes de adicionar arquivos ao controle de versão, primeiro você deve configurar o espaço de trabalho no seu computador de desenvolvimento.

O que você deseja fazer?

• Criar um novo projeto e solução de código sob controle de versão

• Colocar uma solução existente e codificar os projetos sob controle de versão

• Adicionar um ou mais arquivos ao controle de versão

• Aproveitar os binários de terceiros que seu código não compila

• Personalizar quais arquivos são ignorados pelo controle de versão

• Trabalhar no prompt de comando

Criar um novo projeto e solução de código sob controle de versão

Você pode criar um novo projeto de equipe e adicioná-lo ao controle de versão simultaneamente para que você e sua equipe possam aproveitar imediatamente todos os benefícios controle de versão desde a primeira linha de código que você escreve.

1. No Visual Studio, caso ainda não o tenha feito, conecte-se ao projeto de equipe.

2. Escolha Arquivo, Novo, Projeto (teclado: CTRL + SHIFT + N).

   A caixa de diálogo Novo Projeto é exibida.

3. Selecione o tipo de projeto de código que você deseja criar.

4. Na caixa Nome, especifique o nome do projeto de código.

5. Se a lista Solução aparecer, verifique se a opção Criar nova solução está selecionada.

6. Na lista Localização, especifique o caminho para uma boa pasta de trabalho local (como c:\code\SiteApp\Main\) no espaço de trabalho que você criou quando configurou seu computador de desenvolvimento.

   Verifique se as caixas de seleção Criar diretório para a solução e Adicionar ao controle do código-fonte estão marcadas.

7. Escolha OK para criar o projeto de código, que depois você pode ver no Gerenciador de Soluções (Teclado: CTRL + ALT + L).

   

8. No Gerenciador de Soluções, abra o menu de contexto da solução que você criou ou modificou e escolha Fazer Check-in para enviar suas alterações pendentes.

Colocar uma solução existente e codificar os projetos sob controle de versão

Para adicionar uma solução existente ao controle de versão, mova todos os arquivos da solução para seu espaço de trabalho e, em seguida, adicione-os.

Dica

Evite usar a caixa de diálogo Adicionar Solução ao Controle do Código-Fonte para carregar sua solução no controle de versão.Use o procedimento a seguir.

1. No Visual Studio, caso ainda não o tenha feito, conecte-se ao projeto de equipe.

2. Selecione Exibir, Outras Janelas, Gerenciador do Controle do Código-Fonte.

3. No Gerenciador do Controle do Código-Fonte, navegue até uma pasta pai lógica para sua solução, como $/SiteApp/Main, onde SiteApp é o nome do projeto de equipe. Por que essa é uma boa pasta pai?

4. Escolha o link ao lado de Caminho Local para abrir a pasta pai no Windows Explorer (Explorador de Arquivos no Windows 8).

   O que devo fazer se o texto do link for "Não Mapeado"?

5. Mova a pasta que contém sua solução para a pasta pai.

6. No Visual Studio, escolha Arquivo, Abrir, Projeto/Solução e use a caixa de diálogo Abrir Projeto para abrir a solução.

7. No Gerenciador de Soluções (teclado: Ctrl + Alt + L), selecione a solução, abra o menu de contexto e clique em Adicionar Solução ao Controle do Código-Fonte.

8. No Gerenciador de Soluções, selecione a solução, abra o menu de contexto e escolha Fazer Check-in.

9. No Team Explorer, a página Alterações Pendentes aparecerá.

10. Há Alterações detectadas mostradas na sessão Alterações Excluídas?

    • Não: pule para a próxima etapa.

    • Sim: escolha o link Alterações detectadas. A caixa de diálogo Promover Alterações Candidatas aparecerá. Os arquivos listados nesta caixa de diálogo não são referenciados por nenhum projeto de código em sua solução. Se sua equipe vier a precisar desses arquivos, verifique se eles estão selecionados e escolha Promover para movê-los para a seção Alterações Incluídas da página Alterações Pendentes. Para obter mais informações, consulte Fazer check-in de seu trabalho para a base de código da equipe.

11. Quando você estiver pronto, envie suas alterações pendentes.

Adicionar um ou mais arquivos ao controle de versão

Quando você usa o Gerenciador de Soluções para adicionar um arquivo ao seu projeto de código, o sistema adiciona-o automaticamente ao controle de versão. No entanto, você também pode adicionar arquivos que não são referenciados por seus projetos de código.

Dica

Se estiver criando um processo automatizado ou o preferir usar o prompt de comando, você poderá usar Adicionar comando em vez dos procedimentos a seguir.

Adicionar automaticamente um ou mais arquivos ao controle de versão

Se você estiver usando um espaço de trabalho local, os novos arquivos são detectados automaticamente pela página Alterações Pendentes.

1. No Visual Studio, caso ainda não o tenha feito, conecte-se ao projeto de equipe.

2. Selecione Exibir, Outras Janelas, Gerenciador do Controle do Código-Fonte.

3. No Gerenciador do Controle do Código-Fonte, navegue até a pasta onde você deseja adicionar os arquivos ou pastas.

4. Escolha o link ao lado de Caminho Local para abrir a pasta de destino no Windows Explorer (Explorador de Arquivos no Windows 8).

   Mova seus arquivos e suas pastas para essa pasta.

   O que devo fazer se o texto do link for "Não Mapeado"?

5. No Visual Studio, no Team Explorer, escolha Alterações Pendentes.

6. Na página Alterações Pendentes, na seção Alterações Excluídas, escolha Alterações detectadas.

7. Na caixa de diálogo Promover Alterações Candidatas, certifique-se de que apenas os arquivos para check-in estejam selecionados e escolha Promover.

8. Enviar suas alterações pendentes.

Adicionar arquivos manualmente ao controle de versão

Você também pode adicionar arquivos manualmente ao controle de versão.

1. Selecione Exibir, Outras Janelas, Gerenciador do Controle do Código-Fonte.

2. No Gerenciador do Controle do Código-Fonte, navegue até a pasta onde você deseja colocar seus arquivos.

   Importante

   Verifique se foi feito o check-in dessa pasta antes de prosseguir.Se você estiver criando a pasta agora, abra o menu de contexto e escolha Fazer Check-in e faça o check-in da nova pasta antes de continuar.

3. Arraste as pastas ou os arquivos do Windows Explorer (ou do Explorador de Arquivos) na pasta do Gerenciador do Controle do Código-Fonte.

4. Quando a caixa de diálogo Adicionar ao Controle do Código-Fonte aparecer, certifique-se de que todos os arquivos que você deseja adicionar estejam selecionados e selecione Incluir itens.

5. Escolha Concluir.

6. No Team Explorer, quando a página Alterações Pendentes aparecer, verifique se os binários que você deseja adicionar aparecem na seção Alterações Incluídas. Escolha Fazer Check-in.

Aproveitar os binários de terceiros que seu código não compila

Várias equipes desenvolvem código que depende de binários não compilados pela solução na qual elas gerenciam seu código. Normalmente, esses binários fazem parte de uma biblioteca que a equipe licenciou de um terceiro.

Às vezes, esses binários vêm de outra equipe na mesma empresa. Por exemplo, a equipe A depende dos binários gerados pela equipe B, e cada equipe deve, por algum motivo, trabalhar em coleções de projetos de equipe diferentes. Sendo assim, a equipe B fornece binários para a equipe A, que os verifica no controle de versão.

Dica

Se os computadores de desenvolvimento e os servidores de compilação puderem acessar a Internet, o NuGet poderá facilitar o gerenciamento de suas dependências e a atualização de seus binários para sua equipe.Mesmo se você decidir usar o NuGet, provavelmente ainda deverá adicionar os binários ao controle de versão para poder reproduzir e criar versões históricas do seu código.

A estrutura de pastas e espaços de trabalho que você deve usar para armazenar os binários de terceiros depende da forma com que suas soluções dependem dessas bibliotecas.

Adicionar binários em sua estrutura de pastas ou de ramificações

Se você colocar os binários de terceiros na mesma pasta pai que contém suas pastas de solução, todos os seus projetos de código em todas as soluções poderão fazer referência às bibliotecas com o mesmo caminho relativo.

Por exemplo, uma equipe usa esta estrutura de pastas:

Cada projeto de código pode fazer referência à pasta de bibliotecas com o seguinte caminho relativo: ../../Lib

Se, mais adiante em seu projeto, sua equipe precisar isolar esforços separados que exijam versões diferentes dos binários, você poderá ramificar a pasta de bibliotecas com sua pasta de soluções.

Por exemplo, um aplicativo da Versão 1 usa a Versão 1 de uma biblioteca. Como alguns desenvolvedores na equipe de acesso a dados trabalham na próxima versão, eles usam a Versão 2. Mas as outras equipes ainda não estão prontas para atualizar. Você pode usar ramificações para gerenciar esse tipo de situação.

Usar um espaço de trabalho para mapear em binários

Algumas empresas devem gerenciar dependências mais complicadas em bibliotecas de terceiros. Por exemplo, vários projetos de equipe contêm soluções com dependências diferentes em um conjunto comum de bibliotecas. Em casos como esse, você pode armazenar suas bibliotecas de terceiros em um projeto de equipe dedicado. Os colaboradores de vários projetos de equipe mapeiam nas pastas que contêm as bibliotecas de que precisam.

Por exemplo, a FabrikamFiber coloca o projeto de equipe, a ramificação e a estrutura de pastas a seguir em prática:

Raíssa configura seu computador de desenvolvimento com dois espaços de trabalho para dois trabalhos diferentes, cada um mapeando nas bibliotecas de que ela precisa:

Personalizar quais arquivos são ignorados pelo controle de versão

Por padrão, determinados tipos de arquivos (por exemplo, arquivos .dll) são ignorados pelo controle de versão. Portanto:

• Quando você adiciona arquivos ignorados às pastas que são mapeadas em um espaço de trabalho local, eles não aparecem na página Alterações Pendentes no Team Explorer.

• Quando você tentar adicionar arquivos ignorados usando a caixa de diálogo Adicionar ao Controle do Código-Fonte (por exemplo, arrastando-os para o Gerenciador do Controle do Código-Fonte), eles serão exibidos automaticamente na guia Itens excluídos.

Você pode configurar quais tipos de arquivos são ignorados colocando o arquivo de texto chamado .tfignore na pasta onde você deseja que as regras sejam aplicadas. Os efeitos do arquivo .tfignore são recursivos. No entanto, você pode criar arquivos .tfignore em subpastas para substituir os efeitos de um arquivo .tfignore em uma pasta pai.

Regras do arquivo .tfignore

As seguintes regras se aplicam a um arquivo .tfignore:

• # inicia uma linha de comentário

• Os curingas * e ? são aceitos.

• Um filespec é recursivo a menos que seja prefixado pelo caractere \.

• ! nega um filespec (arquivos que correspondem ao padrão não são ignorados)

Exemplo de arquivo .tfignore

######################################
# Ignore .cpp files in the ProjA sub-folder and all its subfolders
ProjA\*.cpp
# Ignore .txt files in this folder 
\*.txt
# Ignore .xml files in this folder and all its sub-folders
*.xml
# Ignore all files in the Temp sub-folder
\Temp
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

Criar e usar um arquivo .tfignore

Você pode criar manualmente um arquivo de texto .tfignore usando as regras acima, podendo também gerar um automaticamente quando a página Alterações Pendentes detectar uma alteração.

Para gerar automaticamente um arquivo .tfignore

1. Na página Alterações Pendentes, na seção Alterações Excluídas, exclua o link Alterações detectadas.

   A caixa de diálogo Promover Alterações Candidatas aparecerá.

2. Selecione um arquivo, abra o menu de contexto e escolha Ignorar este item local, Ignorar por extensão, Ignorar por nome de arquivo ou Ignorar por pasta.

3. Escolha OK ou Cancelar para fechar a caixa de diálogo Promover Alterações Candidatas.

4. Um arquivo .tfignore aparece na seção Alterações Incluídas da página Alterações Pendentes. Você pode abrir o arquivo e modificá-lo para atender às suas necessidades.

O arquivo .tfignore é adicionado automaticamente como uma alteração pendente incluída de modo que as regras criadas se apliquem a cada membro da equipe que obtém o arquivo.

Trabalhar no prompt de comando

• Adicionar comando carrega arquivos do espaço de trabalho do seu computador de desenvolvimento para o servidor.

Consulte também

Outros recursos

Decidir entre usar um espaço de trabalho local ou em servidor