Add CMakePresets.json

[DownerCase]

Description

Adds CMakePresets.json with the most common user-facing build profiles:

• core: Minimal build. Focuses on building just the core libraries and nothing else.
• wheel: Builds the Python wheel.
  • Simplifies building the wheel to: cmake --preset wheel && cmake --build --preset wheel
• cli: Extends core to include the CLI/TUI applications
• gui: Extends cli to include the QT GUI applications too
• docs: Extends wheel to also build the Sphinx documentation
  • Made much more ergonomic to use via CMake: automatic venv creation for docs #1359 so you don't need to set up the documentation virtual environment

I did not include a "full" build, testing, or C# presets as I was focusing on the most common feature levels users (from my perspective) would want. These presets should evolve over time to meet end-user, contributor, and developer needs.

With this PR it is much easier to build the different feature levels; especially for users that may not want a complete build.

Additionally, users may write their own "CMakeUserPresets.json" to extend the set of presets with something tailored to their use and preference. ( I, personally, will be using this feature)

Lastly, IDEs, such as Visual Studio, understand CMakePresets and allow for quickly switching between the different presets, aiding development and checking the different feature levels.

Technical notes

The builds default the CMAKE_BUILD_TYPE to Release to prevent the combinatorial explosion of having explicit debug/release(/relwithdebinfo/minsizerel) presets.
This is only relevant for single-config generators (like "Unix Makefiles" or regular "Ninja") and does not affect "Visual Studio *" or "Ninja Multi-Config" generators.

This PR includes a CMake option to default BUILD_SHARED_LIBS to OFF only on "win32" builds. This setting is always required when building with MSVC due to the current DLL situation.
I do not define BUILD_SHARED_LIBS on non-win32 builds to match existing behaviour.

I bumped the minimum CMake version of CMakeFunctions solely because it was giving a deprecation message about support for CMake < 3.5.

CMake Preset documentation

Related issues

• closes CMake Presets #528

Cherry-pick to

• Whatever the team is happy for, it would be nice to have for 5.13 but you will have to change HAS_QT back to HAS_QT5. I don't think any other changes would be needed.

[KerstinKeller]

Why does it have to be set explicitly? BUILD_SHARD_LIBS is already a CMake option, defaulting to OFF on Windows platforms?

[DownerCase]

I believe the cURL submodule was turning it on if it wasn't set causing problems for eCAL as curl goes first. This also matches what is done elsewhere in the project ([1], [2]) where BUILD_SHARED_LIBS is explicitly set OFF for Windows.

[DownerCase]

And this isn't in the CMakePresets because then you'd need separate Windows and non-Windows presets to handle the mandatory platform-dependent setting. The presets themselves don't handle platform dependent things very well. Its best at setting high-level options which the build system understands and can do what you ask (like handling whether BUILD_SHARED_LIBS needs to be set on your platform or which thirdparty submodules to build from source)

[FlorianReimold]

Thanks for this PR! 👍