Learn CMake

Modern CMake

• Modern CMake
• More Modern CMake

CMake Book

• Modern CMake for C++
• Professional CMake
• CMake Cookbook
• CMake Documentation
• CMake Wiki
• Modern CMake

CMake is building the solution in three stages: configuration, generation, and running the build tool.

Link

• CMake使用生成器表达式（Generator Expression）添加编译和链接选项
• CMake实践应用专题
• jjjstephen
• CMake DSL语言
• find_package用法详解

CMake Command

rm -rf build/ && cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_BUILD_TYPE=Debug && cmake --build build --parallel cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_CXX_COMPILER=/usr/bin/g++-10 -G "Unix Makefiles"
cmake --build build --clean-first --parallel 10
cmake --build build --target "foo"
cmake --build build --verbose
cmake --build build --parallel --config Release
cmake --build build --target help
cmake --install build --prefix /tmp/install_test

set(CMAKE_VERBOSE_MAKEFILE on)
cmake --build build -v

# CMake属性调试接口
set(CMAKE_DEBUG_TARGET_PROPERTIES
INCLUDE_DIRECTORIES
INTERFACE_INCLUDE_DIRECTORIES
)
		    

CMake Usage

set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
set(CMAKE_INSTALL_PREFIX testInstall)

# Set default visibility to hidden for all targets
set(CMAKE_CXX_VISIBILITY_PRESET hidden)
set(CMAKE_VISIBILITY_INLINES_HIDDEN YES)
		    

Library

libfoo.so.1 为soname 软连接指向realname: libfoo.so.1.1
libfoo.so.1.1 为realname
libfoo.so 为linkname
Understanding RPATH (With CMake)
RPATH handling

Project

• ModernCppStarter

Test

# CMakeLists file for the Chapter 7 example, showing a simple project which executes a test
#
# SPDX-License-Identifier: MIT

cmake_minimum_required(VERSION 3.28)

project(
  "simple_test"
  VERSION 1.0
  DESCRIPTION "A simple C++ project to demonstrate basic CMake usage"
  LANGUAGES CXX)

# Enable testing for this project
# enable_testing()
# Ad the executalbe to test
add_executable(simple_test)
target_sources(simple_test PRIVATE simple_test.cpp)
target_link_libraries(simple_test PRIVATE Catch2::Catch2WithMain)

# Add a test called example_test which executes the command `ch7_simple_test`
add_test(NAME example_test COMMAND simple_test)

# Add a test called example_test_2 which executes the command `ch7_simple_test` with the argument `arg1`
# add_test(NAME example_test_2 COMMAND ch7_simple_test arg1)

		    

• 编译标志: 使用target_compile_option
• 预处理宏标志: 使用target_compile_definitions
• 链接标志: 使用target_link_options

CMake Commands

find_package

Module mode: Find<PackageName>.cmake 搜索路径: CMAKE_MODULE_PATH CMAKE_ROOT
Config mode: 由package自身提供 <PackageName>Config.cmake 或者 <lower-case-package-name>-config.cmake 搜索路径: <PackageName>_DIR CMAKE_PREFIX_PATH

set_target_properties

set_target_properties 常见属性以及获取target 属性

Function

1. ${ARGC}: The count of arguments
2. ${ARGV}: All arguments as list
3. ${ARGV<index>}: The value of an argument at a specific index (starting from 0), regardless of whether this argument was expected or not
4. ${ARGN}: A list of anonymous arguments that were passed by a caller after the last ex-pected argument