Simple find_package config file example

by

Don’t write a config yourself; use CMake’s export command. It’s too broad to cover here in its entirety, but here’s a modified example from one of my projects:

install(TARGETS
        your_target
    EXPORT YourPackageConfig
    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)
export(TARGETS
        your_target
    NAMESPACE YourPackage::
    FILE "${CMAKE_CURRENT_BINARY_DIR}/YourPackageConfig.cmake"
)
install(EXPORT
        YourPackageConfig
    DESTINATION "${CMAKE_INSTALL_DATADIR}/YourPackage/cmake"
    NAMESPACE YourPackage::
)

This will create the config file for you, so other projects can use it via find_package.

find_package(YourPackage REQUIRED)
target_link_libraries(foo YouprPackage::your_target)

This handles the IMPORTED targets automatically, and also lets you embed compiler flags, include paths, library dependencies, and even which files are part of your interface (basically, anything that falls under the INTERFACE properties).

More Related Contents:

  1. CMake link to external library
  2. Hinting Find.cmake Files with a custom directory
  3. What’s the CMake syntax to set and use variables?
  4. Is it better to specify source files with GLOB or each file individually in CMake?
  5. CMake does not find includes / libraries
  6. CMake + GoogleTest
  7. How to specify a compiler in CMake?
  8. Passing compiler options cmake
  9. What use is find_package() when you need to specify CMAKE_MODULE_PATH?
  10. How do I change the working directory for my program
  11. Why add header files into ADD_LIBRARY/ADD_EXECUTABLE command in CMake
  12. CMake : How to get the name of all subdirectories of a directory?
  13. MacOS, CMake and OpenMP
  14. What is CMake equivalent of ‘configure –prefix=DIR && make all install ‘?
  15. Making a CMake library accessible by other CMake packages automatically
  16. CMake: How to build external projects and include their targets
  17. cmake: Selecting a generator within CMakeLists.txt
  18. Set CFLAGS and CXXFLAGS options using CMake
  19. Passing compiler options in CMake
  20. Setting CMAKE_INSTALL_PREFIX from CMakeLists.txt file
  21. Tell CMake to use C++ compiler for C files coming from CMake?
  22. spacing in -D option in cmake
  23. Using CMake, how do I get verbose output from CTest?
  24. Difference between add_compile_options and SET(CMAKE_CXX_FLAGS…)
  25. How to configure Eclipse CDT for cmake?
  26. CMake : Changing name of Visual Studio and Xcode exectuables depending on configuration in a project generated by CMake
  27. Passing compiler options in CMake command line
  28. How to strip trailing whitespace in CMake variable?
  29. Linking GLEW with CMake
  30. How to print all the properties of a target in cmake?

Leave a Comment