## 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][rzip] Unpack and place it alongside the project ### Linux * Install Ubuntu 24.04 * Install [Swiftly][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 ![Developer mode][w11-dev-mode] * 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 * Install [Visual Studio 2022 and Swift toolchain][vs] * 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 winget` While 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_profile` add Swift location (without `swift.exe`) to `PATH` `export 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 --version ``` Never mind the segfault message on ARM: that's normal for running x64 on ARM ## Components | Component | macOS | iOS | Android | Linux | Windows | Description | | --- | --- | --- | --- | --- | --- | --- | | hp | √ | √ | √ | √ | | **h**ello-**p**latform is a simple UI to validate platform support | | hrb | | | | | | **h**ello-**r**ayli**b** is a simple raylib rendering to validate platform support | [rzip]: https://github.com/ghera/raylib-iOS/releases/download/6.2.0-iOS/raylib-ios-xcframeworks-6.2.0-iOS.zip [swiftly]: https://www.swift.org/install/linux/ [vs]: https://www.swift.org/install/windows/ [w11-dev-mode]: docs/img/w11-dev-mode.jpg