cmake_find_package

This is the reference page for cmake_find_package generator. Go to Integrations/CMake if you want to learn how to integrate your project or recipes with CMake.

The cmake_find_package generator creates a file for each requirement specified in the conanfile.

The name of the files follow the pattern Find<package_name>.cmake. So for the zlib/1.2.11@conan/stable package, a Findzlib.cmake file will be generated.

Variables in Find{name}.cmake

Being {name} the package name:

NAME VALUE
{name}_FOUND Set to 1
{name}_INCLUDE_DIRS Containing all the include directories of the package
{name}_INCLUDES Same as the XXX_INCLUDE_DIRS
{name}_DEFINITIONS Definitions of the library
{name}_LIBRARIES Library paths to link
{name}_LIBS Same as XXX_LIBRARIES

Target in Find<package_name>.cmake

A target named {name}::{name} target is generated with the following properties adjusted:

  • INTERFACE_INCLUDE_DIRECTORIES: Containing all the include directories of the package.
  • INTERFACE_LINK_LIBRARIES: Library paths to link.
  • INTERFACE_COMPILE_DEFINITIONS: Definitions of the library.

The targets are transitive. So, if your project depends on a packages A and B, and at the same time A depends on C, the A target will contain automatically the properties of the C dependency, so in your CMakeLists.txt file you only need to find_package(A) and find_package(B).