Cmake使用教程(一)

很久没写博客了,技术博客再开!

进入新环境,适应段时间之后又开始了新的学习。Cmake是编程领域重要的工具。这篇博客就介绍从零开始的cmake教程。

补:又发现一个简介明了的cmake教程http://www.hahack.com/codes/cmake/。

1.单个文件编译

如果只需要编译main.cpp,那么在目录下新建名为CMakeLists.txt的文件,在其中加入如下代码即可:

cmake_minimum_required(VERSION 2.8)
add_definitions("-Wall -std=c++11") # <= 新增的编译选项
add_executable(Main main.cpp)

然后在目录下运行如下命令,即可生成目标执行文件Main

cmake .
make

2.单目录多个源文件编译

加入你的项目中有如下四个源文件main.cpp、mod.hpp、mod_func1.cpp、mod_func2.cpp。因为cmake可以很轻松地解析出各文件的依赖关系,因此CMakeLists.txt其实十分简单:

cmake_minimum_required(VERSION 2.8)
add_executable(Main
  main.cpp
  mod_func1.cpp
  mod_func2.cpp
)

3.多目录程序的编译

假如项目的目录结构如下:

项目名/
  main.cpp
  mod1.hpp
  mod1/
    func1.cpp
    func2.cpp
  mod2.hpp
  mod2/
    func1.cpp
    func2.cpp

编译该工程,一般有以下两种方法:

3.1 整个项目仅编写单个CMakeLists.txt

在项目的根目录下编写CMakeLists.txt

cmake_minimum_required(VERSION 2.8)
add_executable(Main
  main.cpp
  mod1/func1.cpp
  mod1/func2.cpp
  mod2/func1.cpp
  mod2/func2.cpp
)

3.2 每个目录均编写一个CMakeLists.txt

#CMakeLists.txt
cmake_minimum_required(VERSION 2.8)
add_subdirectory(mod1) 
add_subdirectory(mod2) 
add_executable(Main main.cpp)
target_link_libraries(Main Mod1 Mod2) 
#mod1/CMakeLists.txt
cmake_minimum_required(VERSION 2.8)
add_library(Mod1 STATIC
  func1.cpp
  func2.cpp
)
#mod2/CMakeLists.txt
cmake_minimum_required(VERSION 2.8)
add_library(Mod2 STATIC
  func1.cpp
  func2.cpp
)

这种方法似乎要编写更多的代码,但是更加模块化,管理会更加轻松。

add_library

如果加上了STATIC,那么就是生成静态库,比如上面的例子将生成mod1/libMod1.a和mod2/libMod2.a两个库文件。

add_subdirectory

用于添加cmake管理的目录,如果该目录下没有CMakeLists.txt文件,将会直接报错。通过add_definitions和set定义的变量可以传送到对于的子目录,但在子目录设置的变量将不会影响到父目录。

target_link_libraries

将库文件链接到指定的可执行文件,最终生成的linux命令类似于-lMod1 -lMod2。camke会自动寻找对应名称的库文件,而无需书写类似“mod1/Mod1”这样的完整路径。

 

 

 

《Cmake使用教程(一)》有1条评论

发表评论