SDL 3.0
|
(www.cmake.org)
The CMake build system is supported on the following platforms:
Assuming the source for SDL is located at ~/sdl
.
This will build SDL in the ~/build
directory. Installation can be done using:
This will install SDL to /usr/local.
SDL can be included in your project in 2 major ways:
The following CMake script supports both, depending on the value of MYGAME_VENDORED
.
For CMake to find SDL, it must be installed in a default location CMake is looking for.
The following components are available, to be used as an argument of find_package
.
Component name | Description |
---|---|
SDL3-shared | The SDL3 shared library, available through the SDL3::SDL3-shared target |
SDL3-static | The SDL3 static library, available through the SDL3::SDL3-static target |
SDL3_test | The SDL3_test static library, available through the SDL3::SDL3_test target |
SDL3 | The SDL3 library, available through the SDL3::SDL3 target. This is an alias of SDL3::SDL3-shared or SDL3::SDL3-static . This component is always available. |
Headers | The SDL3 headers, available through the SDL3::Headers target. This component is always available. |
This only requires a copy of SDL in a subdirectory.
By default, CMake provides 4 build types: Debug
, Release
, RelWithDebInfo
and MinSizeRel
. The main difference(s) between these are the optimization options and the generation of debug info. To configure SDL as an optimized Release
library, configure SDL with:
To build it, run:
CMAKE_<LANG>_FLAGS
to pass extra flags to the compiler.CMAKE_EXE_LINKER_FLAGS
to pass extra option to the linker for executables.CMAKE_SHARED_LINKER_FLAGS
to pass extra options to the linker for shared libraries.build a SDL library optimized for (more) modern x64 microprocessor architectures.
With gcc or clang:
With Visual C:
CMake 3.14+ natively includes support for iOS and tvOS. SDL binaries may be built using Xcode or Make, possibly among other build-systems.
When using a recent version of CMake (3.14+), it should be possible to:
To use, set the following CMake variables when running CMake's configuration stage:
CMAKE_SYSTEM_NAME=<OS>
(either iOS
or tvOS
)CMAKE_OSX_SYSROOT=<SDK>
(examples: iphoneos
, iphonesimulator
, iphoneos12.4
, /full/path/to/iPhoneOS.sdk
, appletvos
, appletvsimulator
, appletvos12.4
, /full/path/to/AppleTVOS.sdk
, etc.)CMAKE_OSX_ARCHITECTURES=<semicolon-separated list of CPU architectures>
(example: "arm64;armv7s;x86_64")for iOS-Simulator, using the latest, installed SDK:
for iOS-Device, using the latest, installed SDK, 64-bit only
for iOS-Device, using the latest, installed SDK, mixed 32/64 bit
for iOS-Device, using a specific SDK revision (iOS 12.4, in this example):
for iOS-Simulator, using the latest, installed SDK, and building SDL test apps (as .app bundles):
for tvOS-Simulator, using the latest, installed SDK:
for tvOS-Device, using the latest, installed SDK:
for QNX/aarch64, using the latest, installed SDK: