Compartilhar via

Adicionar arquivos ao servidor

  • Artigo

 

Publicado: abril de 2016

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?

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

  • Coloque uma solução existente e codifique os projetos sob controle de versão

  • Adicione um ou mais arquivos para 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

  • Trabalho do prompt de comando

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

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

Caixa de diálogo New Project

  1. No Visual Studio, se você não tiver feito isso, se conecta ao projeto da equipe.

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

    A caixa de diálogo Novo Projeto é exibida.

  3. Selecione o tipo do código de projeto 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 sua máquina de desenvolvimento.

    Verifique se o criar diretório para solução e Adicionar ao controle de origem caixas de seleção estão marcadas.

  7. Escolha OK para criar o projeto de código que você pode exibir no Solution Explorer (Teclado: CTRL + ALT + L).

    Novo projeto de código no Solution Explorer

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

Coloque uma solução existente e codifique os projetos sob controle de versão

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

Dica

Evite usar a caixa de diálogo Adicionar Solução ao Controle de Origem para carregar sua solução em controle de versão.Em vez disso, use o seguinte código.

  1. No Visual Studio, se você não tiver feito isso, se conecta ao projeto da equipe.

  2. Selecione Modo de Exibição, Outro Windows, Gerenciador do Controle de Código-fonte.

  3. No Gerenciador de 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 pasta é uma boa pasta pai?

  4. Escolha o link próximo a Caminho Local para abrir a pasta pai no Windows Explorer (File Explorer no Windows 8).

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

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

  6. No Visual Studio, escolha Arquivo, Abrir, Projeto/Solução e então 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 de Origem.

  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 aparece.

  10. São exibidas Alterações Detectadas na sessão Alterações Excluídas?

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

    • Sim: escolher o link de 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 a sua equipe vier a necessitar 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.

Adicione um ou mais arquivos para 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 você estiver criando um processo automatizado ou prefere usar o prompt de comando, você pode usar Adicionar comando em vez dos procedimentos a seguir.

Adiciona automaticamente um ou mais arquivos para controle de versão

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

  1. No Visual Studio, se você não tiver feito isso, se conecta ao projeto da equipe.

  2. Selecione Modo de Exibição, Outro Windows, Gerenciador do Controle de Código-fonte.

  3. Em o controle de O código-fonte, navegue para a pasta onde você deseja adicionar os arquivos ou pastas.

  4. Escolha o link próximo a Caminho Local para abrir a pasta destino no Windows Explorer (File Explorer no Windows 8).

    Mova seus arquivos e suas pastas para esta pasta.

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

  5. No Visual Studio, no Team Explorer, escolha Modificaçõ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 Modificações Candidatas, certificar-se de que apenas os arquivos que você deseja verificar estão selecionados, e escolher Promover.

  8. Enviar suas alterações pendentes.

Adicionar arquivos manualmente ao acompanhamento de versão

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

  1. Selecione Modo de Exibição, Outro Windows, Gerenciador do Controle de Código-fonte.

  2. Em gerenciador de controle de código-fonte, navegue para 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 então faça o check-in da nova pasta antes de continuar.

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

  4. Quando a caixa de diálogo Adicionar ao Controle do Código-Fonte aparece, certifique-se de que todos os arquivos que você deseja adicionar estejam selecionados e, em seguida, 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 são 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. Como resultado, a equipe B entrega binários para a equipe A, que os verifica no controle de versão.

Dica

Se os computadores de desenvolvimento e servidores de compilação podem acessar a Internet, em seguida, NuGet pode facilitar sua equipe para gerenciar suas dependências e manter seus binários atualizados.Mesmo se você decidir usar NuGet, provavelmente, você ainda deve adicionar os binários ao controle de versão para que você possa reproduzir e criar versões históricas do seu código.

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

Adicione os binários em sua pasta ou estrutura de ramificação

Se você colocar os binários de terceiros na mesma pasta pai que contém suas pastas de solução, entã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 essa estrutura de pastas:

Pasta dentro da pasta pai principal da biblioteca

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

Se, posteriormente em seu projeto, sua equipe precisar isolar esforços separados que exijam versões diferentes dos binários, você pode ramificar a pasta de biblioteca junto com a pasta da solução.

Por exemplo, um aplicativo da Versão 1 aproveita 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.

Pasta Biblioteca dentro de uma estrutura de ramificação

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

Algumas empresas devem gerenciar as 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. Colaboradores do mapa de vários projetos de equipe nas pastas que contêm as bibliotecas de que precisam.

Por exemplo, a FabrikamFiber coloca o projeto de equipe, ramificação e estrutura de pastas no lugar:

Bibliotecas armazenadas em um projeto de equipe dedicada

Raíssa configura sua máquina de desenvolvimento com dois espaços de trabalho para dois esforços diferentes, cada um mapeando nas bibliotecas de que ela precisa:

Mapa de espaços de trabalho nas bibliotecas

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. Como resultado:

  • 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 de Origem (por exemplo, arrastando-os no Gerenciador de Controle de Origem), 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 de .tfignore em uma pasta pai.

Regras de arquivo .tfignore

As seguintes regras se aplicam a um arquivo .tfignore:

  • # inicia uma linha de comentário

  • Os curingas * e ? são suportados.

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

  • ! nega um filespec (arquivos que correspondam 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

Crie e use 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 aparece.

  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.

Trabalho do prompt de comando

  • Adicionar comando carregar arquivos no espaço de trabalho em seu computador de desenvolvimento para o servidor.

Consulte também

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