虚幻引擎

欢迎来到虚幻引擎源代码！

虚幻引擎 5.4 引入了新的最终用户许可协议 (EULA)，该协议将管辖此版本及后续版本。根据您使用虚幻引擎创作的作品，您可能需要支付新的或不同的费用。请在此处查看 EULA，并确保您了解这些变更如何适用于您。下载或使用虚幻引擎 5.4 或更高版本，或以其他方式表示您接受 EULA，即表示您同意受其条款的约束。如果您不同意或无法同意 EULA 的条款，请不要下载或使用虚幻引擎 5.4 或更高版本。

使用此代码库中的代码，您可以构建适用于 Windows、Mac 和 Linux 的虚幻编辑器；为各种目标平台（包括桌面、游戏主机、移动设备和嵌入式设备）编译虚幻引擎游戏；以及构建虚幻 Lightmass 和虚幻前端等工具。您可以随心所欲地修改代码，并与他人分享您的更改！

我们有大量关于该引擎的官方文档。如果您正在寻找某个问题的答案，不妨从以下位置开始：

• 虚幻引擎中的编程和脚本

• 开发设置

• 使用 GitHub 源代码分发

• 虚幻引擎 C++ API 参考

如果您需要更多信息，尽管问！许多 Epic 开发者都会阅读Epic Games 开发者社区网站上的讨论和问答论坛，我们很荣幸能成为这个由数千名成员组成的、充满善意、友好且热情的社区的一员。

我们在几个分支中发布了引擎的源代码：

• 编号分支标识了过去和即将发布的官方版本，并且发布分支始终反映当前的官方版本。这些版本经过我们的 QA 团队的广泛测试，因此是学习虚幻引擎和制作您自己的游戏的绝佳起点。我们致力于确保版本稳定可靠，并计划每隔几个月发布一个新版本。

• UE5 上最活跃的开发工作都集中在ue5-main分支上。这个分支体现了引擎的尖端技术，可能存在 bug，甚至可能无法编译。我们将其开放给经验丰富的开发者，让他们能够测试新功能或与我们保持同步合作。

  如果您选择在此分支中工作，请注意，该分支的发布时间可能早于当前官方版本和即将发布的下一个版本的分支。因此，您在 ue5-main 分支中创建的内容和代码可能与公开版本不兼容，直到我们为未来的官方版本直接从 ue5-main 创建新的分支为止。

• 主分支是我们所有引擎开发团队对 UE4 所做的更改的中心。它不像发布分支那样需要经过那么多的测试，所以如果您正在使用 UE4，这可能不是您的最佳选择。

• 名称中包含dev、staging和 的分支test通常用于 Epic 内部流程，对最终用户很少有用。

随着我们稳定新版本或修补程序，其他短暂的分支可能会不时出现。

以下步骤将指导您克隆自己的私有分支，然后自行编译和运行编辑器：

1. 安装适用于 Windows 的 GitHub Desktop，然后分叉并克隆我们的存储库。

   GitHub Desktop 完成创建 fork 后，会询问“您计划如何使用此 fork？”。选择“出于我自己的目的”。这将有助于确保您所做的任何更改都保留在本地仓库中，并避免创建意外的拉取请求。如果您想将您在 fork 中所做的修改提交回我们的仓库，您仍然可以发起拉取请求。

   其他选项：

• 要从命令行使用 Git，请参阅设置 Git和Fork a Repo文章。

• 如果您不想使用 Git，可以使用右侧的“下载 ZIP”按钮获取源代码。请注意，Windows 内置的 zip 实用程序会将从互联网下载的 .zip 文件的内容标记为不安全，因此请右键单击该 .zip 文件，然后选择“属性…”和“解除阻止”，然后再解压。

2. 安装Visual Studio 2022。

   Visual Studio 2022 的所有桌面版本（17.4或更高版本，建议使用17.8）均可构建 UE5，其中包括Visual Studio Community，它对小型团队和个人开发者免费。

   要安装用于 UE5 开发的正确组件，请参阅设置 Visual Studio。

