在Fedora系统上构建Apollo项目的技术要点解析

项目背景与构建挑战

Apollo是一个开源的流媒体服务器项目，基于Moonlight协议实现，允许用户通过网络将游戏从主机流式传输到其他设备。该项目在Linux平台上的构建过程涉及多个依赖项和复杂的配置，特别是在Fedora系统上可能会遇到一些特有的挑战。

关键构建问题分析

子模块初始化问题

构建过程中最常见的错误之一是未能正确初始化Git子模块。Apollo项目依赖多个第三方库作为子模块，包括：

• moonlight-common-c/enet
• Simple-Web-Server
• libdisplaydevice

这些子模块必须通过git clone --recursive-submodules命令完整获取，否则会导致CMake配置阶段失败，提示找不到相关目录或CMakeLists.txt文件。

Boost库依赖处理

项目对Boost库有特定版本要求（至少1.86.x）。当系统未安装合适版本的Boost时，CMake会尝试通过FetchContent机制自动下载并构建所需版本。这一过程会自动包含以下Boost组件：

• filesystem
• locale
• log
• program_options
• system
• asio
• crc
• format
• process
• property_tree

FFmpeg预编译二进制文件

Apollo构建系统期望在特定路径找到FFmpeg预编译二进制文件。如果不存在，建议用户考虑为相关构建依赖仓库贡献预编译文件，或者通过FFMPEG_PREPARED_BINARIES选项指定系统安装的FFmpeg库路径。

构建流程优化建议

测试构建的特殊处理

项目测试代码目前存在兼容性问题，特别是：

1. 在process.cpp中，跨平台的前台任务控制代码（fg.disable()）未正确处理非Windows平台的情况
2. HTTP配对测试中的类型不匹配问题

建议在构建时禁用测试，使用以下CMake参数：

-DBUILD_TESTS=false -DBUILD_DOCS=false

构建脚本改进

针对Fedora系统的构建脚本(linux_build.sh)需要注意：

1. 避免在脚本中执行source ~/.bashrc，这可能导致脚本意外终止
2. 为AMD用户添加--skip-cuda选项支持，自动禁用CUDA相关构建
3. 正确处理SVG资源文件的安装路径问题

完整构建流程

经过问题修复后的推荐构建步骤如下：

1. 克隆仓库并初始化子模块：

git clone --recursive-submodules https://github.com/ClassicOldSong/Apollo.git
cd Apollo

2. 配置构建环境：

cmake -B=build -S=. \
  -DBUILD_WERROR=ON \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX=/usr \
  -DSUNSHINE_ASSETS_DIR=share/sunshine \
  -DSUNSHINE_EXECUTABLE_PATH=/usr/bin/sunshine \
  -DSUNSHINE_ENABLE_WAYLAND=ON \
  -DSUNSHINE_ENABLE_X11=ON \
  -DSUNSHINE_ENABLE_DRM=ON \
  -DBUILD_TESTS=false \
  -DBUILD_DOCS=false

3. 编译并安装：

cd build
make -j$(nproc)
sudo make install

总结

在Fedora系统上构建Apollo项目需要注意子模块初始化、依赖库版本匹配以及测试代码的特殊处理。通过合理配置CMake参数和修正构建脚本中的问题，可以顺利完成项目的编译和安装。对于开发者而言，理解这些构建细节有助于快速定位和解决类似项目中的构建问题。