cmake总结
无论生活还是工作上,做过的事,需要总结下。
接触cmake,一般都会看一本书 <<cmake 实践>>. 这是cmake的入门书。我就不多说了。
下面说一下我对部分cmake命令的使用与理解,不正确的,请大家指点,谢谢!
1. 所有的注释,都以#开头。
#XXX Build Script
#CMakeLists.txt
#
#Copyright (c) 2011, L
#All rights reserved.
2. cmake版本的控制。
cmake_minimum_required (VERSION 2.8)
3. 定义项目名称。
PROJECT (xxx)
4. 如果想看到更多cmake编译时候的信息,置为ON,否则为OFF.
set(CMAKE_VERBOSE_MAKEFILE ON)
5. 在项目中,我们一般会用到一些第三方库。cmake支持一些,注意,只是部分。例如对Boost的支持,对apr的不支持。
set(Boost_USE_STATIC_LIBS ON)
set(Boost_USE_MULTITHREAD ON)
find_package(Boost 1.4.3 REQUIRED)
如果你的机器上装有Boost,它会自动找出来,找不出来,就会报错,停止编译。(REQUIRED的作用)
在项目中,我们用到了apache runtime library(apr).cmake不支持,我的解决方法手动添加apr的路径。
例如:
#apr
SET(APR_ROOT $ENV{APR_DIST})
尝试写个.cmkae模块,用findXXX调用,但是不知道该如何如找apr的安装路径。有知道的朋友,希望指点,谢谢!
找到Boost后,我们会自动得到它的include路径和lib路径。
同时,我们可以得到一些库的名称。
MESSAGE(STATUS "Boost include path:" ${Boost_INCLUDE_DIRS})
MESSAGE(STATUS "Boost lib path:" ${Boost_LIBRARY_DIRS})
FIND_PACKAGE(Boost REQUIRED COMPONENTS system)
STRING(REPLACE "boost_system" "boost_regex" Boost_REGEX_LIBRARY ${Boost_SYSTEM_LIBRARY})
STRING(REPLACE "boost_system" "boost_regex" Boost_REGEX_LIBRARY_DEBUG ${Boost_SYSTEM_LIBRARY_DEBUG})
STRING(REPLACE "boost_system" "boost_regex" Boost_REGEX_LIBRARY_RELEASE ${Boost_SYSTEM_LIBRARY_RELEASE})
6. 如果你的cmake实现中,用到了一些模块,例如*.cmake.这个时候,需要
#set module path. for FindXXX.cmake
SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR})
7. 创建宏。
例如你建的工程是unicode 编码,可以这样:
#set character set. unicode
add_definitions(-DUNICODE -D_UNICODE)
8. 添加子目录,它会去子目录中寻找CmakeLists.txt,然后执行它。
ADD_SUBDIRECTORY(subdir)
9. 将一个文件下的编译用的源文件添加到一个宏列表中。
AUX_SOURCE_DIRECTORY(. SRC_LIST)
注意,它只是将.cc .cpp .c的文件添加到SRC_LIST中,.h除外。
10. 如果你想将.h文件也加进来,使用
file (GLOB HEADERS "include/*.h")
SET(SRC_LIST ${SRC_LIST} ${HEADERS})
注意GLOB这个参数,它不支持子目录。如果你想让它支持子目录,用GLOB_RECURSE。
在vs中可以创建子文件夹,这样会使我们的项目看上去美观,规范。
cmake支持这一功能。
source_group(Include\\utils FILES ${HEADERS})
这个可以亲自试试,看看效果。在使用这个命令的时候,本想用regex,正则来处理,试过了好几次,发现cmake好像不怎么支持正则,例如Perl的语法。
例如:if(${f} MATCHES "(.*)(\.h)$")
如在这块有心得的朋友,希望指点下,哈哈。
11. 头文件包含路径及库路径
INCLUDE_DIRECTORIES
link_directories
12. 在windows+vs中,如果我们想改变项目的输出路径,dll, .lib,需要
IF(MSVC)
set( CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${PROJECT_SOURCE_DIR}/bin )
set( CMAKE_ARCHIVE_OUTPUT_DIRECTORY_DEBUG ${PROJECT_SOURCE_DIR}/lib )
ELSE(MSVC)
set( CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/bin )
set( CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}/lib )
ENDIF(MSVC)
13. 检查一个文件或目录是否存在,用
if(NOT EXISTS ${APR_ROOT})
endif()
注意这里的if,是小写的,用大写的,就会报错,为此,我折腾了半天。
14. cmake提供了gui界面。如果想使用界面方式,例如:设置变量MY_ROOT的值
SET(MY_ROOT "/usr/lib" CACHE PATH "my root path")
记得不要加FORCE。加上了,会rebuild,不是我们想要的效果。
好了,希望对用得到的朋友,有所帮助。谢谢!