实用操作笔记

排查 iPhone 应用崩溃

从 iPhone 的 IPA 构建与签名路线出发,分清安装失败、启动退出、管线准备和读档崩溃,记录设备、系统、游戏版本与项目提交。更新或重装前先保存应用数据和可用日志,按单一变量复查;Mac 运行报告不能证明手机表现,本站也不承诺重装能够恢复存档或解决崩溃。

首次发布译文修改来源核验

适用范围 iPhone IPA 路线;本站未核验特定设备的游戏运行结果。

先确认平台路线

iPhone 需要上游 IPA 构建和签名或侧载流程,不能使用 Finder Mac 应用。到项目 README 查看当前设备与系统要求。满足要求不等于某款游戏一定可玩,本站奥德赛 iPhone 记录引用作者报告,具体设备测量仍未知。

前置条件

记录具体机型、iOS 版本、项目提交、游戏版本和安装方式。只使用自己的游戏和密钥。区分安装阶段、启动阶段、管线准备阶段与读取存档后的崩溃,这些故障所需信息不同。

操作步骤

  1. 对照目标提交的上游要求检查环境。
  2. 如果还能打开应用或数据容器,替换前从“文件 → 应用名称”复制 save/ 和 pso_user.tsv,并保存同目录可用的 log.txt。
  3. 安装或启动失败时检查签名和侧载工具;Mac 游戏运行报告不能解释所有签名问题。
  4. 每次只尝试一个有文档依据的变化,重新记录首次失败发生在哪里。
  5. 提交问题时附环境和经过脱敏的相关日志,不上传游戏或密钥。

检查点与失败处理

部分侧载工具重装会更换数据容器;新安装看不到旧存档,不一定代表游戏本身修好了。始终保留独立备份,并在更新后检查存档是否可见。应用无法打开且无法访问容器时,先保留现有安装再研究访问方式,本站不能保证恢复。

找到第一个失败阶段

看到的现象优先核对不应直接推断
安装工具拒绝 IPA工具报错与签名配置游戏图形代码已经开始运行
游戏启动前就退出设备和系统门槛、可取得的应用日志更新游戏版本就能修复签名
到某个场景或存档后退出可复现步骤、项目提交和游戏版本所有平台都存在同一个问题
应用能开但旧进度不见了应用身份与数据容器存档一定被删了,或再重装一次就能恢复

从构建到安装的完整流程见iPhone/iPad 安装指南。上游 README 讨论了签名方式支持时的 Increased Memory Limit 能力,可以记录是否实际应用,但不要把所有闪退都判断为内存问题,也不能保证加上它就会修复。

整理别人能够复现的报告

用一条笔记记录游戏及版本、nxnative 提交、设备与芯片、系统、安装工具、第一个失败阶段和最短复现步骤。只有实际比较过,才说明新开游戏和旧存档是否有差异;没有验证的结果继续写未知。

README 将 log.txt 放在“文件”中对应应用的目录下,并把 log.prev.txt 标为上一次运行的日志。再次启动前先复制有用记录;分享前检查私人路径或个人信息,不附加密钥或游戏数据。如果无法访问容器,就如实记录这个限制,不要卸载唯一副本。替换应用前先保护存档。

常见问题

能用 Mac 帧率推断 iPhone 表现吗?

不能。本站不会把 Mac 的帧率、设备信息或运行结论移植到 iPhone 或 iPad。

来源与核验

根据链接中的项目文档和问题报告原创整理;来源核验日期为 2026-10-27。

兼容性查询 →