Files
Mitchell Wilson 3f8c52a80a Copying //UE4/Dev-Documentation to Samples-Main (//UE4/Samples-Main)
#rb none

[CL 6955335 by Mitchell Wilson in Main branch]
2019-06-12 12:19:04 -04:00

224 lines
9.6 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
INTSourceChangelist:3467293
Availability:Public
Title:为UE4设置Visual Studio
Description:如何设置Visual Studio以使用虚幻引擎4进行开发的提示、技巧和技术。
Crumbs: %ROOT%
Parent:Programming/Development
Order:
Version: 4.16
type:overview
tags:Visual Studio
skilllevel:Beginner
topic-image:SettingUpVSForUE4_topic.png
[TOC(start:2 end:3)]
[EXCERPT:Intro]
虚幻引擎4(UE4)设计为可与Visual Studio顺利集成允许您在项目中快速、轻松地更改代码以便在编译完成时立即看到结果。
设置Visual Studio以配合UE4使用可以帮助使用UE4的开发人员提高效率和整体用户体验。
在本文中我们还将介绍设置UE4到VS2013工作流程的基础知识。
[/EXCERPT:Intro]
(#beforesetting-upyourue4-to-vsworkflow)
## 设置您的UE4到VS工作流程之前
需要注意的是Visual Studio 2015(VS2015)默认情况下不安装C++工具支持。安装VS2015时选择 **自定义Custom** 安装然后选择您的工作流程所需的C++组件。
如果您已经安装了Visual Studio 2015选择 **文件File> 新建New> 项目Project> C++** 来安装C++。
下表列出了Visual Studio的哪些版本可与UE4的二进制版本集成。
| 虚幻引擎版本 | Visual Studio版本 |
| ------------------------- | --------------------- |
| **4.15或更高版本** | VS2017 |
| **4.10到4.14** | VS2015 |
| **4.2到4.9** | VS2013 |
UE4的开源版本可通过GitHub和P4获得与VS2013集成。此外本文档不讨论较早UE4版本与较旧Visual Studio版本的集成。
(#recommendedsettings)
## 推荐设置
以下是对使用Visual Studio和虚幻引擎4的开发人员的推荐设置。
[EXCERPT:BasicVSFormat]
1. 通过执行以下步骤增加解决方案配置下拉菜单的宽度:
1. 右键单击工具栏并在出现的菜单底部选择 **自定义Customize**。
![](SelectingCustomize.png)
1. 单击 **命令Commands** 选项卡。
![](ClickCommandsTab.png)
1. 选择 **工具栏Toolbar** 单选按钮。
![](SelectToolbarRadioButton.png)
1. 在 **工具栏Toolbar** 旁边的下拉菜单中,选择 **标准Standard**。
![](SelectStandard.png)
1. 在底部的 **控件Controls** 列表中,选择 **解决方案配置Solution Configurations** 控件。
![](SelectSolutionConfigControl.png)
1. 单击右侧的 **修改选择Modify Selection**。
![](ClickModifySelection.png)
1. 将 **宽度Width** 设置为“200”。
![](SetWidth_200.png)
1. 单击 **关闭Close**。您的工具栏应立即更新。
![](ClickClosetoUpdateToolbar.png)
1. 通过执行以下步骤添加解决方案平台Solution Platforms下拉菜单。
1. 在标准工具栏上找到最右边的按钮,它将打开下拉菜单,允许您从工具栏中添加和删除按钮。
![](SelectDropDownButton.png)
1. 单击下拉按钮,将鼠标悬停在 **添加或删除按钮** 上,然后单击 **解决方案平台Solution Platform** 将菜单添加到工具栏中。
![](SelectSolutionPlatforms.png)
1. 我们建议您关闭 **错误列表Error List** 窗口。通常,当代码中出现错误时,**错误列表Error List** 窗口会自动弹出。但是,在使用虚幻引擎时,**错误列表Error List** 窗口可以显示假的错误信息。在使用虚幻引擎时,最好禁用 **错误列表Error List** 窗口,并使用 **输出Output** 窗口查看真实的代码错误。下面的步骤向您展示如何关闭 **错误列表Error List** 窗口:
1. 如果 **错误列表Error List** 窗口是打开的,关闭它。
1. 从 **工具Tools** 菜单中,打开 **选项Options** 对话框。
![](OpenOptionsDialog.png)
1. 选择 **项目和解决方案Projects and Solutions**,取消勾选 **如果构建完成时出错总是显示错误列表Always show Error List if build finishes with error**。
![](UncheckErrorsListOption.png)
1. 单击 **确定OK**。
[/EXCERPT:BasicVSFormat]
[REGION:tip]
您可能会发现的其他有用的配置步骤为:
* 关闭 **显示不活动的代码块Show Inactive Blocks**。如果未关闭,许多代码块可能在文本编辑器中显示为灰色。(**工具Tools> 选项Options> 文本编辑器Text Editor> C/C++ > 视图View**)。
* 将 **禁用外部依赖性文件夹Disable External Dependencies Folders** 设置为True将不需要的文件夹隐藏在 **解决方案浏览器Solution Explorer** 中。(**工具Tools> 选项Options> 文本编辑器Text Editor> C/C++ > 高级Advanced** 中的 **禁用外部依赖性文件夹Disable External Dependencies Folders**
* 关闭 **编辑和继续Edit & Continue** 功能,您不需要它们。(**工具Tools> 选项Options> 调试Debugging> 编辑和继续Edit and Continue**
* 打开智能感应IntelliSense请参阅[智能感应、实时错误和Squiggle](#Intellisense)
[/REGION]
(#visualassistxusers)
###Visual Assist X用户
如果已安装了Visual Assist X
* 关闭 **粘贴后格式化Format After Paste****VAssistX > Visual Assist X选项Visual Assist X Options> 高级Advanced> 纠正Corrections**。如未禁用此选项Visual Assist X将自动格式化源代码可能会导致出现格式不佳的文档。
(#visualstudio2017users)
###Visual Studio 2017用户
如果您是第一次安装Visual Studio您需要确保启用了以下选项。
(#withtheue4installer)
####带UE4安装程序
以下选项将下载UE4安装程序作为Visual Studio 2017安装的一部分。
![](VS2017_SettingsInstaller.png)
(#withouttheue4installer)
####不带UE4安装程序
以下选项不会将UE4安装程序作为Visual Studio 2017安装的一部分下载。
![](VS2017_SettingsNoInstaller.png)
(#Intellisense)
(#intellisense,liveerrors,andsquiggles)
## 智能感应、实时错误和Squiggle
UE4项目现在有了正确的智能感应支持包括实时错误列表和squiggle。
(有关如何启用它,请参见下面的内容。)
当您输入时智能感应会重新编译C++。这比仅仅使用VAX的语法检查功能强大得多
因为它使用完整的C++编译器来验证每一行代码。它非常棒,
可以加快您的工作流程!
![VC++ Intellisense Squiggles](squiggle.png)
除了Squiggle之外您还将在正在查看的任何文件的错误列表中看到智能感应错误。
您可以在错误列表中的 **右键菜单** 中打开或关闭它。
![Error List](error_list.png)
您可能已经禁用了Squiggle因为它们不能用于UE4项目。请确保点击C/C++高级C/C++ Advanced选项卡并使用
与下面类似的设置。
![VC++ Advanced Options](intellisense_options.png)
当您打开一个C++文件,您可以通过寻找以下图标看到智能感应编译器“工作”:
![Intellisense Progress Indicator](intellisense_progress.png)
(#implementationdetails)
### 实施详情
* 在编辑代码时有时需要几秒钟的时间才会显示Squiggle。
* 这是因为我们有大量的包含文件而智能感应目前并不使用PCH。
* 有时您会看到“错误肯定”的智能感应错误。有几个可能的原因。
* 智能感应编译器(EDG)比MSVC编译器更严格。
* 有些#定义的智能感应设置与正常构建时的设置不同。
* 由智能感应编译的C++总是被视为32位。
* 在绝对必要的情况下,您可以将代码打包到“#ifdef __INTELLISENSE__”以消除Squiggle。
* 智能感应错误的措辞与VC++编译器的错误稍有不同。事实就是如此。
* 标头文件中的Squiggle的工作原理是根据已知的包含该标头文件的“.cpp”编译标头文件。
* 有时智能感应会搞砸您会在标头中看到Squiggle。
* 有一个 **Max Cached Translation Units** 设置(如上所示),如果需要可以增加。
* 它使用了更多内存,但可能会稍微提高响应能力。
* 一些C++文件仍然不兼容智能感应。
* 虚幻构建工具有一个新的“-智能感应(-IntelliSense”选项。
* 这将为我们所有的项目文件生成智能感应属性表。
* 这只需要在添加新模块或更改项目包含内容时重新运行。
(#unrealvsextension)
## UnrealVS扩展
[INCLUDE:Programming/Development/VisualStudioSetup/UnrealVS#Overview]
有关设置和使用扩展的信息,请参阅[](Programming/Development/VisualStudioSetup/UnrealVS)
页面。
(#debugging)
## 调试
Visual Studio支持使用查看器扩展调试器这些查看器可以方便地检查常见的虚幻类型如FName和动态阵列。
(#installingtheue4visualizerforvisualstudio2013)
### 为Visual Studio 2013安装UE4查看器
安装UE4查看器需要两个步骤。
[PUBLISH:Licensee]
1. 定位包含查看器逻辑的文件该文件是UE4发布版的一部分
* //depot/UE4/Engine/Extras/VisualStudioDebugging/UE4.natvis
[/PUBLISH:Licensee]
[PUBLISH:Rocket]
1. 定位包含查看器逻辑的文件,该文件是您的安装的一部分:
* [UE4Root]/Engine/Extras/VisualStudioDebugging/UE4.natvis
[/PUBLISH:Rocket]
1. 将“UE4.natvis”复制到以下任一位置
* [VisualStudioInstallPath]/Common7/Packages/Debugger/Visualizers/UE4.natvis
* [UserProfile]/My Documents/Visual Studio 2013/Visualizers/UE4.natvis
[REGION:warning]
将文件复制到Visual Studio安装目录可能需要管理员权限。
[/REGION]