cmake 學習筆記(一)

看來不學習一下cmake是不行了，一點一點來吧，找個最簡單的C程序，慢慢複雜化，試試看：

例子一

一個經典的C程序，如何用cmake來進行構建程序呢？

//main.c#include <stdio.h>int main(){ printf("Hello World!/n"); return 0;}

編寫一個 CMakeList.txt 文件(可看做cmake的工程文件)：

project(HELLO)set(SRC_LIST main.c)add_executable(hello ${SRC_LIST})

然後，建立一個任意目錄（比如本目錄下創建一個build子目錄），在該build目錄下調用cmake

cmake .. -G"NMake Makefiles"nmake

或者

cmake .. -G"MinGW Makefiles"make

即可生成可執行程序 hello(.exe)

目錄結構

+| +--- main.c+--- CMakeList.txt|/--+ build/ | +--- hello.exe

cmake 真的不太好用哈，使用cmake的過程，本身也就是一個編程的過程，只有多練才行。

我們先看看：前面提到的這些都是什麼呢？

第一行project不是強制性的，但最好始終都加上。這一行會引入兩個變數

同時，cmake自動定義了兩個等價的變數

因為是out-of-source方式構建，所以我們要時刻區分這兩個變數對應的目錄

可以通過message來輸出變數的值

message(${PROJECT_SOURCE_DIR})

set命令用來設置變數

add_exectuable告訴工程生成一個可執行文件。

add_library則告訴生成一個庫文件。

cmake命令

cmake 命令後跟一個路徑(..)，用來指出 CMakeList.txt 所在的位置。

由於系統中可能有多套構建環境，我們可以通過-G來制定生成哪種工程文件，通過cmake-h可得到詳細信息。

要顯示執行構建過程中詳細的信息(比如為了得到更詳細的出錯信息)，可以在CMakeList.txt內加入：

或者執行make時

或者

例子二

一個源文件的例子一似乎沒什麼意思，拆成3個文件再試試看：

#ifndef DBZHANG_HELLO_#define DBZHANG_HELLO_void hello(const char* name);#endif //DBZHANG_HELLO_

#include <stdio.h>#include "hello.h"void hello(const char * name){ printf ("Hello %s!/n", name);}

#include "hello.h"int main(){ hello("World"); return 0;}

project(HELLO)set(SRC_LIST main.c hello.c)add_executable(hello ${SRC_LIST})

執行cmake的過程同上，目錄結構

+| +--- main.c+--- hello.h+--- hello.c+--- CMakeList.txt|/--+ build/ | +--- hello.exe

例子很簡單，沒什麼可說的。

接前面的例子，我們將 hello.c 生成一個庫，然後再使用會怎麼樣？

改寫一下前面的CMakeList.txt文件試試：

project(HELLO)set(LIB_SRC hello.c)set(APP_SRC main.c)add_library(libhello ${LIB_SRC})add_executable(hello ${APP_SRC})target_link_libraries(hello libhello)

和前面相比，我們添加了一個新的目標 libhello，並將其鏈接進hello程序

然後想前面一樣，運行cmake，得到

+| +--- main.c+--- hello.h+--- hello.c+--- CMakeList.txt|/--+ build/ | +--- hello.exe +--- libhello.lib

裡面有一點不爽，對不？

添加一行

set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")

就可以了

在前面，我們成功地使用了庫，可是源代碼放在同一個路徑下，還是不太正規，怎麼辦呢？分開放唄

我們期待是這樣一種結構

+|+--- CMakeList.txt+--+ src/| || +--- main.c| /--- CMakeList.txt|+--+ libhello/| || +--- hello.h| +--- hello.c| /--- CMakeList.txt|/--+ build/

哇，現在需要3個CMakeList.txt 文件了，每個源文件目錄都需要一個，還好，每一個都不是太複雜

project(HELLO)add_subdirectory(src)add_subdirectory(libhello)

include_directories(${PROJECT_SOURCE_DIR}/libhello)set(APP_SRC main.c)add_executable(hello ${APP_SRC})target_link_libraries(hello libhello)

set(LIB_SRC hello.c)add_library(libhello ${LIB_SRC})set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")

恩，和前面一樣，建立一個build目錄，在其內運行cmake，然後可以得到

回頭看看，這次多了點什麼，頂層的 CMakeList.txt 文件中使用 add_subdirectory 告訴cmake去子目錄尋找新的CMakeList.txt 子文件

在 src 的 CMakeList.txt 文件中，新增加了include_directories，用來指明頭文件所在的路徑。

前面還是有一點不爽：如果想讓可執行文件在 bin 目錄，庫文件在 lib 目錄怎麼辦？

就像下面顯示的一樣：

+ build/ | +--+ bin/ | | | /--- hello.exe | /--+ lib/ | /--- hello.lib

project(HELLO)add_subdirectory(src bin)add_subdirectory(libhello lib)

不是build中的目錄默認和源代碼中結構一樣么，我們可以指定其對應的目錄在build中的名字。

這樣一來：build/src 就成了 build/bin 了，可是除了 hello.exe，中間產物也進來了。還不是我們最想要的。

src/CMakeList.txt 文件

include_directories(${PROJECT_SOURCE_DIR}/libhello)#link_directories(${PROJECT_BINARY_DIR}/lib)set(APP_SRC main.c)set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)add_executable(hello ${APP_SRC})target_link_libraries(hello libhello)

libhello/CMakeList.txt 文件

set(LIB_SRC hello.c)add_library(libhello ${LIB_SRC})set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")

例子六

在例子三至五中，我們始終用的靜態庫，那麼用動態庫應該更酷一點吧。 試著寫一下

如果不考慮windows下，這個例子應該是很簡單的，只需要在上個例子的 libhello/CMakeList.txt 文件中的add_library命令中加入一個SHARED參數：

add_library(libhello SHARED ${LIB_SRC})

可是，我們既然用cmake了，還是兼顧不同的平台吧，於是，事情有點複雜：

#ifndef DBZHANG_HELLO_#define DBZHANG_HELLO_#if defined _WIN32 #if LIBHELLO_BUILD #define LIBHELLO_API __declspec(dllexport) #else #define LIBHELLO_API __declspec(dllimport) #endif#else #define LIBHELLO_API#endifLIBHELLO_API void hello(const char* name);#endif //DBZHANG_HELLO_

set(LIB_SRC hello.c)add_definitions("-DLIBHELLO_BUILD")add_library(libhello SHARED ${LIB_SRC})set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")

恩，剩下來的工作就和原來一樣了。