解决Carla Simulator在Ubuntu 22.04下UE5分支打包失败问题

问题背景

Carla Simulator是一个开源的自动驾驶仿真平台，近期社区贡献了基于Unreal Engine 5的开发分支(ue5-dev)。许多开发者在Ubuntu 22.04系统上按照官方文档进行构建时，发现前几个步骤都能顺利完成，但在最后的打包阶段(package)会遇到各种错误。

常见错误现象

1. 内存不足错误(Out of memory)，即使系统有256GB内存也会出现
2. 文件描述符过多问题
3. 资产加载失败警告
4. 国际化初始化断言失败(FInternationalization is not initialized)
5. UnrealTraceServer进程挂起无法终止

根本原因分析

经过技术分析，这些问题主要由以下几个因素导致：

1. 资产内容版本不匹配：Carla主仓库与内容仓库(Content)的提交版本不同步，导致资产引用失效
2. 构建依赖缺失：官方文档中列出的依赖项不完全，缺少部分关键库
3. 系统资源限制：默认的文件描述符限制不足
4. 构建顺序问题：打包目标(package)的依赖关系定义不完整

详细解决方案

1. 确保版本匹配

使用以下版本组合可获得稳定构建：

• Carla主仓库：ue5-dev分支，commit aa9d95eb21d03abe143471d9a7e854a794e5533d
• 内容仓库：ue5devStable0.1标签版本
• UE5引擎：CarlaUnreal/UnrealEngine仓库的ue5-dev-carla分支，commit f1c3b5d77ccf403e25b59f6735157ccf5e3961e7

2. 补充系统依赖

除了官方文档列出的依赖外，还需要安装以下软件包：

sudo apt-get install libwebsockets-dev libnss3-dev libatk-bridge2.0-dev libpango1.0-dev libsdl2-dev

3. 调整系统资源限制

为避免文件描述符不足问题，执行以下命令：

ulimit -n 1024
ulimit -u 1024

4. 正确的构建流程

遵循以下构建顺序：

# 1. 配置项目
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/LinuxToolchain.cmake \
  -DCMAKE_BUILD_TYPE=Release -DENABLE_ROS2=ON \
  -DBUILD_CARLA_UNREAL=ON -DCARLA_UNREAL_ENGINE_PATH=$CARLA_UNREAL_ENGINE_PATH

# 2. 构建Carla
cmake --build Build

# 3. 安装Python API
cmake --build Build --target carla-python-api-install

# 4. 启动编辑器(即使没有GUI也需要执行)
cmake --build Build --target launch
# 出现启动尝试后按Ctrl+C终止

# 5. 打包(可能需要多次执行)
cmake --build Build --target package

5. 处理打包过程中的问题

打包时可能会遇到UnrealTraceServer进程挂起的情况，解决方法：

1. 按Ctrl+C中断当前构建
2. 使用ps aux | grep UnrealTraceServer查找进程ID
3. 使用kill -9 <PID>强制终止挂起的进程
4. 重新执行打包命令

技术深入解析

国际化初始化失败问题

当出现"FInternationalization is not initialized"错误时，这表明UE5的国际化系统在静态初始化阶段被调用。解决方案是确保所有文本本地化操作都在引擎完全初始化后执行。

资产引用问题

资产加载失败警告如"Failed to load '/Game/Carla/Static/Static/SM_LightBox2'"通常表明：

1. 内容仓库版本不正确
2. 资产路径变更但引用未更新
3. 打包过程中资产未被正确包含

使用匹配的内容仓库版本是最可靠的解决方案。

最佳实践建议

1. 在EXT4文件系统上构建，避免使用网络挂载的文件系统
2. 为构建过程分配至少32GB内存
3. 使用SSD存储加速构建过程
4. 定期清理中间文件，避免累积导致问题
5. 考虑使用CCache加速重复构建

通过以上方法，开发者应该能够在Ubuntu 22.04系统上成功构建并打包基于UE5的Carla Simulator。如遇新问题，建议检查各仓库的最新提交，确保版本兼容性。