企业官网建设流程全解析

vphone-cli Home键卡住怎么办？VNC右键模拟home按钮的完整操作指南

【免费下载链接】vphone-cli项目地址: https://gitcode.com/GitHub_Trending/vp/vphone-cli

使用 vphone-cli 启动虚拟 iPhone 时，很多新手会卡在 “Press home to continue”（按 Home 键继续）界面——这是因为虚拟 iPhone 没有实体 Home 键，需要手动模拟一次按键。本文教你 3 种模拟 home 按钮的方法，其中VNC 右键模拟 home 按钮是官方 FAQ 推荐的快速解法，30 秒即可解锁。

为什么虚拟 iPhone 会卡在 Home 键

vphone-cli 基于 Apple 的 Virtualization.framework 在 Mac 上启动完整的 iOS 系统，虚拟机中的 iPhone 没有物理按键。系统首次开机或恢复流程中会提示“Press home to continue”，如果你不知道如何“按下” Home 键，就会一直停在这一步。

方法一：VNC 右键模拟 Home 键（官方推荐）

这是 README.md 官方 FAQ 给出的标准解法，适用于任何连接场景：

1. 获取虚拟机 IP：窗口标题栏或vphone-cli vm info <名称>都能查看。

2. 在 Mac 上打开屏幕共享（或其他 VNC 客户端），输入地址：

   vnc://<vm-ip>:5901

3. 在 VNC 画面中右键点击屏幕（触控板双指点击），相当于按了一次 home 按钮，系统即可继续启动。

💡 为什么右键有效？vphone-cli 将 VM 显示视图的右键事件（rightMouseDown）直接映射为 Home 键 HID 信号，相关逻辑见 VPhoneVirtualMachineView.swift。

方法二：原生窗口右键 / Cmd+H 快捷键

如果你用的是 vphone-cli 自带的 macOS 窗口（而非 VNC 客户端），其实有更直接的方式：

• 鼠标右键点击虚拟机画面→ 立即触发 home 按钮；
• 按下 Cmd + H→ 同样效果；
• 点击窗口工具栏右上角的圆形 Home 按钮（图标为双圆环）。

三种方式底层都调用同一个函数，向虚拟机发送 HID Consumer Page（0x0C）中 usage 为 0x40 的按键信号，见 VPhoneKeyHelper.swift 和 VPhoneWindowController.swift：

func sendHome() { guard requireConnection() else { return } control.sendHIDPress(page: 0x0C, usage: 0x40) }

3 种模拟方式对比清单

常见追问

Q：右键点了没反应怎么办？确认窗口标题显示VPHONE [connected]，说明 guest 内的 vphoned 守护进程已连接；若显示[disconnected]，请等启动完成后重试。

Q：除了 home 键，能模拟电源、音量键吗？可以。同一套 HID 机制还支持电源键（usage 0x30）、音量加减（0xE9 / 0xEA）等，定义在 VPhoneKeyHelper.swift。

Q：卡在 “Press home to continue” 是在哪一步出现的？通常出现在 DFU 恢复（vphone-cli restore）或首次启动阶段，属于正常流程提示，不是报错。

总结

遇到 vphone-cli Home 键卡住时，记住一句话：VNC 连接后用双指右键点击屏幕，即可模拟 home 按钮继续启动。配合vnc://<vm-ip>:5901的连接地址，整个虚拟 iPhone 从创建到可用只需几分钟。更多连接与 SSH 调试信息可参考 README.md 中的 Running & Connecting 章节。

【免费下载链接】vphone-cli项目地址: https://gitcode.com/GitHub_Trending/vp/vphone-cli