I don't know what the argument COMPONENT
of the install()
command means, and I don't understand the CMake documentation for this. What is it in more detail?
What would an example be?
I don't know what the argument COMPONENT
of the install()
command means, and I don't understand the CMake documentation for this. What is it in more detail?
What would an example be?
You can group installation targets into components, for example, "docs", "libs", "runtime", etc.
add_library(libone libone.c)
add_executable(one main1.c)
install(TARGETS libone one DESTINATION /somedir COMPONENT comp_one)
add_library(libtwo libtwo.c)
add_executable(two main2.c)
install(TARGETS libtwo two DESTINATION /somedir COMPONENT comp_two)
This makes it possible to run cmake -DCOMPONENT=comp_one -P {your_build_dir}/cmake_install.cmake
to install only the libone
library and the one
executable. When you issue make install
all components are installed.
cmake
invocation is the only way to do it. But you can wrap it into target using add_custom_target(TARGET install_one COMMAND ${CMAKE_PROGRAM} -DCOMPONENT=comp_one -P {CMAKE_BINARY_DIR}/cmake_install.cmake
and then use make install_one
.
cmake --install <dir> --component <component>
since 3.15. Could you add this to your answer?
There are three ways you can use the install
command in CMake:
Install an executable
INSTALL(TARGETS ExecutableTarget RUNTIME DESTINATION FOLDER_LOCATION)
Install a static library
INSTALL(TARGETS StaticLibraryTarget ARCHIVE DESTINATION FOLDER_LOCATION)
Install dynamic library
INSTALL(TARGETS SharedLibraryTarget LIBRARY DESTINATION FOLDER_LOCATION)
COMPONENT
keyword. This answer demonstrates three kinds of targets which is an orthogonal concept.
Jul 8, 2015 at 20:31