#Cmake print variable software#
#Cmake print variable code#

However, we decided our training projects benefited from using wildcards so that we didn’t have to get everyone to edit the build system as we went through the programming exercises. General advice is to avoid wildcards in a build configuration as the potential problems are more serious than the extra administrative load. The simple solution to this problem is to delete the entire output folder and regenerate everything. Note that using the –target clean option on the CMake command will only delete artefacts defined by the current build configuration and not older unreferenced artefacts. These sort of build problems may not be discovered until a later date when rebuilding the whole project from scratch. linking in an object file that is no longer built from a source file). The downside is that old artefacts may be left in the output build folder and used in the build (e.g. Many sites using wildcards simply regenerate the build files whenever a build takes place – it doesn’t take that much time compared to the build. To get proper wildcard support, the CMake build command must be run whenever there is a change to the source file structure. The well-documented proviso in CMake is that wildcards are evaluated when the build files are generated and not when the build takes place. As part of the build file generation CMake can optionally generate a list of compilation commands by setting the CMAKE_EXPORT_COMPILE_COMMANDS variable: set(CMAKE_EXPORT_COMPILE_COMMANDS ON)

#Cmake print variable software#

Software risk analysis usually requires a definitive list of the source files used to build a given project.

Teams following a more formal methodology usually prefer to specify every source file to avoid accidentally including unwanted sources and to maintain accurate list modules dependencies. Teams following agile development models based on Evolutionary Prototyping where the source file structure can change regularly may prefer to use wildcard patterns to specify multiple source files to simplify project administration.

cmake -build build -no-print-directory Source File Wildcards

You can suppress this directory tracking using the –no-print-directory option on the build command line.

#Cmake print variable code#

When using subdirectories to organise source code the generated build commands print out each directory name as it is being processed. Target_include_directories(Application PRIVATE For example: target_include_directories(Application PRIVATEĭirectory locations are relative to the project root but we can use the CMAKE_SOURCE_DIR variable to reinforce this: add_executable(Application We don’t specify the header files as part of the source dependencies.Īlthough we never list the header files as part of the configuration (as discussed in previous blogs), we need to specify the directories to search for header files by adding entries to the target_include_directories() directive. Remember that CMake will scan the source files looking for dependencies to build a dependency tree for the source files and included header files. We just add these source files to the add_executable() definition: add_executable(Application

logic controller ( controller.cpp and controller.h).

hardware devices ( devices.cpp and devices.h).

Let’s say we have two separate modules for our project: We can extend our list of source files for the target executable. You can find the complete configuration files in the GitHub project accompanying this blog. Set_target_properties(Application PROPERTIES The following is a simplified project configuration file where we have omitted the compiler and linker options as we are now concentrating on source code management: cmake_minimum_required(VERSION 3.16) So far, our example project has just used a single main.cpp source file, although the supporting GitHub projects use multiple source files to build a usable ELF image.įrom the previous blog, you may remember that, for our build, we use a separate toolchain file ( toolchain-STM32F407.cmake) and a project configuration file ( CMakeLists.txt). Any non-trivial project will use separate source files to encapsulate different functional areas of the system.