Compartilhar via


Fazer check-in de seu trabalho para a base de código da equipe

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

No Team Explorer do Visual Studio, abra a página Alterações pendentes para fazer check-in em seu código para um novo conjunto de alterações ou pressione Ctrl+O, P no teclado.

A captura de tela mostra um painel de Alterações pendentes com um comentário e um botão Fazer check-in.

Dica

É possível selecionar o ícone para desfazer a página Alterações pendentes do Team Explorer e mostrá-la em uma janela separada.

Selecionar os arquivos dos quais você deseja fazer o check-in

Você pode especificar quais alterações no arquivo deseja fazer check-in arrastando-as entre as seções Alterações incluídas e Alterações excluídas da página Alterações pendentes no Team Explorer. Também é possível fazer check-in enquanto trabalha em outras áreas do Visual Studio.

  • Em Gerenciador de Soluções, clique com o botão direito do mouse na solução, em um ou mais projetos de código ou em um ou mais arquivos e selecione Fazer check-in.

  • No Source Control Explorer, selecione um ou mais itens com alterações pendentes ou uma ou mais pastas que contêm itens com alterações pendentes. O ícone de status de check-out do TFVC indica itens com alterações pendentes. Clique com o botão direito do mouse nos itens selecionados e selecione Fazer check-in.

Importante

A opção Fazer check-in não será exibida se não houver alterações pendentes nos itens selecionados.

Se não houver alterações pendentes para um item no qual deseja marcar, verifique se ele não está listado como uma alteração excluída. Abra a visualização Alterações pendentes e selecione o link Detectado em Alterações excluídas. Na caixa de diálogo Promover alterações candidatas, selecione apenas os arquivos que você deseja fazer check-in e, em seguida, selecione Promover. Os itens foram movidos para a seção Alterações incluídas e agora pode ser feito check-in.

Associar itens de trabalho

Quando você fizer o check-in das alterações, associe os itens de trabalho às alterações. Esta prática oferece os seguintes benefícios:

  • Um membro da equipe que verifica o item de trabalho pode se vincular diretamente ao conjunto de alterações para ver o trabalho realizado.
  • Um membro da equipe que examina o histórico de um arquivo alterado pode exibir o conjunto de alterações e verificar os itens de trabalho que foram a justificativa para a alteração.
  • É possível criar suas alterações em seu sistema de build automatizado, por exemplo, com um Build de CI ou um Build de check-in restrito. Os membros da equipe podem ver em qual build concluída a tarefa foi concluída ou o bug foi corrigido.

Para associar itens de trabalho às suas alterações, é possível:

  • Selecione Adicionar item de trabalho por ID na seção Itens de trabalho relacionados da página Alterações pendentes. Insira a ID de item de trabalho e selecione Adicionar.

  • Arraste um item de trabalho da página Item de trabalho do Team Explorer para a seção Itens de trabalho relacionados da página Alterações pendentes.

Depois de adicionar um item de trabalho, selecione o link ao lado do item para escolher como o item deve estar relacionado às suas alterações: Associar ou Resolver. Essas opções estão disponíveis somente se o item de trabalho não estiver em um estado que impeça essa relação, como Resolvido, Concluído ou Fechado.

Fazer check-in das alterações

  1. No Team Explorer, escolha Página Inicial e, em seguida, selecione Alterações pendentes ou pressione Ctrl+0, P.

  2. Na página Alterações pendentes, insira um Comentário para que os membros da equipe que depois precisarem revisar e entender o histórico de seus arquivos possam compreender o que você fez. Por exemplo: Controlador de carrinho de compras implementado.

    Algumas equipes querem que seus membros forneçam determinados tipos de informações sobre cada conjunto de alterações e podem implementar uma política de check-in para exigir essa prática. Se um administrador de projeto tiver habilitado ou exigido as anotações de check-in, insira as informações na seção Anotações.

  3. Selecione Check-in.

Um dos seguintes resultados aparece:

  • É feito check-in das suas alterações.

    Todas as alterações no arquivo do seu espaço de trabalho juntamente com o comentário, observações de check-in e links para itens de trabalho relacionados são armazenadas no servidor como um único conjunto de alterações no seu servidor.

  • Conflitos bloqueiam suas alterações.

    O sistema mostra conflitos entre suas alterações na versão mais recente dos arquivos no servidor. Consulte Resolver conflitos de controle de versão do Team Foundation.

  • Uma política de check-in bloqueia seu check-in.

    Os administradores do seu projeto podem implementar políticas de check-in para incentivar sua equipe a seguir as práticas recomendadas. Por exemplo, uma política de check-in pode incentivar os membros da equipe a se associarem pelo menos a um item de trabalho com suas alterações. Para obter mais informações, consulte Definir e aplicar portões de qualidade.

    Para substituir essas políticas de check-in, na seção Avisos de política, selecione Substituir avisos e insira um motivo para a substituição.

  • Você está fazendo o check-in das alterações em uma pasta controlada por um processo de compilação com check-in restrito.

    Se estiver fazendo check-in das alterações nas pastas de controle de versão controladas por um processo de compilação de check-in restrito, aparece a caixa de diálogo Check-in restrito. Para obter informações sobre como concluir o check-in, consulte Fazer check-in em uma pasta controlada por um processo de build de check-in restrito.

    A captura de tela mostra a caixa de diálogo Check-in restrito com uma mensagem.

Assinar alertas

Se quiser ser notificado quando alguém fizer check-in no código em seu projeto TFVC, assine para receber alertas por email. Nas Configurações do usuário do projeto TFVC, selecione Notificações. Selecione Nova assinatura e escolha e personalize os modelos de Check-in para Código (TFVC).

A captura de tela mostra a página de alertas de um projeto TFVC no portal da Web.

Trabalhar no prompt de comando

  • O comando Check-in permite exibir as alterações pendentes e os arquivos de check-in.

Dicas

  • Alterne entre modo de exibição de árvore e lista selecionando Visualizar opções nas seções Itens incluídos ou Itens excluídos da página Alterações pendentes.

  • Antes de fazer check-in do novo código, você deve considerar uma análise do código. Consulte Suspender trabalho, corrigir um bug e conduzir uma revisão de código.

  • Você pode gerenciar e, se necessário, desfazer as alterações pendentes. Consulte Desenvolver código e gerenciar alterações pendentes.

  • Se você precisa separar suas alterações, consulte Suspender seu trabalho e gerenciar seu check-in particular.

  • É feito check-in das alterações atomicamente. A operação é totalmente bem-sucedida ou totalmente falha. Se alguma das alterações não puder ser enviada, nenhuma das alterações será confirmada e um conjunto de alterações não será criado. Por exemplo, se houver perda de conectividade de rede no meio de um check-in, toda a operação falhará.

    A exceção é a associação de itens de trabalho ao conjunto de alterações. Se houver falha na associação do item de trabalho, mas todos os outros aspectos do check-in forem bem-sucedidos, o conjunto de alterações será criado. Você pode associar manualmente um item de trabalho a um conjunto de alterações.

Próximas etapas

Renomear ou mover arquivos e pastas