CMake 备忘清单

imnobody2001 2023-08-23 发布于黑龙江

展开全文

入门

Hello CMake

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

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

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

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!

生成项目构建系统

$ cmake [<options>] <path-to-source | path-to-existing-build>bash
$ cmake [<options>] -S <path-to-source> -B <path-to-build>

建立一个项目

$ cmake --build <dir> [<options>] [-- <build-tool-options>]

安装项目

$ cmake --install <dir> [<options>]

运行指定项目

cmake --build <dir> --target <project>

打开一个项目

$ cmake --open <dir>

运行脚本

$ cmake [-D <var>=<value>]... -P <cmake-script-file>

运行命令行工具

$ cmake -E <command> [<options>]

运行查找包工具

$ cmake --find-package [<options>]

运行工作流预设

$ cmake --workflow [<options>]

查看帮助

$ cmake --help[-<topic>]

常用参数

方式一: 在CMakeLists.txt中使用set(KEY VAL)函数
方式二: 在执行cmake ... -D
指定(只需一次,推荐)

# 指定编译参数(Debug/Release/MinSizeRel/RelWithDebInfo)
$ cmake ... -D CMAKE_BUILD_TYPE=DEBUG
# 指定编译链工具(windows下vcpkg需要)
$ cmake ... -D CMAKE_TOOLCHAIN_FILE=<vcpkg_path>/scripts/buildsystems/vcpkg.cmake
# 指定编译器
$ cmake ... -D CAMKE_C_COMPILER=...
$ cmake ... -D CAMKE_CXX_COMPILER=...
# 指定生成器
$ cmake .. -G 'Unix Makefile'
$ cmake .. -G 'Ninja'
$ cmake .. -G 'Visual Studio 17 2022'

# 设置Cpp标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON) # 在检测到不支持时出错
set(CMAKE_CXX_EXTENSIONS ON) #一般设为off，否则在msvc上没有特性会出错

参考地址：http://ttroy50./cmake-examples/

Linux平台使用Qt举例Cmake

语法解释：

cmake_minimum_required(VERSION 3.5)
project(Cmake LANGUAGES CXX)
set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOUIC ON)set(CMAKE_AUTOMOC ON)set(CMAKE_AUTORCC ON)
set(CMAKE_CXX_STANDARD 11)set(CMAKE_CXX_STANDARD_REQUIRED ON)
# QtCreator supports the following variables for Android, which are identical to qmake Android variables.# Check http://doc./qt-5/deployment-android.html for more information.# They need to be set before the find_package(Qt5 ...) call.
#if(ANDROID)#    set(ANDROID_PACKAGE_SOURCE_DIR '${CMAKE_CURRENT_SOURCE_DIR}/android')#    if (ANDROID_ABI STREQUAL 'armeabi-v7a')#        set(ANDROID_EXTRA_LIBS#            ${CMAKE_CURRENT_SOURCE_DIR}/path/to/libcrypto.so#            ${CMAKE_CURRENT_SOURCE_DIR}/path/to/libssl.so)#    endif()#endif()
find_package(Qt5 COMPONENTS Widgets REQUIRED)
if(ANDROID)  add_library(Cmake SHARED    main.cpp    mainwindow.cpp    mainwindow.h    mainwindow.ui  )else()  add_executable(Cmake    main.cpp    mainwindow.cpp    mainwindow.h    mainwindow.ui  )endif()
target_link_libraries(Cmake PRIVATE Qt5::Widgets)