1. 程式人生 > >【C/C++】從零開始的cmake教程

【C/C++】從零開始的cmake教程

本文轉自:https://blog.csdn.net/gg_18826075157/article/details/72780431
通過編寫CMakeLists.txt,然後執行cmake命令可以自動生成對應Makefile,從而控制make的編譯過程。因此在學習cmake之前,建議先對make有個大致的瞭解。(歡迎閱讀本人編寫的另一篇部落格【C/C++】從零開始的Make教程)。

 

1.單個原始檔的編譯
如果你的專案只有一個原始檔main.cpp,那麼只需要在同一個目錄下新建一個名為CMakeLists.txt的檔案,並新增下面的兩行程式碼即可。
cmake_minimum_required(VERSION 2.8)
add_executable(Main main.cpp)

然後執行下面的命令,直接生成目標可執行檔案Main。
cmake .
make

如果要新增編譯選項,可以通過下面的方法:
cmake_minimum_required(VERSION 2.8)
add_definitions("-Wall -std=c++11") # <= 新增的編譯選項
add_executable(Main main.cpp)
 

2.單目錄多原始檔的編譯
假如你的專案中只有下面4個原始檔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
一般有以下兩種方法:


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
)
 

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”這樣的完整路徑。