cmake 從放棄到入門

2020-06-16 16:45:50

這是我看過最好的cmake入門文章，短小精悍，情不自禁做一分享，原文地址如下：
http://derekmolloy.ie/hello-world-introductions-to-cmake/

簡介

cmake的亮點在於編譯複雜專案上的應用 —— cmake是一個跨平台的Makefile 生成工具!
一言以蔽之——cmake 為專案自動生成Makefile, 雖然cmake功能遠不止步於此，但是本文聚焦於此。

原始碼

這篇文章是cmake的helloworld, 所用範例非常短小，我按照原文在Ubuntu上測試了，全部通過，所以程式碼可以放心使用。
本文程式碼位於github：

git clone https://github.com/derekmolloy/exploringBB.git

例1:Hello World

第一個例子的原始碼位於extras/cmake/helloworld ，原始碼只有一個檔案HelloWorld.cpp：

#include<iostream>

int main(int argc, char *argv[]){
std::cout << "Hello World!" << std::endl;
return 0;
}

CMakeLists.txt也只有三行而已（使用cmake管理專案的過程，也就是編寫CMakeLists.txt的過程）

cmake_minimum_required(VERSION 2.8.9)
project (hello)
add_executable(hello helloworld.cpp)

第一行用於指定cmake最低版本
第二行指定專案名稱（這個名稱是任意的）
第三行指定編譯一個可執行檔案，hello是第一個引數，表示生成可執行檔案的檔名（這個檔名也是任意的），第二個引數helloworld.cpp則用於指定原始檔。

如果您電腦上已經安裝了cmake，那麼我們就已經完事具備了。
第一步，用cmake生成Makefile檔案

cmake命令後邊跟的就是CMakelist.txt所在的目錄，這個目錄不必是當前目錄，你也可以新建一個build目錄或者其他名字的目錄來生成build檔案，實際專案中也都是這麼做的，這樣程式碼會很乾淨也便於git管理：

第二步，make編譯程式，編譯成功

通過上一步我們發現，當前目錄下已經多出了幾個檔案，特別是Makefile檔案

第三步，測試程式
到此，第一個用cmake管理的程式，成功了！

例2: 包含目錄結構的專案

在例1中完全體現不出cmake的任何優勢，用g++一行可以解決的問題我們繞了一大圈。可是cmake本來的優勢就是管理龐大的專案的。

這個例子用最小的程式來體現一個帶目錄結構的專案。其中有原始檔目錄，標頭檔案目錄。額。。。這就夠了，範例程式碼位於/extras/cmake/student

範例的目錄結構如下圖：

cmake_minimum_required(VERSION 2.8.9)
project(directory_test)

#Bring the headers, such as Student.h into the project
include_directories(include)

#Can manually add the sources using the set command as follows:
#set(SOURCES src/mainapp.cpp src/Student.cpp)

#However, the file(GLOB...) allows for wildcard additions:
file(GLOB SOURCES "src/*.cpp")

add_executable(testStudent ${SOURCES})

和第一個例子比起來，CMakelist.txt有如下改變：
1. 使用include_directories() 包含標頭檔案目錄
2. 使用set(SOURCES … ) 或GLOB (or GLOB_RECURSE) 設定原始檔SOURCES
3. add_executable 使用變數SOURCES ，而不是具體的檔名
接下來的步驟就和例子1一樣了，不同之處是我們新建了一個build目錄來儲存編譯中間檔案，如下圖：

下一步make，然後執行結果如下：

例3：動態庫編譯(.so)

有了前兩個例子的基礎，接下來的例子我們只需要看一下目錄結構和CMakelist.txt.本例程式碼位於/exploringBB/extras/cmake/studentlib_shared

CMakelist.txt如下：

project(directory_test)
set(CMAKE_BUILD_TYPE Release)

#Bring the headers, such as Student.h into the project
include_directories(include)

#However, the file(GLOB...) allows for wildcard additions:
file(GLOB SOURCES "src/*.cpp")

#Generate the shared library from the sources
add_library(testStudent SHARED ${SOURCES})

#Set the location for library installation -- i.e., /usr/lib in this case
# not really necessary in this example. Use "sudo make install" to apply
install(TARGETS testStudent DESTINATION /usr/lib)

兩個重要變化：
1. 我們不再使用add_executable() 而是使用add_library()
2. install 指定安裝目錄，執行sudo make install時動態庫將被安裝在/usr/lib目錄
如前兩個例子，我們依次執行，cmake make編譯結果如下：

例4：靜態庫編譯 (.a)

基於例3，我們編譯一個靜態庫，程式碼位置
exploringBB/extras/cmake/studentlib_static/

將CMakeList.txt修改為如下所示：

cmake_minimum_required(VERSION 2.8.9)
project(directory_test)
set(CMAKE_BUILD_TYPE Release)

#Bring the headers, such as Student.h into the project
include_directories(include)

#However, the file(GLOB...) allows for wildcard additions:
file(GLOB SOURCES "src/*.cpp")

#Generate the static library from the sources
add_library(testStudent STATIC ${SOURCES})

#Set the location for library installation -- i.e., /usr/lib in this case
# not really necessary in this example. Use "sudo make install" to apply
install(TARGETS testStudent DESTINATION /usr/li

可以看出，只需將add_library中的shared改為static即可。
編譯結果如下：