Choose your operating system:
Windows
macOS
Linux
在Epic,我们在使用虚幻引擎时会参考这些信息来设置QtCreator。尽管我们提供了这篇文档,但我们对QtCreator的支持仅限于虚幻引擎4.14。
在本教程的最后,你将配置一个
集成开发环境
(IDE),以构建和运行虚幻引擎4(UE4)。
1 - 配置Qt Creator以构建UE4
虽然有些开发者喜欢使用文本编辑器和命令行调试器来修改他们的游戏源代码,但大多数开发者更喜欢使用集成开发环境(IDE)来编辑、调试和编译他们的代码。如果你是一名游戏开发者,希望在Linux环境下设置一个IDE来使用虚幻引擎4(UE4),那么本指南适合你。
虽然我们认识到选择IDE取决于个人的偏好,但是我们已经将UE4配置为在Linux中与三个IDE连接;具体来说,是Qt Creator、KDevelop和Codelite。我们不偏向任何一个IDE;但是,作为一个学习用例,我们选择了向你展示如何配置Qt Creator来构建和运行UE4。在本指南的最后,你将了解如何配置IDE来构建和运行UE4。最后,你还将了解如何设置IDE来构建和运行从虚幻编辑器新建的C++(CPP)项目。
在我们开始之前,请确保你已经使用我们的 Linux快速入门 设置了工作流程。此外,请确保 Qt Creator 已安装在你的机器上。
-
启用Qt Creator,打开 Qt欢迎(Qt Welcome) 菜单。
点击显示大图。
-
单击 打开项目(Open Project) 按钮打开Qt项目文件浏览器。
点击显示大图。
-
导航到你构建UE4的目录,选择UE4 Qt项目( UE4.pro )文件,并单击 打开(Open) 。
点击显示大图。
-
此时,Qt Creator尚未配置为在调试和发布模式下构建UE4。单击 配置项目(Configure Project) ,该选项位于 配置项目(Configure Project) 菜单中。
点击显示大图。
-
现在单击 项目(Projects) 以进入项目模式,打开 构建设置(Build Settings) 菜单。
点击显示大图。
-
在 构建步骤(Build Steps) 部分下,单击 详情(Details) 下拉菜单旁边的 X 按钮,清除 qmake 构建步骤。
点击显示大图。
-
现在清除 阴影构建(Shadow build) 复选框以取消该选择。
点击显示大图。
阴影构建允许你使用Qt Creator的qmake工具在单独的构建目录中构建项目。因为UE4是使用[UnrealBuildTool]自定义Make文件分发的,该文件利用的是 UnrealBuildTool ,因此你不需要使用Qt Creator的qmake工具。
-
现在单击 详情(Details) 下拉菜单以打开 Make 构建步骤的输入表单。
-
将`UE4Editor-Linux-Debug`输入到 Make arguments: 文本字段。
-
在 清除步骤(Clean Steps) 部分下,单击 详情(Details) 下拉菜单以打开 Make 清除步骤的输入表单。
-
通过将`UE4Editor-Linux-Debug ARGS="-clean"
输入到 **Make arguments:** 文本字段中,以替换`clean
。 -
现在单击 编辑构建配置:(Edit build configuration:) 下拉菜单并选择 发布(Release) 以打开发布模式的 构建设置(Build Settings) 。
点击显示大图。
-
重复步骤6到11,以编辑发布模式的构建配置设置。请确保你的设置与下图匹配:
如果你想为你的项目设置额外的构建配置,请参阅Qt Creator 构建设置文档 ,其中向你展示了如何添加可能需要的尽可能多的构建配置。
阶段成果
点击显示大图。
此时,你已经将UE4配置为在调试和发布模式下进行构建。根据系统规格,你可能会注意到UE4在调试模式下运行得更慢。有关可用构建配置的性能特性的更多信息,请通读我们的 构建配置参考 页面。记住这一点,你就可以配置Qt Creator以运行UE4了。
2 - 配置Qt Creator以运行UE4
此时,你已经将UE4配置为在调试和发布模式下进行构建。现在,你已准备好配置Qt Creator以运行UE4了。
-
单击 运行(Run) 按钮打开 运行设置(Run Settings) 菜单。
点击显示大图。
-
在 运行(Run) 部分下,单击 Executable: 文本字段末尾处的 浏览(Browse) 。
点击显示大图。
-
导航到编辑器的二进制文件路径所在目录,选择 UE4编辑器(UE4Editor) ,并单击 打开(Open) 。
点击显示大图。
-
现在单击 Working directory: 文本字段末尾处的 浏览(Browse) 。
点击显示大图。
-
导航到编辑器的二进制文件路径所在的目录,选择
[UE4ROOT]\Engine\Binaries\Linux
,并单击 选择(Choose) 。点击显示大图。
阶段成果
点击显示大图。
现在你已经准备好在调试和发布模式下使用Qt Creator构建和运行UE4。
3 - 使用Qt Creator构建UE4
既然已经配置Qt Creator来构建和运行UE4,那么就可以从IDE运行UE4了。在从IDE运行UE4之前,你需要打开一些输出窗口,以便能够看到工作中的UnrealBuildTool。
-
单击 编辑(Edit) 进入编辑模式,打开Qt Creator的编辑器。
点击显示大图。
在编辑模式下,可以查看、调试和编辑支持UE4的CPP源代码。
-
默认情况下,Qt Creator隐藏主工具栏。将鼠标光标悬停在屏幕顶部,触摸顶部边缘即可显示工具栏。
-
现在,打开 窗口(Window) 菜单,将鼠标悬停在 输出窗格(Output Panes) 子菜单,单击 编译输出(Compile Output) 。或者,你可以按 Alt+4 键盘组合键打开 编译输出(Compile Output) 窗口窗格。
打开 编译输出(Compile Output) 窗口窗格,你可以在从源代码构建UE4时查看任何错误。
构建UE4
-
将鼠标光标悬停在屏幕顶部,触摸顶部边缘即可显示工具栏。
-
要构建UE4,打开 构建(Build) 菜单并单击 构建项目"UE4"(Build Project "UE4") 。或者可以按 Ctrl+B 键盘组合键构建UE4。
阶段成果
点击显示大图。
此时,你应该看到编译器将消息刷新到IDE内的 编译输出(Compile Output) 窗口。根据系统规格,编译器可能需要10分钟到一个多小时不等的时间来编译引擎。如果你想缩短根据源代码编译引擎所需的时间,我们建议编译源代码的计算机至少有八(8)GB 的RAM和至少八(8)核的多核处理器(包括超线程)。
4 - 从Qt Creator运行UE4
现在已经编译了引擎,可以运行编辑器了。在此步骤中,你将使用IDE运行UE4。
-
如果你想在运行UE4时查看应用程序的状态,你需要打开 应用程序输出(Application Output) 窗口窗格。要打开 应用程序输出(Application Output) 窗口窗格,按 Alt+3 键盘组合键。
点击显示大图。
-
要从IDE运行UE4,单击 运行(Run) 。或者可以按 Ctrl+R 键盘组合键从IDE运行UE4。
点击显示大图。
阶段成果
点击显示大图。
祝贺你!现在应该看到从IDE运行UE4。
5 - 创建蓝图项目
你可以在UE4中从 项目浏览器 创建蓝图或CPP项目。在本节中,我们将向你展示如何从UE4创建一个新的蓝图项目。出于本指南的目的,让我们假设你想要创建一个带有飞行机制的新蓝图游戏。幸运的是,UE4附带适合你的完美模板!
-
在 新建项目(New Project) 菜单中,确保 蓝图(Blueprint) 菜单打开。
点击显示大图。
-
选择 飞行(Flying) 蓝图项目模板,并将项目命名为`FlyingBP_Prj`。
点击显示大图。
-
最后,单击 创建项目(Create Project) ,以使用飞行蓝图项目模板创建新蓝图项目。
点击显示大图。
根据系统规格,UE4可能需要几分钟的时间来创建新的蓝图项目。
阶段成果
点击显示大图。
UE4将启动你的新蓝图项目,不需要任何额外步骤。
点击显示大图。
祝贺你!在蓝图项目模板的帮助下,你刚刚从UE4创建了一个新的蓝图项目。无论有没有项目模板,现在都能够创建任何类型的蓝图项目。然而,有些时候你会想要创建和修改驱动游戏的源代码。在下一部分中,我们将向你展示如何从UE4创建一个新的CPP项目。
6 - 创建C++项目
到目前为止,你已了解如何配置IDE以在Linux环境中运行UE4。此外,你还了解如何使用项目模板创建一个新的蓝图项目。在这一部分中,我们将向你展示如何从UE4创建一个新的C++(CPP)项目。为了本演示的目的,让我们假设你想要创建一个带有驾驶机制的新CPP游戏。
-
在 新建项目(New Project) 菜单中,确保 C++ 菜单打开。
点击显示大图。
-
选择 载具(Vehicle) CPP项目模板,并将项目命名为`DrivingCPP_Prj`。
点击显示大图。
-
最后,单击 创建项目(Create Project) ,以使用载具CPP项目模板创建新CPP项目。
点击显示大图。
根据系统规格,UE4可能需要几分钟的时间来创建新的CPP项目。在UE4创建新CPP项目后,将启动新CPP项目的Qt Creator实例,并在此过程中关闭UE4Editor。
-
此时,你应该在Qt Creator的新启动实例中看到Qt Creator的 配置项目(Configure Project) 菜单。使用到目前为止所学到的知识来配置新的CPP项目,使其具有以下调试模式的构建设置;
以及发布模式:
此时,不会从原始UE4编辑器项目设置继承项目设置。因此,当你使用Qt Creator创建一个新的UE4 CPP项目时,你需要使用与在本指南前面学到的相同步骤来配置项目设置。
-
现在,配置你的新CPP项目,以具有以下运行设置:
-
通过单击IDE左侧面板中的 编辑(Edit) 切换到IDE中的 编辑(Edit) 模式。或者,你可以按 Ctrl+2 键盘组合键打开Qt Creator的 编辑模式(Edit Mode) 。
点击显示大图。
-
现在单击 运行(Run) 。或者可以按 Ctrl+R 键盘组合键从IDE运行UE4。
点击显示大图。
-
在显示 DriveCPP_Prj模块丢失(Missing DriveCPP_Prj Modules) 对话框后,单击 是(Yes) 。
点击显示大图。
-
根据系统规格,IDE可能需要几分钟的时间来构建和启动新的CPP项目。
点击显示大图。
阶段成果
点击显示大图。
祝贺你!你现在应该看到你的新CPP项目从Qt Creator内部运行。现在已经创建并启动了新的CPP项目,你已经了解在Linux环境下从IDE处理UE4项目所需的所有知识。
虚幻引擎入门
在学习本教程的过程中,你了解到:
✓ 如何配置IDE以在调试和发布模式下构建和运行UE4。
✓ 如何从IDE构建和运行UE4。
✓ 如何使用UE4从IDE创建和配置新的蓝图和C++项目。
现在,请参阅我们的 UE4入门 文档,了解如何使用虚幻引擎!此外,如果你想快速开始用UE4制作内容,你也可以查看以下教程: