Cemu模拟器项目编译指南：从源码构建全平台版本-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00919/article/details/148441283

Cemu模拟器项目编译指南：从源码构建全平台版本

Cemu Cemu - Wii U emulator 项目地址: https://gitcode.com/gh_mirrors/ce/Cemu

前言

Cemu是一款广受欢迎的Wii U模拟器，能够让用户在PC上体验Wii U游戏。对于开发者或技术爱好者而言，从源码编译Cemu可以获得最新功能并深度定制。本文将详细介绍在Windows、Linux和macOS三大平台上编译Cemu的完整流程。

Windows平台编译指南

环境准备

在Windows上编译Cemu需要以下工具：

Git版本控制系统
Visual Studio 2022（推荐最新版）
- 必须包含"C++ CMake工具"组件
- 安装Windows 10/11 SDK

详细步骤

获取源码：

git clone --recursive 源码仓库地址

使用VS2022打开项目：
- 启动Visual Studio 2022
- 选择"打开本地文件夹"选项
- 导航到刚克隆的Cemu目录
配置CMake：
- 在菜单栏选择"项目"→"配置CMake"
- 等待配置完成（首次可能耗时较长）
构建与运行：
- 配置完成后即可直接构建、运行和调试

其他IDE支持

除VS2022外，以下IDE也已验证可用：

CLion（需配置CMake和MSVC工具链）
Visual Studio Code（需安装C++和CMake扩展）

Linux平台编译指南

系统要求

编译Cemu需要支持C++20的编译器环境：

推荐Clang-15或更高版本
GCC 11+也可用，但Clang是首选

依赖安装

Arch系发行版

sudo pacman -S --needed base-devel bluez-libs clang cmake freeglut git glm gtk3 libgcrypt libpulse libsecret linux-headers llvm nasm ninja systemd unzip zip

Debian/Ubuntu系

sudo apt install -y cmake curl clang-15 freeglut3-dev git libbluetooth-dev libgcrypt20-dev libglm-dev libgtk-3-dev libpulse-dev libsecret-1-dev libsystemd-dev libtool nasm ninja-build

Fedora系

sudo dnf install bluez-libs-devel clang cmake cubeb-devel freeglut-devel git glm-devel gtk3-devel kernel-headers libgcrypt-devel libsecret-devel libtool libusb1-devel llvm nasm ninja-build perl-core systemd-devel wayland-protocols-devel zlib-devel zlib-static

编译流程

使用Clang编译（推荐）

git clone --recursive 源码仓库地址
cd Cemu
cmake -S . -B build -DCMAKE_BUILD_TYPE=release \
      -DCMAKE_C_COMPILER=/usr/bin/clang \
      -DCMAKE_CXX_COMPILER=/usr/bin/clang++ \
      -G Ninja
cmake --build build

使用GCC编译

cmake -S . -B build -DCMAKE_BUILD_TYPE=release \
      -DCMAKE_C_COMPILER=/usr/bin/gcc \
      -DCMAKE_CXX_COMPILER=/usr/bin/g++ \
      -G Ninja
cmake --build build

调试版本构建

将-DCMAKE_BUILD_TYPE=release替换为-DCMAKE_BUILD_TYPE=debug即可构建调试版本。

常见问题排查

编译错误

vcpkg安装失败：
- 进入dependencies/vcpkg目录执行git fetch --unshallow
找不到Ninja：
- 添加参数-DCMAKE_MAKE_PROGRAM=/usr/bin/ninja
Boost构建失败：
- 检查系统头文件完整性，确保C++相关包已正确安装

构建错误

std::__cxx11错误：
- 这是Clang-14的已知问题，建议降级Clang或改用GCC
找不到'span'头文件：
- 安装新版libstdc++（至少v10）

macOS平台编译指南

特殊要求

需要支持C++20的编译器（Xcode 15已验证可用）
必须使用Vulkan（通过Molten-VK兼容层）

环境准备

安装Homebrew：

/bin/bash -c "$(curl -fsSL 安装脚本地址)"

设置环境变量：
- Intel Mac：eval "$(/usr/local/Homebrew/bin/brew shellenv)"
- Apple Silicon Mac：eval "$(/opt/homebrew/bin/brew shellenv)"

依赖安装

工具链

brew install git cmake ninja nasm automake libtool

库依赖

brew install boost molten-vk

编译命令

git clone --recursive 源码仓库地址
cd Cemu
cmake -S . -B build -DCMAKE_BUILD_TYPE=release \
      -DCMAKE_OSX_ARCHITECTURES=x86_64 \
      -G Ninja
cmake --build build