Suspender o trabalho e gerenciar check-ins particulares

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

Visual Studio 2019 | Visual Studio 2022

Por várias razões, às vezes você precisa deixar de lado alguns ou todos os seus trabalhos que estão em andamento. Os conjuntos de check-in particular no TFVC (Controle de Versão do Team Foundation) são úteis quando você deseja interromper o trabalho para:

  • Interrupção: você tem alterações pendentes que não estão prontas para check-in, mas é preciso trabalhar em uma tarefa diferente.
  • Colaboração: você tem alterações pendentes que não estão prontas para check-in, mas é preciso compartilhá-las com outro membro da equipe.
  • Revisão de código: você deseja que outro membro da equipe examine suas alterações pendentes. Para obter mais informações sobre revisões de código, consulte Dia na vida de um desenvolvedor de DevOps: escrever um novo código para uma história de usuário.
  • Compilação Privado antes de fazer o check-in de suas alterações, você pode usar o sistema de compilação automatizada para compilar e testar seu código.
  • Backup: você tem um trabalho em andamento que não pode ser concluído, mas deseja fazer uma cópia de backup. Você deseja que a cópia de backup seja armazenada no servidor e disponível para outros membros da equipe.
  • Entrega: você tem trabalho em andamento que deseja entregar para outro membro da equipe.

Nesses cenários e em outros, você pode mover suas alterações pendentes para um check-in particular no servidor e limpar seu workspace. O check-in particular salva suas revisões de arquivo, comentários, lista de itens de trabalho relacionados e anotações de check-in quando você avalia as políticas antes de arquivar.

Pré-requisitos

Você deve ser um dos Colaboradores de seu projeto. Para saber mais, confira Permissões padrão do TFVC.

Observação

Os recursos do Visual Studio Meu Trabalho e Revisão de Código estão disponíveis nas seguintes edições:

  • Visual Studio 2022: Visual Studio Community, Visual Studio Professional e Visual Studio Enterprise
  • Visual Studio 2019: Visual Studio Professional e Visual Studio Enterprise

Suspender e retomar seu trabalho na página Meu Trabalho

Na página Meu Trabalho no Team Explorer, você pode salvar e restaurar suas alterações de arquivo e itens de trabalho relacionados. Você também pode restaurar a posição de suas janelas abertas, pontos de interrupção e outras indicações importantes.

  1. No Visual Studio, selecione Exibir>Team Explorer.

  2. No Team Explorer, selecione Página Iniciale, em seguida, selecione Meu Trabalho.

  3. Na página Meu Trabalho, expanda Suspender, insira uma descrição do trabalho suspenso e selecione Suspender.

    Captura de tela da página Meu Trabalho no Team Explorer. Em Trabalho em Andamento, na seção Suspender, uma descrição e o botão Suspender são realçados.

  4. Quando estiver pronto, você poderá retomar o trabalho. Na página Meu Trabalho, em Trabalho Suspenso, selecione a descrição do seu trabalho e selecione Retomar.

    Captura de tela da página Meu Trabalho no Team Explorer. Em Trabalho Suspenso, uma descrição de trabalho é realçada. Em seu menu de atalho, Retomar está realçado.

Fazer o check-in particular das alterações

Dica

