Windows 平台编译 shadPS4 指南

方案一：使用 Visual Studio 2022（推荐）

环境准备

  1. 安装 Visual Studio 2022 社区版： • 从官网下载安装程序 • 勾选”使用 C++ 的桌面开发”工作负载 • 在”单个组件”中搜索并安装： ◦ C++ Clang Compiler for Windows ◦ MSBuild support for LLVM

  2. 安装 Qt 开发环境： • 从Qt 官网下载安装程序（需注册账号） • 选择 MSVC 2022 64-bit 和 QT Multimedia 组件 • 安装完成后，在 VS 中安装 Qt Visual Studio Tools • 配置 Qt 路径：工具 → 选项 → Qt → 版本 → 添加 C:\Qt\6.8.2\msvc2022_64

  3. 安装 Git： • 从官网下载安装

编译步骤

  1. 获取源码：

    1. git clone --depth 1 --recursive https://github.com/shadps4-emu/shadPS4

  2. 使用 VS 编译： • 打开 VS，选择”打开本地文件夹”，定位到源码目录 • 在配置管理器中选择 x64-Clang-Release • 如需 Qt GUI 支持： ◦ 在”CMake 命令参数”中添加：

    1. ```
    2. -DENABLE_QT_GUI=ON -DCMAKE_PREFIX_PATH=C:\Qt\6.8.2\msvc2022_64
    3. ```

    • 生成 → 全部生成

  3. 部署运行时文件：

    1. C:\Qt\6.8.2\msvc2022_64\bin\windeployqt6.exe "C:\path\to\shadps4.exe"

输出文件位于：源码目录\Build\x64-Clang-Release\

方案二：MSYS2/MinGW（当前不可用）

[!重要提示] 目前 MSYS2 编译方案存在问题，建议使用 Visual Studio 方案

环境配置

  1. 安装 MSYS2： • 从官网下载安装

  2. 安装编译工具链：

    1. pacman -Syu
    2. pacman -S --needed git mingw-w64-x86_64-binutils mingw-w64-x86_64-clang 
    3. mingw-w64-x86_64-cmake mingw-w64-x86_64-rapidjson 
    4. mingw-w64-x86_64-ninja mingw-w64-x86_64-ffmpeg
    5. # 可选 Qt 组件
    6. pacman -S --needed mingw-w64-x86_64-qt6-base mingw-w64-x86_64-qt6-tools 
    7. mingw-w64-x86_64-qt6-multimedia

编译命令

  1. git clone --recursive https://github.com/shadps4-emu/shadPS4
  2. cd shadPS4
  3. cmake -S . -B build -DCMAKE_C_COMPILER="clang.exe" \
  4.     -DCMAKE_CXX_COMPILER="clang++.exe" \
  5.     -DCMAKE_CXX_FLAGS="-O2 -march=native"
  6. # 可选 Qt GUI 支持
  7. cmake --build build
  8. windeployqt6 build/shadps4.exe

注意事项

  1. ARM64 架构： • 目前不支持 ARM64 设备编译和运行 • 相关说明仅面向开发人员参考

  2. 发布注意事项： • 使用 MSYS2 编译的版本需要附带相关 DLL 文件 • 必须在 MSYS2 环境中运行

  3. 调试版本： • 如需调试版本，请选择 x64-Clang-Debug 配置

  4. Qt 路径： • 如自定义了 Qt 安装路径，请相应修改命令中的路径参数

建议开发者优先使用 Visual Studio 方案进行编译，以获得最佳兼容性和开发体验。