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

Publicado: abril de 2016

Use a página Alterações Pendentes (Teclado: Ctrl + 0, P) para fazer o check-in do código para a base de código da equipe.

O que você deseja fazer?

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

• Associar itens de trabalho

• Fazer check-in das alterações

• Resolver avisos da política de check-in

• Executar check-in restringido

• Assinar alertas

• Trabalhar no prompt de comando

• Obter dicas

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

Você pode especificar de 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. Você também pode definir o escopo de seu check-in enquanto trabalha em outras áreas do Visual Studio:

• No Gerenciador de Soluções, selecione uma das seguintes opções:

  • A solução

  • Um ou mais projetos de código

  • Um ou mais arquivos

  Depois de selecionar os itens, abra o menu de contexto e escolha Fazer Check-in.

• No Gerenciador do Controle do Código-Fonte, selecione um ou mais itens com modificações pendentes ou uma ou mais pastas que contêm itens com modificações pendentes. (Os itens com alterações pendentes são indicados por este símbolo: ). Abra o menu de contexto dos itens selecionados e escolha Fazer Check-in.

Associar itens de trabalho

Quando você altera os arquivos na base de código, normalmente faz isso para concluir uma tarefa, corrigir um bug, ou para satisfazer à demanda de qualquer outro tipo de item de trabalho. Quando você fizer o check-in das alterações, associe os itens de trabalho às alterações das quais estiver fazendo o check-in. Os benefícios de fazer isso incluem:

• Um membro da equipe que olha para 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 ver os itens de trabalho que foram a justificação para a alteração.

• Se você compilar suas alterações em seu sistema de compilação automatizada (por exemplo, com uma Compilação CI ou uma Compilação de check-in restringido), os membros de sua equipe poderão ver em que compilação concluída a tarefa foi concluída ou o bug foi corrigido.

Para associar itens de trabalho ao check-in:

• Escolha o link Adicionar Item de Trabalho por ID na seção Itens de Trabalho Relacionados.

• Arraste um item de trabalho de uma janela de consulta na seção Itens de Trabalho Relacionados.

Ao lado de cada item de trabalho, selecione como ele deve ser relacionado ao seu check-in: Associar ou Resolver (disponível somente se o item de trabalho ainda não estiver em um estado que impossibilite essa relação, como Resolvido, Concluído ou Fechado).

Fazer check-in das alterações

Para fazer check-in das alterações

1. No Team Explorer, escolha Página Inicial e Alterações Pendentes (Teclado: Ctrl + 0, P).

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

3. Algumas equipes preferem que seus membros forneçam determinados tipos de informações sobre cada check-in. Em alguns casos, elas até implementam uma política de check-in para exigir isso. Se um administrador do projeto de equipe habilitou observações de check-in, você pode digitar as informações em cada campo na seção Observações.

4. Escolha o botão Fazer Check-in.

Um dos seguintes resultados ocorre.

Suas alterações são submetidas a check-in

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 o check-in

O sistema lhe apresenta 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.

Seu check-in é bloqueado porque viola uma política de check-in.

Os administradores do seu projeto de equipe 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 Set and Enforce Quality Gates.

Em alguns casos, você pode substituir essas políticas de check-in. Na seção Avisos da Política, escolha Substituir Avisos.

Na caixa Motivo, explique por que você está substituindo a política.

Fazer check-in em uma pasta controlada por um processo de compilação de check-in restringido

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

Assinar alertas

Se você desejar ser notificado quando alguém fizer check-in no código em seu projeto de equipe do TFVC, assine para receber alertas por email. Veja como.

Trabalhar no prompt de comando

• Comando Check-in: exibir alterações pendentes e fazer check-in de arquivos

Dicas

• Você pode desencaixar a página Alterações Pendentes do Team Explorer e abri-la em uma nova janela.

• Você pode alternar entre a exibição de lista e de árvore no menu Ações.

• Antes de fazer check-in do novo código, você deve considerar uma análise do código. Consulte Um dia na vida de um desenvolvedor do ALM: 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ê precisar reservar suas alterações, consulte Suspender o trabalho e gerenciar check-ins particulares.

• Um check-in é executado automaticamente — a operação acontece de maneira completa ou falha completamente (com uma exceção). Se qualquer uma das alterações não puder ser enviada ao Team Foundation Server, nenhuma das alterações será confirmada e um conjunto de alterações não será criado. Por exemplo, se você perder a conectividade de rede no meio de um check-in, toda a operação falhará.

  A exceção é associação de itens de trabalho ao conjunto de alterações. Se a associação do item de trabalho falhar, 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. Consulte Gerenciar dependências, vincular itens de trabalho para dar suporte à rastreabilidade.