Choose your operating system:
前置主题
为了理解并使用本文中的内容,请确保您已掌握以下主题:
本页面为虚幻用户介绍了如何从虚幻引擎4(UE4)的GitHub仓库下载源代码,以及如何利用源代码快速上手。
你
无需
下载源代码就能使用虚幻引擎4。如果你想通过下载可执行文件的方式来安装虚幻引擎,请参阅
安装虚幻引擎
一文,了解
获取虚幻
的方式。不过,你会发现掌握源代码会为你和项目带来宝贵的信息。例如:
-
你将获得Epic工程师每天(实际上是每一分钟)完成的最新功能和漏洞修复。
-
如果你发现了一个尚未被我们修复,但对你的项目来说影响很大的漏洞,你可以自己在源代码中进行修复并重新生成二进制文件,以便项目能够正常运行。
-
通过将你的修复工作提交给Epic,你可以改进引擎并为整个虚幻社区提供帮助。
如果你是虚幻引擎的授权用户,你可以通过我们的Perforce服务器访问源代码,而无需通过GitHub的公开仓库访问代码。
源代码分支
你会注意到我们已通过三个滚动分支发布了UE4的源代码。
发布分支(Release Branch)
发布分支
经过我们QA团队充分测试,因此是学习UE4或制作虚幻游戏的绝佳起点。我们会努力让这个分支保持稳定,并计划每1-2个月发布一次新构建版。
升级分支
中会更新供我们设计师和美术师使用的构建版本。我们尝试每天更新这个分支,以便订阅用户能够访问UE4的最新稳定功能。该分支能让你了解UE4中的功能是如何开发的。
主分支(Master Branch)
由于主分支包含引擎最新开发的内容,因此UE4无法保证它的源代码一定能编译成功。
主分支
会记录引擎团队所做的
实时更改
。我们的资深订阅用户通常会在这个分支中工作,以便与UE4开发者协同工作。
由于我们会努力稳定新版本进行热修复,所以你时不时会看到其他分支。
下载源代码
请按照如下说明下载虚幻引擎的源代码。
请确保你在Windows桌面系统中安装了Visual Studio 2015或更高版本的VS,然后再继续操作。
-
安装
Windows版GitHub
,然后
分叉并克隆我们的仓库
。
假如你想从命令行使用Git,请参阅
设置Git
以及
分叉仓库
等文档。
如果你不想用Git,你可以通过右侧的 '下载ZIP'(Download ZIP)按钮获取源代码。Windows内置的解压工具会将从网上下载的zip文件内容标记为不安全和不宜执行,因此请右键单击zip文件,并选择 '属性...' 和 '解锁',然后再进行解压。第三方zip工具通常不需要进行此操作。
-
安装
Visual Studio 2017
。
所有桌面版Visual Studio 2017都可以构建UE4,包括
Visual Studio Community 2017
,这是面向小型团队和个人开发者免费提供的工具。
请确保作在安装中添加C++支持,这在默认情况下是禁用的。
-
在资源管理器中打开你的源代码文件夹,并运行
Setup.bat
。
这样将下载引擎的二进制内容和先决程序,并设置虚幻文件关联。
在Windows 8上,可能会显示SmartScreen警告。请依次单击"更多信息"和"运行"以继续。
引擎二进制文件的完整下载包目前大概有3到4GB大小,所以需要一些时间才能完成下载。
后续检出只需要下载增量部分,速度将会大幅提高。
-
运行
GenerateProjectFiles.bat
来为引擎创建项目文件。这个过程应该不超过一分钟即可完成。
-
双击
UE4.sln
文件以将项目加载到Visual Studio中。将你的解决方案配置设置为
开发编辑器
,将解决方案平台设置为
Win64
,然后右键单击
UE4
目标并选择
构建
。大概需要10-40分钟完成编译,具体取决于系统规格。
-
编译完成后,可以将启动项目设置为
UE4
并按
F5
进行调试,以便从Visual Studio加载编辑器。
-
安装
Mac版GitHub
,然后
分叉并复制仓库
。
如需在终端使用Git,请参阅文章
设置Git
和
分叉仓库
。
若不想使用Git,请点击右边的 '下载ZIP(Download ZIP)' 即可直接获得源代码。
-
安装最新版本的
Xcode
。
-
在访达(Finder)中打开源文件夹,双击
Setup.command
下载引擎的二进制内容。之后可以关闭终端窗口。
如果将源代码以.zip格式下载,则可能会弹出警告,称其来自无法识别的开发者(因为GitHub上的.zip文件未进行数字签名)。
解决方法是右键点击Setup.command、选择Open,然后点击Open按钮。
-
在同一个文件夹中双击
GenerateProjectFiles.command
。这一步操作应不会长于一分钟时间。
-
双击
UE4.xcworkspace
文件将项目加载到Xcode中。在标题栏中选择
My Mac
目标的
ShaderCompileWorker
,然后选择 '产品(Product) > 编译(Build)' 菜单项。Xcode完成编译后,为
My Mac
目标和
UE4
执行相同操作。编译时间可能在15到40分钟之间,具体取决于你的系统配置。
-
编译完成后,选择 '产品(Product) > 运行(Run)' 菜单项目来加载编辑器。
我们的开发人员和支持团队目前使用最新版本的Ubuntu;因此,我们可能无法对其他Linux发布版本(包括其他版本的Ubuntu)提供支持。
-
设置Git
和
抓取元库
。
如果你倾向于不使用Git,请可使用右侧的 '下载ZIP'(Download ZIP)按钮来获取zip文件格式的源代码。
-
打开源代码文件夹,并运行
Setup.sh
以下载引擎的二进制内容。
-
交叉编译和原生构建均受支持。
如果你使用Windows进行开发(我们同时计划支持Mac开发),并想要针对Linux平台打包游戏,而且希望尽量减少问题,则
交叉编译(Cross-compiling)
是较为合适的选择,这要求你安装
交叉编译工具链
(请参阅
wiki上的Linux交叉编译页面
)。
原生编译(Native compilation)
在
单独的自述文件
和
社区wiki页面
中进行讨论。
本页面为订阅用户展示了如何从GitHub上的源代码仓库下载并构建虚幻引擎。如果你想下载二进制版本的虚幻引擎,请阅读我们的
安装虚幻引擎
文档了解如何
获取虚幻
。
许可和贡献
你对GitHub上的Unreal Engine的访问和使用受
虚幻引擎最终用户许可协议
的约束。如果你不同意这些条款(我们会不时对它们加以修订),你将不会被获准访问或使用虚幻引擎。
我们欢迎你通过GitHub上的
拉取请求
,为虚幻引擎的开发做出贡献。我们大部分的积极开发都在
主
分支中进行,所以我们更喜欢在那里接受拉取请求(对于新功能而言尤其如此)。我们尽力确保所有新代码都遵守
Epic编码标准
。所有贡献均受EULA条款的约束。
后续步骤
现在你已经下载并设置了虚幻引擎,你可以随时
从源代码构建引擎
。
注意事项
当你首次编译源代码并启动编辑器时,加载时间可能会比较长。
引擎会针对你的平台优化内容并将信息保存为
派生数据缓存(derived data cache)
,这种优化应该只会进行一次。
你为虚幻引擎代码设置的Fork分支会与你的GitHub账号权限关联。
如果你取消了订阅或切换了GitHub用户名,则需要重新创建Fork分支并从本地副本上传改动内容。