MakeDeps

Warning

This feature is experimental and subject to breaking changes. See the Conan stability section for more information.

MakeDeps is the dependencies generator for make. It generates a Makefile file named conandeps.mk containing a valid make file syntax with all dependencies listed, including their components.

This generator can be used by name in conanfiles:

conanfile.py

  1. class Pkg(ConanFile):
  2.     generators = "MakeDeps"

conanfile.txt

  1. [generators]
  2. MakeDeps

And it can also be fully instantiated in the conanfile generate() method:

  1. from conan import ConanFile
  2. from conan.tools.gnu import MakeDeps
  4. class App(ConanFile):
  5.     settings = "os", "arch", "compiler", "build_type"
  6.     requires = "zlib/1.2.13"
  8.     def generate(self):
  9.         pc = MakeDeps(self)
  10.         pc.generate()

Generated files

make format file named conandeps.mk, containing a valid makefile file syntax. The prefix variable is automatically adjusted to the package_folder:

  1. CONAN_DEPS = zlib
  3. # zlib/1.2.13
  4. CONAN_NAME_ZLIB = zlib
  5. CONAN_VERSION_ZLIB = 1.2.13
  6. CONAN_REFERENCE_ZLIB = zlib/1.2.13
  7. CONAN_ROOT_ZLIB = /home/conan/.conan2/p/b/zlib273508b343e8c/p
  8. CONAN_INCLUDE_DIRS_ZLIB = $(CONAN_INCLUDE_DIR_FLAG)$(CONAN_ROOT_ZLIB)/include
  9. CONAN_LIB_DIRS_ZLIB = $(CONAN_LIB_DIR_FLAG)$(CONAN_ROOT_ZLIB)/lib
  10. CONAN_BIN_DIRS_ZLIB = $(CONAN_BIN_DIR_FLAG)$(CONAN_ROOT_ZLIB)/bin
  11. CONAN_LIBS_ZLIB = $(CONAN_LIB_FLAG)z
  13. CONAN_INCLUDE_DIRS = $(CONAN_INCLUDE_DIRS_ZLIB)
  14. CONAN_LIB_DIRS = $(CONAN_LIB_DIRS_ZLIB)
  15. CONAN_BIN_DIRS = $(CONAN_BIN_DIRS_ZLIB)
  16. CONAN_LIBS = $(CONAN_LIBS_ZLIB)

Customization

Flags

By default, the conandeps.mk will contain all dependencies listed, including their cpp_info information, but will not pass any flags to the compiler.

Thus, the consumer should pass the following flags to the compiler:

  • CONAN_LIB_FLAG: Add a prefix to all libs variables, e.g. -l

  • CONAN_DEFINE_FLAG: Add a prefix to all defines variables, e.g. -D

  • CONAN_SYSTEM_LIB_FLAG: Add a prefix to all system_libs variables, e.g. -l

  • CONAN_INCLUDE_DIR_FLAG: Add a prefix to all include dirs variables, e.g. -I

  • CONAN_LIB_DIR_FLAG: Add a prefix to all lib dirs variables, e.g. -L

  • CONAN_BIN_DIR_FLAG: Add a prefix to all bin dirs variables, e.g. -L

Those flags should be appended as prefixes to flags variables. For example, if the CONAN_LIB_FLAG is set to -l, the CONAN_LIBS variable will be set to -lz.

Reference

class MakeDeps(conanfile)

Generates a Makefile with the variables needed to build a project with the specified.

  • Parameters:

    conanfile – < ConanFile object > The current recipe object. Always use self.

  • generate() → None

    Collects all dependencies and components, then, generating a Makefile