阿喵前言
想在 Mac 上玩 Switch 游戏，通常想到的是模拟器；MacNativeGames 走的是另一条路线：把 Switch 游戏自己的 ARM64 代码放到 Apple 芯片上运行，再用 Metal 重建 NVN 图形接口。它目前仍是技术探索项目，但已经展示了在 Mac、iPhone 和 iPad 上运行部分 Switch 游戏的可能性。
资源介绍
MacNativeGames 是一个面向 Apple 芯片的 Switch 游戏原生移植实验项目。仓库通过宿主服务处理 Switch 系统调用，把游戏图形从 NVN 映射到 Apple Metal，让游戏代码直接运行在 ARM64 Apple 芯片上，不依赖传统模拟器路线。
项目目前列出了《塞尔达传说：王国之泪》《塞尔达传说：旷野之息》以及多个社区移植项目。不同游戏的支持状态、版本和平台并不相同，需要按对应目录的说明构建。
截图
特色
- 原生 ARM64 路线：游戏代码直接运行在 Apple 芯片上，不是传统模拟器。
- Metal 图形重建：项目尝试把 Switch 的 NVN 图形接口转换为 Apple Metal。
- 支持多个 Apple 平台：已列出 Mac、iPhone、iPad，部分项目还处于社区移植或早期阶段。
- 包含技术资料：仓库提供工作原理、安装步骤、控制方式、测试记录和性能分析文档。
- 着色器共享清单：项目记录着色器标识，帮助后续构建减少首次进入场景时的卡顿。
注意
- 必须拥有正版游戏，并使用从自己的 Switch 导出的游戏文件、密钥和系统文件。
- 仓库不提供游戏文件、密钥、固件或成品游戏 App，也不能把构建出的 App 分享给别人。
- 不同游戏和版本的支持情况不同，社区移植项目可能仍在开发中。
- iPhone 和 iPad 构建有系统与设备要求，具体以项目安装文档为准。
- 导出和使用游戏数据的合法性取决于所在地法律，请自行确认。
使用教程
- 阅读项目说明：先查看仓库 README 和对应游戏目录，确认自己的游戏版本和设备是否在支持范围内。
- 准备自有文件：准备自己购买的游戏文件、从自己的 Switch 导出的
prod.keys及项目要求的系统文件。 - 选择安装方式：按照
docs/install.zh-CN.md操作，也可以让 Claude Code、Codex 等 AI 助手读取项目内的安装 Skill 协助执行。 - 构建应用：根据游戏目录运行对应脚本，构建 Mac App；需要 iPhone 或 iPad 时，按照文档生成未签名 IPA。
- 检查运行效果：首次进入新场景时可能需要编译着色器；遇到问题可查看控制、已知问题和测试记录文档。
资源获取
MacNativeGames 是 MIT 开源的技术探索项目，仓库只提供移植代码、脚本和文档，不提供游戏内容。
