Desenvolver código e gerenciar alterações pendentes

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

Visual Studio 2019 | Visual Studio 2022

A maioria das alterações feitas aos arquivos são colocadas na fila como alterações pendentes. Conforme você trabalha, é possível organizar, gerenciar e obter detalhes sobre o que foi alterado.

Trabalhar no Visual Studio

Na página inicial do Team Explorer do Visual Studio, que você pode abrir pressionando Ctrl+0, H, você pode começar a codificar em uma solução nova ou existente.

Depois de abrir uma solução, você pode abrir Gerenciador de Soluções pressionando Ctrl+Alt+L.

Quando você usa Gerenciador de Soluções para abrir e modificar um arquivo que está sob controle do código-fonte, o arquivo é automaticamente submetido a check-out para você. Os ícones parecem indicar quais arquivos você não alterou, aqueles que você fez check-out e aqueles que você adicionou à solução .

Se você estiver trabalhando em uma solução que contenha vários arquivos, provavelmente achará conveniente filtrar o Gerenciador de Soluções para mostrar somente os arquivos que você alterou , ou pressione Ctrl+[, P

Usar a página Meu Trabalho para gerenciar o trabalho

Você pode abrir a página Meu Trabalho no Team Explorer ou pressionar Ctrl+0, M para gerenciar seu trabalho.

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

Você pode usar o Meu Trabalho para:

• Atribuir trabalho a si mesmo.
• Acompanhar o seu trabalho em relação a itens de trabalho.
• Suspender e retomar posteriormente seu trabalho, incluindo as alterações do arquivo, itens de trabalho associados e o estado do Visual Studio, como posições da janela e pontos de interrupção.
• Solicitar uma revisão de código

Para obter exemplos passo a passo, consulte Um dia na vida de um desenvolvedor DevOps: escrever um novo código para uma história de usuário e Um dia na vida de um desenvolvedor DevOps: suspender o trabalho, corrigir um bug e realizar uma revisão de código.

Dicas

• Você pode controlar os tipos de itens de trabalho que aparecem na seção Itens de Trabalho Disponíveis. Escolha uma das opções padrão ou algumas de suas consultas que estão contidas na pasta raiz Consultas compartilhadas. Para trabalhar com essas consultas, use a página Itens de Trabalho no Team Explorer.

• Ao mover um item de trabalho para Itens de Trabalho Disponíveis, Trabalho Em Andamento ou Trabalho Suspenso, o estado ou comentários do item de trabalho são atualizados de modo que sua equipe possa ser automaticamente informada sobre o status do trabalho. Por exemplo, o painel de tarefas da sua equipe é atualizado para mostrar seu status. Consulte Acompanhar o trabalho com o Visual Studio.

• Se o seu projeto de equipe contiver definições de tipo de item de trabalho personalizado, talvez tenha problemas ao usar Meu Trabalho, a menos que um administrador do seu projeto tenha executado determinadas etapas. Consulte Configurar e personalizar ferramentas de planejamento Agile para um projeto e Atualizar um modelo de processo personalizado para acessar novos recursos.

Usar a página Alterações Pendentes para gerenciar seu trabalho

Você pode usar a página Alterações Pendentes no Team Explorer para gerenciar seu trabalho. Para abrir Alterações Pendentes, selecione Check-In em Trabalho em Andamento na página Meu Trabalho, ou pressione Ctrl+0, P.

Dica

• Você pode desencaixar a página Alterações Pendentes do Team Explorer para abri-la em uma nova janela.
• Você pode alternar entre os modos de exibição de árvore no link Opções de Exibição em Alterações Incluídas.

Quase toda alteração que você fizer nos arquivos no seu computador de desenvolvimento é armazenada em seu espaço de trabalho como uma alteração pendente até que você faça check-in. Alterações incluem:

• add
• branch
• delete
• edit
• rename, incluindo a movimentação de itens
• properties
• rollback
• type ou codificação de arquivo
• undelete

Trabalhar com alterações detectadas automaticamente

Se você estiver trabalhando em um espaço de trabalho local, o Visual Studio pode detectar as mudanças que você fez fora do sistema. Se você editar um arquivo fora do Visual Studio, por exemplo, no Bloco de Notas, a alteração aparecerá automaticamente em Alterações Incluídas na página Alterações Pendentes.

Se você adicionar ou remover um arquivo fora do Visual Studio, por exemplo, no Explorador de Arquivos, o arquivo aparecerá no link Detectado na seção Alterações Excluídas. Se você quiser incluir essas alterações, selecione o link Detectado.

A caixa de diálogo Promover Alterações Candidatas aparecerá. Você pode clicar com o botão direito do mouse em itens e escolher Procurar no Windows Explorer para exibi-los ou Excluir do disco para excluí-los. Selecione itens e, em seguida, selecione Promover para adicionar os itens em Alterações Incluídas.

Observação

Pastas vazias não serão exibidas.

Se os itens que você não precisa fazer check-in aparecerem regularmente na caixa de diálogo Promover Alterações Candidatas, você pode clicar com o botão direito do mouse no item e escolher Ignorar este item local para ignorar o item. Você também pode escolher Ignorar por extensão, Ignorar por nome de arquivo, ou Ignorar por pasta para criar um arquivo que faz com que o Visual Studio ignore sistematicamente esse tipo de arquivo. Para obter mais informações sobre arquivos .tfignore , consulte Adicionar arquivos ao servidor.

Para excluir alterações, consulte Escolher os arquivos que você deseja fazer check-in.

Associar itens de trabalho

É uma prática recomendada associar os itens de trabalho, como tarefas ou bugs, com suas alterações. Em Itens de Trabalho Relacionados, arraste os itens de trabalho de uma consulta ou adicione um item de trabalho por ID.

Ver o que você alterou

Você pode revisar o que alterou em um arquivo.

Use Alterações Pendentes para visualizar o que você alterou

Na página Alterações Pendentes, clique com o botão direito do mouse no item e escolha:

• Comparar com versão do espaço de trabalho para ver o que foi alterado da versão em seu espaço de trabalho.
• Comparar com a Versão mais Recente para ver como as alterações são comparadas com a versão mais recente do arquivo na base de código de sua equipe

Use o Gerenciador de Soluções ou Gerenciador do Controle do Código-Fonte para visualizar o que você alterou

1. Localize e selecione o item no Gerenciador de Soluções ou no Source Control Explorer.
2. Clique com o botão direito do mouse no item e escolha Comparar.
3. Na caixa de diálogo Comparar, no menu Tipo, escolha:
   • Versão do espaço de trabalho para ver o que foi alterado em relação à versão em seu espaço de trabalho.
   • Última Versão para ver como as mudanças comparam com a versão mais recente do arquivo na base de código de sua equipe.
   • Uma das outras opções: Conjunto de Alterações, Data ou Etiqueta.
4. Selecione OK.

Aparece a janela Diff. Para usar essa janela, consulte Comparar arquivos.

Desfazer as alterações pendentes

Você pode descartar uma, algumas ou todas as alterações pendentes em seu espaço de trabalho.

Observação

Outras opções:

• É possível excluir as primeiras alterações em um check-in particular no servidor antes de removê-las do seu espaço de trabalho.
• Se você já tiver feito o check-in da alteração e quiser revertê-lo, consulte Reverter conjunto de alterações.

Para desfazer algumas de suas alterações pendentes

1. Abra a caixa de diálogo Desfazer Alterações Pendentes:

   • Em Gerenciador de Soluções, clique com o botão direito do mouse nos itens e escolha Controle do código-fonte>Desfazer alterações pendentes.
   • Na página Alterações Pendentes do Team Explorer, clique com o botão direito do mouse nos itens e escolha Desfazer.
   • Em Source Control Explorer, clique com o botão direito do mouse nos itens e escolha Desfazer alterações pendentes.

   Dica

   Para desfazer todas as alterações feitas em sua solução ou em um projeto de código, clique com o botão direito do mouse na solução ou no projeto e escolha Desfazer Alterações Pendentes.

2. Na caixa de diálogo Desfazer Alterações Pendentes, verifique se as alterações que você deseja desfazer estão selecionadas e escolha Desfazer Alterações.

Para desfazer todas as suas alterações pendentes

Na página Alterações pendentes no Team Explorer, selecione o link Ações e escolha Desfazer tudo.

Usar o prompt de comando

• O comando Status exibe as alterações pendentes no prompt de comando.

• O comando Checkin abre as alterações pendentes na caixa de diálogo Check-In.

• O comando Undo desfaz as alterações pendentes.

  Dica

  Você pode usar o comando Undo para desfazer o check-out de outro usuário se tiver permissões suficientes.

• O comando Diferença mostra o que você alterou em um arquivo.

Próximas etapas

Quando terminar de fazer suas alterações:

• Para solicitar uma revisão de código de suas alterações pendentes, na página Alterações pendentes, em Ações, escolha Solicitar revisão. Para obter mais informações, confira Um dia na vida de um desenvolvedor DevOps: suspender o trabalho, corrigir um bug e realizar uma revisão de código.

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

• Para fazer check-in e adicionar suas alterações à base de código da equipe, confira Fazer check-in do seu trabalho na base de código da equipe.

Dicas

• Se você não estiver familiarizado com o desenvolvimento de um aplicativo com o Visual Studio e o TFVC, consulte Um dia na vida de um desenvolvedor DevOps: escrever um novo código para uma história de usuário.

• Quando você iniciar um novo item de trabalho, é uma boa ideia baixar os arquivos mais recentes do servidor antes de fazer check-out dos arquivos e começar seu trabalho.

• Use o Source Control Explorer para gerenciar seus arquivos no controle de versão.