UnrealVS扩展

本指南说明如何安装、设置和使用Visual Studio的UnrealVS扩展。

Windows
MacOS
Linux

Visual Studio的UnrealVS扩展使得在使用虚幻引擎4进行开发时可以轻松执行常见操作。此文档将介绍如何安装扩展,以及如何将其用于项目。

它的功能包括:

  • 设置启动项目

  • 绑定构建启动项目的命令

  • 设置命令行参数

  • 批量构建项目

  • 快速构建项目菜单

UnrealVS扩展不适用于Visual Studio Express。它只与Visual Studio社区版和专业版兼容。

安装及设置

要安装UnrealVS扩展:

  1. 在以下位置找所用Visual Studio版本的扩展:

    [UE4RootLocation]/Engine/Extras/UnrealVS/<VS-Version>/UnrealVS.vsix

  2. 运行UnrealVS.vsix文件以开始安装,只需双击该文件即可。

  3. UnrealVS扩展用于特定的Visual Studio版本。确保安装程序查找到你的版本,并选中该复选框。接下来,单击 安装(Install) 按钮继续。

    UnrealVSExtension-InstallSetup-03.png

  4. 安装完毕后,单击 关闭(Close) 按钮。

    Install Complete

  5. 运行Visual Studio,在 工具 > 扩展和更新...(Tools > Extensions and Updates...) 中,你应该可以看到该扩展。

    Extension Manager

    如果Visual Studio已经在运行,需要将其重启才能加载和显示扩展。扩展也会显示在 帮助 > 关于Microsoft Visual Studio(Help > About Microsoft Visual Studio) 对话框的“已安装的产品”列表中。

  6. 转到 视图 > 工具栏(View > Toolbars)右键单击 Visual Studio工具栏区域,然后选择 UnrealVS 以显示扩展的工具栏。

    UnrealVS Toolbar

  7. 默认情况下,工具栏显示如上,但其内容可进行自定义,步骤为在 工具 > 自定义...(Tools > Customize...) 下的 命令 选项卡中选择 UnrealVS 工具栏。

    UnrealVS Customize Toolbar

  8. 自定义(Customize) 对话框中选择 添加命令...(Add Command...),然后从 类别(Categories) 列表中选择 UnrealVS 来查看可添加到工具栏的UnrealVS命令列表。添加命令完毕后,点击 确认

    UnrealVS Customize Commands

设置启动项目

通过 启动项目(Startup Project) 下拉列表可快速设置和切换启动项目。它可以自动列出所有可用于在解决方案中构建可执行文件的项目。从列表中选择项目并将其设置为当前的启动项目。

startup_project_menu.png

你可以更改UnrealVS选项中列出的项目。要仅显示游戏项目,请转到 工具->选项...(Tools->Options...),然后选择 UnrealVS

Set Startup Project

构建启动项目

扩展还包含了构建当前启动项目的命令。这些命令可绑定到热键或其他运行自定义命令的方法上。

要将命令绑定到热键:

  1. 转到 工具 > 选项...(Tools > Options...),选择 环境(Environment) 树下的 键盘(Keyboard)。在 应用以下额外键盘映射方案(Apply the following additional keyboard mapping scheme) 下点击下拉菜单并选择 Visual C++ 6

  2. 在命令列表中选择 UnrealVS.BuildStartupProject 命令。

    Filtered Command List

    在搜索框中输入"Unreal"来过滤列表。

  3. 选中命令后,单击 按下快捷键(Press Shortcut Keys) 框,然后按下要用于执行命令的按键组合。(例如,下方示例中显示的 Ctrl + Alt + Shift + B)。

    Shortcut Keys

    请不要选择已分配给其他命令的按键组合。如果输入的按键组合已被使用,将显示 快捷键当前正被使用(Shortcut currently used by) 警告框。

  4. 按下 分配(Assign) 按钮将按键绑定到命令。这些按键组合会显示在 选定命令的快捷键(Shortcuts for selected command) 下。

    Assigned Keys

  5. 按下 确定(OK) 按钮保存更改。现在,当使用该快捷键时,将自动构建设置为“启动项目”的项目。

在单个源文件中迭代

如果您习惯在Visual Studio中使用Ctrl+F7单个源文件(.cpp)中迭代更新,可以将 Ctrl+F7 绑定到 UnrealVS.CompileSingleFile 命令,它会用当前解决方案配置、平台和 -singlefile=<Path to currently open file> 参数编译您的活跃项目。

命令行参数

命令行 功能按钮用于在运行调试会话时对当前项目设置 命令参数。这是一种快捷方法,无需通过项目 属性 来设置。实际上,这里所做的更改都会自动反映在 属性 中。

在文本框中输入参数,或从下拉列表中的最近参数列表中进行选择。调试会话启动时,这些参数将被传递给可执行文件。

