使用CMake,程序员必需编写好CMake脚本CMAkeLists.txt,对于一些复杂的项目,可能需要编写CMake模块,但对于构建过程而言,则是极其简单的。
相形之下,GNU AutoTools是很复杂的,无论是程序员在撰写Makefile.am,还是构建时的步骤。致命的是,GNU AutoTools间很难兼容。
另外,CMake的构建过程会比GNU AutTools在速度上有优势,在输出上更是很友好。
下面的是来自Google的趋势图,可以看出CMake的应用情况。
我们先来看个简单的CMake项目。这里有4个文件:CMakeLists.txt, main.cpp, pr.cpp, pr.h。
CMakeLists.txt的内容如下:
project(MyProject)
cmake_minimum_required(VERSION2.8)
add_library(pr SHARED pr.cpp)
target_link_libraries(pr m)
add_library(prs STATIC pr.cpp)
target_link_libraries(prs m)
set_target_properties(prs PROPERTIES OUTPUT_NAME pr)
add_executable(mypr main.cpp)
target_link_libraries(mypr pr)
set(PR_HEADER pr.h)
install(TARGETS mypr pr prs
RUNTIME DESTINATION bin
LIBRARY DESTINATION lib
ARCHIVE DESTINATION lib/static)
install(FILES ${PR_HEADER}
DESTINATION include)
这个CMake脚本声明了此项目名为MyProject,并要求cmake的最少版本为2.8。
通常情况下2.6以上的特性不会用到,除非在一些复杂的项目中要自己处理一些问题而用到例如function这样的宏。
要构建这个项目,可在所在目录建立一个目录,例如名为build,并切换到该目录,然后执行cmake .. && make
一般的项目会涉及到多个模块,文档以及测试用例等。下图为一般CMake项目的文件布局。每一层目录如果包含有构建目标,一般都会有一个CMakeLists.txt。
包含CMakeLists.txt的子目录通常由上层的CMakeLists.txt用语句add_subdirectory来包含。对于这个项目而言,顶层的CMakeLists.txt包含如下的语句:
add_subdirectory(include)
add_subdirectory(src)
add_subdirectory(tests)
add_subdirectory(docs)
在多个模块的情况下,可能一个模块的链接依赖於其它模块,例如一个可执行二进制需要链接某些模块,此时link_directories将有发挥作用。
如在CMakeLists.txt增加:link_directories(${MyProject_BINARY_DIR}/src/libxxx
${MyProject_BINARY_DIR}/src/libyyy)
将指示CMake在LDFLAGS附加-Lsrc/libxxx -Lsrc/libyyy。
放置在src下的代码要引用include的头文件,可以使用相对路径引用,也可以让include放置在头文件搜索路径中,即CPPFLAGS,-Iinclude。如何指示CMake呢?只需要加上include_directories(BEFORE include),或者include_directories(BEFORE ${MyProject_SOURCE_DIR}/include),前者引用CMakeLists.txt的相对路径,而后者则是依项目的完整路径。
在上面提及到set可以修改一些内部变量,例如可以修改编译器的参数,如
set(CMAKE_C_FLAGS ”-std=c99 -O2 -pipe -Wall -Wextra”)
set(CMAKE_C_FLAGS_DEBUG ”${CMAKE_C_FLAGS} -g -ggdb -pg”)
set(CMAKE_C_FLAGS_RELEASE ”${CMAKE_C_FLAGS} -s -DNDEBUG”)
CMake还提供了一些find函数,如find_package、find_library,用于检查项目构建的依赖或者控制功能的开启。
这些功能已经超出今天的简单介绍,有兴趣的朋友请参考官方资讯。
http://www.cmake.org/Wiki/CMake:Articles
http://www.cmake.org/Wiki/CMake_FAQ
http://techbase.kde.org/Development/CMake
http://techbase.kde.org/Policies/CMake_Coding_Style