Partilhar via

Instalar um visualizador

Importante

A partir do Visual Studio 2022 versão 17.9, os visualizadores agora podem ser escritos no .NET 6.0+ que são executados fora do processo usando o novo modelo VisualStudio.Extensibility. Para extensões criadas usando o novo modelo, consulte a documentação no Criar visualizadores de depuração do Visual Studio. Se você precisar oferecer suporte a versões mais antigas do Visual Studio ou quiser enviar seus visualizadores personalizados como parte de uma DLL de biblioteca, use as informações neste artigo, que se aplica somente ao modelo mais antigo de desenvolvimento de extensão (VSSDK).

Depois de criar um visualizador, você deve instalá-lo para que ele esteja disponível no Visual Studio. Instalar um visualizador é um processo simples.

Observação

Em aplicativos UWP, apenas os visualizadores de texto padrão, HTML, XML e JSON são suportados. Não há suporte para visualizadores personalizados (criados pelo usuário).

Para instalar um visualizador para o Visual Studio 2019

  1. Localize a DLL que contém o visualizador que você criou.

    Normalmente, é melhor se a DLL do lado do depurador e a DLL do lado do depurado especificarem Qualquer CPU como a plataforma de destino. A DLL do depurador deve ser Any CPU ou 32 bits. A plataforma de destino para a DLL do lado do depurador deve corresponder ao processo de depuração.

    Observação

    O visualizador do lado do debugger é carregado no processo do Visual Studio, portanto, deve ser uma DLL do .NET Framework. O lado a ser depurado pode ser o .NET Framework ou .NET Standard, dependendo do processo que está a ser depurado no Visual Studio.

  2. Copie a DLL do lado do depurador (e quaisquer DLLs das quais dependa) para um dos seguintes locais:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers

    • My Documents\ VisualStudioVersion\Visualizers

  3. Copie a DLL do lado do depurador para um dos seguintes locais:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers\Enquadramento

    • My Documents\ VisualStudioVersion\Visualizers\Framework

    onde Framework é um dos seguintes:

    • net2.0 para depuradores que executam o .NET Framework tempo de execução.
    • netstandard2.0 para depuradores que usam um tempo de execução que suporta netstandard 2.0 (.NET Framework v4.6.1+ ou .NET Core 2.0+).
    • netcoreapp para programas depurados que executam o ambiente de execução .NET Core. (suporta .NET Core 2.0+)

    Uma DLL do lado do depurador é necessária se você quiser criar um visualizador autônomo. Esta DLL contém código para o objeto de dados, que pode implementar métodos de VisualizerObjectSource.

    Se você estiver segmentando várias vezes o código do lado do depurador, a DLL do lado do depurador deverá ser colocada na pasta para TFM com suporte mínimo.

  4. Reinicie a sessão de depuração.

Observação

O procedimento é diferente no Visual Studio 2017 e versões anteriores. Consulte a versão anterior deste artigo.

Conteúdo relacionado

  • Last updated on