u53r55 / ipasim

iOS emulator for Windows

ipasim

This repository contains source code of ipasim, an iOS emulator for Windows. More detailed documentation is available.

Cloning the repository

We use Git Submodules (recursively), so make sure you clone with --recurse-submodules. We also use Git LFS, so make sure you have that installed if you want to get all files.

Building and installation

If you want to use the emulator, you can either build it from sources (that's slow), use partially prebuilt artifacts (that's fast and recommended if you want to make changes; however, you still need to have Docker and Visual Studio installed) or just use prebuilt binaries (recommended if you don't want to make changes).

Directory structure

• deps contains third-party dependencies (mostly as Git submodules because patching was necessary).
• docs contains documentation and issues.
• include has C++ headers of the project.
• samples contains sources of sample iOS applications and some other samples.
• scripts contains various scripts, mostly supporting build of the project.
• src contains C++ sources of the project.
  • HeadersAnalyzer is a tool that runs at compile-time, generating supporting code for the emulator.
  • IpaSimulator is the emulator itself.
  • objc contains our port of Apple's Objective-C runtime to Windows.

Executive summary