CMake编译规则梳理

文章目录

概述

本文讲述Cmake常用语法和示例。

编译方式

源代码本地编译

顶层目录有CMakeLists.txt时，说明该代码是通过cmake进行编译的。
编译步骤：
1.mkdir build
2.cd build; cmake ..
3.make

源代码交叉编译

在CMakeLists.txt中增加如下配置，例如：

set(CMAKE_CXX_STANDARD 11)
SET(CMAKE_SYSTEM_NAME Linux)
SET(CMAKE_SYSTEM_PROCESSOR arm)
SET(TOOLCHAIN_DIR "/opt/linux/x86-arm/aarch64-mix210-linux")
SET(CMAKE_FIND_ROOT_PATH ${TOOLCHAIN_DIR})
SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
SET(CMAKE_C_COMPILER ${TOOLCHAIN_DIR}/bin/aarch64-mix210-linux-gcc)
SET(CMAKE_CXX_COMPILER ${TOOLCHAIN_DIR}/bin/aarch64-mix210-linux-g++)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -o3 -std=c++0x -fpermissive")

将其中系统架构，和交叉编译工具链路径改为自己的路径即可。

buildroot编译cmake代码包

在package.mk中使用$(eval $(cmake-package))进行编译

CMAKE常用关键字

指定cmake最低版本

例：cmake_minimum_required(VERSION 2.8)
编译时将检查cmake版本，示例必须大于2.8

指定项目名称

例：project(mylib)

设置变量

将一个CMAKE变量设置为给定值。

  set(<variable> <value> [[CACHE <type> <docstring> [FORCE]] | PARENT_SCOPE])

将变量的值设置为。在被设置之前，会被展开。
如果有CACHE选项，那么就会添加到cache中；这时和是必需的。

：对该变量作用的描述。

: 该变量的类型，可以是下述值中的一个：
FILEPATH = 文件选择对话框。
PATH = 路径选择对话框。
STRING = 任意的字符串。
BOOL = 布尔值选择复选框。
INTERNAL = 不需要GUI输入端。(适用于永久保存的变量)。

例：

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_C_STANDARD 99)

set(RECEIVER_SOURCES receiver/receiver.c receiver/receiver.h)

CMAKE_CURRENT_BINARY_DIR

外部编译时，指的是target目录，内部编译时，指的是顶级目录

指定编译选项

set(CMAKE_C_FLAGS “${CMAKE_C_FLAGS} -z noexecstack -fstack-protector”)

指定库、头文件路径

指定头文件路径

INCLUDE_DIRECTORIES(PATH)
示例：添加当前路径
INCLUDE_DIRECTORIES(.)

链接指定库

指定库路径：LINK_DIRECTORIES()
链接库：target_link_libraries(bin_name lib_name)

指定SSL库

当系统中有多个ssl库时，需要指定特定路径下的ssl库时：

set(OPENSSL_ROOT_DIR "/usr/local/kssl/1.1")
find_package(OpenSSL 1.1.1 REQUIRED)
if (OpenSSL_FOUND)
    message(STATUS "found library:${OPENSSL_LIBRARIES},${OPENSSL_INCLUDE_DIR} ENABLE_OPENSSL defined")
    include_directories(${OPENSSL_INCLUDE_DIR})
    add_definitions(-DKOAL_SSL_EXTENSION)
else()
message(WARNING "openssl not found!!")
endif()

编译生成库

add_library(MyLib STATIC MyUtil.cpp) # 生成静态库
add_library(MyLib SHARED MyUtil.cpp) # 生成动态库或共享库

编译生成可执行文件

add_executable(MyDemo MyDemo.cpp) # 生成可执行文件

判断语句

if_else

语法

if(<condition>)
  <commands>
elseif(<condition>) # optional block, can be repeated
  <commands>
else()              # optional block
  <commands>
endif()

示例

IF(${CMAKE_C_FLAGS} MATCHES "-DWIFI_PASSWD_ERR_PROMPT=1")
    target_link_libraries(pthread  wpa_client)
ENDIF(${CMAKE_C_FLAGS} MATCHES "-DWIFI_PASSWD_ERR_PROMPT=1")

调试信息

message("ssdbg"${CMAKE_C_FLAGS})