Sideloaded builds read hardware keyboard events from the private UIEvent._gsEvent, at offsets hardcoded for iOS 7 and 9, through a UIApplication subclass. The UIPress path the App Store build uses works from iOS 13.4, so use it in all builds, and delete the hack along with PPSSPPUIApplication and SmartKeyboardMap. System_Vibrate asked the private UIDevice feedbackSupportLevel whether to use the feedback generator, in App Store builds too, and sideloaded builds fell back to the private AudioServicesPlaySystemSoundWithVibration. The feedback generator just does nothing on devices without a Taptic Engine, so always use it. That leaves the iPhone 6s and first SE without virtual button vibration in sideloaded builds. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Updating with a self-built MoltenVK
Probably won't be needed again.
cp -r ../dev/build-molten/MoltenVK/Package/Release/MoltenVK/static/MoltenVK.xcframework ios/MoltenVK
The Old iOS Build Instructions
Important Notes
These instructions have not been updated for a long time and may be outdated.
Prerequisites:
- Xcode (from the Mac App Store) with command line tools installed
- MacPorts (from macports.org); easiest to install with their package installers
- cmake build system (from MacPorts); run "sudo port install cmake" from the command line
If you need to build ffmpeg yourself too, then you'll also need:
-
gas-preprocessor; download the zip from https://github.com/mansr/gas-preprocessor, unzip and from the command line run:
sudo cp gas-preprocessor.pl /usr/bin/ sudo chmod +rw /usr/bin/gas-preprocessor.pl -
you may need pkg-config (from MacPorts); run "sudo port install pkgconfig" from the command line
Most of this is done from the command line:
Change directory to wherever you want to install ppsspp (eg. "cd ~"), and then clone the main ppsspp repository:
git clone https://github.com/hrydgard/ppsspp.git
Change directory to the newly created ppsspp directory and run:
git submodule update --init
The above command will pull in the submodules required by PPSSPP, including the native, ffmpeg, and lang directories. Included in the ffmpeg directory should be the necessary libs and includes for ffmpeg, so most people can skip the next command. However, if you need to recompile ffmpeg for some reason, change directory into ffmpeg and run (this will take a while):
./ios-build.sh
Change directory back up to the main ppsspp directory and do the following:
mkdir build-ios
cd build-ios
cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/ios.cmake -GXcode ..
You now should have an Xcode project file in the build-ios directory named PPSSPP.xcodeproj. Open it up in Xcode and do Product->Build to build the debug version, or Product->Build For->Archiving to build the release version (which is much faster). If your iOS device is plugged in, you may be able to just Run in Xcode to install and test it. Otherwise, copy the PPSSPP app from build-ios/Debug-iphoneos/PPSSPP.app or build-ios/Release-iphoneos/PPSSPP.app to the /Applications directory on your device and from ssh or MobileTerminal do a "chmod +x PPSSPP" inside the PPSSPP.app directory. If this is the first time you've installed the PPSSPP app, you'll have to respring or restart your device for the icon to show up.