Installing PPSSPP on iOS 11 isn't particularly hard but does require several steps which can be mildly daunting for non-developers or non-iOS developers. I based this guide off of the official guide but realized it provided scant details to troubleshoot any issues.

Important support disclaimer

PPSSPP, as of writing this is, not officially supported on iOS 11. Videos on youtube claiming iOS 11 PSP emulation are generally posted around 2015 or 2016 running iOS9/iOS10, well before even the iOS 11 beta with updated titles to garner views. The emulator, Happy Chick, often featured in these YouTube videos, also does not support iOS 11, which also uses the PPSSPP core. PPSSPP will launch but it will be unable to load a game. This guide should be accurate if/when PPSSPP gains 64 bit dynarec support. If there are changes to PPSSPP's install process, I'll be sure to update the guide. If you are interested in a fully functional emulator for iOS 11, I have a guide for installing Provenance, which supports a host of 8 bit and 16 bit era consoles.

These instructions should work for iOS 9 / iOS 10 devices as well.

For more information about Emulation on iOS, please see my very extensive guide iOS Emulation, gamepads, Cydia, Xcode, - A Tutorial for iOS emus. It's geared as primer for iOS emulation and the various ways emulators can be installed on iOS.



Building iOS applications requires installing Xcode, so if you haven't installed Xcode or updated to Xcode 9.0, download it. Once installed, launch Xcode and then launch a terminal session. Run the following to install the CLI utilities for Xcode.

xcode-select --install

If you do not have an Apple developer ID, you will need to create one.

Step 1 Confirm MacPorts is installed

port version

If you get an error message or about version matching or command not found, Go to MacPorts Releases and download the version of macports that matches your OS version.

Step 2

Navigate in your terminal to the directory you'd like install the project to.

Run in your terminal: (this may take a bit depending on your internet connection)

git clone

After its installed navigate into your newly cloned repository,

cd ppsspp

Next from ppsspp directory run the following:

git submodule update --init --recursive

Step 4

Next we want to create the PPSSPP.xcodeproj and dependencies in an directory called build-ios. This will take a bit.

mkdir build-ios
cd build-ios
cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/ios.cmake -GXcode ..

If you get an error:

Error: Current platform "darwin 16" does not match expected platform "darwin 15"
Error: If you upgraded your OS, please follow the migration instructions:
OS platform mismatch
    while executing

The above error means you have the incorrect version of MacPorts. Go to the link listed above and download and install it.

Step 4

Open up PPSSPP.xcodeproj in the build-ios folder in Xcode.

Codekit settings

Select in the menu, the PPSSPP app icon, instead of ALL_BUILD. If you do not do this, you will not successfully build the app. Next Under Project -> Build For, select running.

Plug in your iPhone or iPad into your computer and select the target as your device instead of a simulator.

If you hit build, mostly likely you will get a provisioning error. Assign it to your developer ID. If you haven't added your developer ID, go to Xcode -> Preferences -> Accounts, and add your developer profile. In the general tab of the PPSSPP project assign your developer profile to the Signing section.

Hit build. If Xcode errors out abt the bundle identifier, give a random string after the .org name.

properly configured Xcode project for PPSSPP

Image: Properly configured PPSSPP project requires the fields to be set.

Step 5

PPSSPP on phone

You should now see PPSSPP on your iOS device.

Untrusted Developer

If you encounter the error, Untrusted Developer: "your device management setting do not allow using apps from developer... on this iPhone. You can allow using these apps in Settings."

Go to Settings -> General -> Profiles & Device Managment and under developer App, tap your profile to allow apps.

Congrats, you're now ready to use PPSSPP. Note, as of writing this, PPSSPP's iOS 11 support appears to be incomplete. PPSSPP will launch but freezes when gamesattempt to load due to the dynamic recompiler not being 64 bit.

2017-10-23: Added support disclaimer.