安装 Visual Studio Tools for Unreal Engine

本文可帮助你安装工具,以便从 Visual Studio 中执行以下作:

  • 查看 UE 日志记录
  • 查看和展开 UE 宏
  • 添加 UE 类、模块和插件
  • 发现、运行、管理和调试 Unreal Engine 测试
  • 调试 Unreal Engine 蓝图调用的C++代码,并在 Visual Studio 调试器中查看蓝图信息
  • 查看和查找对 UE 蓝图的引用

先决条件

在安装 Visual Studio Tools for Unreal Engine 之前安装以下内容:

  • Visual Studio 版本 17.7 或更高版本。 若要安装,请参阅 Visual Studio 下载
  • Unreal Engine 版本 4.27 或 5.0 或更高版本。 若要安装,请参阅 下载说明

安装

本文介绍如何安装工具,以增强在 Visual Studio 中编写和调试 Unreal Engine (UE) 代码。 下面是工具的概述:

工具 安装到 功能性
Visual Studio Tools for Unreal Engine Visual Studio 从 Visual Studio 中添加 UE 类、模块、查看 UE 日志记录、查看 UE 宏扩展、查找蓝图引用、直接打开 UE .uprojects 等。 从 Visual Studio 2022 版本 17.7 开始,不再需要 Unreal Engine Visual Studio 集成工具插件才能在 Visual Studio 中查看 UE 蓝图。
适用于 Unreal Engine 蓝图的 Visual Studio 调试器工具 Visual Studio 支持调试C++代码和蓝图。 要求 Visual Studio 的 UE 插件在调试器中显示蓝图节点引脚值。
Unreal Engine 测试适配器 Visual Studio 从 Visual Studio 中发现、运行、管理和调试 Unreal Engine 测试。 需要 Visual Studio 的 UE 插件。
Visual Studio 的 Unreal Engine 插件 Unreal Engine 提供 Unreal Engine 和 Visual Studio 之间的集成,以在 Visual Studio 中运行 UE 测试,并在 Visual Studio 本地变量窗口中查看蓝图节点固定值。

按照以下步骤将工具添加到 Visual Studio:

  1. 在 Windows 搜索框中,键入“Visual Studio Installer”。

  2. 在“应用”结果下查找安装程序,然后双击它。

  3. 出现安装程序时,选择您正在使用的 Visual Studio 版本,然后单击“修改”。

  4. 选择“工作负载” 选项卡,然后选择具有C++工作负载的 游戏开发。

  5. “安装详细信息”窗格中,请确保在“使用C++进行游戏开发”>(可选)下选择以下内容:

    • Visual Studio 用于 Unreal Engine 的工具
    • 适用于 Unreal Engine 蓝图的 Visual Studio 调试器工具
    • Unreal Engine 测试适配器
    • 如果使用 High-Level 着色器语言(HLSL)文件,请选择 HLSL 工具
  6. 选择对话框顶部的 单个组件 选项卡。

  7. 在右侧的安装详细信息下,展开使用 C++ 的游戏开发

  8. 确保在 可选 下选择 Windows 10 SDK 10.0.18362.0或更高版本。

  9. 选择修改 以完成安装。

    Visual Studio 安装程序的屏幕截图。选择了具有C++工作负荷的游戏开发。在安装详细信息窗格中,选择了 Visual Studio Tools for Unreal Engine、Visual Studio Debugger tools for Unreal Engine Blueprints、HSL Tools 和 Windows 11 SDK。

若要将 Visual Studio 的 Unreal Engine 插件添加到 UE,请执行以下步骤:

  • 有关手动安装说明,请参阅 vc-ue-extensions
  • 如果你有一个可在 Visual Studio 中打开的 Unreal Engine 项目,则安装插件的另一种方法是通过 Unreal Engine 配置窗口在 Visual Studio 中。
    • 在 Visual Studio 中打开 Unreal Engine 项目后,选择 Project>Configure Tools for Unreal Engine 以打开 Unreal Engine 集成配置 窗口。
    • “Visual Studio 集成工具状态 ”部分中,选择“ 安装到项目 ”或 “安装到引擎 ”以满足你的需求。

如果未看到安装按钮,请选择窗口右上角的刷新图标以刷新状态。 如果需要手动安装插件,手动 安装说明 链接将打开 “vc-ue-extensions ”页。

Unreal Engine 集成配置窗口的屏幕截图。在“Visual Studio 集成工具状态”部分中,突出显示了“刷新”、“安装到项目”、“安装到引擎”按钮。此外,还突出显示了“手动安装说明”链接。

检查更新

为了获得最新的 bug 修复、功能和对 Unreal 引擎的支持,我们建议您保持 Visual Studio 更新。 更新 Visual Studio 不需要更新 Unreal Engine。

  1. 在 Visual Studio 主菜单中,选择“帮助”>“检查更新”。

    Visual Studio 帮助菜单中“检查更新”菜单的屏幕截图。

  2. 如果更新可用,Visual Studio 安装程序会显示新版本。 选择“更新”

    带有更新的 Visual Studio 安装程序的屏幕截图。

后续步骤

试用 Visual Studio Tools for Unreal Engine 的一些功能:

快速入门:使用 Visual Studio Tools for Unreal Engine
Visual Studio 中添加 Unreal Engine 类、模块和插件
在 Visual Studio 中查看 Unreal Engine 蓝图
在 Visual Studio 中查看 Unreal Engine 日志记录
在 Visual Studio 中查看 Unreal Engine 宏