虚幻引擎5文档已被迁移至 Epic开发者社区

Linux快速入门

了解如何在Linux上下载、编译和运行UE4。

Choose your operating system:

Windows

macOS

Linux

在本教程结束时，您将已经在您的Linux计算机上运行了虚幻引擎4（UE4），并且已经了解了如何设置Git（用于下载UE4源代码），如何fork和克隆我们的源代码，如何根据源代码编译虚幻引擎，以及如何在您的Linux计算机上运行虚幻引擎。最后，本指南的重点是向您展示如何设置在Linux计算机上运行UE4所需的主要工作流。

1 - 必要的设置

目前，我们没有为Linux用户提供UE4的二进制安装程序。好消息是，您可以根据我们用于开发引擎的相同源代码编译一个虚幻引擎的二进制文件。如果您想访问我们的源代码，您必须注册一个Epic Games帐户，注册一个GitHub帐户，将您的GitHub用户名与您的Epic Games帐户关联起来，并在Linux计算机上设置Git。

注册一个Epic Games帐户

如果您想要使用虚幻引擎创建游戏，或者为未来Linux上的UE4做出贡献，您需要拥有一个有效的Epic Games帐户。

  1. 导航到 UnrealEngine.com 。

  2. 单击 获取虚幻（Get Unreal） 。

    Download_Unreal-2.PNG

    单击显示全图。

  3. 填写我们的 '加入社区（Join the Community）' 表格，然后单击 注册（Sign Up） 。注册前，务必确保阅读了我们的 服务条款 。

    Create_Account-1.PNG

    单击显示全图。

  4. 单击 接受（Accept） 前，阅读我们的 虚幻引擎最终用户许可协议 （EULA）。如果您对EULA的条款和条件有其他疑问，请参阅我们的 EULA常见问题 。

    EULA-1.PNG

    单击显示全图。

拥有一个帐户有很多好处，包括（但不限于）可以访问虚幻引擎社区，在这里，您将可以与其他UE4 Linux开发人员进行联系，并且能够了解有关虚幻引擎的最新消息。

设置Git

现在您已经注册了一个Epic Games帐户，您可以通过以下步骤访问GitHub上的UE4源代码。

  1. 在 GitHub.com 上注册一个GitHub帐户。

    GItHub_Header.PNG

    单击显示全图。

  2. 前往 您的Epic Games帐户 ，并单击 已关联帐户（Connected Accounts） 。
    Connected_Accounts-1.PNG

  3. 单击GitHub图标下面的 关联（Connect） 来关联您的GitHub用户名。
    Connect Accounts-1.PNG

  4. 要授权此连接，单击 授权EpicGames（Authorize EpicGames） 。
    Authoriize_Connect.PNG

  5. 最后，在进入下一步之前设置 Git 。

分段结果

到目前为止，您已经注册了一个Epic Games帐户，并将其与您的GitHub用户名关联。此外，您还安装了Git，可以开始执行下一步，在下一步中，您将从虚幻引擎GitHub元库fork并克隆UE4源代码。

2 - 下载UE4 on Linux

既然您已经在Linux计算机上设置了Git，那么就可以从我们的 GitHub网站 下载虚幻引擎源代码了。有两种方法可以下载UE4源代码，一种方法是使用我们GitHub页面上的下载功能，另一种方法是使用Git客户端克隆虚幻引擎元库。我们将在本页介绍这两种方法。

从GitHub下载

如果您不想使用Git克隆虚幻引擎元库，可以使用我们的 GitHub网站 上的 下载ZIP（Download ZIP） 按钮。

  1. 首先，单击页面左侧的 分支：（Branch:） ，选择要下载的分支。有关虚幻引擎GitHub元库中的分支的更多信息，请参见源代码分支参考页面。

    SelectRepoBranch.png

    单击显示全图。

  2. 选择要下载的分支之后，单击位于页面右侧的克隆或下载（Clone or download）。

    CloneorDownloadButton.png

    单击显示全图。

  3. 单击 下载ZIP（Download ZIP） 以下载虚幻引擎源代码。

    DownloadSourceButton.png

    单击显示全图。

  4. 最后，将`UnrealEngine-(branch_name).zip`解压缩到您的硬盘上。

使用Git克隆

