Atualização manual
Quando você atualiza itens em um espaço de trabalho ou desfaz uma confirmação, há sempre uma chance de que um ou mais itens falhem. O espaço de trabalho não será atualizado se a atualização de entrada da ramificação do Git causar inconsistências ou outros problemas no espaço de trabalho difíceis de determinar com antecedência. Quando um item não é atualizado, o processo de atualização é interrompido. Se o item que falhou for o primeiro (ou único) item que foi atualizado, o espaço de trabalho permanecerá sincronizado com a ramificação original. Se um item falhar depois que um ou mais itens forem atualizados com sucesso, você terá uma situação em que alguns itens serão sincronizados e outros não. Nesse caso, seu espaço de trabalho não é sincronizado com nenhuma ramificação do Git.
Importante
Este recurso está em pré-visualização.
Uma atualização pode falhar por vários motivos. As possíveis razões incluem, entre outras, os seguintes problemas:
- Itens dependentes foram alterados ou excluídos
- Foram criadas dependências circulares
- Item renomeado
- Dados de item inválidos
Nota
Isto não é o mesmo que resolução de conflitos. Se forem feitas alterações no mesmo item no espaço de trabalho e na ramificação do Git, isso causará um conflito e as atualizações serão desabilitadas. Este artigo discute o que fazer um espaço de trabalho não é atualizado, mesmo que não haja conflitos diretos.
Uma mensagem de erro informa qual item falhou e por quê.
Esta mensagem de erro aparece quando a atualização falha. Qualquer usuário que tente acessar o espaço de trabalho depois disso verá o seguinte erro até que a atualização seja concluída com êxito.
Selecione Exibir detalhes para ver a mensagem de erro anterior.
Status do Git após falha de um item
Seu espaço de trabalho agora contém os seguintes itens:
- O item ou itens atualizados antes da falha. Esses itens são idênticos aos itens no git, mas os metadados não são atualizados. Eles têm um status Git sincronizado, mas com um sinal de aviso de triângulo.
- O item que falhou. Este item tem um status Git de Atualização necessária.
- Possivelmente, itens que ainda não foram atualizados quando o item falhou. Esses itens ainda não foram atualizados e têm um status Git de Atualização necessária.
A barra de status na parte inferior da tela que mostra o status de sincronização mais recente está vermelha e indica o status parcialmente sincronizado.
Atualizar o item com falha
Para atualizar o espaço de trabalho manualmente depois que ele falhou na atualização automática:
- Descubra qual item está causando a falha da atualização e qual é o problema usando a caixa de diálogo de erro que diz qual item falhou e mensagem de erro.
- Corrija o problema no Git. Isso pode significar fazer um ou mais dos seguintes procedimentos, dependendo do problema:
- Reverter o item para uma versão anterior que não falha
- Editar o item resolver o problema
- Restaurar um item dependente que foi excluído
- Excluir item não suportado que depende do item excluído
- Volte para o espaço de trabalho e atualize todo o espaço de trabalho novamente.
Considerações e limitações
O processo de atualização falha assim que um item falha. Portanto, não há como saber se outros itens no ramo Git também são problemáticos. Se você estiver atualizando muitos itens e mais de um item for problemático, será necessário repetir esse processo uma vez para cada item com falha.