macOS 平台编译 shadPS4 指南

环境准备

必要工具安装

  1. Xcode 要求： • 必须安装 Xcode 16.0 或更新版本

  2. Homebrew 安装：

    1. # 安装原生 ARM 版 Homebrew 到 /opt/homebrew
    2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    4. # 将 Homebrew 添加到环境变量
    5. echo 'eval $(/opt/homebrew/bin/brew shellenv)' >> ~/.zprofile
    6. eval $(/opt/homebrew/bin/brew shellenv)
    8. # 安装基础工具
    9. brew install clang-format cmake

Qt 库安装（如需图形界面）

ARM 芯片 Mac 用户：

  1. # 安装 x86_64 版 Homebrew 到 /usr/local
  2. arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)")
  4. # 安装 Qt6 库
  5. arch -x86_64 /usr/local/bin/brew install qt@6

Intel 芯片 Mac 用户：

  1. brew install qt@6

注：如不需要 Qt 图形界面可跳过此步骤

源码编译

获取源码

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

配置编译选项

  1. # 基础编译配置（x86_64架构）
  2. cmake -S . -B build/ -DCMAKE_OSX_ARCHITECTURES=x86_64
  4. # 如需图形界面添加参数
  5. cmake -S . -B build/ -DCMAKE_OSX_ARCHITECTURES=x86_64 -DENABLE_QT_GUI=ON

执行编译

  1. cd build/
  2. cmake --build . --parallel$(sysctl -n hw.ncpu)

运行模拟器

  1. ./shadps4 /游戏路径/文件夹/eboot.bin

注意事项：

  1. 编译过程将自动使用所有 CPU 核心
  2. 首次运行需授予终端完全磁盘访问权限
  3. 游戏路径中如包含空格需使用引号包裹
  4. 建议将编译好的可执行文件复制到 Applications 目录方便使用