UsePkgConfig

Load this module in a CMake project with:

include(UsePkgConfig)

Commands

This module provides the following command:

pkgconfig

Finds external package using pkg-config and sets result variables:

pkgconfig(<package> <includedir> <libdir> <linkflags> <cflags>)

This command invokes pkg-config command-line utility to retrieve the package information into specified variables. If pkg-config or the specified package <package> is NOT found, the result variables remain empty.

The arguments are:

<package>

Name of the package as defined in its PC metadata file (<package>.pc).

<includedir>

Variable name to store the package's include directory.

<libdir>

Variable name to store the directory containing the package library.

<linkflags>

Variable name to store the linker flags for the package.

<cflags>

Variable name to store the compiler flags for the package.

Examples

Using this module fills the desired information into the four given variables:

include(UsePkgConfig)
pkgconfig(
  libart-2.0
  LIBART_INCLUDEDIR
  LIBART_LIBDIR
  LIBART_LDFLAGS
  LIBART_CFLAGS
)

Migrating to the FindPkgConfig would look something like this:

find_package(PkgConfig QUIET)
if(PkgConfig_FOUND)
  pkg_check_modules(LIBART QUIET libart-2.0)
endif()

message(STATUS "LIBART_INCLUDEDIR=${LIBART_INCLUDEDIR}")
message(STATUS "LIBART_LIBDIR=${LIBART_LIBDIR}")
message(STATUS "LIBART_LDFLAGS=${LIBART_LDFLAGS}")
message(STATUS "LIBART_CFLAGS=${LIBART_CFLAGS}")