From 02d6041dc203ef27d5ddb01cce99fd90e6c9198e Mon Sep 17 00:00:00 2001 From: vsaint1 Date: Sat, 23 May 2026 06:16:17 -0300 Subject: [PATCH] feat: ios guide device/simulator --- examples/iOS/README.md | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 examples/iOS/README.md diff --git a/examples/iOS/README.md b/examples/iOS/README.md new file mode 100644 index 000000000..3eca0a105 --- /dev/null +++ b/examples/iOS/README.md @@ -0,0 +1,42 @@ +# raylib Breakout demo + +This example is generated with CMake and opened in Xcode. Use the simulator or a real device by changing the Apple SDK you target. + +## Requirements + +- macOS with Xcode installed +- CMake 3.18 or newer +- iOS Simulator support from Xcode, or a connected iPhone/iPad for device testing +- An Apple developer signing team if you want to run on a real device +- Min. iOS API 13 + +## Generate the Xcode project + +From this folder, run: + +```sh +cmake -S . -B build -G Xcode -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_SYSROOT=iphonesimulator +``` + +This generates `build/raylib_ios_example.xcodeproj`. + +## Run in the iOS Simulator + +1. Open `build/raylib_ios_example.xcodeproj` in Xcode. +2. Select an iPhone Simulator destination. +3. Build and run the `raylib-ios-example` scheme. + +## Run on a real iPhone or iPad + +1. Regenerate the project for the device SDK: + +```sh +cmake -S . -B build -G Xcode -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_SYSROOT=iphoneos +``` + +2. Open the generated Xcode project. +3. Select your connected device. +4. Set a valid signing team in Xcode if needed. +5. Build and run the same `raylib-ios-example` scheme. + +