CMake 备忘清单 & cmake cheatsheet & 速查表

CMake 是一个用于配置跨平台源代码项目应该如何配置的工具建立在给定的平台上。

├── CMakeLists.txt  # 希望运行的 CMake命令
├── main.cpp        # 带有main 的源文件
├── include         # 头文件目录
│   └── header.h
└── src             # 源代码目录
    ├── a.c
    └── b.c

在此项目上运行 CMake 时,系统会要求您提供二进制目录,运行 CMake 不会创建最终的可执行文件,而是会为 Visual StudioXCodemakefile 生成项目文件。 使用这些工具构建该项目

CMakeLists.txt

# 设置可以使用的最低 CMake 版本
cmake_minimum_required(VERSION 3.5)
# 设置项目名称
project (hello_cmake)
# 添加可执行文件
add_executable(hello_cmake main.cpp)
# 添加头文件目录
target_include_directories(hello_cmake PRIVATE ./include)
# 批量添加源文件
file(GLOB SRCS CONFIGURE_DEPENDS ./src/*.cpp)
target_sources(hello_cmake PUBLIC ${SRCS})
# 添加第三方库
find_package(OpenGL CONFIG REQUIRED)
# 链接第三方库
target_link_libraries(hello_cmake PRIVATE OpenGL)
# 指定输出路径
set_property(TARGET hello_cmake ${CMAKE_SOURCE_DIR}/bin)

main.cpp

#include <iostream>

int main(int argc, char *argv[])
{
  std::cout << "Hello CMake!" << std::endl;
  return 0;
}

编译示例

$ mkdir build   # 创建 build 目录
$ cd build      # 进入目录
$ cmake ..      # 目录的上一级目录运行命令
$ make          # 使用对应的编译工具
$ ./hello_cmake # 运行生成的 hello_cmake
Hello CMake!