Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Quando você depura uma extensão do Visual Studio, uma instância especial do Visual Studio chamada Instância Experimental é usada para hospedar sua extensão enquanto você executa o depurador no IDE principal do Visual Studio. As duas instâncias são executadas lado a lado de forma independente. Este artigo descreve como depurar extensões criadas com o SDK VisualStudio.Extensibility quando elas estão em execução na instância experimental do IDE do Visual Studio.
Processos de extensão
O processo de depuração difere um pouco para extensões executadas dentro ou fora do processo. Consulte Criar sua primeira extensão VisualStudio.Extensibility compatível com VSSDK. Com uma extensão fora de processo, sua extensão é executada em um processo separado, fora de devenv.exe. Quando você inicia uma extensão usando F5, o Visual Studio inicia a Instância Experimental do Visual Studio e se conecta ao processo que hospeda sua extensão. Normalmente, você não precisa se preocupar com o processo exato, pois quando você inicia o depurador de um projeto de extensão pressionando F5 o IDE do Visual Studio, o Visual Studio localiza o processo certo para conectar o depurador.
Quando você inicia uma sessão de depuração, o assembly de extensão e seus símbolos não são carregados imediatamente. Antes do carregamento da extensão, o Visual Studio controla os locais onde a extensão pode ser ativada. Essas informações são gerenciadas em uma instância interna de VisualStudioContribution ↗. Mesmo antes do carregamento da extensão, o Visual Studio tem informações sobre onde ela pode ser ativada, como quando o usuário escolhe um item de menu específico, pressiona um botão de barra de ferramentas ou carrega um arquivo de um determinado tipo no editor. A montagem da extensão não será carregada até que ela seja ativada na IDE. Portanto, durante a depuração, a primeira coisa que você precisa fazer é executar uma ação no IDE do Visual Studio para acionar a extensão a ser carregada. Por exemplo, talvez seja necessário selecionar o item de menu da extensão ou o botão da barra de ferramentas. Nesse ponto, o assembly da extensão é carregado, o código de inicialização é executado e você pode chegar aos pontos de interrupção e percorrer o código. O primeiro código a ser executado em sua extensão é o método InitializeAsync ↗ na classe Extension ↗, e o próximo método é InitializeServices ↗.
Processos e pilhas de chamadas
Se a sua extensão estiver dentro do processo, a pilha de chamadas incluirá registros de ativação do Visual Studio e da sua extensão. Os símbolos normalmente não estão disponíveis para o Visual Studio, mas você pode ver as chamadas em que o Visual Studio chama sua extensão.
Com uma extensão fora do processo, você só vê a pilha de chamadas da sua extensão; os registros de ativação do Visual Studio ficam em um processo separado. O Visual Studio chama sua extensão por meio de interfaces compatíveis com JsonRpc, o host do ServiceHub roteia a chamada e, em seguida, a execução em seu processo começa no callback. O controle retorna ao Visual Studio durante o retorno de chamada.
O estado é passado para a extensão por métodos variados, conforme necessário e encapsulado por uma instância IClientContext ↗ para facilitar o uso, mas é importante considerar que se trata de um instantâneo do estado, que pode mudar entre o tempo do instantâneo e o momento em que você está lendo-o pelo código de extensão ou visualizando-o no depurador.
Há algum código interno no processo de host do ServiceHub que manipula a intermediação de RPC (Chamada de Procedimento Remoto) ↗. Se ocorrer uma falha nessa camada, ela não estará visível para você. Esses erros devem ser relatados como problemas do produto.
Depurar a extensão na instância experimental do Visual Studio
Abra o projeto de extensão.
Configure um ponto de interrupção, por exemplo, no método
InitializeServices↗ da extensão, na classe principal derivada deExtension↗. Para definir um ponto de interrupção em uma linha de código, clique na linha e pressioneF9.No menu principal, escolha Depurar > Iniciar Depuração ou pressione
F5. A Instância Experimental do Visual Studio é iniciada; ao mesmo tempo, o processo de hospedagem do ServiceHub é iniciado.Execute as etapas na instância experimental do Visual Studio que fazem com que sua extensão seja ativada ou reproduza o cenário que você pretende depurar.
O Visual Studio para em um ponto de interrupção.
Tip
Pode ser conveniente ter vários monitores, para que você possa ver o depurador e a instância experimental ao mesmo tempo em dois monitores diferentes. Talvez você queira alterar o tema na Instância Experimental para torná-lo mais óbvio com qual IDE você está trabalhando a qualquer momento. Consulte Alterar fontes, cores e temas em Visual Studio ↗ .
Iniciar ou redefinir a instância experimental
Você pode redefinir ou iniciar a instância experimental usando os atalhos ResetExperimental e StartExperimental na pasta VSSDK (na pasta de instalação do Visual Studio).
No Visual Studio 2026 e posterior, você também pode usar comandos no menuDesenvolvimento de Extensão de > para iniciar ou redefinir a instância experimental.
Troubleshooting
Ao iniciar o depurador, se você vir o erro Essa extensão não tem suporte no produto atual, abra o .vsixmanifest arquivo e verifique o InstallationTarget elemento. Não há suporte para o destino Microsoft.VisualStudio.IntegratedShell de instalação; use Microsoft.VisualStudio.Community em vez disso. Consulte a Referência do Esquema de Extensão VSIX 2.0 ↗.
Usar o Diagnostics Explorer
A partir do Visual Studio 18.9, o VisualStudio.Extensibility Diagnostics Explorer é um recurso interno do Visual Studio (substituindo a extensão de diagnóstico autônoma anterior). Habilite-o por meio de Ferramentas > Opções > Ambiente > Recursos de Visualização pesquisando por VisualStudio.Extensibility Diagnostics.
O Diagnostics Explorer mostra informações em tempo real sobre extensões carregadas: status, canais de comunicação, logs de erros e disponibilidade do serviço. Isso é útil para solucionar problemas de carregamento de extensão e depurar problemas de comunicação em extensões fora de processo.
Note
A extensão VisualStudio.Extensibility do Diagnostics autônoma não será mais compatível depois de 18.9. Em vez disso, use o recurso interno.