CMakeLists.txt files for multiple libraries and executables

Question

I am just starting playing with CMake. I have something like:

/DEV
 |-- lib1
        | CMakeLists.txt

 |-- lib2
        | CMakeLists.txt

 |-- exe1
        | CMakeLists.txt

/BUILD
 |-- lib1
 |-- lib2
 |-- exe1

/INSTALL
 |-- include
 |-- lib
 |-- bin

I would like to:

• Build each lib and exe independently when needed. (So I suppose I must add a CMakeLists.txt file for each lib and exe);
• When building, include and lib directories should reference INSTALL directory; (is it a good idea?)
• When building, add dependencies to other lib and rebuild them if not up to date.

I dont have any clue where to start. Please help...

Answer 1

You don't need individual CMakeLists.txt to build targets independently. Say you have one top level CMakeLists.txt with:

ADD_LIBRARY(lib1 ${all_lib1_files})
ADD_LIBRARY(lib2 ${all_lib2_files})
ADD_EXECUTABLE(exe1 ${all_exe1_files})
TARGET_LINK_LIBRARIES(lib2 lib1)  # lib2 now depends on lib1
TARGET_LINK_LIBRARIES(exe1 lib2)  # exe1 now depends on lib2 and lib1

Then you can build just lib1 by running make lib1 or msbuild lib1.vcxproj, etc. You can achieve the same by having individual CMakeLists.txt files per target - it's up to you if you think it's worth it.

If your project imports these targets using FIND_LIBRARY or FIND_PACKAGE, then they won't be rebuilt if they're not up to date. Ultimately, if you want out-of-date dependencies to be automatically rebuilt, you need to let CMake know about the sources and rules for the dependent target, i.e. the CMakeLists.txt file needs to have added the target using ADD_LIBRARY or ADD_EXECUTABLE.

You shouldn't then need to reference the INSTALL directory (except in INSTALL commands I imagine), since CMake will implicitly use libs/exes build locations rather than installed locations when linking targets.