实用操作笔记
nxnative 与 MacNativeGames 怎么选
想选 nxnative 还是 MacNativeGames，先看自己的游戏、版本和目标设备。本页依据两个项目各自文档比较游戏范围、手机门槛与 Mac 构建路线，说明为什么不能混用参数、缓存或存档路径，并给出逐项选择顺序；没有跨项目性能实测，不以星数或单个运行报告替代兼容性判断。
适用范围 2026-10-27 核验的项目选择参考；没有跨项目性能或稳定性实测。
从自己的游戏出发，而不是从热度出发
两个项目都使用用户自备的游戏数据构建苹果应用，但游戏资料、脚本和文档要求分别维护。真正有用的问题是：哪一个项目对你的游戏、版本和目标设备有对应证据？GitHub 星数不能回答这个问题，本站也没有进行两个项目的性能对测。
对照各自文档中的路线
| 要确认的问题 | nxnative | MacNativeGames |
|---|---|---|
| 去哪里找自己的游戏？ | 游戏资料目录包含多款作品 | README以塞尔达相关工作为重点，也记录独立的社区移植 |
| 手机和平板的要求是什么？ | README：iPhone A17 Pro 或更新、iPad M1 或更新，iOS/iPadOS 26+ | README 描述 iPhone 14+ 与 iOS/iPadOS 26 路线；具体游戏条件和 iPad 证据仍需单独核对 |
| 能生成 Mac 应用吗？ | Apple 芯片 .app 路线使用 --platform mac-app | 使用它自己的 Mac 构建流程和对应游戏配置 |
| 文件和命令跟谁的说明？ | nxnative 自己的脚本、游戏资料与产物约定 | MacNativeGames 自己的游戏目录和构建步骤 |
| 某条运行报告说明什么？ | 仅对应报告中的游戏、构建、平台和验证范围 | 同样需要限定范围，不能把结果转移到另一个项目 |
一列中的要求不能覆盖另一列。特别是 MacNativeGames 写明的某个 iPhone 门槛，不代表 nxnative 也接受相同设备。
按这个顺序选择
- 两边都有对应游戏时，分别打开游戏说明。有条目但没有相关测试，只能作为继续研究的线索。
- 对照版本和目标平台，区分手机游玩报告、Mac 图形检查和仅完成构建的结果。
- 从头读完所选安装路线，确认自己具备要求的输入与环境，再开始构建。
- 第一次尝试先选定一个项目，把项目提交、产物和笔记放在一起，确保知道自己实际检查的是哪一版。
- 之后再尝试另一个项目时，把它当作独立尝试，保留备份并使用不同工作目录。
选择 nxnative 后，继续看设备要求和快速入门。选择 MacNativeGames 时，直接遵循它的 README 与对应游戏步骤，不凭猜测把 nxnative 的命令改一下就用。
不要混用设置、缓存与存档
文件名看起来相似，不代表格式和目录布局相同。不要用另一个项目的产物覆盖当前可用应用的数据。任何迁移尝试之前，都应单独保留完整原始存档，核对目标游戏标识和版本。本站备份指南写的是 nxnative 路径，不能直接套给其他项目。
某个选项在某一构建中改善了表现，就把结果记录在那个构建下。环境变量或社区临时处理方法跨项目使用前，需要确认目标项目确实有对应说明。
检查点与失败处理
寻找非塞尔达作品时，可以先从 nxnative 的多游戏资料目录查起；研究特定塞尔达作品时，也值得阅读 MacNativeGames 的专门记录。这是查阅路线，不是速度或稳定性排名。设备条件和作者报告都不能认证你的设备，更不能代表完整通关。
常见问题
MacNativeGames 只支持 Mac 吗？
不是。它的 README 也记录了 iPhone 和 iPad 路线，应阅读具体游戏和设备条件，不能仅按项目名推断。
能直接共用另一个项目的存档路径和构建命令吗？
不能默认相同。按选定项目自己的说明操作，任何迁移尝试前先保留独立备份。
来源与核验
根据链接中的项目文档和问题报告原创整理；来源核验日期为 2026-10-27。