RPCS3模拟器项目编译指南：从环境搭建到构建完成

RPCS3模拟器项目编译指南：从环境搭建到构建完成

rpcs3 PS3 emulator/debugger 项目地址: https://gitcode.com/gh_mirrors/rp/rpcs3

前言

RPCS3是一款开源的PlayStation 3模拟器，能够让用户在PC上运行PS3游戏。本文将详细介绍如何在Windows和Linux系统上编译构建RPCS3项目，帮助开发者或技术爱好者从零开始搭建开发环境并成功编译项目。

环境准备

Windows系统要求

要在Windows 10或更高版本上构建RPCS3，需要准备以下工具：

1. Visual Studio 2022：作为主要的开发环境，提供C++编译器和相关工具链
2. CMake 3.28.0+（可选）：Visual Studio 2022已集成CMake 3.29+，但也可选择独立安装
3. Python 3.6+：用于脚本处理和构建系统支持
4. Qt 6.9.0：图形用户界面框架
5. Vulkan SDK 1.3.268.0：图形API支持，注意必须使用此特定版本

Linux系统要求

Linux环境下需要以下核心组件：

1. 编译器：Clang 17+或GCC 13+
2. 构建工具：CMake 3.28.0+和Ninja
3. 图形支持：Qt 6.9.0和Vulkan SDK 1.3.268.0
4. 音频支持：SDL3（用于FAudio后端）

不同Linux发行版的安装命令

• Arch Linux：

  sudo pacman -S glew openal cmake ninja vulkan-validation-layers qt6-base qt6-declarative qt6-multimedia qt6-svg sdl3 sndio jack2 base-devel
  

• Debian/Ubuntu：

  sudo apt-get install build-essential ninja-build libasound2-dev libpulse-dev libopenal-dev libglew-dev zlib1g-dev libedit-dev libvulkan-dev libudev-dev git libevdev-dev libsdl3-3.2 libsdl3-dev libjack-dev libsndio-dev
  

• Fedora：

  sudo dnf install alsa-lib-devel cmake ninja-build glew glew-devel libatomic libevdev-devel libudev-devel openal-devel qt6-qtbase-devel qt6-qtbase-private-devel vulkan-devel pipewire-jack-audio-connection-kit-devel qt6-qtmultimedia-devel qt6-qtsvg-devel llvm-devel
  

• OpenSUSE：

  sudo zypper install git cmake ninja libasound2 libpulse-devel openal-soft-devel glew-devel zlib-devel libedit-devel vulkan-devel libudev-devel libqt6-qtbase-devel libqt6-qtmultimedia-devel libqt6-qtsvg-devel libQt6Gui-private-headers-devel libevdev-devel libsndio7_1 libjack-devel
  

项目初始化

获取项目源代码并初始化子模块：

git clone --recurse-submodules <项目仓库地址>
cd rpcs3
git submodule update --init

Windows平台构建方法

使用Visual Studio解决方案构建（推荐）

1. 打开Visual Studio，选择"打开项目或解决方案"，导航到RPCS3根目录下的rpcs3.sln文件

2. Qt插件配置（如使用）：

   • 在"扩展->Qt VS Tools->Qt版本"中添加Qt安装路径
   • 在"扩展->Qt VS Tools->选项->旧版项目格式"中启用"构建:运行预构建设置"

3. 构建依赖库：

   • 推荐下载预编译的LLVM库并解压到指定目录
   • 或手动构建llvm_build或llvm_build_clang_cl项目

4. 构建主项目：

   • 从解决方案配置下拉菜单中选择"Release"
   • 点击"生成->生成解决方案"
   • 构建完成后，RPCS3可执行文件将位于<项目根目录>/bin目录下

使用Visual Studio CMake解决方案构建

1. 打开Visual Studio，选择"打开本地文件夹"，导航到RPCS3根目录

2. 在解决方案资源管理器中：

   • 右键点击"rpcs3"并选择"切换到CMake目标视图"
   • 从配置下拉菜单中选择"msvc-release"
   • 右键点击"CMakeLists.txt项目"并选择"配置缓存"
   • 构建完成后，可执行文件位于<项目根目录>/build-msvc/bin目录

使用独立CMake工具构建

1. 在项目根目录执行以下命令：

   cmake --preset msvc
   cmake --build --preset msvc-release
   

2. 构建完成后，可执行文件位于<项目根目录>/build-msvc/bin目录

Linux平台构建方法

1. 在项目根目录执行以下命令生成构建文件：

   cmake -B build -G Ninja
   

   （如需指定编译器，可添加前缀如CC=clang CXX=clang++）

2. 编译项目：

   cmake --build build
   

3. 运行模拟器：

   build/bin/rpcs3
   

ARM平台注意事项：构建时需要添加-DUSE_NATIVE_INSTRUCTIONS=OFF标志以避免NEON相关编译错误。

调试技巧

使用GDB调试时，建议配置其忽略SIGSEGV信号：

handle SIGSEGV nostop noprint

结语

通过本文的详细指导，您应该已经成功在Windows或Linux系统上搭建了RPCS3的开发环境并完成了项目构建。不同构建方法各有优势，Visual Studio解决方案适合Windows开发者，而CMake方法则提供了跨平台的一致性。如果在构建过程中遇到问题，建议检查各依赖组件的版本是否符合要求，特别是Vulkan SDK必须使用指定的1.3.268.0版本。

rpcs3 PS3 emulator/debugger 项目地址: https://gitcode.com/gh_mirrors/rp/rpcs3