Command Arguments

对构建虚幻编辑器的游戏项目使用项目配置,项目名称会自动添加到命令行,以使编辑器可执行文件知道你正在使用哪个项目。例如,如果你使用构建配置“调试编辑器(Debug Editor)”来构建QAGame,命令行会将QAGame.uproject添加到命令参数,而无需在框中输入。要启动QAGame编辑器,即使将 命令行 功能按钮留空,编辑器也会知道要运行哪个项目。

有关可用参数的完整列表,请参阅命令行参数

刷新项目

你可以使用自动生成项目文件在Visual Studio中生成项目文件。由于不必手动查找和运行.bat文件,可以更快地同步和更新所有项目文件。

要刷新项目文件:

  1. 按下 UnrealVS 工具栏上的 刷新项目(Refresh Projects) 按钮。

    button_refresh_crop.png

  2. 项目生成过程的进度会显示在 输出(Output) 窗口中。

    Project Generator Output

  3. 出现提示时,重新加载任意必要的项目。

批量构建程序

UnrealVS批量构建程序(UnrealVS Batch Builder) 提供了一种方式让我们可以创建和运行一组自定义构建作业。它比Visual Studio中的 构建 > 批量构建...(Build > Batch Build...) 选项更好用。

要打开“批量构建程序”窗口:

  1. 按下 UnrealVS 工具栏上的“批量构建程序”按钮,或者使用分配给UnrealVS.BatchBuilder命令的键盘快捷键(有关为 UnrealVS 命令设置键盘快捷键的说明,请参阅上面的 构建启动项目)。

    Batch Builder

  2. UnrealVS批量构建程序 窗口将出现。

    Batch Builder Window

    • 选择 项目配置平台 然后点击单选按钮来选择作业类型来创建 构建作业

    • 使用 >< 按钮来添加/移除作业。

    • 使用右侧箭头按钮把选择的作业在 构建作业 列表中上下移动。

    • 构建作业 列表的下拉菜单中选择想要编辑的 作业集

    • 要创建新 作业集,在输入框中输入新的名称。

    • 删除(Delete) 按钮会把选择的 作业集 从列表中删除。

    • 使用 开始(Start) 按钮来 开始/停止 当前作业集的批量构建任务。

    • 作业集存储在.suo文件中,以便下次继续用于载入的解决方案。

  3. 单击 开始(Start) 时,显示的 输出(Output) 选项卡会显示批量构建的进度。

    Batch Builder Window running

    正在运行的作业集中的 构建作业 将显示在输出列表中。当前正在执行的构建作业显示为粗体。

    • Queued Build Job = 排队作业

    • Succeeded Build Job = 作业完成,成功作业

    • Failed Build Job = 失败作业

    • Cancelled Build Job = 取消作业

    当批量构建在运行时,会显示繁忙的动画和 停止 的按钮。

  4. 通过双击 输出选项卡 中的条目,或者单击鼠标右键并从快捷菜单中选择 显示输出(Show Output from),可以查看各个 构建作业 的输出。

    BatchBuild Output Pane

    各条目的 批量构建程序 输出显示在Visual Studio 输出(Output) 窗口中名为 UnrealVS - BatchBuild 的窗格中。不要将其与“构建(Build)”窗格弄混了,后者显示当前/上一构建作业的输出。

快速构建菜单

快速构建(Quick Build) 菜单为用户提供了一条捷径,让他们可以使用任意配置和平台组合来构建项目,而无需变更主解决方案构建配置。

Quick Build Menu

  1. 解决方案浏览器 中右键单击项目节点。

  2. UnrealVS快速构建(UnrealVS Quick Build) 菜单包含虚幻引擎解决方案中可用的平台和构建配置的子菜单。

  3. 选择要用于构建所选项目、平台和配置的条目。这个方法比在IDE中变更解决方案配置和解决方案平台、开始构建然后切回配置和平台快得多。

使用UnrealVS源代码

UnrealVS源代码位于 [UE4RootLocation]/Engine/Source/Programs/UnrealVS/文件夹中。

要将UnrealVS项目文件加载到Visual Studio中,必须为要用于编译UnrealVS的相应Visual Studio版本安装相应的Visual Studio SDK。例如,要最高支持Visual Studio 2015,你需要安装Visual Studio 2015 SDK,然后将UnrealVS项目文件加载到Visual Studio 2015中。

欢迎来到全新虚幻引擎4文档站!

我们正在努力开发新功能,包括反馈系统,以便您能对我们的工作作出评价。但它目前还未正式上线。如果您对此页面有任何意见与在使用中遭遇任何问题,请前往文档反馈论坛告知我们。

新系统上线运行后,我们会及时通知您的。

发表反馈意见