Run a virtual iPhone on an Apple Silicon Mac.
Swift
快速开始
用 Launchpad 设置 vphone,并启动第一台虚拟 iPhone。请在 Mac 满足系统要求后再进行。
用 Launchpad 设置
- 从最新版本下载
vphone-launchpad-<version>-notarized.zip,解压并打开。并非每个版本都经过公证。如果最新版本没有-notarized文件,请在下载中选择一个已公证的版本。 - 在 Host Setup(宿主机设置)中授予开发者工具权限,并安装辅助程序。
- 在 Core Bundle 中点击 Download and Install(下载并安装)。
- 在 Machines(虚拟机)中点击 New Machine(新建虚拟机),选择固件组合,然后点击 Create(创建)。
Launchpad 会下载固件、打补丁、恢复系统并启动虚拟机。要使用自己的 iPhone 和 cloudOS IPSW,请参阅兼容性。
让 Agent 代劳
如果你在这台 Mac 上使用编程 Agent(Claude Code、Codex 等),可以直接粘贴下面的提示词,不必手动操作。Agent 会读取 vphone skill,检查哪些已经设置好,安装 Launchpad 和 VPhone.bundle;遇到需要你处理的步骤(例如输入管理员密码,或在 macOS 恢复中进行更改)时会停下来询问。
在这台 Mac 上设置 vphone。先阅读这个 skill:
https://raw.githubusercontent.com/Lakr233/vphone-cli/main/Skills/vphone-guest-control/SKILL.md
以及它在 references/(同一目录)下链接的文件,然后照着做:
安装最新的已公证 vphone-launchpad(并非每个 release 都有 -notarized 压缩包),
把 vphone-launchpad-cli 加到 PATH,安装与 Launchpad 系列一致的 VPhone.bundle,
并运行 `vphone-launchpad-cli status` 检查。不要修改 SIP、boot-args 或任何其他
宿主机安全设置;在我确认固件和可用磁盘空间之前,不要创建虚拟机。遇到需要我
操作的步骤,请准确告诉我该做什么,然后等待。
后续步骤
- 在虚拟机中安装软件包管理器:软件包环境。
- 在终端中管理虚拟机,或不用 Launchpad 创建虚拟机:创建与运行虚拟机。
- 通过 HTTP 和 WebSocket 编写脚本控制虚拟机:自动化 API。
- 遇到问题:故障排查。