CMake使用总结

CMake简介

CMake是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。只是 CMake 的组态档取名为 CMakeLists.txt。Cmake 并不直接建构出最终的软件，而是产生标准的建构档（如 Unix 的 Makefile 或 Windows Visual C++ 的 projects/workspaces），然后再依一般的建构方式使用。这使得熟悉某个集成开发环境（IDE）的开发者可以用标准的方式建构他的软件，这种可以使用各平台的原生建构系统的能力是 CMake 和 SCons 等其他类似系统的区别之处。

CMake 安装教程

Linux最新安装方式

1.Centos8 为例子
最新版本也可以直接去官网下载
CMake官网：
CMakeV.3.21版本：

Windows 选择安装版 Linux则选择已经编译好的压缩包
Linux先卸载先 Ubuntu和Deepin可以这样

sudo apt-get autoremove cmake

方法一：比较快 但是有些Linux不行
Linux解压cmake-3.21.0
tar zxvf cmake-3.21.0-rc2-linux-x86_64.tar.gz
拷贝到一个安全的目录存放如/usr/local/cmake

sudo mv cmake-3.21.0-rc2-linux-x86_64 /opt/cmake-3.21.0
sudo ln -sf /opt/cmake-3.21.0/bin/* /usr/bin/

方法二：使用githut 源码或者官网下载源码进行编译安装

wget -c https://cmake.org/files/v3.21/cmake-3.21.0-rc2.tar.gz
tar zxvf cmake-3.21.0-rc2.tar.gz
cd cmake-3.17.0-rc3
./bootstrap
gmake
gmake install

Centos需要安装openssl和gcc g++
yum install gcc gcc-c++
yum install openssl-devel
cmake编译比较简单，gcc环境和libstdc++.so.6没问题的情况下一般不会出现什么问题
查看编译后的版本：

ln -s /usr/local/bin/cmake /usr/bin/cmake
#查看一下cmake版本
cmake --version

下面是一个打印常用内置变量的CMakeList.txt
创建一个CMakeList.txt文件 内容如下

# CMake 最低版本号要求
CMAKE_MINIMUM_REQUIRED (VERSION 3.20.0)
MESSAGE(STATUS "----------------打印CMAKE缺省变量----------------")
MESSAGE(STATUS "CMAKE_VERSION:" ${CMAKE_VERSION})
MESSAGE(STATUS "CMAKE_MAJOR_VERSION:" ${CMAKE_MAJOR_VERSION})
MESSAGE(STATUS "CMAKE_MINOR_VERSION: " ${CMAKE_MINOR_VERSION})

#添加预处理宏定义 
#ADD_DEFINITIONS(-DWin32 -D_UNICODE)
#ADD_DEFINITIONS(-DLinux)

#添加编译选项
ADD_COMPILE_OPTIONS(-std=c++11)

#用于指定工程名称
PROJECT(ShowDafultInfo)
MESSAGE(STATUS "PROJECT_NAME:" ${PROJECT_NAME})
MESSAGE(STATUS "PROJECT_BINARY_DIR：" ${PROJECT_BINARY_DIR})
MESSAGE(STATUS "PROJECT_SOURCE_DIR: " ${PROJECT_SOURCE_DIR})

#MESSAGE(SEND_ERROR "产⽣错误，⽣成过程被跳过")
#MESSAGE(FATAL_ERROR "----------------终止CMAKE----------------")

MESSAGE(STATUS "----------------打印编译参数----------------")
#SET(CMAKE_BUILD_TYPE "Release")
MESSAGE(STATUS "CMAKE_BUILD_TYPE:${CMAKE_BUILD_TYPE}")
#如果给定的字串或变量值域给定的正则表达式匹配的话 ，表达式返回真
if(${CMAKE_BUILD_TYPE} MATCHES "Release")
    MESSAGE(STATUS "Release版本")
    MESSAGE(STATUS "CXXFLAGS: " ${CMAKE_CXX_FLAGS})
    MESSAGE(STATUS "CFLAGS: " ${CMAKE_C_FLAGS})
else()
    MESSAGE(STATUS "Debug版本")
    MESSAGE(STATUS "CXXFLAGS: " ${CMAKE_CXX_FLAGS})
    MESSAGE(STATUS "CFLAGS: " ${CMAKE_C_FILAGS})
endif()

执行下列命令进行构建

mkdir build
cd build
cmake..

其中CMakeCache.txt cmake_install.cmake Makefile文件和CMakeFiles目录就是我们通过cmake …
其中CMakeCache.txt一个配置文件。

CMakeLists.txt 中通过 set(… CACHE …) 设置的变量
CMakeLists.txt 中的 option() 提供的选项
CMakeLists.txt 中find_package() 等find命令引入变量

find_package()命令是用来查找依赖包的，理想情况下，一句find_package()把一整个依赖包的头文件包含路径、库路径、库名字、版本号等情况都获取到，后续只管用就好了。但实际中往往CMake失败就是出在find_package()的失败上

命令行 cmake . -D := 定义变量

cmake 第一次运行时将生成 CMakeCache.txt 文件，我们可以通过ccmake或cmake-gui或make edit_cache对其进行编辑。
对应于命令行 -D 定义变量，-U 用来删除变量（支持globbing_expr），比如 cmake -U/QT/ 将删除所有名字中带有QT的cache项。

项目目录

生成执行程序模板

CMAKE_MINIMUM_REQUIRED (VERSION 3.12.0)
SET(PROJECT_NAME main)
#项目名称
PROJECT(${PROJECT_NAME})
#采用C++14标准
SET(CMAKE_CXX_STANDARD 14)
#默认编译Rlease
SET(CMAKE_BUILD_TYPE "Release")
# 条件判断
if(CMAKE_BUILD_TYPE AND (CMAKE_BUILD_TYPE STREQUAL "Debug"))
    SET(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -Wall -g -ggdb -pthread")
    message("Debug mode:${CMAKE_C_FLAGS_DEBUG}")
elseif(CMAKE_BUILD_TYPE AND (CMAKE_BUILD_TYPE STREQUAL "Release"))    
    SET(CMAKE_CXX_FLAGS_RELEASE "$ENV{CXXFLAGS} -O3 -Wall -pthread")
    message("Release mode:${CMAKE_C_FLAGS_RELEASE}")
else()
    message("else:${CMAKE_BUILD_TYPE}")
    message("else:${CMAKE_C_FLAGS_RELEASE}")
endif()
#生成的文件路径
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/../bin)
#.cpp 文件放这
AUX_SOURCE_DIRECTORY(${PROJECT_SOURCE_DIR}/src DIR_SRC)
#头文件目录
INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include)
#需要链接的库文件目录
LINK_DIRECTORIES(${PROJECT_SOURCE_DIR}/lib)

#生成执行程序
ADD_EXECUTABLE(${PROJECT_NAME} ${DIR_SRC})
#执行程序链接的库
TARGET_LINK_LIBRARIES(${PROJECT_NAME} libtof_app.so libopencv_world.so)

生成库模板

目录结构与上面区别不大

CMAKE_MINIMUM_REQUIRED(VERSION 3.12.0)
#设置项目名字 运行程序名字或者动态库名字
SET(PROJECT_NAME my)#生成 libmy.so 或者 静态库 libmy.a
PROJECT(${PROJECT_NAME})

SET(CMAKE_CXX_STANDARD 14)
SET(CMAKE_BUILD_TYPE "Release")
SET(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -Wall -g -ggdb -DDEBUG")
SET(CMAKE_CXX_FLAGS_RELEASE "$ENV{CXXFLAGS} -O3 -Wall -lpthread")
#[[
如果不加-fPIC,则加载.so文件的代码段时,代码段引用的数据对象需要重定位, 
重定位会修改代码段的内容,这就造成每个使用这个.so文件代码段的进程在内核里都会生成这个.so文件代码段的copy.
每个copy都不一样,取决于 这个.so文件代码段和数据段内存映射的位置.
]] 
#编译参数
ADD_COMPILE_OPTIONS(-fPIC)

#生成的文件路径
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/../bin)
#.cpp 文件放这
AUX_SOURCE_DIRECTORY(${PROJECT_SOURCE_DIR}/src DIR_SRC)
#头文件目录
INCLUDE_DIRECTORIES(${PROJECT_SOURCE_DIR}/include)

//VS工程头文件写法
#FILE(GLOB_RECURSE HEADER_FILES  ${CMAKE_CURRENT_SOURCE_DIR}/include/*.h )
#SOURCE_GROUP("Header Files" FILES ${HEADER_FILES})
#ADD_LIBRARY(${PROJECT_NAME} SHARED ${DIR_SRC} ${HEADER_FILES})

#需要链接的库文件目录
LINK_DIRECTORIES(${PROJECT_SOURCE_DIR}/lib)
#生成动态库(SHARED)
ADD_LIBRARY(${PROJECT_NAME} SHARED ${DIR_SRC})
#生成静态库
#ADD_LIBRARY(${PROJECT_NAME} ${DIR_SRC})