从零开始了解 nxnative

nxnative 能做什么

nxnative 使用你自己提供的游戏文件与密钥构建苹果应用。游戏代码在苹果硬件上运行，由运行环境补上所需的系统服务，并将图形调用转换到 Metal。开始之前需要选择目标：Mac 应用，或者安装到 iPhone/iPad 的 IPA。这篇指南先帮你确定路线，避免构建到最后才发现产物选错了。

开始前准备

把构建应用的 Mac和实际游玩的设备分开考虑，先阅读设备要求清单。准备自己的游戏本体、打算使用的对应更新和 prod.keys；不同游戏各放一个文件夹。如果旧应用里已有进度，先单独备份存档，再考虑替换应用。

第一步：核对游戏、平台和版本

1. 在上游游戏资料目录中找到游戏。
2. 打开游戏专属说明，对照你手里的游戏版本与文档记录。
3. 查看是否有目标平台的运行证据。Mac 上的检查结果不能回答 iPhone 是否可玩。
4. 记下游戏版本和计划使用的 nxnative 提交，把这条记录与构建产物保存在一起，便于之后比较。

本站的兼容性查询仅整理了部分可追溯记录，并非上游的完整游戏目录。本站搜不到某款游戏，不等于上游不支持。

第二步：选择构建路线

你的目标	阅读路线	完成后应检查什么
在 Apple 芯片 Mac 的 Finder 中打开游戏	Mac 应用构建	使用 --platform mac-app 生成的游戏 .app
在 iPhone 或 iPad 安装	IPA 构建与安装	已生成 IPA，接下来仍需签名和安装
还在比较两个项目	nxnative 与 MacNativeGames	所选项目中对应的游戏资料和设备条件

--platform mac 是开发主机路线，与最终可以从 Finder 打开的应用不是同一种产物。

第三步：逐个核对检查点

按完成构建 → 完成安装或打开应用 → 到达标题画面 → 操作正常 → 能读取存档记录结果。记下第一个失败的环节，不要把所有问题都归为“闪退”。每个成功环节只能证明这一环节通过，到达标题画面不代表能够完整通关。

第一次运行先用文档中的默认设置；需要调整时逐项记录，不要同时更换构建和多个选项。后续更新仍应先备份，在确认新版本之前保留可用的旧产物。

失败后去哪里查

• 没有生成产物：保留终端首个报错和使用的命令，分享前去掉私人路径与密钥信息。
• IPA 装不上：查看手机安装指南中的签名与安装阶段。
• 打开后退出：按iPhone 崩溃检查表收集信息。
• Mac 卡在管线准备：对照特定管线问题报告，确认是否与自己的环境一致。
• 重装后进度不见了：先停止继续替换应用，再检查备份与恢复位置。

需要完整导航时返回教程总览。本站核对了文档与报告，没有亲自构建或游玩这些游戏。