CMake find package

[alxvth]

Installs ManiVaultTargets.cmake, ManiVaultConfig.cmake and related cmake packages files such that ManiVault can be found using find_package.

The ExamplePlugins, BinIO and SpectralViewer plugins show how this looks from a plugins perspective:

find_package(ManiVault COMPONENTS Core PointData ClusterData ImageData CONFIG)
target_include_directories(${MyPlugin} PRIVATE "${ManiVault_INCLUDE_DIR}")
target_link_libraries(${MyPlugin} PRIVATE ManiVault::Core ManiVault::PointData ManiVault::ClusterData ManiVault::ImageData)

The variables ManiVault_INCLUDE_DIR, ManiVault_INSTALL_DIR, ManiVault_LIB_DIR, ManiVault_LINK_LIBS and ManiVault_VERSION are automatically set in CONFIG mode.

For CMake to find the package, you need to define a path ManiVault_DIR that point to where the ManiVaultConfig.cmake lies. After building the core, this will be MV_INSTALL_DIR/cmake/mv, i.e. will now be a cmake folder next to the Debug, Release, etc. config folder in the install directory.

Since ManiVault is installed into a bit of a non-standard directory layout, I couldn't yet figure out how to set INTERFACE_INCLUDE_DIRECTORIES correctly, meaning that the target_include_directories have to be set explicitly. (Ideally only the target_link_libraries should be necessary).

You can also specify versions:

find_package(ManiVault 1 COMPONENTS Core PointData CONFIG)    # Ok
find_package(ManiVault 2 COMPONENTS Core PointData CONFIG)    # Won't work, we are at version 1

When using the core and plugins in a project with add_subdirectory (like in the DevBundle), the find package command must not use the REQUIRED argument.

TODO:

• find_package on CI
• Compatibility with add_subdirectory, as used in DevBundle
• Test on Windows (msvc)
• Test on Linux (gcc)
• Test on MacOS (apple clang)
• rebase to current master

[sbvis]

I built and ran the core and the ExamplePlugins, BinIO and SpectralViewer plugins on macOS. It was built correctly and ran correctly. Please see the screenshot below.

[sbvis]

It build and ran successfully and I also see a cmake folder next to the Release.

[ThomasKroes]

Works on Win11

[alxvth]

Nice, thanks for testing this! :)