如何在 macOS 上快速安装 Super Mario 64 构建工具：完整依赖配置指南
项目地址: https://gitcode.com/gh_mirrors/sm6/sm64 想要在 macOS 上编译经典的 Super Mario 64 游戏吗？🤔 这份详细的安装指南将带你一步步完成所有构建工具的依赖安装，让你轻松开启复古游戏开发之旅！
Super Mario 64 是一个完整的逆向工程项目，包含了日本、北美、欧洲、震动版和神游机等多个版本的游戏源码。通过正确的工具链配置，你可以在 macOS 系统上成功构建这些 ROM 文件。🎮
🚀 macOS 安装前准备
在开始安装之前，请确保你的 macOS 系统满足以下要求：
- macOS 10.14 或更高版本
- 至少 2GB 可用磁盘空间
- 稳定的网络连接
📦 核心依赖安装步骤
第1步：安装 Homebrew 包管理器
Homebrew 是 macOS 上必备的包管理器，能帮你轻松管理各种开发工具：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)
第2步：安装构建工具依赖
运行以下命令安装所有必要的构建工具：
brew update
brew install coreutils make pkg-config tehzz/n64-dev/mips64-elf-binutils
这些工具包括：
- coreutils: GNU 核心工具集
- make: 项目构建工具
- pkg-config: 库依赖管理
- mips64-elf-binutils: MIPS 架构交叉编译工具链
第3步：配置基础 ROM 文件
对于你想要构建的每个游戏版本（jp/us/eu/sh/cn），需要将原始 ROM 文件放置到项目根目录：
cp /path/to/your/rom/baserom.us.z64 ./
第4步：开始构建游戏
使用 Homebrew 提供的 GNU make 来构建游戏：
gmake VERSION=us -j4
这里：
VERSION=us指定构建美版-j4使用 4 个并行任务加速构建
🛠️ 项目结构概览
了解项目结构能帮助你更好地进行开发：
💡 常见问题解决
问题1：make 版本过旧
macOS 自带的 make 版本可能过旧，需要使用 Homebrew 的版本：
which gmake # 确认使用 GNU make
问题2：权限问题
如果遇到权限错误，确保你有足够的权限安装软件包：
sudo chown -R $(whoami) /usr/local/*
🎯 构建配置选项
你可以通过以下参数自定义构建过程：
- VERSION: jp, us, eu, sh, cn（游戏版本）
- COMPARE: 1 或 0（是否验证 ROM 哈希值）
- NON_MATCHING: 使用功能等效的 C 实现
📊 成功构建的标志
构建完成后，你将在 build 目录中找到以下文件：
sm64.us.z64- 美版游戏 ROM- 各种中间编译文件
🌟 进阶使用建议
一旦成功构建基础版本，你可以：
- 探索 enhancements/ 目录中的各种改进补丁
- 研究 src/game/ 中的游戏逻辑代码
- 修改 levels/ 中的关卡设计
现在你已经掌握了在 macOS 上安装 Super Mario 64 构建工具的全部知识！🎉 按照这个指南操作，你将能够成功构建这个经典游戏，并开始自己的修改和开发工作。记住，耐心是成功的关键 - 如果有任何问题，重新检查每个步骤通常能解决问题。Happy coding! 👨💻
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
