Ubuntu20.04安装UE4（保姆教程 - 更新至2024.02）

教程亮点

• 权限：从2021年8月13日起，GitHub 要求使用个人访问令牌 (PAT)进行命令行认证，而非密码。
• 配置：运行 Setup.sh脚本前的注意事项
• 便捷：创建UE4的桌面快捷方式

---

官方文档 （可进行流程对照与补充）

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

---

准备工作

1. 注册 Epic Games 帐户

2. 注册 Github 账户

3. 关联 Epic Games 和 Github 账户

登录Epic Games个人账户>>点击 应用与账户 >> 在Github 版块点击 连接

4. 安装 Git

打开终端安装 Git ，用于管理和跟踪UE源代码的历史版本

sudo apt install git

---

在Linux上下载UE4

1. 加入EpicGames组织 （有权限访问 Unreal Engine 私密仓）

注册完Epic Game账户之后，注册邮箱会收到一封来自 EpicTeamAdmin 的邀请邮件，邀请注册者加入EpicGames组织，点击 Join @EpicGames

2. 生成个人访问令牌（PAT）

登录Github个人账号 >> 点击自己的头像 >> settings >> Developer setting >> Personal access tokens >> Tokens(classic) >> Generate new token >> Generate new token(classic) >> 在note行给token取一个名字，然后勾选repo，拉到最下面点击Generate token >> 复制个人访问令牌（这将作为个人账户的密码在命令行输入，最好另外保存在一个地方，因为你再也看不到它啦）

3. 克隆 UE4 ​​​​​​​到本地

请求从 GitHub 上克隆 Unreal Engine 仓库的一个特定分支，如4.26版本：

git clone -b 4.26 https://github.com/EpicGames/UnrealEngine.git

回车后，要求输入Github 的用户名和密码（令牌）进行身份和权限验证：

Username for 'https://github.com': # 输入Github用户名 
Password for 'https://用户名@github.com': # 输入生成的个人访问令牌，粘贴的令牌不会显示出来

若验证不顺利，请检查：

• 是否已经加入 Epic Game 组织（注册后不会自动加入）
• 是否生成正确的个人访问令牌（不是 Fine grained tokens）

若验证顺利，会显示下载进度：

remote: Enumerating objects: 5826744, done.
remote: Counting objects: 100% (165/165), done.
remote: Compressing objects: 100% (40/40), done.
remote: Total 5826744 (delta 157), reused 125 (delta 125), pack-reused 5826579
接收对象中: 100% (5826744/5826744), 26.16 GiB | 25.58 MiB/s, 完成.
处理 delta 中: 100% (3552602/3552602), 完成.
正在更新文件: 100% (138080/138080), 完成.

下载完成之后，在导航路径下会生成一个 UnrelEngine 的文件夹。

---

在Linux上编译UE4

1. 配置开发环境（即安装项目依赖与配置）

• 运行 Setup.sh 脚本前的注意事项
• 磁盘空间：确保系统包含至少100GB磁盘空间。
• sh指向：运行 Setup.sh 脚本涉及到 pushd 命令的使用，而 pushd 命令需要在 bash 的环境中执行。而Ubuntu 默认的 sh 指向 dash，导致 pushd 命令无法在运行 sh Setup.sh 时被识别和执行。因此，需要改变 sh 的链接，让它指向 bash 而不是 dash。

sudo dpkg-reconfigure dash

在弹出的对话框中选择 NO，重启终端生效。

• 运行 Setup.sh 脚本

然后，导航到 UnrelEngine 的文件夹，从终端运行 Setup.sh 以设置生成项目文件所需的依赖项目。

sh Setup.sh

显示 Unreal Engine 的第三方库编译成功。

Target arch set to: x86_64-unknown-linux-gnu
Building ThirdParty libraries

If you don't see SUCCESS message in the end, then building did not finish properly.
In that case, take a look into /home/shika/下载/应用程序/UnrealEngine/Engine/Build/BatchFiles/Linux/BuildThirdParty.log for details.

No third party libs needed to be built locally

**********  SUCCESS ****************

2. 生成构建系统所需的项目文件

从终端运行 GenerateProjectFiles.sh 来生成项目文件。

./GenerateProjectFiles.sh

3. 编译（即把源代码转换成可以计算机上运行的程序）

从终端输入 make 进行编译。以 UE4.26 为例，构建过程包含 2782 个单独的步骤，根据系统配置的不同，引擎编译可能需要花费十分钟到超过一个小时不等的时间。

make

4. 启动UE4

导航到 UnrealEngine/Engine/Binaries/Linux ，运行 UE4Editor，即Unreal Engine 编辑器的可执行文件

./UE4Editor

恭喜你，UE4 已经安装成功！

---

添加桌面快捷方式

1. 创建 .desktop 桌面文件

使用文本编辑器在桌面创建一个新文件，后缀名为 .desktop，输入以下内容，不要有多余的空格，保存退出

[Desktop Entry]
Name=Unreal Engine
Comment=UE (v4.26)  # 替换成自己的版本
Exec=/home/用户名/下载/应用程序/UnrealEngine/Engine/Binaries/Linux/UE4Editor  # 替换成自己的UE4Editor 所在路径
Icon=/home/用户名/下载/应用程序/UnrealEngine/Engine/Content/Slate/Icons/UE4Icon.png  # 替换成UE图标所在路径，我是另外从网上下了一个icon
Terminal=false
Type=Application
Categories=Development;
StartupNotify=true
NoDisplay=false

2. 集成到系统级应用快捷方式的保存路径

将编辑好的*.desktop*文件复制到系统级应用快捷方式的保存路径

sudo cp ~/桌面/UE4.26.desktop /usr/share/applications/UE4.26.desktop  # 替换成自己的桌面路径和目标路径

3. 桌面图标生成

右键桌面 .desktop 文件 >> 允许启动（UE图标出现）>> 双击图标，启动UE4应用程序（需要等待一小会）

新建UE4项目

1. 新建UE4蓝图项目

新建项目类型：游戏 >> 第三人称游戏 >> 项目设置：蓝图 (C++项目需要设置集成开发环境 (IDE） >> 底部选择项目储存的位置与命名 >> 创建项目

2. 将仅限BP的项目转变为包含C++代码的项目

第一步：在蓝图项目中添加C++类

文件 >> 新建 C++类 >> 选择父类：Actor >> 命名和路径选择 >> 创建类

第二步：检查C++类是否编译成功

重启UE >> 内容浏览器 >> 是否出现C++类文件夹（若出现则转换成功）

至此，Linux上UE4的安装与快捷方式的添加已全部完成，下一次启动UE可以直接双击桌面图标啦！

完结撒花！～～