Henge README

项目的 README,来自 github.com/Leviidev/Henge。合并为一个 markdown 文件:README.md。

Henge

Henge

macOS on your iPhone and iPad.

Install · How it works · Website · Releases

Downloads GPL-2.0-or-later

Download macOS, install it on the device, and use it.

On an iPhone 17 Pro, macOS reaches the lock screen in about 15 seconds. Discord installs, opens in about 15 seconds, logs in and sends messages.

Install

Sideload Henge.ipa from Releases with SideStore or AltStore, or install Henge.tipa with TrollStore or TrollStore Lite. To get updates in SideStore or AltStore, add Henge's source, https://raw.githubusercontent.com/Leviidev/Henge/main/repo.json, or https://itslevii.dev/repo.json for all of Leviidev's apps. iOS or iPadOS 17 or later, on an A14 or M1 chip or newer. So far it's tested only on an iPhone 17 Pro: iPad support is new and hasn't run on a real iPad yet.

Then open the Install tab, pick macOS Sequoia 15.6.1, and keep Henge open with the device plugged in. Tahoe 26.6.2 and macOS 27.2 are offered too: both install and run on an iPhone 17 Pro, though Tahoe's first setup is slow and macOS 27 is the slowest (Safari's pages may stay blank on it). Sonoma 14.6.1 and Ventura 13.6 are smaller downloads (14.1 and 12.3 GB) for devices short on storage: they install, set up, and run Safari (both tested on an iPhone 17 Pro). Monterey isn't offered yet: it installs, but its desktop never appears.

Sharing with the Mac

Do this once for each Mac: open Terminal on the Mac, then in Henge open Details and tap Type the Set Up Command. Press Return on the Mac, and choose Allow when macOS asks about henge-agent and local networks. It needs the Mac's keyboard layout to be U.S.

Then a Henge folder in the Mac's home folder is the same folder as Files › Henge › Shared. What you copy on the Mac is copied on the device too, and the paste button pastes from the device into the Mac.

Known limits

Screenshots

Discord on an iPad
iPad
Macs
Macs
Trackpad
Trackpad
Install macOS
Install macOS

Captured on a Mac: the app's own screens with sample data, at iPad and iPhone sizes, showing a frame from Henge's renderer.

Building

To use Henge, install the latest release. Every change lands on main as it's made, so main can be unfinished between releases.

On a Mac with Xcode 27 or later and xcodegen. Henge takes StikJIT, on-device pairing, libslirp and glib from a built Husk checkout at ~/Documents/Coding/Husk (set HUSK to use another path):

ios/scripts/fetch_deps.sh
tools/build_ios_restore.sh
make ios-lib
ios/scripts/package_ipa.sh

That produces ~/Desktop/Henge.ipa, and package_ipa.sh --trollstore writes Henge.tipa.

make builds the engine for the Mac, build/hengevm, and make test runs its tests.

Licence

GPL-2.0-or-later. Henge compiles in usbmuxd (GPLv2 or GPLv3) and code from Husk (GPL-2.0-or-later), so the shipped binary is a combined GPL work. It cannot go on the App Store. See docs/licensing.md.

macOS and the Mac's boot ROM are Apple's and aren't part of Henge. Henge downloads both from Apple when you install.

Henge (Leviidev/Henge)

正在搜索数据库…

2.4K ·GitHub
这是什么?Henge 可以在 iPhone 或 iPad 上运行 macOS。它是独立的模拟器,拥有自己的 JIT、MMU 和设备模拟,并直接在设备上从 Apple 的恢复镜像安装 macOS。
这是 Mac 应用还是手机应用?它是一款需要安装在设备上的 iOS/iPadOS 应用。macOS 本身是 Apple 的软件,Henge 会在安装过程中下载它。
怎么才能让它运行起来?用 SideStore 或 AltStore 侧载 Releases 中的 Henge.ipa,或者用 TrollStore 或 TrollStore Lite 安装 Henge.tipa。然后打开「Install」标签页,选择 macOS Sequoia 15.6.1,并在设备连接电源的情况下保持 Henge 处于打开状态。
安装前需要准备什么?需要 iOS 或 iPadOS 17 或更高版本,设备芯片为 A14 或 M1 及更新的型号;还需要一种 JIT 方案,例如 StikDebug,或 Henge 内置的 StikJIT 辅助工具(需要 iOS 26 或更高版本);另外需要约 43 GB 的可用存储空间。安装过程不需要 Mac。
主要有哪些限制?由于是模拟运行,速度比真正的 Mac 慢。在 macOS 中登录 Apple 账户会因验证错误而失败,并且每次启动只能运行一台 Mac。
目前在哪些设备上测试过?目前只在 iPhone 17 Pro 上测试过。iPad 支持是新增功能,尚未在真正的 iPad 上运行过。
它是免费的吗?能上架 App Store 吗?它采用 GPL-2.0-or-later 许可证,可以免费使用。由于发布的二进制文件将 usbmuxd 和 Husk 的代码合并为一个 GPL 作品,因此无法上架 App Store。
能连接外接显示器吗?可以。在运行 Mac 的过程中,通过支持视频输出的 USB-C 线缆或 USB-C/HDMI 扩展坞连接的显示器会自动接管画面,同时设备保留触控板和键盘的控制功能。USB-C 视频输出仅在运行 iOS 27 的 iPhone 17 Pro 上得到用户确认。
为什么要自己开发模拟器,而不用 QEMU?iOS 不向应用提供虚拟化管理程序(hypervisor),因此 Henge 通过自己的 JIT 运行 Mac 的 arm64 代码,并配有自己的 MMU 和设备模拟。它不使用 QEMU 或 Virtualization.framework。
macOS 在手机上启动要多久?在 iPhone 17 Pro 上,macOS 大约 15 秒即可进入锁屏界面。Discord 安装后约 15 秒即可打开,并可以登录和发送消息。
有哪些类似的项目?Madeira, Husk, totk-mobile, nxnative, Wind-Waker-Recomp, S2Arm, UTM, Stela
作者
Leviidev
大小
8 MB
星标
2.4K
时长
16天
提交 · 90 天