CMake常用指令

最新推荐文章于 2024-08-21 10:55:48 发布

张小方32

最新推荐文章于 2024-08-21 10:55:48 发布

阅读量1.1k

点赞数 1

分类专栏： gcc/gdb/cmake/cgdb 文章标签： cmake

本文链接：https://blog.csdn.net/analogous_love/article/details/52875325

版权

gcc/gdb/cmake/cgdb 专栏收录该内容

13 篇文章 1 订阅

订阅专栏

cmake_minimum_required(VERSION 2.8) 检查cmake的版本，至少为2.8
project(helloworld) 工程名为helloworld
aux_source_directory(. SRC_LIST) 查找当前目录下所有的源文件并保存到SRC_LIST变量中
include_directories(./include ./abc) 将./include和./abc加入包含目录列表
link_directories(./lib) 将 ./lib加入编译器链接阶段的搜索目录列表
add_executable(hello $(SRC_LIST}) 使用SRC_LIST源文件列表里的文件生成一个可执行文件hello
add_library(hello STATIC ${SRC_LIST}) 使用SRC_LIST源文件列表里的文件生成一个静态链接库libhello.a
add_library(hello SHARD ${SRC_LIST}) 使用SRC_LIST源文件列表里的文件生成一个动态链接库libhello.so

add_library(libname [SHARED|STATIC|MODULE][EXCLUDE_FROM_ALL]source1 source2 … sourceN)

你不需要写全libhello.so，只需要填写hello即可，cmake系统会自动为你生成libhello.X。类型有三种:

SHARED，动态库(扩展名为.so)
STATIC，静态库(扩展名为.a)
MODULE，在使用dyld的系统有效，如果不支持dyld，则被当作SHARED对待。
EXCLUDE_FROM_ALL 参数的意思是这个库不会被默认构建，除非有其他的组件依赖或者手工构建。
例如：
add_library(kafkawrapper SHARED ${kafka_wrapper_srcs})
TARGET_LINK_LIBRARIES(kafkawrapper rdkafka rdkafka++ crypto ssl)

target_link_libraries(hello a b.a c.so) 将若干库文件链接到目标hello中，target_link_libraries里的库文件的顺序符合gcc/g++链接顺序的规则，即被依赖的库放在依赖它的库的后面，如果顺序有错，链接时会报错。
自定义链接选项
自定义Makefile目标

target_link_libraries( … … …) 其中必须在当前目录中被add_executable()命令或add_library()命令创建出来。

小型程序的CMakeLists.txt模板：

cmake_minimum_required(VERSION 2.8) //cmake的最低版本

project(example) //项目名

include_directories("/usr/include") //程序所需头文件的位置

link_directories("/usr/lib") //程序所需库文件的位置

add_executable(example example.cpp) //编译example.cpp生成example对象文件

target_link_libraries(example gsl) //链接libgsl.a链接库文件到example对象文件中

target_link_libraries(example gslcblas) //链接libgslcblas.a链接库文件到example对象文件中

FIND_PATH( name1 [path1 path2 …]) 该命令在参数path1, path2…指示的目录中查找文件name1并将查找到的路径保存到变量VAR中
FIND_LIBRARY 同FIND_PATH类似，用于查找链接库并将结果保存在变量中

Example：在开发软件的时候我们会用到一些函数库，这些函数库在不同的系统中安装的位置可能不同，编译的时候需要首先找到这些头文件以及链接库所在的目录以便生成编译选项。

第一步，在项目的根目录中创建目录cmake/modules/, cmake/modules/下创建文件Findlibxx.cmake,内容如下：

MESSAGE(STATUS “Using budled findlibxx.cmake…”)

FIND_PATH(

LIB_XX_INCLUDE_DIR

XX.h

/usr/include/

/use/local/include/

)

//在/usr/lib/ 和/usr/local/lib/目录下，寻找名为xx的链接库，并将结果保存在 LIB_XX_LIBRARIES中

FIND_LIBRARY(

LIB_XX_LIBRARIES NAMES XX

PATHS /usr/lib/  /usr/local/lib/

)

第二步，项目的根目录中的CmakeList.txt

project(main)

cmake_minimum_required(version 2.8)

set(CMAKE_SOURCE_DIR .)

set(CMAKE_MODULE_PATH ${CMAKE_ROOT}/Modules ${CMAKE_ROOT}/cmake/modules}

aux_source_directory(. DIR_SRCS)

add_executable(main ${DIR_SRCS})

find_package(XX required)

mark_as_advanced(

LIB_XX_INCLUDE_DIR

LIB_XX_LIBRARIES

)

文章来源：
http://www.cnblogs.com/cbyzju/p/5180897.html

下面是实际项目中一个CMakeLists.txt:

PROJECT(TRADE)

AUX_SOURCE_DIRECTORY(./ SRC_LIST)
SET(EXECUTABLE_OUTPUT_PATH ../bin)

ADD_DEFINITIONS(-g -O0 -W -Wall -D_REENTRANT -D_FILE_OFFSET_BITS=64 -DAC_HAS_INFO -DAC_HAS_WARNING -DAC_HAS_ERROR -DAC_HAS_CRITICAL -DTIXML_USE_STL -DHAVE_CXX_STDHEADERS -Wno-deprecated ${CMAKE_CXX_FLAGS})


INCLUDE_DIRECTORIES(
./
/usr/local/include/commonlib/dbapi
/usr/local/include/commonlib/json2
/usr/local/include/commonlib/mysql
/usr/local/include/commonlib/svrutil2
/usr/local/include/commonlib/fastdb
)

LINK_DIRECTORIES(
./
/usr/local/lib/commonlib
)

ADD_EXECUTABLE(trade ${SRC_LIST})

TARGET_LINK_LIBRARIES(trade pthread netutil svrutil dl json2 z mysqlclient dbapi fastdb)

需要注意的几个地方：
一、一般像系统的头文件目录和库文件目录，如/usr/lib /usr/lib64，不需要在INCLUDE_DIRECTORIES和LINK_DIRECTORIES指定，编译器会自动去其中查找。
二、另外光指定库路径还不行，你用了哪个库还需要在TARGET_LINK_LIBRARIES中指定，库名字一般去掉前缀lib，比如上文中的mysqlclient真正的名字叫libmysqlclient。否则编译能通过，链接可能出现错误，如：

CMakeFiles/testlibevent.dir/main.o: In function `onTime(int, short, void*)':
/home/zhangyl/testlibevent/main.cpp:14: undefined reference to `event_add'
CMakeFiles/testlibevent.dir/main.o: In function `main':
/home/zhangyl/testlibevent/main.cpp:20: undefined reference to `event_init'
/home/zhangyl/testlibevent/main.cpp:24: undefined reference to `event_set'
/home/zhangyl/testlibevent/main.cpp:30: undefined reference to `event_add'
/home/zhangyl/testlibevent/main.cpp:33: undefined reference to `event_dispatch'
collect2: error: ld returned 1 exit status
make[2]: *** [testlibevent] Error 1
make[1]: *** [CMakeFiles/testlibevent.dir/all] Error 2
make: *** [all] Error 2