Cemu项目在Fedora 39上的编译问题分析与解决方案

问题背景

在Fedora 39系统上编译Cemu模拟器项目时，开发人员遇到了两个主要的构建问题。这些问题主要与vcpkg依赖管理系统和libxcrypt库的编译相关。本文将详细分析这些问题的成因，并提供完整的解决方案。

问题一：vcpkg浅克隆导致的构建失败

在构建过程中，系统首先报出了vcpkg相关的错误。错误信息表明vcpkg是以浅克隆(shallow clone)方式获取的，这导致无法正确解包某些git树对象。

错误表现

构建过程中出现以下关键错误信息：

error: failed to execute: /usr/bin/git --git-dir=/root/cemu/dependencies/vcpkg/.git --work-tree=... read-tree -m -u 843c4331dc1453c80f99e25be4513c99074c5cf2
vcpkg was cloned as a shallow repository
fatal: failed to unpack tree object 843c4331dc1453c80f99e25be4513c99074c5cf2

原因分析

vcpkg作为Cemu的依赖管理系统，需要完整的git历史记录来正确解析和构建某些依赖项。浅克隆方式只获取了最近的提交历史，缺少完整的git对象数据库，导致无法访问特定的历史树对象。

解决方案

1. 进入vcpkg目录：

cd dependencies/vcpkg

2. 将浅克隆转换为完整克隆：

git fetch --unshallow

3. 更新所有分支：

git pull --all

问题二：libxcrypt编译失败

解决vcpkg问题后，构建过程在libxcrypt库的编译阶段再次失败。

错误表现

错误日志显示：

fatal error: sys/endian.h: No such file or directory
configure: failed program was:
| #include <sys/endian.h>

原因分析

libxcrypt在配置阶段尝试检测系统头文件时失败，特别是缺少sys/endian.h头文件。这个头文件通常由libbsd-devel包提供，用于处理字节序相关的操作。

解决方案

1. 安装必要的开发包：

dnf install libbsd-devel

2. 确保所有相关开发工具已安装：

dnf groupinstall "Development Tools"

3. 验证环境变量是否正确设置，特别是包含路径。

完整构建建议

为了确保Cemu在Fedora 39上顺利构建，建议遵循以下完整步骤：

1. 克隆Cemu仓库：

git clone https://github.com/cemu-project/Cemu.git
cd Cemu

2. 初始化并更新子模块：

git submodule update --init --recursive

3. 进入vcpkg目录并转换为完整克隆：

cd dependencies/vcpkg
git fetch --unshallow
git pull --all
cd ../..

4. 安装系统依赖：

dnf install libbsd-devel cmake ninja-build gcc-c++ libglvnd-devel

5. 执行构建：

cmake -S . -B build -DCMAKE_BUILD_TYPE=release -G Ninja
cmake --build build

总结

在Fedora 39上构建Cemu项目时，主要会遇到vcpkg浅克隆和系统头文件缺失两个关键问题。通过将vcpkg转换为完整克隆并安装必要的开发包，可以解决这些问题。这些解决方案不仅适用于Cemu项目，对于其他依赖vcpkg和系统库的项目也有参考价值。