下载虚幻引擎源代码

连接到源代码元库和下载虚幻引擎最新版本的步骤。

Windows
MacOS
Linux
Prerequisite Topics

This page assumes you have prior knowledge of the following topics. Please read them before proceeding.

本页包含如何在虚幻引擎GitHub元库中下载虚幻引擎4(UE4)的详细指南,帮助订阅者对代码进行入门。

如要访问https://github.com/EpicGames/UnrealEngine 上的元库,您必须:

  • 是虚幻引擎的订阅者。

  • 拥有GitHub帐户。

  • GitHub上的UE4 所述,已将GitHub帐户与您的虚幻引擎帐户进行关联。

您不 需要 下载源代码来使用虚幻引擎4。若只想下载和安装二进制版本的虚幻引擎,请参见安装虚幻引擎 文档,了解获取虚幻 的方式。同时您可能会发现掌握源代码访问权对您和项目来说都非常宝贵。例如:

  • 您可以获取Epic工程师每日(实际上是每一分钟)完成的所有最新功能和修复的漏洞。

  • 如发现了一个我们尚未修复但对项目非常重要的漏洞,您可通过在自己的源代码版本中进行修复并重新编译二进制文件来取消对项目的阻挡。

  • 通过将修复和功能提交至Epic,您可以改进引擎并向整个虚幻社区提供帮助。

若您是虚幻引擎的授权用户,可通过我们的Perforce服务器访问源代码,而无需通过GitHub公开元库。若您未看到任何关于使用Perforce的子主题,请先使用Epic Games帐户登录此网站,然后再返回此处。

源代码分支

您将注意到我们已通过三个滚动分支发布了UE4的源代码。

Branches.png

发布分支

发布分支 是经过我们QA团队充分测试的,因此是学习UE4或制作虚幻游戏的绝佳起点。我们在努力让这个分支保持稳定,并计划每1-2个月发布一次新构建版。

升级分支

升级分支 中将更新供设计师和美工使用的构建版。我们尝试每天更新这个分支,让订户能够访问UE4的最新稳定功能。该分支是了解UE4中的功能开发工作方式的有用途径。

主分支

由于主分支包含最先进的技术,因此UE4不保证从源代码编译。

主分支 跟踪引擎团队所做的实时更改 。我们经验丰富的订户想要与UE4开发者协同工作时,通常会从这个分支工作。

在我们努力发布稳定版的新版本或热修复时,可能会不时出现其他分支。

下载源代码

请按照如下说明以下载虚幻引擎的源代码。

请确保您安装了Windows桌面版Visual Studio 2015或更高版本,然后再继续操作。

  1. 安装Windows版GitHub ,然后抓取并克隆我们的元库

    要从命令行使用Git,请参阅设置Git抓取元库 文章。

    如果您倾向于不使用Git,可以通过右侧的“下载ZIP”(Download ZIP)按钮获取源代码。内置Windows zip工具会将从网上下载的zip文件内容标记为不安全而不宜执行,因此右键单击zip文件,并选择“属性...”和“解锁”,然后再进行解压。第三方zip工具通常不需要进行这个操作。

  2. 安装 Visual Studio 2017

    所有桌面版Visual Studio 2017都可以构建UE4,包括Visual Studio Community 2017 ,这是面向小型团队和个人开发者免费提供的工具。 请确保作为安装的一部分包含C++支持,这在默认情况下是禁用的。

  3. 在资源管理器中打开您的源代码文件夹,并运行 Setup.bat

    这样将下载引擎的二进制内容,以及安装必备软件并设置虚幻文件关联。 在Windows 8上,可能会显示来自SmartScreen的警告。依次单击“更多信息”和“运行”以继续。

    引擎二进制文件的完整下载包目前是3-4GB,需要一些时间才能完成。 后续检出只需要下载增量部分,速度将会大幅提高。

  4. 运行 GenerateProjectFiles.bat 来为引擎创建项目文件。这个过程应该不超过一分钟即可完成。

  5. 双击 UE4.sln 文件以将项目加载到Visual Studio中。将您的解决方案配置设置为 开发编辑器,将解决方案平台设置为 Win64,然后右键单击 UE4 目标并选择 构建。大概需要10-40分钟完成编译,具体取决于系统规格。

  6. 编译完成后,可以将启动项目设置为 UE4 并按 F5 进行调试,以从Visual Studio加载编辑器。

  1. 安装Mac版GitHub ,然后分叉并复制元库

    如需在终端使用Git,请参阅文章设置Git分叉元库 。 若不想使用Git,点击右边的“下载ZIP(Download ZIP)”即可直接获得源。

  2. 安装最新版本的Xcode

  3. 在查找器中打开源文件夹,双击 Setup.command 下载引擎的二进制内容。之后可以关闭终端窗口。

    如果将源代码下载为.zip文件,可能会弹出警告,称其来自无法识别的开发者(因为GitHub上的.zip文件未进行数字签名)。 解决方法是右键点击Setup.command、选择Open,然后点击Open按钮。

  4. 在同一个文件夹中双击 GenerateProjectFiles.command。完成操作的时间应短于一分钟。

  5. 双击 UE4.xcworkspace 文件将项目加载到Xcode中。在标题栏中选择 My Mac 目标的 ShaderCompileWorker,然后选择“产品(Product) > 编译(Build)”菜单项。Xcode完成编译后,为 My Mac 目标的 UE4 执行相同操作。编译时间可能在15到40分钟之间,具体取决于系统配置。

  6. 编译完成后,选择“产品(Product) > 运行(Run)”菜单项目来加载编辑器。

我们的开发人员和支持团队目前使用最新版本的Ubuntu;因此,我们可能无法对其他Linux发行版(包括其他版本的Ubuntu)提供支持。

  1. 设置Git抓取元库 。 如果您倾向于不使用Git,可使用右侧的“下载ZIP”(Download ZIP)按钮来获取zip文件格式的源代码。

  2. 打开源代码文件夹,并运行 Setup.sh 以下载引擎的二进制内容。

  3. 交叉编译和原生构建均受支持。

如果您使用Windows进行开发(也在计划推出Mac支持),并想要针对Linux封装游戏,而且希望尽量减少问题,则 交叉编译 是较为合适的选择,它要求安装交叉编译工具链 (请参阅wiki上的Linux交叉编译页面 )。

原生编译单独的自述文件社区wiki页面 中进行讨论。

本页面向订阅者展示了如何从GitHub上的源代码元库下载并构建虚幻引擎。如果您想下载二进制版本的虚幻引擎,请阅读我们的安装虚幻引擎 文档了解如何获取虚幻

许可和贡献

您对GitHub上的Unreal Engine的访问和使用受虚幻引擎最终用户许可协议 的约束。如果您不同意这些条款(我们会不时对它们加以修订),您将不会被获准访问或使用虚幻引擎。

我们欢迎您通过GitHub上的拉取请求 ,为虚幻引擎的开发做出贡献。我们大部分的积极开发都在 分支中进行,所以我们更喜欢在那里接受拉取请求(对于新功能而言尤其如此)。我们尽力确保所有新代码都遵守Epic编码标准 。所有贡献均受EULA条款的约束。

后续步骤

现在您已经下载并设置了虚幻引擎,可随时从源代码构建引擎

脚注

当您首次从新的源代码构建启动编辑器时,您可能会经历较长的加载时间。 引擎正在将您平台的内容优化到_derived data cache_,而且这种优化应该只进行一次。

您有关虚幻引擎的私有分支与您的GitHub帐户权限相关。 如果您取消了订阅或切换了GitHub用户名,则需要重新创建分支并从本地副本上传更改。

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback