Zelda64Recomp构建指南：从源码编译到依赖管理的完整流程
项目地址: https://gitcode.com/gh_mirrors/zel/Zelda64Recomp 想要在PC上体验经典游戏《塞尔达传说：姆吉拉的假面》吗？Zelda64Recomp项目通过静态重编译技术将N64游戏移植到Windows和Linux平台。这份终极构建指南将带你完成从源码编译到依赖管理的完整流程，让你轻松搭建属于自己的游戏环境。🎮
🛠️ 准备工作与环境配置
在开始构建之前，你需要准备两个关键文件：
- 游戏的美版ROM文件（解压缩版本）
- 从Majora's Mask反编译项目生成的ELF文件
克隆项目仓库
首先克隆Zelda64Recomp仓库，由于项目使用了子模块，需要添加--recurse-submodules参数：
git clone --recurse-submodules https://gitcode.com/gh_mirrors/zel/Zelda64Recomp
安装系统依赖
Linux系统（以Ubuntu为例）：
sudo apt-get install cmake ninja libsdl2-dev libgtk-3-dev lld llvm clang-15
Windows系统：
- 安装Visual Studio 2022，选择"C++桌面开发"工作负载
- 包含"C++ Clang Compiler for Windows"和"C++ CMake tools for Windows"
- 通过Chocolatey安装make工具：
choco install make
📁 项目结构与核心文件
Zelda64Recomp项目采用清晰的模块化结构：
- CMakeLists.txt - 主要的CMake构建配置文件
- src/ - 源代码目录，包含游戏逻辑和UI实现
- patches/ - 补丁文件，处理游戏特定的修改
- lib/ - 第三方依赖库，如RmlUi、GamepadMotionHelpers等
🔧 ELF文件生成与ROM处理
这是构建过程中最关键的一步。你需要从Majora's Mask反编译项目的特定提交构建ELF文件和解压缩ROM。在构建过程中可能会遇到'jr' instruction does not have an 'jump label' field错误，需要修改tools/disasm/disasm.py文件中的相应代码。
成功构建后，将以下文件复制到Zelda64Recomp项目根目录：
mm.us.rev1.rom_uncompressed.elfmm.us.rev1.rom_uncompressed.z64
🚀 代码生成与编译构建
生成C代码
使用N64Recomp工具生成可编译的C代码：
./N64Recomp us.rev1.toml
./RSPRecomp aspMain.us.rev1.toml
./RSPRecomp njpgdspMain.us.rev1.toml
最终构建项目
使用CMake进行最终构建：
cmake -S . -B build-cmake -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build-cmake --target Zelda64Recompiled -j$(nproc) --config Release
✅ 构建成功与注意事项
恭喜！🎉 在build-cmake目录中你将找到Zelda64Recompiled可执行文件。现在你可以在PC上畅玩这款经典游戏了！
重要提示：在游戏运行时，请使用标准的ROM文件，而不是解压缩版本。
通过这份完整的Zelda64Recomp构建指南，即使是初学者也能顺利完成从源码到可执行文件的整个编译过程。记住，耐心和细心是成功构建的关键！🌟
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