3. 在 Windows 资源管理器中打开源文件夹并运行Setup.bat。这将下载引擎的二进制内容，安装先决条件，并设置虚幻文件关联。

   在 Windows 8 上，可能会出现 SmartScreen 的警告。点击“更多信息”，然后点击“仍然运行”继续。

   引擎二进制文件的干净下载目前需要 18+ GiB，可能需要一些时间才能完成。后续运行会更快，因为只下载新增和更新的内容。

4. 运行GenerateProjectFiles.bat为引擎创建项目文件。该操作大约需要一分钟即可完成。

5. 双击新的UE5.sln文件将项目加载到 Visual Studio 中。

6. 将解决方案配置设置为开发编辑器，并将解决方案平台设置为Win64，然后右键单击UE5目标并选择构建。编译可能需要 10 到 40 分钟，具体取决于您的系统配置。

7. 编译完成后，您可以通过将启动项目设置为UE5并按F5开始调试来从 Visual Studio 运行编辑器。

1. 安装适用于 Mac 的 GitHub Desktop，然后分叉并克隆我们的存储库。

   GitHub Desktop 完成创建 fork 后，会询问“您计划如何使用此 fork？”。选择“出于我自己的目的”。这将有助于确保您所做的任何更改都保留在本地仓库中，并避免创建意外的拉取请求。如果您想将您在 fork 中所做的修改提交回我们的仓库，您仍然可以发起拉取请求。

   其他选项：

• 要从终端使用 Git，请参阅设置 Git和Fork a Repo文章。

• 如果您不想使用 Git，请使用右侧的下载 ZIP按钮直接获取源代码。

2. 安装最新版本的Xcode。

3. 在 Finder 中打开源文件夹，双击“Setup.command”即可下载引擎的二进制内容。之后，您可以关闭“终端”窗口。

   如果您下载的源代码是 .zip 文件，您可能会看到一条警告，提示该文件来自身份不明的开发者，因为 GitHub 上的 .zip 文件未经数字签名。要解决此问题，请右键单击Setup.command，选择“打开”，然后单击“打开”按钮。

4. 在同一文件夹中，双击GenerateProjectFiles.command。该操作大约需要一分钟即可完成。

5. 双击UE5.xcworkspace文件，将项目加载到 Xcode 中。在标题栏中选择ShaderCompileWorker for My Mac目标，然后选择“产品”>“构建”菜单项。Xcode 构建完成后，对UE5 for My Mac目标执行相同操作。编译可能需要 15 到 40 分钟，具体取决于您的系统配置。

6. 编译完成后，选择产品>运行菜单项来加载编辑器。

1. 安装一个可视化的 Git 客户端，然后分叉并克隆我们的存储库。

   其他选项：

• 要从命令行使用 Git，请参阅设置 Git和Fork a Repo文章。

• 如果您不想使用 Git，请使用右侧的“下载 ZIP”按钮将源代码作为 zip 文件获取。

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

3. 支持交叉编译和本机构建。

• 对于希望以最少的麻烦将游戏打包到 Linux 平台的 Windows 开发者来说，交叉编译非常方便。它需要安装交叉编译器工具链。请参阅文档中的 Linux 交叉编译页面。

• 本机编译在单独的 README和社区 wiki 页面中讨论。

• 如果您已安装 Android NDK，安装脚本将下载Android支持。请参阅Android 快速入门指南。

• iOS开发需要 Mac。具体说明请参阅iOS 快速入门指南。

• 只有在第三方供应商处注册开发者帐户后，才可以针对Sony PlayStation、Microsoft Xbox和Nintendo Switch等访问受限的游戏机和其他平台进行开发。

  根据平台的不同，虚幻开发者网络支持站点可能会提供额外的文档或指导，或者虚幻引擎论坛中专门针对您的平台的部分中可能会提供可下载的存档。

  如果您无法访问这些资源，请先在第三方供应商处注册一个开发者账户。然后，如果您有 Epic Games 客户经理，请联系他；如果没有，请填写并提交虚幻引擎的主机开发申请表。Epic 将与您联系，并提供一份正式的数字签名协议。协议获得批准后，您将收到有关如何访问源代码、二进制文件以及适用于您平台的其他说明。