Codepuração em uma sessão de colaboração no Visual Studio

O recurso de depuração colaborativa do Visual Studio Live Share é uma maneira exclusiva e avançada de depurar um problema. Esse recurso permite uma experiência colaborativa para solucionar problemas. Os participantes da sessão também podem usá-la para investigar problemas que possam ser específicos do ambiente, fornecendo uma sessão de depuração compartilhada na máquina do host.

Dica

Como todos os participantes podem navegar e editar arquivos de forma independente, como um host, convém restringir quais arquivos os convidados podem acessar em seu projeto por meio de um arquivo .vsls.json . Você também deve estar ciente de que o acesso ao Console/REPL significa que os participantes podem executar comandos em sua máquina, portanto, você só deve co-depurar com aqueles em quem confia. Como convidado, também é importante perceber que você pode não ser capaz de seguir o depurador enquanto ele entra em determinados arquivos restritos como resultado dessas configurações. Confira Controlar o acesso a arquivos e visibilidade para saber mais detalhes.

Para usá-lo, o host da sessão de colaboração precisa iniciar a depuração por meio dos meios usuais no Visual Studio.

Screenshot that shows the Visual Studio Debug button.

Depois que o depurador é anexado no lado do host, todos os convidados são automaticamente anexados. Embora haja apenas uma "sessão" de depuração em execução na máquina do host, todos os participantes estão conectados a ela e têm sua própria exibição.

Dica

Se você quiser alterar quando e como a codepuração acontece, você pode alterar os comportamentos padrão por meio das configurações de Live Share das Opções > de Ferramentas>.

Screenshot that shows the Visual Studio debugger attached.

Qualquer pessoa pode passar pelo processo de depuração, que permite a alternância perfeita entre colaboradores sem ter que negociar o controle.

Observação

Confira Suporte de plataforma para obter o estado das funcionalidades de depuração por linguagem ou plataforma.

Cada colaborador pode investigar variáveis diferentes, pular para arquivos diferentes na pilha de chamadas, inspecionar variáveis e, até mesmo, adicionar ou remover pontos de interrupção. Cada participante pode usar recursos de coedição para rastrear onde os outros estão localizados. Os participantes podem alternar perfeitamente entre investigar simultaneamente diferentes aspectos do problema e depurar colaborativamente.

Observação

Enquanto estiver em uma sessão de colaboração somente leitura, os convidados não poderão passar pelo processo de depuração. No entanto, eles ainda podem adicionar ou remover pontos de interrupção e inspecionar variáveis.

Dica

Você também pode participar de sessões de depuração de código do Visual Studio do Visual Studio e vice-versa! Confira as instruções do Visual Studio Code sobre codepuração para obter mais informações.

Compartilhamento automático do aplicativo Web

Para projetos de ASP.NET Web App, se o projeto do host estiver configurado para iniciar automaticamente um navegador da Web para se conectar ao aplicativo Web em execução durante a depuração, o Live Share fará automaticamente o mesmo na máquina de cada convidado! Esse processo é feito de forma segura e, por padrão, o aplicativo Web remoto só está disponível para convidados durante a sessão de depuração.

Consulte Compartilhar um servidor para obter informações sobre como compartilhar o acesso ao servidor para outros tipos de projeto e durante a sessão.

Dica

Se você não gostar do comportamento de compartilhamento automatizado do navegador e quiser alterá-lo, poderá atualizar as configurações em Opções de Ferramentas > Live Share>.

Animation that shows concurrent debugging.

Alterar quando o Visual Studio ingressa em sessões de depuração

Os convidados são automaticamente anexados às sessões de depuração quando o host os compartilha por padrão. No entanto, em alguns casos, você pode achar esse comportamento perturbador. Felizmente, você pode alterá-lo da seguinte maneira:

  1. Vá para Opções > de Ferramentas > Live Share
  2. Altere o comportamento de associação de sessão de depuração para um dos seguintes:
Opção Comportamento
Automático O padrão. Como um convidado, você ingressará automaticamente em qualquer sessão de depuração compartilhada iniciada pelo host.
Prompt Como convidado, você será solicitado a ingressar em uma sessão de depuração compartilhada quando ela for iniciada pelo host.
Manual Como convidado, você precisará ingressar manualmente em qualquer sessão de depuração. Confira desanexando e reanexando.

Desanexando e reanexando

Como convidado, talvez você queira parar de depurar temporariamente. Você pode clicar no ícone de parada na barra de ferramentas de depuração para desanexar o depurador sem afetar o host ou outros convidados.

Talvez você tenha atualizado as configurações para não se conectar mais automaticamente ou queira reanexar mais tarde. Você pode selecionar a sessão de depuração em execução preferida na lista suspensa Selecionar Item de Inicialização...

Screenshot that shows the Visual Studio Debug button when selecting a debugging session from the Select Startup Item drop-down.

Em seguida, clique nele para anexar.

Screenshot that shows the Visual Studio Debug button when reattaching.

Próximas etapas