CMake...

时间 2019-11-24

标签 cmake 繁體版

原文原文链接

http://blog.atime.me/note/cmake.html

简单的例子

一个完整的Demo可参考这里。html

假设当前目录的结构为java

./a.cpp
./b.cpp

./include/common.h
./include/defines.h

./other/c.cpp
./other/d.cpp

./lib/libB.a
./lib/libBd.a
./lib/libA.so
./lib/libAd.so
./lib/libB.so
./lib/libBd.so
./lib/libC.so
./lib/libCd.so

使用下面的CMakeLists.txt文件，目标是编译当前目录和./other目录下的全部源文件，并连接./lib目录下的相应库文件到最终的可执行文件./bin/hello(或./bin/hellod)。c++

cmake_minimum_required(VERSION 2.8) project(helloworld) set(CMAKE_VERBOSE_MAKEFILE on) set(CMAKE_CXX_COMPILER "g++") set(CMAKE_CXX_FLAGS "-Wall") set(CMAKE_CXX_FLAGS_DEBUG "-g3") set(CMAKE_CXX_FLAGS_RELEASE "-O2") set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin) aux_source_directory(./ SRC_LIST) aux_source_directory(./other OTHER_SRC_LIST) list(APPEND SRC_LIST ${OTHER_SRC_LIST}) include_directories(${PROJECT_SOURCE_DIR}/include) link_directories(${PROJECT_SOURCE_DIR}/lib) if(${CMAKE_BUILD_TYPE} MATCHES "debug") add_executable(hellod ${SRC_LIST}) target_link_libraries(hellod Ad Bd.a Cd.so) else() add_executable(hello ${SRC_LIST}) target_link_libraries(hello A B.a C.so) endif()

执行命令cmake -DCMAKE_BUILD_TYPE=debug .生成Makefile，make以后生成./bin/hellod（调试版本），或执行cmake .最后生成./bin/hello。git

经常使用的CMake变量

详细内容请参考CMake Useful Variables。github

PROJECT_SOURCE_DIR 工程的源文件目录，一般是包含CMakeLists.txt（有Project命令的）的目录。

自定义变量

可在命令行下向CMake传递自定义变量ui

cmake -DMY_VAR=hello .

而后在CMakeLists.txt中使用，注意大小写。spa

message(${MY_VAR})

构建类型

cmake默认支持多种构建类型(build type)，每种构建类型都有专门的编译参数变量，详情见下表1:命令行

CMAKE_BUILD_TYPE	对应的c编译选项变量	对应的c++编译选项变量
None	CMAKE_C_FLAGS	CMAKE_CXX_FLAGS
Debug	CMAKE_C_FLAGS_DEBUG	CMAKE_CXX_FLAGS_DEBUG
Release	CMAKE_C_FLAGS_RELEASE	CMAKE_CXX_FLAGS_RELEASE
RelWithDebInfo	CMAKE_C_FLAGS_RELWITHDEBINFO	CMAKE_CXX_FLAGS_RELWITHDEBINFO
MinSizeRel	CMAKE_C_FLAGS_MINSIZEREL	CMAKE_CXX_FLAGS_MINSIZEREL

在CMakeLists.txt中能够自定义编译选项变量debug

set(CMAKE_CXX_FLAGS_RELEASE "-O2")

而后运行cmake的时候，传入相应的构建类型便可调试

cmake -DCMAKE_BUILD_TYPE=Release

经常使用命令

详情可参考对应版本的CMake文档。

检查CMake版本

cmake版本至少为2.8

cmake_minimum_required(VERSION 2.8)

定义工程名称

工程名为helloworld

project(helloworld)

查找源文件

查找当前目录下全部的源文件并保存到SRC_LIST变量里

aux_source_directory(. SRC_LIST)

查找src目录下全部以cmake开头的文件并保存到CMAKE_FILES变量里

file(GLOB CMAKE_FILES "src/cmake*")