No Gerenciador de Soluções ou no Gerenciador de Controle de Origem, você pode arquivar um subconjunto específico dos arquivos com os quais está trabalhando. Selecione-os, abra o menu de contexto e selecione Prateleira de Alterações Pendentes. A página Alterações Pendentes aparecerá, pronta para fazer o check-in particular somente dos arquivos que você selecionou.

  1. No Team Explorer, selecione Página Iniciale, em seguida, selecione Meu Trabalho.

  2. Na página Alterações Pendentes, verifique se as alterações das quais você deseja fazer check-in particular estão listadas na seção Alterações Incluídas. Você pode arrastar arquivos entre Alterações Incluídas e Alterações Excluídas. No teclado, você também pode abrir o menu de contexto de um item e, em seguida, selecionar Incluir ou Excluir.

  3. Expandir Check-in Particular.

  4. Digite um nome para o check-in particular.

    Captura de tela da página Alterações Pendentes no Team Explorer. Na seção Check-in Particular, um nome que descreve o trabalho é realçado.

  5. (Opcional) Você pode selecionar uma das seguintes opções:

    • Preserve as alterações pendentes localmente. Por padrão, essa opção é selecionada. Como resultado, suas alterações pendentes não são removidas do workspace. O comentário e a lista de itens de trabalho relacionados também não são removidos. Se você quiser limpar seu workspace para trabalhar em outra tarefa, desmarque essa caixa de seleção.

    • Avalie as políticas e observações antes do check-in particular. Quando você marca essa opção, todas as políticas de check-in são avaliadas antes de o check-in particular ser criado. Para obter mais informações sobre políticas de check-in, consulte Definir e impor restrições de qualidade.

  6. Selecione Check-in Particular.

Localizar um check-in particular

  1. No Team Explorer, selecione Página Iniciale, em seguida, selecione Alterações Pendentes.

  2. Expanda Açõese selecione Localizar Check-ins Particulares.

  3. Na página Localizar Check-ins Particulares, insira o nome ou o alias de um membro da equipe de projeto na caixa de pesquisa e pressione a tecla Enter.

    Captura de tela da página Localizar Check-ins particulares no Team Explorer. A caixa de pesquisa contém o nome de um membro da equipe. Em Resultados, dois check-ins particulares estão visíveis.

    Dica

    Se você não souber o nome do proprietário, é possível digitar * para listar os check-ins particulares de todos os usuários.

  4. Uma lista de check-ins particulares aparecerá na lista Resultados. Você pode filtrar os resultados para reduzir o tamanho da lista.

Exibir e trabalhar com um check-in particular

Depois que a página Localizar Check-ins Particulares exibir uma lista de check-ins particulares, conforme descrito em Localizar um Check-in Particular, clique duas vezes em um check-in particular para exibi-lo. A página Detalhes do Check-in Particular aparecerá.

Captura de tela da página Detalhes do Check-in Particular no Team Explorer. O nome do check-in particular, o comentário, os itens de trabalho e as alterações estão visíveis.

  • Para alternar entre as exibições de lista e árvore, use o menu Opções de Exibição .

  • Para obter informações detalhadas sobre uma alteração em um arquivo, abra seu menu de contexto e selecione Abrir, Histórico de Exibição ou uma das opções Comparar.

  • Para recuperar as alterações no check-in particular em seu workspace, selecione Alterações no Check-in Particular Desfeito:

    1. Se houver uma alteração de arquivo que você não deseja desfazer o check-in particular, abra o menu de contexto do arquivo e selecione Excluir.

    2. Se você desejar excluir o check-in particular, desmarque a caixa de seleção Preservar check-in particular no servidor.

    3. Se você não desejar restaurar a lista de itens de trabalho e as observações de check-in que estão associadas ao check-in particular, desmarque a caixa de seleção Restaurar itens de trabalho e observações de check-in.

    4. Selecione Desfazer Check-in Particular. Se houver conflitos entre alterações no check-in particular e as versões de arquivo em seu workspace, o sistema solicitará que você os resolva.

  • Para excluir o conjunto de check-in particular, selecione Excluir Check-in Particular.

    Aviso

    Certifique-se de que você não precisa de nenhum dos trabalhos armazenados em um check-in particular antes de excluí-lo. Não é possível recuperar um check-in particular excluído.

Trabalhar no prompt de comando

Dica

  • Diferente do conjunto de alterações, o check-in particular é uma entidade sem versão. Você pode desfazer o check-in particular os itens em um check-in particular, editar vários arquivos e, em seguida, refazer o check-in particular. Mas o sistema não cria uma nova versão dos itens para comparação futura. Ele também não mantém um registro de quem revisou os itens, quando eles foram revisados ou de que maneira. O check-in particular original é completamente substituído.
  • Conflitos podem prevenir que você retome o trabalho suspenso. Se você tiver conflitos, consulte Resolver conflitos de Controle de Versão do Team Foundation.