Prerequisites
Android
- Install Android Studio Quail 3 (2026.1.3)
iOS
-
Install Xcode 26
-
Install XcodeGen
brew install xcodegen -
Get ghera's raylib-ios-xcframeworks
Unpack and place it alongside the project
Linux
-
Install Ubuntu 24.04
-
Install Swiftly + Swift (installed by Swiftly)
-
Install Swift dependencies (proposed by Swiftly after Swift installation)
apt-get -y install binutils git gnupg2 libcurl4-openssl-dev libgcc-13-dev libpython3-dev libstdc++-13-dev libxml2-dev libncurses-dev libz3-dev pkg-config zlib1g-dev -
Install CrossSwiftUI dependency
apt-get -y install libgtk-4-dev
macOS
-
Install Xcode 26
-
Install Raylib 6
brew install raylib
Windows
-
Install Windows 11
Use x64 Windows if you want to target goth Intel and ARM PCs, not ARM only
Windows has PRISM on ARM to launch x64 effortlessly, so stick with x64
-
Enable developer mode
Settings -> System -> Advanced -> Developer Mode: On (see the screenshot above)
-
Install Git Bash
winget install --id Git.Git -e --architecture x64 --override "/DIR=\"C:\Program Files\Git\" /ADDGENERICPORTS=YES /BASH=YES /SYMLINKS=YES" --source wingetWhile in Git Bash installation wizard, select defaults
-
Inside Git Bash: configure Git to use actual symlinks
git config --global core.symlinks true -
Inside GitBash: find the location of
swift.exe$ find /c -name swift.exe /c/Users/mk/AppData/Local/Programs/Swift/Toolchains/6.4.2+Asserts/usr/bin/swift.exe -
Inside Git Bash: to
~/.bash_profileadd Swift location (withoutswift.exe) toPATHexport PATH="$PATH:/c/Users/mk/AppData/Local/Programs/Swift/Toolchains/6.4.2+Asserts/usr/bin" -
Restart Git Bash
-
Make sure Swift compiler is working
$ swift --version Swift version 6.4.2 (swift-6.4.2-RELEASE) Target: x86_64-unknown-windows-msvc Build config: +assertions Segmentation fault swift --versionNever mind the segfault message on ARM: that's normal for running x64 on ARM
Components
| Component | macOS | iOS | Android | Linux | Windows | Description |
|---|---|---|---|---|---|---|
| hp | √ | √ | √ | √ | hello-platform is a simple UI to validate platform support | |
| hrb | hello-raylib is a simple raylib rendering to validate platform support |
