cmake介紹和使用cmake實踐

Cmake優點:

1.       開發源代碼,實用類BSD許可發佈。

2.       跨平臺,並可以生成native編譯配置文件,在linux/unix平臺,生成makefile,在mac平臺可以生成xcode,在windows平臺可以生成msvc工程的配置文件。

3.       能夠管理大型項目

4.       簡化編譯構建過程和編譯過程,只需要cmake+make就可以

5.       高效率

6.       可擴展,可以爲cmake編寫特定功能的模塊,擴充cmake功能

如何安裝cmake

1.       Cmake的安裝可以使用autotools進行安裝,點擊cmake-2.8.6.tar.gz 鏈接,可以對軟件進行下載。

2.       ./configure

3.       make

4.       sudo make install

 

Cmake的原理

 

Helloworld cmake

//main.cpp

#include<cstdio>

 

int main()

{

    printf("hello world from main\n");

    return 0;

}

 

創建CMakeLists.txt(注意大小寫一個字母都不能錯)

向該文件中加入以下幾行(稍後會做解釋)

PROJECT (HELLO)

SET(SRC_LIST main.cpp)

MESSAGE(STATUS "This is BINARY dir " ${HELLO_BINARY_DIR})

MESSAGE(STATUS "This is SOURCE dir "${HELLO_SOURCE_DIR})

ADD_EXECUTABLE(hello ${SRC_LIST})

運行以下命令:

cmake . (別忘記加上這個點,表示當前目錄)


注意執行完這句話之後會生成幾個文件如下:


CMakeFiles, CMakeCache.txt, cmake_install.cmake等文件,並且生成了Makefile

然後執行make 就可以生成可執行文件hello


這是當前目錄下就會生成可執行文件如下圖:


對例子的解釋:

CMakeLists.txt的內容如下:

PROJECT (HELLO)

SET(SRC_LIST main.cpp)

MESSAGE(STATUS "This is BINARY dir " ${HELLO_BINARY_DIR})

MESSAGE(STATUS "This is SOURCE dir "${HELLO_SOURCE_DIR})

ADD_EXECUTABLE(hello ${SRC_LIST})

 

Project的指令的語法是:

PROJECT(projectname [CXX] [C] [JAVA])

這個執行是用來定義工程的名稱的和定義工程支持的語言。這個指令也隱式的定義了兩個cmake變量:<projectname>_BINARY_DIR以及<projectname>_BINARY_DIR,這裏就是HELLO_BINARY_DIR和HELLO_SOURCE_DIR,兩個變量指的都是當前工程的路徑。

SET指令的語法:

SET(VAR[VALUE] [CACHE TYPE DOCSTRING [FORCE]])

Set指令是用來顯式的定義變量的,我們之前用到的是SET(SRC_LIST main.cpp)如果有多個源文件,也可以定義成SET(SRC_LIST main.cpp t1.cpp t2.cpp)。

 

MESSAGE指令的語法是:

MESSAGE([SEND_ERROR | STATUS | FATAL_ERROR] "message to display" ...)

這個指令用於向終端輸出用戶信息,包含三種類型:

SEND_ERROR,產生錯誤,生成過程被跳過。

SATUS,輸出前綴爲-的信息。

FATAL_ERROR,立即終止所有cmake過程。

我們在這裏使用的是STATUS信息輸出,顯示了由PROJECT指令頂一頂兩個飲食變量HELLO_BINARY_DIR和HELLO_SOURCE_DIR。

 

ADD_EXECUTABLE(hello ${SRC_LIST})

定義了這個工程會生成一個文件名爲hello的可執行文件,相關的源文件是SRC_LIST中定義的源文件列表,本例中你可以直接寫成ADD_EXECUTABLE(hello main.c)。

 

將本例改寫成一個最簡化的CMakeLists.txt:

PROJECT(HELLO)

ADD_EXECUTABLE(hello main.c)

 

下面我們介紹一個比較實用的例子,即包含生成靜態庫又包含引入外部頭文件和鏈接庫的cmake demo。

先按照工程規範建立工程目錄,並編寫代碼,以下面的工程目錄爲例進行解釋這個例子,工程的目錄結構爲:

 

編譯工程要實現的目標:

1. 添加子目錄doc,用以放置這個工程的文檔hello.txt

2. 生成hello的靜態庫,並在main可執行程序鏈接hello靜態庫

3. 在這個工程中添加COPYRIGHT,README

4. 在工程目錄中添加一個run.sh的腳本,用以調用生成的二進制可執行文件

