cmake使用
文章目錄
一 安裝cmake
sudo apt install cmake
二 cmake使用例子
新建一個hello.c
#include
int main(void)
{
printf("Hello World\n");
return 0;
}
在相同的目錄下新建.txt
cmake_minimum_required (VERSION 2.8)
project (demo)
add_executable(main main.c)
然后輸入以下命令運行cmake,
cmake .
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--62)(C:\Users\\\\\-user-\image-.png)]
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--63)(C:\Users\\\\\-user-\image-.png)]
輸入make就可以使用cmake自動生成的來編譯生成可執行文件hello
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--64)(C:\Users\\\\\-user-\image-.png)]
三 同一個目錄下多個源文件
多個文件的程序只需要在里把所有源文件都添加進去就可以了
但是如果有一百個源文件,再這樣做就有點坑了,無法體現cmake的優越性,cmake提供了一個命令可以把指定目錄下所有的源文件存儲在一個變量中,這個命令就是
(dir var)。
第一個參數dir是指定目錄,第二個參數var是用于存放源文件列表的變量。
cmake_minimum_required (VERSION 2.8)
project (demo)
aux_source_directory(. SRC_LIST)
add_executable(main ${SRC_LIST})
使用set命令去新建變量來存放需要的源文件,如下,
cmake_minimum_required (VERSION 2.8)
project (demo)
set( SRC_LIST

./main.c
./testFunc1.c
./testFunc.c)
add_executable(main ${SRC_LIST})
四 不同目錄下多個源文件
cmake_minimum_required (VERSION 2.8)
project (demo)
include_directories (test_func test_func1)
aux_source_directory (test_func SRC_LIST)
aux_source_directory (test_func1 SRC_LIST1)
add_executable (main main.c ${SRC_LIST} ${SRC_LIST1})
五 正規一點的組織結構
正規一點來說,一般會把源文件放到src目錄下,把頭文件放入到文件下,生成的對象文件放入到build目錄下,最終輸出的elf文件會放到bin目錄下,這樣整個結構更加清晰。讓我們把前面的文件再次重新組織下,
我們在最外層目錄下新建一個.txt,內容如下,
cmake_minimum_required (VERSION 2.8)
project (demo)
add_subdirectory (src)
這里出現一個新的命令(),這個命令可以向當前工程添加存放源文件的子目錄,并可以指定中間二進制和目標二進制的存放位置,具體用法可以百度。
這里指定src目錄下存放了源文件,當執行cmake時,就會進入src目錄下去找src目錄下的.txt,所以在src目錄下也建立一個.txt,內容如下,
aux_source_directory (. SRC_LIST)
include_directories (../include)
add_executable (main ${SRC_LIST})
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
這里又出現一個新的命令set,是用于定義變量的,和是CMake自帶的預定義變量,其意義如下,
TH :目標二進制可執行文件的存放位置
:工程的根目錄
所以,這里set的意思是把存放elf文件的位置設置為工程根目錄下的bin目錄。(cmake有很多預定義變量,詳細的可以網上搜索一下)
添加好以上這2個.txt后,整體文件結構如下,
下面來運行cmake,不過這次先讓我們切到build目錄下,然后輸入以下命令,
cmake ..
會在build目錄下生成,然后在build目錄下運行make,
運行ok,我們再切到bin目錄下,發現main已經生成,并運行測試,
上面的例子也可以只使用一個.txt,把最外層的.txt內容改成如下
cmake_minimum_required (VERSION 2.8)
project (demo)
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
aux_source_directory (src SRC_LIST)
include_directories (include)
add_executable (main ${SRC_LIST})
六 動態庫和靜態庫的編譯控制
以四則運算函數為例
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--64)(C:\Users\\\\\-user-\image-.png)]
cmake_minimum_required (VERSION 3.5)
project (demo)
set (SRC_LIST ${PROJECT_SOURCE_DIR}/arithmetic_test/arithmetic.c)
add_library (arithmetic_shared SHARED ${SRC_LIST})
add_library (arithmetic_static STATIC ${SRC_LIST})
set_target_properties (arithmetic_shared PROPERTIES OUTPUT_NAME arithmeticfunc)
set_target_properties (arithmetic_static PROPERTIES OUTPUT_NAME arithmeticfunc)
set (LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)
這里又出現了新的命令和預定義變量,
: 生成動態庫或靜態庫(第1個參數指定庫的名字;第2個參數決定是動態還是靜態,如果沒有就默認靜態;第3個參數指定生成庫的源文件)
s: 設置最終生成的庫的名稱,還有其它功能,如設置庫的版本號等等
: 庫文件的默認輸出路徑,這里設置為工程目錄下的lib目錄
在build目錄下運行 cmake ..,然后執行make
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--64)(C:\Users\\\\\-user-\image-.png)]
PS: 前面使用s重新定義了庫的輸出名稱,如果不使用s也可以,那么庫的名稱就是里定義的名稱,只是連續2次使用指定庫名稱時(第一個參數),這個名稱不能相同動態庫鏈接靜態庫失敗,而s可以把名稱設置為相同,只是最終生成的庫文件后綴不同(一個是.so,一個是.a),這樣相對來說會好看點。
七 對庫進行鏈接
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--65)(C:\Users\\\\\-user-\image-.png)]
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--65)(C:\Users\\\\\-user-\image-.png)]
cmake_minimum_required (VERSION 3.5)
project (demo)
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
set (SRC_LIST ${PROJECT_SOURCE_DIR}/src/main.c)
#find testfunc.h
include_directories (${PROJECT_SOURCE_DIR}/func/inc)

