安装可视化工具

重要

从 Visual Studio 2022 版本 17.9 开始,可视化工具现在可以使用 .NET 6.0+ 编写,其使用新的 VisualStudio.Extensibility 模型在进程外运行。 我们鼓励可视化工具作者参考创建 Visual Studio 调试程序可视化工具处的新文档,除非他们希望支持旧版 Visual Studio,或者希望将其自定义可视化工具作为库 DLL 的一部分交付。

创建可视化工具后,还必须安装该可视化工具,这样才可在 Visual Studio 中使用它。 安装可视化工具是个简单的过程。

注意

UWP 应用仅支持标准文本、HTML、XML 和 JSON 可视化工具。 不支持自定义(用户创建的)可视化工具。

安装适用于 Visual Studio 2019 的可视化工具

  1. 找到包含已创建的可视化工具的 DLL。

    通常,最理想的情况是调试器端 DLL 和调试对象端 DLL 指定任意 CPU 作为目标平台。 调试器端 DLL 必须为“任意 CPU”或“32 位” 。 调试对象端 DLL 的目标平台应对应于调试对象进程。

    注意

    调试器端可视化工具会加载到 Visual Studio 进程中,因此必须是 .NET Framework DLL。 调试对象端可以是 .NET Framework 也可以是 .NET Standard,具体取决于 Visual Studio 中正在调试的进程。

  2. 调试器端 DLL(以及它所依赖的任意 DLL)复制到以下位置之一:

    • VisualStudioInstallPath \Common7\Packages\Debugger\Visualizers

    • My Documents\ VisualStudioVersion \Visualizers

  3. 调试对象端 DLL 复制到下列位置之一:

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

    • My Documents\ VisualStudioVersion \Visualizers\ Framework

    其中 Framework:

    • 对于运行 .NET Framework 运行时的调试对象,为 net2.0
    • 对于使用支持 netstandard 2.0.NET Framework v4.6.1+.NET Core 2.0+)的运行时的调试对象,为 netstandard2.0
    • 对于运行 .NET Core 运行时的调试对象,为 netcoreapp。 (支持 .NET Core 2.0+

    如果要创建独立可视化工具,则需要调试对象端 DLL。 此 DLL 包含数据对象的代码,该代码可实现 VisualizerObjectSource 方法。

    如果你对调试对象端代码设定了多个目标,则必须将调试对象端 DLL 置于最小支持 TFM 的文件夹中。

  4. 重新启动调试会话。

注意

此过程在 Visual Studio 2017 及更早版本中是不同的。 请参阅本文的早期版本