Instalar um visualizador

  • Artigo

Importante

A partir do Visual Studio 2022 versão 17.9, os visualizadores podem ser escritos em .NET 6.0+ que são executados fora do processo usando o novo modelo VisualStudio.Extensibility. Incentivamos os autores de visualizadores a fazer referência à nova documentação em Criar visualizadores de depurador do Visual Studio, a menos que desejem oferecer suporte a versões mais antigas do Visual Studio ou desejem enviar seus visualizadores personalizados como parte de uma DLL de biblioteca.

Após criar um visualizador, você precisa instalá-lo o visualizador para que fique disponível no Visual Studio. Instalar um visualizador é um processo simples.

Observação

Nos aplicativos UWP, somente visualizadores de texto padrão, HTML, XML e JSON têm suporte. Não há suporte para visualizadores personalizados (criados pelo usuário).

Para instalar um visualizador do Visual Studio 2019

  1. Localize a DLL que contém o visualizador criado.

    Normalmente, é melhor que a DLL do lado do depurador e a DLL do lado do depurador especifiquem Qualquer CPU como a plataforma de destino. A DLL do lado do depurador precisa ser Qualquer CPU ou 32 bits. A plataforma de destino da DLL do lado do depurado deve corresponder ao processo do depurado.

    Observação

    O visualizador do lado do depurador é carregado no processo do Visual Studio e, portanto, deve ser uma DLL .NET Framework. O lado do depurado pode ser .NET Framework ou .NET Standard, dependendo de qual processo está sendo depurado no Visual Studio.

  2. Copie a DLL do lado do depurador (e as DLLs das quais ela depende) para qualquer um dos seguintes locais:

    • VisualStudioInstallPath \Common7\Packages\Debugger\Visualizers

    • My Documents\ VisualStudioVersion \Visualizers

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

    • VisualStudioInstallPath \Common7\Packages\Debugger\Visualizers\ Framework

    • My Documents\ VisualStudioVersion \Visualizers\ Framework

    em que Framework é:

    • net2.0 para depurados que executam o runtime .NET Framework.
    • netstandard2.0 para depurados que usam um runtime com suporte para netstandard 2.0 (.NET Framework v4.6.1+ ou .NET Core 2.0+).
    • netcoreapp para depurados que executam o runtime .NET Core. (dá suporte a .NET Core 2.0+)

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

    Se você estiver vários alvos no código do lado do depurado, a DLL do lado do depurado precisará 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 mais antigos. Consulte a versão anterior deste artigo.

Conteúdo relacionado