5. 將生成的二進制文件生成到bin子目錄中

6. 編寫安裝程序

 

1. 編寫CMakeLists.txt

由於一個工程目錄中包含多個項目,其中在此項目中包含util項目和main項目,其中util項目是用以生成main程序需要的靜態庫,main是用以生成可執行文件。

在工程項目中的父目錄向有一個CMakeLists.txt是用以聲明定義工程需要的Cmake設置還定義了子目錄src,用以遞歸的調用src中的MakeLists.txt。其中工程目錄的CMakeLists.txt內容定義如下:

PROJECT(HELLO)

ADD_SUBDIRECTORY(src)

在src裏面的CMakeLists.txt是用以定義src目錄包含的兩個工程的依賴關係分別進行編譯。

util目錄裏面的CMakeLists.txt是用以定義生成util靜態庫的規則,其中內容如下:

SET(LIBRARY_OUTPUT_PATH ${HELLO_SOURCE_DIR}/lib)

SET(CMAKE_C_COMPILER g++)

SET(SRC_LIST hello.c)

 

INCLUDE_DIRECTORIES(${HELLO_SOURCE_DIR}/include)

ADD_LIBRARY(util STATIC ${SRC_LIST})

其中SET(LIBRARY_OUTPUT_PATH ${HELLO_SOURCE_DIR}/lib)定義了庫生成的路徑,LIBRARY_OUTPUT_PATH是一個內部變量,存放庫生成路徑。

SET(SRC_LIST hello.c)是用來定義庫文件需要的源文件。

INCLUDE_DIRECTORIES(${HELLO_SOURCE_DIR}/include)是用來定義非標準庫頭文件要搜索的路徑。其中INCLUDE_DIRECTORIES命令的格式爲:

INCLUDE_DIRECTORIES([AFTER|BEFORE] [SYSTEM] dir1 dir2 ...)

ADD_LIBRARY(util STATIC ${SRC_LIST})是用來定義生成的庫的名字,以及生成庫的類型和生成庫需要的源文件,其中ADD_LIBRARY命令格式爲:

     ADD_LIBRARY(libname    [SHARED|STATIC|MODULE]

          [EXCLUDE_FROM_ALL]

                source1 source2 ... sourceN)

SET(CMAKE_C_COMPILER g++)是用來定義c的編譯器爲g++,防止出現C和C++代碼在不指定C編譯器的情況下默認使用gcc,導致系統編譯混亂。

在main目錄中的CMakeLists.txt是用來定義可執行程序編譯和鏈接時所需要的一些命令或環境。內容如下:

SET(EXECUTABLE_OUTPUT_PATH ${HELLO_SOURCE_DIR}/bin)

SET(SRC_LIST main.cpp)

 

INCLUDE_DIRECTORIES(${HELLO_SOURCE_DIR}/include)

LINK_DIRECTORIES(${HELLO_SOURCE_DIR}/lib)

 

ADD_EXECUTABLE(hello ${SRC_LIST})

TARGET_LINK_LIBRARIES(hello util)

INCLUDE_DIRECTORIES命令是定義工程的include文件夾,其中存放使用到的庫的頭文件,LINK_DIRECTORIES是定義工程的庫文件,其中存放着庫文件,ADD_EXECUTABLE是定義生成的可執行文件,TARGET_LINK_LIBRARIES用以定義鏈接時需要的庫文件。

2.在工程目錄下創建build目錄,並採用out-of-source方式編譯項目。執行命令make ..,執行結果如下:


執行make,這時在build目錄下生成了中間編譯文件:


執行make命令,結果如下:


可以看到工程創建和編譯成功了。

2. 安裝

在工程目錄下添加COPYRIGHT、README、和run.sh,重新編輯工程目錄下的CMakeLists.txt。在CMakeLists.txt中添加如下命令:

INSTALL(FILES COPYRIGHT README DESTINATION share/doc/cmake_demo)

INSTALL(PROGRAMS run.sh DESTINATION bin)

INSTALL(PROGRAMS bin/hello DESTINATION bin)

INSTALL(DIRECTORY doc/ DESTINATION share/doc/cmake_demo)

這些命令表示在執行make install命令時,安裝程序會拷貝相應的文件、目錄或程序到指定的前綴開始的目錄中,cmake執行命令如下:

cmake -DCMAKE_INSTALL_PREFIX=~/data/cmake_demo ..這時將工程目錄安裝到~/data/cmake_demo目錄下。執行結果如下:


其中cmake編譯c、c++工程完畢。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章