file命令同时支持目录递归查找

file(GLOB_RECURSE CMAKE_FILES "src/cmake*")

按照官方文档的说法，不建议使用file的GLOB指令来收集工程的源文件，原文解释以下

We do not recommend using GLOB to collect a list of source files from your source tree. If no CMakeLists.txt file changes when a source is added or removed then the generated build system cannot know when to ask CMake to regenerate.

大意就是，GLOB收集的源文件增长或删除，而CMakeLists.txt没有发生修改时，CMake不能识别这些文件。其实，当CMakeLists.txt使用aux_source_directory和file glob查找工程源文件时，若是添加或删除源文件，都须要从新运行CMake。

set命令

常常配合set命令使用的CMake变量，使用set(variable value)进行设置。

CMAKE_VERBOSE_MAKEFILE on 输出详细的编译和连接信息
CMAKE_CXX_COMPILER "g++" c++编译器
CMAKE_CXX_FLAGS "-Wall" c++编译器参数
- CMAKE_CXX_FLAGS_DEBUG 除CMAKE_CXX_FLAGS外，debug版本的额外编译器参数
- CMAKE_CXX_FLAGS_RELEASE 除CMAKE_CXX_FLAGS外，release版本的额外编译器参数
EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin 可执行文件的输出目录
LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib 连接库的输出目录

set命令还能够设置自定义变量，好比

set(MY_GREETINGS "hello world")

将./include和./abc加入包含目录列表

include_directories(
    ./include
    ./abc
)

将./lib加入编译器连接阶段的搜索目录列表

link_directories(
    ./lib
)

添加生成目标

使用SRC_LIST源文件列表里的文件生成一个可执行文件hello

add_executable(hello ${SRC_LIST})

使用SRC_LIST源文件列表里的文件生成一个静态连接库libhello.a

add_library(hello STATIC ${SRC_LIST})

使用SRC_LIST源文件列表里的文件生成一个动态连接库libhello.so

add_library(hello SHARED ${SRC_LIST})

将若干库文件连接到生成的目标hello(libhello.a或libhello.so)

target_link_libraries(hello A B.a C.so)

须要注意的是，target_link_libraries里库文件的顺序符合gcc连接顺序的规则，即被依赖的库放在依赖它的库的后面，好比上面的命令里，libA.so可能依赖于libB.a和libC.so，若是顺序有错，连接时会报错。还有一点，B.a会告诉CMake优先使用静态连接库libB.a，C.so会告诉CMake优先使用动态连接库libC.so，也可直接使用库文件的相对路径或绝对路径。使用绝对路径的好处在于，当依赖的库被更新时，make的时候也会从新连接。

自定义连接选项

有时候须要自定义连接选项，好比须要单独对B.a使用--whole-archive选项，能够

target_link_libraryies(hello A -Wl,--whole-archive B.a -Wl,--no-whole-archive C.so)

自定义Makefile目标

运行下面的whatever目标make whatever，会先建立一个目录./hello，而后将当前目录的a.txt拷贝到新建的./hello目录里。

add_custom_command(
    OUTPUT ./hello/a.txt
    COMMAND mkdir -p ./hello 
            cp a.txt ./hello
    DEPENDS a.txt
)
add_custom_target(whatever DEPENDS ./hello/a.txt)

自定义目标还可使用add_dependencies命令加入到其余目标的依赖列表里，当执行make demo时，whatever目标会被自动调用。

add_executable(demo ${SRC_LIST})
add_dependencies(demo whatever)

其余经常使用命令

包含其余目录的CMakeLists.txt

include(/path/to/another/CMakeLists.txt)

if命令

if(${CMAKE_BUILD_TYPE} MATCHES "debug")
    ...
else()
    ...
endif()

list命令

list(APPEND SRC_LIST 
    a.cpp
    b.cpp
)

list(REMOVE_ITEM SRC_LIST
    a.cpp
)