在 iPhone 或 iPad 上安装

构建 IPA 之前

先完成设备与工具清单。你需要用于构建的 Mac、自己的游戏文件与密钥，以及满足 nxnative 文档要求的目标设备。对照游戏专属说明核对版本和平台证据；替换旧应用时，先把存档复制到应用之外。

这篇使用 nxnative 自己的命令行路线。带图形界面的社区分支有独立配置与产物约定，不要在构建到一半时混用不同项目的步骤。

阶段一：准备项目与工具

上游 README 的 Pack an IPA 部分维护当前安装步骤。新建项目副本时，对应仓库为：

git clone https://github.com/seedds/nxnative.git
cd nxnative

按上游要求完成 Xcode、Homebrew 和其他依赖准备，并记下当前提交。这里的命令仅供阅读和按自己的路径调整，网页不会执行它们。

阶段二：从单个游戏目录构建

将同一游戏的本体、计划使用的对应更新和 DLC 放在一个目录。从 nxnative 项目目录运行下面的示例，把两处路径改成实际位置：

python3 scripts/build_ipa_from_nsp.py   "/path/to/game-folder"   -k "/path/to/prod.keys"

检查点：脚本没有构建报错，并明确输出 IPA 位置。文件名与游戏有关，使用实际生成的名称；保留终端输出和配套构建索引，便于后续复用。构建中断后只看到某个文件存在，不能据此判定成功。

脚本失败时，先记下第一个失败阶段和报错，再检查缺失依赖或游戏版本不匹配。尚未成功生成产物，就不要先进入签名排障。

阶段三：签名并安装

生成的 IPA 尚未签名。README 列出 AltStore、Sideloadly、LiveContainer 等方式，请遵循所选工具当前的说明和使用条件。上游也记录了通过 --prepare-xcode 和 Apple 开发者账号使用 Xcode 的设备构建路线。

核对当前签名方式是否支持上游建议的 Increased Memory Limit（增加内存上限）能力，不能认为所有工具或账号配置都能使用。如果安装工具报签名错误，先保留该错误并在对应工具中处理，不要直接去改游戏画面参数。

检查点：安装工具报告成功，目标设备上出现预期的游戏应用。这只说明完成安装，还不代表游戏能够正常游玩。

阶段四：检查首次启动

1. 打开应用，记录是在设置画面之前、加载中还是进入游戏之后退出。
2. 有设置入口时，先从游戏的测试默认值开始。上游设置说明解释各选项，实际可用项目因游戏而异。
3. 检查操作，尝试到达可以核对进度的位置。记录实际到达的阶段，不简单归为“全程可玩”。
4. 出问题时保留日志，在保护原有数据之前不要反复卸载重装。

按失败阶段继续处理

最先失败的环节	需要保留的信息	下一步
构建或打包	命令、项目提交、终端首个错误	重新核对上游依赖和游戏资料
签名或安装	工具版本与完整错误提示	阅读所选工具的安装说明
启动或游戏加载	设备、系统、游戏版本、应用日志	iPhone 崩溃检查
替换后存档消失	旧备份、游戏标识与数据目录信息	存档备份与恢复

本站不提供 IPA、游戏数据或密钥。以上是根据文档整理的流程，不表示本站已经在你的设备上完成安装或游戏实测。