如果您刚开始使用Git进行克隆，在执行以下步骤之前，请参阅 GitHub的克隆指南 。

  1. 单击 虚幻引擎（Unreal Engine） 链接以访问我们的 元库 。

    Git_Repository-1.PNG

    单击显示全图。

  2. 单击 克隆或下载（Clone or download） 。

    CloneorDownloadButton.png

    单击显示全图。

  3. 单击 复制URL（Copy URL） 按钮以复制元库的克隆URL。

    CopyHTTPS.png

    单击显示全图。

  4. 打开Git Bash，键入`git clone`，并然后粘贴上一步复制的URL。

    GitBashClone.png

    单击显示全图。

  5. 最后，按 Enter 以创建您的本地克隆。

    如果您需要回顾从命令行使用Git，请参阅 GitHub的文档 。

分段结果

end_result.png

单击显示全图。

无论您是通过在我们的 GitHub site 上使用 下载ZIP（Download ZIP） 按钮还是通过使用Git克隆虚幻引擎元库来下载了虚幻引擎的源代码，您都可以通过使用位于硬盘上的虚幻引擎源代码，来在Linux上编译UE4。

3 - 在Linux上编译UE4

为了准备这一关键步骤，您已下载一份虚幻引擎的源代码到您的硬盘上。在本教程的这一部分中，您将从终端运行几个工具，以便在Linux计算机上编译UE4二进制文件。

我们的开发和支持团队目前使用最新版Ubuntu；因此，我们可能无法提供对其他Linux分发版的支持（包括其他版本的Ubuntu）。此外，请阅读

[](Basics/InstallingUnrealEngine/RecommendedSpecifications)
，确保系统包含至少100GB磁盘空间，然后 再执行以下步骤。

  1. 在根目录中，从终端运行 Setup.sh 以设置生成项目文件所需的文件。

    RunSetupShellScript_Linux.png

  2. 现在，从终端运行 GenerateProjectFiles.sh 以生成项目文件。

    RunGenPrjFilesShellScript_Linux.png

  3. 要构建项目，从终端运行 make 。

    RunMakeFile_Linux.png

根据系统配置，编译引擎可能需要花费十分钟到超过一个小时不等的时间。如果要缩短从源代码编译引擎花费的时间，我们建议你在 RAM至少为8GB且处理器至少为8核（包括超线程）的机器上编译源代码。

分段结果

built_engine.png

此时，您的硬盘上应该有一个完全编译好的UE4二进制文件。现在是时候在Linux系统上运行引擎了！

4 - 在Linux上运行UE4

在完成最后一步时，您已经将您的Epic Games帐户与您的GitHub用户名关联起来，从我们的GitHub网站下载了虚幻引擎源代码，还在Linux系统上编译了UE4二进制文件。剩下的唯一任务是运行UE4编辑器，以便您可以开始为Linux平台制作游戏。

  1. 在终端中输入`cd Engine/Binaries/Linux/`来导航到编辑器的二进制路径。

  2. 运行 UE4Editor 来启动编辑器。

    RunUE4Editor_Linux.png

  3. 恭喜！你已经通过编译源代码启动了引擎。

在Linux上启动UE4

因为您已经在Linux上根据源代码编译了引擎，所以引擎将在启动UE4后编译着色器几分钟。

howTo_compilingshaders.png

创建您的第一个项目

如果您还没有建立一个集成开发环境（IDE）来使用UE4，我们建议您从创建一个 蓝图（Blueprint） 项目开始。

howTo_creatingprrjwithoutIDE.png

分段结果

howTo_endResult.png

如果您要在Linux上创建您的第一个游戏，那么您刚刚了解了如何在Linux上建立UE4主要工作流。在学习本教程的过程中，您了解到：

✓ 如何设置Git来下载虚幻引擎的源代码。
✓ 如何fork和克隆虚幻引擎的源代码。
✓ 如何根据源代码编译虚幻引擎。
✓ 如何在您的Linux计算机上运行虚幻引擎。

您准备好独立地做一些练习了吗？

5 - 看你的了！

提高工作效率的一种方法是编写可以从终端运行的自定义shell脚本。如果您知道如何在Linux中编写shell脚本，请尝试编写一个能够自动执行设置和编译UE4进程的脚本。

autobuild_onyourown.jpg

如果您想在Linux上追踪UE4的最新开发动态，请阅读 这篇文章 ，并前往 虚幻引擎公开问题追踪库 查看影响Linux上UE4的最新公开问题。

UE4_publicJira.jpg

您是否发现了一个可以解决的公开问题？如果您知道如何使用Git fork和克隆 我们的 元库 来提交 拉取请求 ，请加入我们不断壮大的开发者社区，帮助塑造Linux上的UE4的未来。

gitHub_pullrequests.jpg

如果您想快速开始使用UE4制作项目，请查看以下教程：

标签
Linux
欢迎帮助改进虚幻引擎文档！请告诉我们该如何更好地为您服务。
填写问卷调查
取消