从零编译Sonic CD反编译：RSDKv3的CMake构建完整指南（Win/Linux/Mac/Android）

从零编译Sonic CD反编译RSDKv3的CMake构建完整指南Win/Linux/Mac/Android【免费下载链接】Sonic-CD-11-DecompilationA Full Decompilation of Sonic CD (2011) Retro Engine (v3)项目地址: https://gitcode.com/gh_mirrors/so/Sonic-CD-11-Decompilation本文带你从零开始编译Sonic CD2011反编译项目这是一个完整的 Sonic CD 反编译 Retro Engine v3RSDKv3开源引擎采用 CMake 统一构建系统一条命令即可在 Windows、Linux、Mac、Android 四大平台完成编译非常适合想深入 Retro Engine 源码的反编译新手。 项目速览Sonic CD 反编译与 RSDKv3 引擎这个仓库包含两部分完整反编译的 Retro Engine v3RSDKv3驱动 Sonic CD 2011 版的渲染、音频、输入与脚本引擎默认基于 SDL2 与 PC 版渲染后端色板支持完整比如 Tidal Tempest 的水面效果。附加增强功能内置 Mod 加载器与 API、类似 Sonic Mania 的settings.ini配置文件、开发菜单调试功能F12 暂停、F11 单步、F5 重载场景等。核心源码位于 RSDKv3/ 目录含 RetroEngine.cpp、main.cpp 等 20 个模块构建入口是根目录的 CMakeLists.txt构建说明详见 README.md。⚠️ 反编译本身不含游戏资源运行时需要你通过官方渠道Steam / Epic / 主机版等合法获取 Sonic CD 的游戏素材项目 README.md 中有详细说明。 第一步获取源码务必递归克隆不要直接下载 ZIP 压缩包——它不包含编译必需的子模块如 dependencies/all/tinyxml2 这个小而关键的结构化 XML 库。请安装 Git 后在终端执行git clone --recursive https://gitcode.com/gh_mirrors/so/Sonic-CD-11-Decompilation cd Sonic-CD-11-Decompilation如果已经克隆过仓库在仓库内补一句即可git submodule update --init --recursive子模块配置见 .gitmodulesCMake 会把这些依赖源码直接纳入编译列表见 CMakeLists.txt 中的RETRO_FILES。️ 第二步安装 CMake 与平台依赖项目要求CMake ≥ 3.10。下载安装时请勾选「加入系统 PATH」选项。不同平台的依赖策略由 CMakeLists.txt 自动判断识别到 Windows 就加载 platforms/Windows.cmake其余系统按CMAKE_SYSTEM_NAME加载对应的平台脚本找不到系统库时还会自动回退到从源码编译 libogg / libvorbis / libtheora非常省心。 WindowsVisual Studio vcpkg安装Visual Studio Community勾选「使用 C 的桌面开发」工作负载安装vcpkg只需按官方指引完成第 1 步「Set up vcpkg」在命令提示符中安装依赖包把[vcpkg root]换成你的 vcpkg 路径[vcpkg root]\vcpkg.exe install glew sdl2 libogg libtheora libvorbis --tripletx64-windows-static编译 32 位版本时把x64-windows-static全部替换为x86-windows-static。Windows 平台脚本 platforms/Windows.cmake 会链接 winmm、comctl32并强制启用 C17 以支持 Mod 加载器。 Linuxpkg-config 驱动一条包管理器命令platforms/Linux.cmake 使用 pkg-config 作为主探测手段找不到系统库时自动从源码构建。按发行版安装依赖Arch (pacman)sudo pacman -S base-devel cmake glew sdl2 libogg libtheora libvorbisDebian/Ubuntu (apt)sudo apt install build-essential cmake libglew-dev libglfw3-dev libsdl2-dev libogg-dev libtheora-dev libvorbis-devFedora (dnf)sudo dnf install make gcc cmake glew-devel glfw-devel SDL2-devel libogg-devel libtheora-devel libvorbis-devel zlib-develAlpine (apk)sudo apk add build-base cmake glew-dev glfw-dev sdl2-dev libogg-dev libtheora-dev libvorbis-dev MacXcode 路线Mac 端建议直接用 Xcode 工程构建详细步骤见 dependencies/mac/README.md核心流程安装 Xcode 后执行xcode-select --install获取命令行工具按文档把 SDL2.framework、libogg、libvorbis、libtheora 放入dependencies/mac对应位置在仓库根目录执行命令行打包Release 版输出到build/xcodebuild -project RSDKv3.xcodeproj -scheme RSDKv3 DSTROOT./build -configuration Release DEPLOYMENT_LOCATIONYESXcode 工程文件为 RSDKv3.xcodeproj/project.pbxproj直接在 Xcode 中打开即可调试引擎源码。 AndroidAndroid Studio NDKAndroid 构建基于 platforms/Android.cmake产物是共享库.so链接 EGL、GLESv1_CM、OpenSLES 等系统库。步骤见 dependencies/android/README.md下载 SDL22.28.3源码解压到dependencies/android/SDL其余媒体库解压到dependencies/android/对应目录确保android/app/jni下的符号链接指向正确SDL→ SDL 依赖根src→ 仓库根用 Android Studio 打开 android/ 目录安装 NDK 后直接构建。⚙️ 第三步两条命令完成 CMake 构建在仓库根目录执行Windows 需追加 vcpkg 参数cmake -B build cmake --build build --config releaseWindows 完整写法三处[vcpkg root]均替换为你的 vcpkg 安装路径cmake -B build -DCMAKE_TOOLCHAIN_FILE[vcpkg root]/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLETx64-windows-static -DCMAKE_PREFIX_PATH[vcpkg root]/installed/x64-windows-static/ cmake --build build --config release产物可执行文件名为RSDKv3由 CMakeLists.txt 中的RETRO_OUTPUT_NAME决定位于build/目录内。首次启动若缺少游戏素材会自动生成一份 TXT 设置指引。️ 常用 CMake 编译开关RSDKv3 六大旗标在cmake -B build后追加-D[旗标名][值]即可例如-DRETRO_DISABLE_PLUSon旗标默认值作用RETRO_MOD_LOADERON启用/禁用 Mod 加载器RETRO_USE_HW_RENDERON允许使用硬件OpenGL渲染器RETRO_DISABLE_PLUSOFF公开分发构建必须设为 onRETRO_FORCE_CASE_INSENSITIVEOFF加载文件时强制忽略大小写RETRO_ORIGINAL_CODEOFF移除全部自定义代码此模式下无法构建出可玩版本RETRO_SDL_VERSION2在 SDL1 / SDL2 之间切换非特殊需求勿动这些开关在 CMakeLists.txt 中定义并转换为编译宏注入引擎见 CMakeLists.txt。✅ 构建排错速查缺 tinyxml2 / 子模块文件执行git submodule update --init --recursive。Windows 报readdir: No such file or directory删除android/app/build后重试路径过长重建导致。Windows 路径报0xc0000005把仓库符号链接到盘符根目录如C:/RSDKv3再构建。Mac 分发的 .app 无法打开用xattr -cr /path/to/RSDKv3.app清除扩展属性。更多运行时问题画面撕裂、宽屏错位、Origins 素材兼容等见 FAQ.md。从零到可运行的 RSDKv3 构建你只需要递归克隆 → 装好 CMake 与平台依赖 →cmake -B build→cmake --build build --config release。现在就去编译属于你自己的 Sonic CD 反编译版本吧【免费下载链接】Sonic-CD-11-DecompilationA Full Decompilation of Sonic CD (2011) Retro Engine (v3)项目地址: https://gitcode.com/gh_mirrors/so/Sonic-CD-11-Decompilation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考