95 lines
2.5 KiB
Markdown
95 lines
2.5 KiB
Markdown
## 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 both Intel and ARM
|
|
|
|
* Install [Visual Studio 2022 and Swift toolchain][vs]
|
|
* Install App Runtime
|
|
|
|
`winget install --id Microsoft.WindowsAppRuntime.1.5 -e --source winget`
|
|
|
|
* Enable developer mode
|
|
|
|
Settings -> System -> Advanced -> Developer Mode: On (see the screenshot above)
|
|
|
|
* Install Git Bash
|
|
|
|
`winget install --id Git.Git -e --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: aarch64-unknown-windows-msvc
|
|
Build config: +assertions
|
|
```
|
|
|
|
## 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
|