Ubuntu20.04安装UE4(保姆教程 - 更新至2025.07)
- Ubuntu20.04安装UE4(保姆教程 - 更新至2025.07)
- 教程亮点
- 官方文档 (可进行流程对照与补充)
- 准备工作
- 注册 Epic Games 帐户
- 注册 Github 账户
- 关联 Epic Games 和 Github 账户
- 安装 Git
- 在Linux上下载UE4
- 加入EpicGames组织 (有权限访问 Unreal Engine 私密仓)
- 生成个人访问令牌(PAT)
- 克隆 UE4 到本地
- 在Linux上编译UE4
- 配置开发环境(即安装项目依赖与配置)
- 生成构建系统所需的项目文件
- 编译(即把源代码转换成可以计算机上运行的程序)
- 启动UE4
- 添加桌面快捷方式
- 创建 *.desktop* 桌面文件
- 集成到系统级应用快捷方式的保存路径
- 桌面图标生成
- 新建UE4项目
- 新建UE4蓝图项目
- 将仅限BP的项目转变为包含C++代码的项目
Ubuntu20.04安装UE4(保姆教程 - 更新至2025.07)
教程亮点
- 权限:从2021年8月13日起,GitHub 要求使用个人访问令牌 (PAT)进行命令行认证,而非密码。
- 配置:运行 Setup.sh脚本前的注意事项
- 便捷:创建UE4的桌面快捷方式
官方文档 (可进行流程对照与补充)
了解如何在Linux上下载、编译和运行UE4
准备工作
注册 Epic Games 帐户
注册 Github 账户
关联 Epic Games 和 Github 账户
登录Epic Games个人账户>>点击应用与账户>> 在Github 版块点击连接
安装 Git
打开终端安装 Git ,用于管理和跟踪UE源代码的历史版本
sudoaptinstallgit在Linux上下载UE4
加入EpicGames组织 (有权限访问 Unreal Engine 私密仓)
注册完Epic Game账户之后,注册邮箱会收到一封来自 EpicTeamAdmin 的邀请邮件,邀请注册者加入EpicGames组织,点击Join @EpicGames
生成个人访问令牌(PAT)
登录Github个人账号 >> 点击自己的头像 >> settings >> Developer setting >> Personal access tokens >> Tokens(classic) >> Generate new token >> Generate new token(classic) >> 在note行给token取一个名字,然后勾选repo,拉到最下面点击Generate token>> 复制个人访问令牌(这将作为个人账户的密码在命令行输入,最好另外保存在一个地方,因为你再也看不到它啦)
克隆 UE4 到本地
请求从 GitHub 上克隆 Unreal Engine 仓库的一个特定分支,如4.26版本:
gitclone-b4.26https://github.com/EpicGames/UnrealEngine.git回车后,要求输入Github 的用户名和密码(令牌)进行身份和权限验证:
Usernamefor'https://github.com':# 输入Github用户名Passwordfor'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: Total5826744(delta157), reused125(delta125), pack-reused5826579接收对象中:100%(5826744/5826744),26.16GiB|25.58MiB/s, 完成. 处理 delta 中:100%(3552602/3552602), 完成. 正在更新文件:100%(138080/138080), 完成.下载完成之后,在导航路径下会生成一个UnrelEngine的文件夹。
在Linux上编译UE4
配置开发环境(即安装项目依赖与配置)
- 运行Setup.sh脚本前的注意事项
- 磁盘空间:确保系统包含至少100GB磁盘空间。
- sh指向:运行 Setup.sh 脚本涉及到 pushd 命令的使用,而 pushd 命令需要在 bash 的环境中执行。而Ubuntu 默认的 sh 指向 dash,导致 pushd 命令无法在运行 sh Setup.sh 时被识别和执行。因此,需要改变 sh 的链接,让它指向 bash 而不是 dash。
sudodpkg-reconfigure dash在弹出的对话框中选择NO,重启终端生效。
- 运行Setup.sh脚本
然后,导航到 UnrelEngine 的文件夹,从终端运行Setup.sh以设置生成项目文件所需的依赖项目。
shSetup.sh显示 Unreal Engine 的第三方库编译成功。
Target archsetto: x86_64-unknown-linux-gnu Building ThirdParty libraries If you don't see SUCCESS messageinthe end,thenbuilding did not finish properly. In that case, take alookinto /home/shika/下载/应用程序/UnrealEngine/Engine/Build/BatchFiles/Linux/BuildThirdParty.logfordetails. No third party libs needed to be built locally ********** SUCCESS ****************生成构建系统所需的项目文件
从终端运行GenerateProjectFiles.sh来生成项目文件。
./GenerateProjectFiles.sh编译(即把源代码转换成可以计算机上运行的程序)
从终端输入 make 进行编译。以 UE4.26 为例,构建过程包含 2782 个单独的步骤,根据系统配置的不同,引擎编译可能需要花费十分钟到超过一个小时不等的时间。
make启动UE4
导航到UnrealEngine/Engine/Binaries/Linux,运行UE4Editor,即Unreal Engine 编辑器的可执行文件
./UE4Editor
恭喜你,UE4 已经安装成功!
添加桌面快捷方式
创建.desktop桌面文件
使用文本编辑器在桌面创建一个新文件,后缀名为.desktop,输入以下内容,不要有多余的空格,保存退出
[Desktop Entry]Name=Unreal EngineComment=UE(v4.26)# 替换成自己的版本Exec=/home/用户名/下载/应用程序/UnrealEngine/Engine/Binaries/Linux/UE4Editor# 替换成自己的UE4Editor 所在路径Icon=/home/用户名/下载/应用程序/UnrealEngine/Engine/Content/Slate/Icons/UE4Icon.png# 替换成UE图标所在路径,我是另外从网上下了一个iconTerminal=falseType=ApplicationCategories=Development;StartupNotify=trueNoDisplay=false集成到系统级应用快捷方式的保存路径
将编辑好的*.desktop*文件复制到系统级应用快捷方式的保存路径
sudocp~/桌面/UE4.26.desktop /usr/share/applications/UE4.26.desktop# 替换成自己的桌面路径和目标路径桌面图标生成
右键桌面.desktop文件 >> 允许启动(UE图标出现)>> 双击图标,启动UE4应用程序(需要等待一小会)
新建UE4项目
新建UE4蓝图项目
新建项目类型:游戏 >> 第三人称游戏 >> 项目设置:蓝图 (C++项目需要设置集成开发环境 (IDE) >> 底部选择项目储存的位置与命名 >> 创建项目
将仅限BP的项目转变为包含C++代码的项目
第一步:在蓝图项目中添加C++类
文件 >> 新建 C++类 >> 选择父类:Actor >> 命名和路径选择 >> 创建类
第二步:检查C++类是否编译成功
重启UE >> 内容浏览器 >> 是否出现C++类文件夹(若出现则转换成功)
至此,Linux上UE4的安装与快捷方式的添加已全部完成,下一次启动UE可以直接双击桌面图标啦!
完结撒花!~~