10分钟在电脑上看到iOS锁屏:HackiOS的QEMU快速启动完整教程(新手友好)
10分钟在电脑上看到iOS锁屏:HackiOS的QEMU快速启动完整教程(新手友好)
HackiOS(hackios-xnu-kernel)是一个在安卓手机和电脑 QEMU 虚拟机上引导 Apple 开源 XNU 内核、并运行未修改的 iOS 16.5 用户空间的开源项目。本教程带你只用一台 Linux 电脑 + QEMU,就能在屏幕上看到真实的 iOS 16.5 锁屏与主屏,无需任何真机,全程约 10 分钟。
一、为什么值得看这个教程
HackiOS 把 iOS 16.5 完整的启动链(launchd → backboardd → SpringBoard → 应用)搬进了一个普通电脑的虚拟机里:锁屏、滑动解锁、桌面图标、设置、Safari 都能跑。对想学习 iOS 内核、APFS 文件系统或 UEFI 引导的同学来说,这是一个可以随手点开的“活教材”。
下面是项目在真实硬件和 QEMU 中渲染出来的 iOS 界面(Adreno GPU 绘制):
二、环境准备:一键安装步骤
你只需要一台 Linux x86-64 电脑(约 12 GB 空闲磁盘、4 GB 空闲内存),安装以下软件包:
- Arch 系:
sudo pacman -S --needed git python 7zip lz4 gcc qemu-system-aarch64 qemu-ui-gtk edk2-aarch64
- Debian / Ubuntu:
sudo apt install git python3 p7zip-full liblz4-dev gcc qemu-system-arm qemu-efi-aarch64
💡 注意:7-Zip 需要 23 及以上版本,因为它负责读取 Apple 的 APFS 分区;Debian/Ubuntu 的 UEFI 固件路径为
/usr/share/AAVMF/AAVMF_CODE.fd和AAVMF_VARS.fd。
三、获取代码并初始化工作区
git clone https://gitcode.com/gh_mirrors/ha/hackios-xnu-kernel.git hackios
cd hackios
common/setup.sh
common/setup.sh 会做两件事:把配套的 hackios-xnu-userland 仓库拉到同一目录(两个仓库共同构成完整项目),并自动检查本机缺少哪些工具,缺什么一目了然。
项目结构速览(后续命令都用得到):
| 路径 | 作用 |
|---|---|
| common/ | 工作区、构建、启动脚本与设备配置 |
| prebuilt/ | 预编译的内核、EFI loader、UEFI,免编译直接可用 |
| qemu/ | QEMU 运行脚本、触屏模拟与截图工具 |
| xnuloader/ | 自研 EFI 引导加载器源码 |
四、下载并构建 iOS 16.5 系统镜像
仓库里不包含任何 Apple 文件。系统镜像由脚本从 Apple 官方 CDN 下载 iOS 16.5 的 IPSW(约 7.4 GB,5~15 分钟)并提取所需内容,全部在你本地完成:
ios165/fetch.sh # 首次执行,下载并解包
common/build.sh qemu-virt # 构建 APFS 系统镜像
设备配置来自 common/devices/qemu-virt.conf:默认 4 核、20 分钟会话时长,无需任何改动。
五、启动 QEMU,见证 iOS 锁屏
common/run.sh qemu-virt
这条命令等价于依次执行 qemu/run-ios.sh 与 qemu/run.sh:把预编译内核 prebuilt/mach.development.bcm2837 和 APFS 镜像打进内存,再用 qemu-system-aarch64(virt 机型 + GICv3 + UEFI)引导。约 2~3 分钟后,QEMU 窗口里就会出现 iOS 锁屏。
如何操作这个“手机”
- 🖱️ 鼠标按住左键拖动 = 手指:从屏幕最底边向上滑 = 解锁/回到桌面;从左边沿向内滑 = 返回
- ⌨️ 快捷键:
H= Home、L= 锁屏/电源、↑/↓= 音量 - 脚本操作:
qemu/touch.py tap 0.615 0.71(点击)、qemu/touch.py swipe 0.5 0.985 0.5 0.3 250(滑动)、qemu/screendump.sh shot.png(截图)
⏳ SpringBoard 刚出现时系统还在注册应用,耐心等待 30~40 秒再点图标,否则部分 App 会闪退。
六、常见问题排查
| 现象 | 原因与解决 |
|---|---|
no images: run common/build.sh ... |
还没构建镜像,先执行 common/build.sh qemu-virt |
no UEFI firmware at ... |
Debian/Ubuntu 设置 QEMU_EFI=/usr/share/AAVMF/AAVMF_CODE.fd QEMU_VARS=/usr/share/AAVMF/AAVMF_VARS.fd |
only xxx MB of memory available |
宿主机可用内存不足 3 GB,关闭其他 QEMU 实例 |
| 窗口看不到画面 | 确认安装了 qemu-ui-gtk / qemu-system-arm 的 GTK 显示支持 |
更多启动细节见 qemu/run-ios.sh 头部注释,设备移植方法见 docs/PORTING.md,自检技巧见 docs/checks.md。
七、写在最后
至此,你已经在一台普通 Linux 电脑上跑通了 XNU 内核 + 未修改 iOS 16.5 用户空间的完整组合。后续可以继续尝试:QEMU_NET=1 开启 virtio 网络、AUDIO 环境变量接出 iOS 声音、RC_JOBS=rc.jobs.tour 构建自动解锁并逐个打开应用的演示镜像——HackiOS 的魅力,正在于它把整套 Apple 启动链路变成了可以逐行阅读、反复点亮的开源实验台。

