Linux小知识—CMake的使用

背景介绍

前面在介绍SQlite3的使用时，用了CMake的方式，简单编译了源码，其中的CMakeLists.txt有如下内容

cmake_minimum_required (VERSION 3.5)

project(demo)

include_directories (sqlite)

add_executable(main ${PROJECT_SOURCE_DIR}/src/main.c ${PROJECT_SOURCE_DIR}/sqlite/sqlite3.c)
target_link_libraries (main pthread dl)

add_executable(sqliteShell ${PROJECT_SOURCE_DIR}/sqlite/shell.c ${PROJECT_SOURCE_DIR}/sqlite/sqlite3.c)
target_link_libraries (sqliteShell pthread dl)

当执行 cmake ../命令的时候，就能够自动生成makefile，比较神奇。

在linux下一般过程就是

1. 手动编写 CMakeLists.txt。
2. 执行命令 cmake PATH 生成 Makefile ( PATH 是顶层CMakeLists.txt 所在的目录 )。
3. 执行命令 make 进行编译。

CMake基本语法

基本语法格式： 指令(参数 1 参数 2…)
参数使用括弧括起，参数之间使用空格或分号分开；
指令是大小写无关的，参数和变量是大小写相关的

CMake变量

CMake中所有变量都是string类型。可以使用set()和unset()命令来声明或者移除一个变量。
变量的引用：${变量名}

SET(var 666)

MESSAGE("var=${var}")

常见CMake命令

常见的CMakeLists.txt都是由命令组成的，下面介绍一下主要的命令

最小版本

命令cmake_minimum_required含义指定CMake的最小版本要求格式cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])例子cmake_minimum_required(VERSION 2.8.3)

设置变量

命令SET含义指令用来定义变量的值，相当于编程语言中的赋值操作（VAR=VALUE）格式SET(VAR [VALUE])例子# 定义SRC_LIST变量为三个cpp文件的列表。SET(SRC_LIST main.cpp sqrt.cpp pow.cpp)

定义工程名称

命令project含义定义工程名称，并可指定工程支持的语言格式project(projectname [CXX] [C] [Java]))例子project(HELLOWORLD))

头文件搜索

命令include_directories含义向工程添加多个特定的头文件搜索路径 ，相当于指定g++编译器的-I参数格式include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)例子include_directories(/usr/include/myincludefolder ./include))

库文件搜索

命令link_directories含义向工程添加多个特定的库文件搜索路径 —>相当于指定g++编译器的-L参数格式link_directories(dir1 dir2 …)例子link_directories(/usr/lib/mylibfolder ./lib))

添加需要链接的共享库

命令target_link_libraries含义为 target 添加需要链接的共享库 —>相同于指定g++编译器-l参数格式target_link_libraries(target library1 library2…)例子target_link_libraries(main hello)

添加编译参数

命令add_compile_options含义添加编译参数格式add_compile_options()例子add_compile_options(-Wall -std=c99 -O2))

添加子文件夹

命令iadd_subdirectory含义向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制 存放的位置格式add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])例子add_subdirectory(src)

获取源文件

命令aux_source_directory含义发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指 令临时被用来自动构建源文件列表格式aux_source_directory(dir VARIABLE)例子# 定义SRC变量，其值为当前目录下所有的源代码文件aux_source_directory(. SRC)# 编译SRC变量所代表的源代码文件，生成main可执行文件add_executable(main ${SRC})

生成库文件

命令add_library含义生成库文件格式add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)例子add_library(hello SHARED ${SRC})

生成可执行文件

命令add_executable含义生成可执行文件格式add_executable(exename source1 source2 … sourceN)例子add_executable(main main.c)

安装

