Building and installing Radium dependencies once for all

We provide a standalone cmake project (Radium-Engine/external/CMakeLists.txt) to compile and install the Radium dependencies at any location.

Configuration and compilation of the dependencies

For command line, tested on Linux and mac OS, for windows might need more configuration options.

External dependencies have to be installed outside Radium-Engine source tree.

# from wherever you want outside radium source tree
# in release
cmake -S Radium-Engine/external -B builds/radium-external-build-r -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=installs/radium-external-r
cmake --build builds/radium-external-build-r --config Release --parallel
 
# in debug
cmake -S Radium-Engine/external -B builds/radium-external-build-d -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=installs/radium-external-d
cmake --build builds/radium-external-build-d --config Debug --parallel

If not given on the command line, the installation directory is set by default to Radium-Engine/{CMAKE_CURRENT_BINARY_DIR}/Bundle-${CMAKE_CXX_COMPILER_ID} for CMAKE_BUILD_TYPE=Release, and Radium-Engine/{CMAKE_CURRENT_BINARY_DIR}/Bundle-${CMAKE_CXX_COMPILER_ID}-${CMAKE_BUILD_TYPE} for any other CMAKE_BUILD_TYPE.

Command line instructions (linux, macos, windows)

For command line, tested on Linux and mac OS, for windows might need more configuration options.

Follow the usual sequence, assuming you have build dependencies as explained here:

cmake -S Radium-Engine -B builds/radium-build-r -DCMAKE_BUILD_TYPE=Release -C installs/radium-external-r/radium-options.cmake
cmake --build builds/radium-build-r --config Release --parallel -DQt5_DIR=path/to/qt5
cmake --install builds/radium-build-r

If Qt is installed system wide (likely on linux), -DQt5_DIR is not needed.

Note: Qt6 is also supported. To enable it, replace -DQt5_DIR=path/to/qt5 by -DQt6_DIR=path/to/qt6. To ease maintenance accross Qt versions, you should also configure the path to Qt cmake package using -DCMAKE_PREFIX_PATH=path/to/qtX where X is the Qt version you want to use.

If both Qt5 and Qt6 are installed system wide, Qt6 is the default, -DQT_DEFAULT_MAJOR_VERSION=5 allow select Qt5. During client application cmake setup find_package(Radium COMPONENTS ... Gui ...) will check Qt version consistency.

Note: Running cmake --install is recommended as it will copy all the radium related library in the same place, generate the cmake packages and bundle applications with their dependencies (on macos and windows).