Suspenda o seu trabalho e faça a gestão das suas prateleiras

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

Visual Studio 2019 | Visual Studio 2022

Por vários motivos, às vezes você precisa reservar parte ou todo o seu trabalho que está em andamento. Shelvesets no Controle de Versão do Team Foundation (TFVC) são úteis quando você deseja parar o trabalho para:

• Interrupção: você tem alterações pendentes que não estão prontas para fazer check-in, mas precisa trabalhar em uma tarefa diferente.
• Colaboração: você tem alterações pendentes que não estão prontas para fazer check-in, mas precisa compartilhá-las com outro membro da equipe.
• Revisão de código: você deseja que outro membro da equipe revise suas alterações pendentes. Para obter mais informações sobre revisões de código, consulte Dia na vida de um desenvolvedor devops: escrever novo código para uma história de usuário.
• Compilação privada: antes de fazer check-in das alterações, você deseja usar seu sistema de compilação automatizado para criar e testar seu código.
• Backup: você tem um trabalho em andamento que não pode concluir, mas deseja fazer uma cópia de backup. Você deseja que a cópia de backup seja armazenada em seu servidor e disponibilizada para outros membros da equipe.
• Handoff: Você tem um trabalho em andamento que deseja entregar a outro membro da equipe.

Nesses cenários e em outros, você pode mover suas alterações pendentes para um conjunto de prateleiras no servidor e, em seguida, limpar seu espaço de trabalho. O conjunto de prateleiras salva suas revisões de arquivos, comentários, lista de itens de trabalho relacionados e notas de check-in quando você avalia políticas antes de arquivar.

Pré-requisitos

Tem de ser um dos Colaboradores do seu projeto. Para obter mais informações, consulte Permissões TFVC padrão.

Nota

Os recursos Visual Studio My Work e Code Review estão disponíveis com as seguintes edições:

• Visual Studio 2022: Comunidade do Visual Studio, Visual Studio Professional e Visual Studio Enterprise
• Visual Studio 2019: Visual Studio Professional e Visual Studio Enterprise

Suspender e retomar o seu trabalho a partir da página O 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 dicas importantes.

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

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

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

   

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

   

Arquive as suas alterações

Gorjeta

No Gerenciador de Soluções ou no Gerenciador de Controle do Código-Fonte, você pode arquivar um subconjunto específico dos arquivos com os quais está trabalhando. Selecione-os, abra o menu de contexto e, em seguida, selecione Alterações pendentes de prateleira. A página Alterações pendentes é exibida, pronta para arquivar apenas os arquivos selecionados.

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

2. Na página Alterações Pendentes, certifique-se de que as alterações que pretende arquivar estão listadas na secçã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 selecionar Incluir ou Excluir.

3. Expanda Prateleira.

4. Insira um nome para o conjunto de prateleiras.

   

5. (Opcional) Selecione uma das seguintes opções:

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

   • Avalie políticas e notas antes de arquivar. Quando você seleciona essa opção, todas as políticas de check-in são avaliadas antes que o conjunto de prateleiras seja criado. Para obter mais informações sobre políticas de check-in, consulte Definir e impor portões de qualidade.

6. Selecione Prateleira.

Encontre um conjunto de prateleiras

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

2. Expanda Ações e selecione Localizar Shelvesets.

3. Na página Localizar Shelvesets, digite o nome ou o alias de um membro da equipe do projeto na caixa de pesquisa e selecione Enter.

   

   Gorjeta

   Se você não souber o nome do proprietário, poderá entrar * na lista de prateleiras para todos os usuários.

4. Uma lista de prateleiras aparece na lista Resultados . Você pode filtrar os resultados para reduzir o tamanho da lista.

Ver e trabalhar com um conjunto de prateleiras

Depois que a página Localizar prateleiras exibir uma lista de conjuntos de prateleiras, conforme descrito em Localizar um conjunto de prateleiras, clique duas vezes em um conjunto de prateleiras para visualizá-lo. A página Shelveset Details (Detalhes do Shelveset) é exibida.

• Para alternar entre os modos de exibição 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, Exibir Histórico ou uma das opções Comparar.

• Para recuperar as alterações no conjunto de prateleiras em seu espaço de trabalho, selecione Alterações de prateleira:

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

  2. Se quiser excluir o conjunto de prateleiras, desmarque a caixa de seleção Preservar conjunto de prateleiras no servidor .

  3. Se não quiser restaurar a lista de itens de trabalho e as notas de check-in armazenadas na prateleira, desmarque a caixa de seleção Restaurar itens de trabalho e anotações de check-in.

  4. Selecione Desarquivar. Se houver conflitos entre as alterações no conjunto de prateleiras e as versões do arquivo em seu espaço de trabalho, o sistema solicitará que você os resolva.

• Para excluir o conjunto de prateleiras, selecione Excluir Shelveset.

  Aviso

  Certifique-se de que não precisa de nenhum dos trabalhos armazenados numa prateleira antes de o eliminar. Não há como recuperar uma prateleira excluída.

Trabalhar a partir da linha de comandos

• Comando Shelve: crie ou exclua um conjunto de prateleiras.
• Comando Shelvesets: Listar prateleiras.
• Comando Unshelve: Unshelve um shelveset.
• Comando Diferença: compare as alterações feitas em um arquivo em um conjunto de prateleiras com outra versão.

Gorjeta

• Ao contrário de um conjunto de alterações, um conjunto de prateleiras é uma entidade sem versão. Você pode desarquivar os itens em um conjunto de prateleiras, editar vários arquivos e, em seguida, arquivar novamente o conjunto de prateleiras. Mas o sistema não cria uma nova versão dos itens para comparação futura. Também não mantém um registro de quem revisou os itens, quando eles foram revisados ou de que maneira. A prateleira original foi completamente substituída.
• Os conflitos podem impedir que você retome o trabalho suspenso. Se você tiver conflitos, consulte Resolver conflitos de controle de versão do Team Foundation.