命令install含义目标文件的安装格式INSTALL(TARGETS targets …[[ARCHIVE|LIBRARY|RUNTIME][DESTINATION

参数中的TARGETS后面跟的就是我们通过ADD_EXECUTABLE或者ADD_LIBRARY定义的目标文件，可能是可执行二进制、动态库、静态库。

目标类型：ARCHIVE特指静态库，LIBRARY特指动态库，RUNTIME特指可执行目标二进制。

DESTINATION定义了安装的路径，如果路径以/开头，那么指的是绝对路径，这时候CMAKE_INSTALL_PREFIX其实就无效了。如果你希望使用CMAKE_INSTALL_PREFIX来定义安装路径，就要写成相对路径
PATTERN用于使用正则表达式进行过滤，PERMISSIONS用于指定PATTERN过滤后的文件权限。

; 打印输出

命令message含义相当于编程中的打印指令格式message([SEND_ERROR|STATUS|FATAL_ERROR] “Content”)SEND_ERROR 报错误信息，不终止CMake构建过程。STATUS 普通输出信息。FATAL_ERROR 报错误信息，终止CMake构建过程。例子message(STATUS “PROJECT_BINARY_DIR: ${PROJECT_BINARY_DIR}”)

CMake常用变量

有些需要用set命令进行设置的。有些事直接使用。

; 编译选项

命令含义CMAKE_C_FLAGSgcc编译选项CMAKE_CXX_FLAGSg++编译选项

例子

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")

编译类型

命令含义CMAKE_BUILD_TYPE编译类型(Debug, Release)

例子

set(CMAKE_BUILD_TYPE Debug)

set(CMAKE_BUILD_TYPE Release)

工程目录

命令含义CMAKE_BINARY_DIR当就在工程顶层编译的时候，等同于工程顶层目录，如果是在build路径等顶层之外的地方编译时，就知道编译发生的路径。PROJECT_BINARY_DIR同上_BINARY_DIR同上CMAKE_SOURCE_DIR工程顶层目录PROJECT_SOURCE_DIR同上_SOURCE_DIR同上

其他参数

命令含义CMAKE_C_COMPILER指定C编译器CMAKE_CXX_COMPILER指定C++编译器EXECUTABLE_OUTPUT_PATH可执行文件输出的存放路径LIBRARY_OUTPUT_PATH库文件输出的存放路径

例子

最后还是来一个简单的例子，就是之前编译Sqlite的例子

进入build路径
执行 cmake ../

会生成Makefile

执行编译，就会生成我们需要的可执行程序

我们还可以稍微修改一下这个CMakeLists.txt，将sqlite3编译成库，然后将我们开发的文件与这个库编译到一起。

cmake_minimum_required (VERSION 3.5)
project(sqlitetest)
include_directories (sqlite)
add_library(sqlite.a STATIC ${PROJECT_SOURCE_DIR}/sqlite/sqlite3.c)
add_executable(sqlitetest ${PROJECT_SOURCE_DIR}/src/main.c)
target_link_libraries (sqlitetest sqlite.a pthread dl)

经过测试，没有问题

[root@localhost build]
-- The C compiler identification is GNU 8.5.0
-- The CXX compiler identification is GNU 8.5.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /usr/bin/cc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- PROJECT_BINARY_DIR: /home/sqlite3/build
-- PROJECT_SOURCE_DIR: /home/sqlite3
-- Configuring done
-- Generating done
-- Build files have been written to: /home/sqlite3/build
[root@localhost build]
[ 25%] Building C object CMakeFiles/sqlite.a.dir/sqlite/sqlite3.c.o
[ 50%] Linking C static library libsqlite.a.a
[ 50%] Built target sqlite.a
[ 75%] Building C object CMakeFiles/sqlitetest.dir/src/main.c.o
[100%] Linking C executable sqlitetest
[100%] Built target sqlitetest
[root@localhost build]
CMakeCache.txt  CMakeFiles  cmake_install.cmake  libsqlite.a.a  Makefile  sqlitetest
[root@localhost build]
abc"abc"bytes: 16, 10000, 0
bytes: 16, 10000, 1
bytes: 16, 10000, 2
bytes: 16, 10000, 3
bytes: 16, 10000, 4

结束语

最近科兴也又被实名举报了，看来孩子的第三针要缓一下了，网上看好多人都因为疫苗出现了这样那样的反应，荨麻疹，白血病，各种结节，真是没有信心继续当小白鼠了。

不过最近身边的人好多都开始过敏性鼻炎了，已经不是少数了，每年春天，会因为一批树木的花粉，杨柳絮，很多人过敏，每年秋天，会因为一大批蒿，苋类植物的花粉，还有一批人过敏，
有人难受一个季度，也有人难受半年。

Original: https://blog.csdn.net/baidu_19348579/article/details/126992295
Author: 胖哥王老师
Title: Linux小知识—CMake的使用