find_library (TESTFUNC_LIB arithmeticfunc HINTS ${PROJECT_SOURCE_DIR}/func/lib)
add_executable (main ${SRC_LIST})
target_link_libraries (main ${TESTFUNC_LIB})
這里出現2個新的命令,
使用的好處是在執行cmake ..時就會去查找庫是否存在,這樣可以提前發現錯誤,不用等到鏈接時。
cd到build目錄下,然后運行cmake .. && make,最后進入到bin目錄下查看,發現main已經生成,運行之
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img--66)(C:\Users\\\\\-user-\image-.png)]
ps:在lib目錄下有的靜態庫和動態庫,( …默認是查找動態庫,如果想直接指定使用動態庫還是靜態庫,可以寫成( .so …或者( .a …
ps: 查看elf文件使用了哪些庫,可以使用 -d ./xx來查看
八 添加編譯選項
有時編譯程序時想添加一些編譯選項,如-Wall,-std=c++11等,就可以使用來進行操作。
這里以一個簡單程序來做演示,main.cpp如下
#include
int main(void)
{
auto data = 100;
std::cout << "data: " << data << "\n";
return 0;
}
.txt內容如下,
cmake_minimum_required (VERSION 2.8)
project (demo)
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
add_compile_options(-std=c++11 -Wall)
add_executable(main main.cpp)
整體目錄結構如下,
然后cd到build目錄下,執行cmake .. && make命令,就可以在bin目錄下得到main的elf文件
九 添加控制選項
有時希望在編譯代碼時只編譯一些指定的源碼,可以使用cmake的命令,主要遇到的情況分為2種:
本來要生成多個bin或庫文件,現在只想生成部分指定的bin或庫文件
對于同一個bin文件,只想編譯其中部分代碼(使用宏來控制)
第1種情況
假設我們現在的工程會生成2個bin文件,main1和main2,現在整體結構體如下,
外層.txt內容如下
cmake_minimum_required(VERSION 3.5)

project(demo)
option(MYDEBUG "enable debug compilation" OFF)
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
add_subdirectory(src)
這里使用了命令,其第一個參數是這個的名字,第二個參數是字符串,用來描述這個是來干嘛的,第三個是的值,ON或OFF,也可以不寫,不寫就是默認OFF。
然后編寫src目錄下的.txt,如下
cmake_minimum_required (VERSION 3.5)
add_executable(main1 main1.c)
if (MYDEBUG)
add_executable(main2 main2.c)
else()
message(STATUS "Currently is not in debug mode")
endif()
注意,這里使用了if-else來根據來決定是否編譯main2.c
其中main1.c和main2.c的內容如下,
// main1.c
#include
int main(void)
{
printf("hello, this main1\n");
return 0;
}
// main2.c
#include
int main(void)
{
printf("hello, this main2\n");
return 0;
}
然后cd到build目錄下輸入cmake .. && make就可以只編譯出main1,如果想編譯出main2,就把設置為ON,再次輸入cmake .. && make重新編譯。
每次想改變時都需要去修改.txt,有點麻煩,其實可以通過cmake的命令行去操作,例如我們想把設置為OFF,先cd到build目錄,然后輸入cmake … -=ON,這樣就可以編譯出main1和main2 (在bin目錄下)
第2種情況
假設我們有個main.c,其內容如下,
#include

int main(void)
{
#ifdef WWW1
printf("hello world1\n");
#endif
#ifdef WWW2
printf("hello world2\n");
#endif
return 0;
}
可以通過定義宏來控制打印的信息,我們.txt內容如下
cmake_minimum_required(VERSION 3.5)
project(demo)
set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)
option(WWW1 "print one message" OFF)
option(WWW2 "print another message" OFF)
if (WWW1)
add_definitions(-DWWW1)
endif()
if (WWW2)
add_definitions(-DWWW2)
endif()
add_executable(main main.c)
這里把的名字保持和main.c里的宏名稱一致,這樣更加直觀,也可以選擇不同的名字。通過與()的配合,就可以控制單個bin文件的打印輸出了。
整體工程結構如下,
cd到build目錄下執行cmake .. && make,然后到bin目錄下執行./main,可以看到打印為空,
接著分別按照下面指令去執行動態庫鏈接靜態庫失敗,然后查看打印效果
這里有個小坑要注意下:假設有2個叫A和B,先調用cmake設置了A,下次再調用cmake去設置B,如果沒有刪除上次執行cmake時產生的緩存文件,那么這次雖然沒設置A,也會默認使用A上次的值。
所以如果有變化,要么刪除上次執行cmake時產生的緩存文件,要么把所有的都顯式的指定其值。
參考文章
.png)
cd到build目錄下執行cmake .. && make,然后到bin目錄下執行./main,可以看到打印為空,
接著分別按照下面指令去執行,然后查看打印效果
這里有個小坑要注意下:假設有2個叫A和B,先調用cmake設置了A,下次再調用cmake去設置B,如果沒有刪除上次執行cmake時產生的緩存文件,那么這次雖然沒設置A,也會默認使用A上次的值。
所以如果有變化,要么刪除上次執行cmake時產生的緩存文件,要么把所有的都顯式的指定其值。
參考文章
(21條消息) Linux下CMake簡明教程_愛就是恒久忍耐的博客-CSDN博客