Run a virtual iPhone on an Apple Silicon Mac.
Swift
故障排查
找到你看到的症状或错误信息,然后按照其下方的方法处理。网络问题请参阅网络。
vphone-vm 在虚拟机打开前被终止
运行宿主机预检:
vphone-cli host preflightCLI 不带授权,因此它会继续运行,并能说明 AMFI 为何拒绝与它配套的已签名
vphone-vm。如果你重新构建了 bundle,cdhash 就会改变。请按照宿主机设置中的说明,用 bundle 自带的辅助程序允许新的二进制文件。
Virtualization is not available on this hardware
PV=3 客户机不能嵌套运行。请在 Apple Silicon Mac 上直接启动,而不是在另一个 macOS 虚拟机中。
vm create 打印了 vphoned 成功信息,但没有虚拟机在运行
这是正常的。创建流程会临时以图形界面启动一次,发送一次真实的 ping,并在返回前停止这次启动。要使用虚拟机,请启动它:
vphone-cli vm launch <name>
停在“Press home to continue”
点击虚拟机窗口标题栏中的主屏幕按钮。当前的 JB 流程不会安装 VNC 服务器。
App 因 EXC_GUARD / GUARD_TYPE_MACH_PORT 退出
内核补丁 kernel-boot-thread_guard_violation 会阻止致命的 Mach 端口守卫投递。它只适用于 iOS 18 基础系统,因为在这类系统上启动需要它,所有预设都会在这类系统上开启它。其他基础系统无法选择这个补丁,因此在 26.x 基础系统上触发这个守卫的 App 仍会退出。见 issue #291。
恢复或首次启动失败
- 在手动流程中,让虚拟机保持在 DFU 模式,直到
restore退出。 - 确认在线票据请求能够访问 Apple。
- 对于完整流程,请用一个新名称并加上
-v重新运行vm create,以获取工具的详细输出。 - 内存或磁盘紧张时,避免同时创建多台虚拟机。
- 把 iPhone IPSW 与 PCC 映像组合使用之前,请查看固件兼容性。
客户机已启动,但 vphoned 在创建期间没有响应
首次启动检查会在 300 秒后超时。创建流程使用图形界面启动,因为新恢复的客户机在首次无界面启动时可能不会启动 vphoned。成功标记能证明什么,请参阅创建与运行。