khanhduytran0/LiveSimBooter

选用指南

AI 根据 README 整理 · 2026/10/28 17:22:01

适用场景

适用于在未越狱的iPhone上运行iOS模拟器，进行应用启动测试、图形显示验证等场景。

查看 README 依据

# LiveSimBooter An experimental native iPhone host for an arm64 iOS Simulator runtime. The native app owns UIKit, process launches, and display/input services; simulator programs run in separate LiveProcess instances using the device’s kernel. It does not emulate a CPU or boot a separate kernel. See [the architecture](docs/architecture.md) for the process boundaries. ## Setup Start with the [agent-assisted setup guide](docs/agent-setup.md) and [AGENTS.md](AGENTS.md). The supported guest baseline is **iOS Simulator 26.0, build 23A343**. Runtime patches and private interfaces are pinned

Guest `launchctl` can manage individual jobs and request a simulator userspace reboot; see [guest control](docs/guest-control.md). The default guest handoff retains the native shared cache and redirects workqueue entry through a hardware breakpoint. Native-cache detachment remains a diagnostic mode, not the normal setup. ## Status and limits The matching runtime has reached SpringBoard with app icons on iPhone18,2 running iOS 27.0 build 24A435. Device tests have verified Contacts, touch and keyboard input, native Metal presentation, interactive Fish, and display settings.

使用方式

通过原生应用界面操作，点击Start启动，支持多标签页切换和参数配置。

查看 README 依据

to that build; a different iOS 26.x or iOS 27 runtime is not an interchangeable input. There is no in-app runtime installer. Supply the original runtime, signing identity, matching provisioning profiles, and device access, then use the tracked setup/build/sign/copy steps. Generated binaries and runtime files stay outside Git. [Device migration](docs/migration.md) covers transfer, App Group discovery, and rollback. ## Running After setup, open the app and tap **Start** on the **IOSurface** tab. Keep the native host in the foreground for baseline use.

The persistent **IOSurface**, **Fish**, and **Settings** tabs share one simulator session; switching tabs does not restart guests. Fish belongs to simulator launchd, and Settings provides the guest performance HUD and touch-marker controls. The [device picker](docs/device-types.md) changes the simulated model and resolution, then restarts the guest session. Silent background audio is optional and disabled by default. Explicit guest arguments, such as `--launchd-services` or `/bin/df`, retain automatic startup for development tests.

部署要求

需要Apple Silicon Mac和Xcode进行构建，支持特定的iOS Simulator 26.0运行时版本，且需要原始运行时、签名身份、配置文件等。

查看 README 依据

to that build; a different iOS 26.x or iOS 27 runtime is not an interchangeable input. There is no in-app runtime installer. Supply the original runtime, signing identity, matching provisioning profiles, and device access, then use the tracked setup/build/sign/copy steps. Generated binaries and runtime files stay outside Git. [Device migration](docs/migration.md) covers transfer, App Group discovery, and rollback. ## Running After setup, open the app and tap **Start** on the **IOSurface** tab. Keep the native host in the foreground for baseline use.

Use the setup guide for current commands; older notes describe earlier cache layouts and device configurations. ## Development checks On an Apple Silicon Mac with Xcode: ```sh sh Tests/run.sh python3 Tests/audit-local-runtime.py ``` Build the native host and guest shim separately using [the setup guide](docs/agent-setup.md). Local tests do not establish device signature acceptance, working mappings, or a successful UI operation. ## License Original project code is available under the [MIT License](LICENSE), copyright 2026 Duy Tran.

已知限制

未实现通用fork/execve、原生PTY等，部分功能如锁屏壁纸渲染存在缺陷，属于部分模拟器环境。

查看 README 依据

App launching also passed a cold-start check and two consecutive userspace reboots; these results do not establish complete app compatibility. Home Screen → Edit → Edit Wallpaper supports color/gradient rendering. PosterBoard’s lock-screen path and direct activation remain broken with black output; the editor’s clipped Done button is also deferred. See [wallpaper status](docs/springboard-services.md#current-wallpaper-status). Generic `fork`/`execve`, native PTYs, stopped/continued wait events, and full job control are not implemented.

The supported process-replacement path uses `POSIX_SPAWN_SETEXEC`. Missing daemons, resources, and private API differences still limit applications; the observed Spotlight last-character crash is deferred. This remains a partial simulator environment. ## Documentation - [Architecture](docs/architecture.md) and [runtime handoff](docs/runtime-handoff.md): loading, callbacks, threads, and debugger metadata. - [Processes](docs/multiprocess.md), [launchd](docs/launchd.md), and [SpringBoard services](docs/springboard-services.md): lifecycle and compatibility.