UE5 Linux打包与部署全攻略 （在国产操作系统上离线部署及像素流送实践）

1. 准备工作：环境与工具

在开始UE5 Linux打包之前，你需要准备以下环境：

• 一台安装了国产操作系统的机器（如统信UOS、麒麟等），并且具备离线环境（无互联网连接）。
• UE5编辑器（Windows或Linux版均可，但打包需要Linux工具链）。
• Linux交叉编译工具链：由于是离线部署，你需要提前下载好所有依赖包，包括clang、libc++、SDL2等。
• 像素流送插件：UE5自带的Pixel Streaming插件，但需要在离线环境下配置信令服务器。

2. UE5 Linux打包步骤详解

UE5对Linux的支持已经很完善，但打包时需要特别注意。以下是详细步骤：

1. 在UE5编辑器中打开你的项目，进入“平台”->“Linux”->“设置SDK”，确保SDK路径指向你离线下载好的工具链。
2. 配置项目设置：在“项目设置”->“平台”->“Linux”中，调整渲染配置（建议使用Vulkan），并启用必要的模块。
3. 开始打包：选择“文件”->“打包项目”->“Linux”，输出目录选择一个空文件夹。等待编译完成，你会得到一个包含可执行文件、.so库和配置文件的文件夹。
4. 关键点：由于是离线部署，你需要将打包生成的所有文件以及依赖的运行时库（如libEGL、libGLESv2等）一并拷贝到目标机器上。

3. 在国产操作系统上离线部署UE5程序

将打包好的文件夹传输到国产操作系统上后，进行以下操作：

• 确保系统已安装必要的图形驱动（如AMD/Intel/NVIDIA的闭源或开源驱动）。国产系统通常自带，但需确认支持Vulkan。
• 赋予可执行文件权限：chmod +x YourProject.sh。
• 运行启动脚本：./YourProject.sh。如果遇到缺少共享库的错误，需要手动将缺失的库文件放入程序目录或系统的库路径。
• 为了简化离线部署，你可以提前将所有依赖库打包成一个tar，并在目标机器上解压到相同位置。

4. 配置像素流送（Pixel Streaming）

像素流送允许你将UE5渲染的画面通过WebRTC推送到浏览器，非常适合远程展示。在离线环境下配置需要一些技巧：

1. 在UE5编辑器中启用“Pixel Streaming”插件，并重启项目。
2. 打包时，插件会自动包含信令服务器（一个Node.js应用）和前端页面。你需要将这些文件一并打包（通常在“Engine/Source/Programs/PixelStreaming/WebServers”下）。
3. 在国产操作系统上，确保已安装Node.js（离线安装需要提前下载二进制包）。启动信令服务器：node cirrus.js。
4. 修改UE5程序的启动参数，添加-PixelStreamingIP=localhost -PixelStreamingPort=8888，然后运行程序。
5. 在局域网内另一台机器的浏览器中访问http://[服务器IP]:3000，即可看到UE5的实时画面并与之交互。

5. 常见问题与解决

- 打包失败：检查Linux工具链版本是否匹配UE5要求，建议使用UE5推荐的clang版本。 - 运行时崩溃：在国产操作系统上，可能是由于缺少Vulkan支持或驱动问题，尝试用OpenGL渲染。 - 像素流送无法连接：检查防火墙是否开放3000和8888端口，信令服务器是否正常运行。 - 离线依赖缺失：可以使用ldd命令查看缺失的库，并从开发机或系统镜像中复制对应库文件。

通过以上步骤，你应该已经掌握了UE5 Linux打包、国产操作系统部署、离线部署以及像素流送的核心方法。尽管离线环境增加了复杂度，但只要提前准备好所有依赖，就能顺利运行。希望这篇教程对你有所帮助！