CMake簡(jiǎn)明基礎(chǔ)知識(shí)匯總及實(shí)例
CMake是一個(gè)跨平臺(tái)的自動(dòng)化構(gòu)建系統(tǒng),它使用名為CMakeLists.txt的配置文件來描述項(xiàng)目的構(gòu)建過程。CMake能夠生成標(biāo)準(zhǔn)的構(gòu)建文件,如Makefile和Visual Studio項(xiàng)目文件,使得項(xiàng)目可以在不同的平臺(tái)上進(jìn)行編譯和構(gòu)建。本文將簡(jiǎn)要介紹CMake的基礎(chǔ)知識(shí)、語(yǔ)法知識(shí)、構(gòu)建過程,并給出一個(gè)簡(jiǎn)單的實(shí)例。
一、基礎(chǔ)知識(shí)
1. 安裝與使用
CMake的安裝非常簡(jiǎn)便,可以直接下載二進(jìn)制包解壓使用,或者從源碼編譯安裝。使用CMake時(shí),通常通過命令行或CMake的圖形界面(cmake-gui)來生成構(gòu)建文件?;久罡袷綖閏make [options] <path-to-source>,其中<path-to-source>是包含CMakeLists.txt的目錄。
2. 基本概念
In-Source Build:在源代碼目錄中直接構(gòu)建項(xiàng)目。
Out-of-Source Build:將構(gòu)建輸出文件與源文件放到不同目錄中,這是推薦的做法,因?yàn)樗梢员3衷创a的清潔。
3. 基本結(jié)構(gòu)
CMake的構(gòu)建過程依賴于CMakeLists.txt文件,這是CMake的配置文件。一個(gè)項(xiàng)目可以包含多個(gè)CMakeLists.txt文件,通常每個(gè)子目錄都會(huì)有一個(gè),用于描述該子目錄的構(gòu)建規(guī)則。在根目錄的CMakeLists.txt中,可以使用project命令指定項(xiàng)目名稱,使用add_subdirectory命令添加子目錄。
二、語(yǔ)法知識(shí)
1. 注釋
CMake中的注釋以#開頭,直到行尾。
2. 變量
使用set命令定義和賦值變量。在if語(yǔ)句中可以直接使用變量名,在其他地方需要使用${}來引用變量。
3. 命令
CMake的命令不區(qū)分大小寫,但參數(shù)通常區(qū)分大小寫。命令的一般格式為command(args ...),參數(shù)之間用空格分隔,如果參數(shù)中包含空格,可以使用雙引號(hào)括起來。
4. 常用命令
project:指定項(xiàng)目名稱。
add_executable:添加可執(zhí)行程序。
add_library:添加庫(kù)文件。
include_directories:指定頭文件的搜索路徑。
link_directories:指定鏈接庫(kù)的搜索路徑。
target_link_libraries:為目標(biāo)添加鏈接庫(kù)。
message:向終端輸出信息。
5. 條件語(yǔ)句和循環(huán)
CMake支持if、else、elseif和endif語(yǔ)句進(jìn)行條件判斷,以及foreach和while循環(huán)進(jìn)行重復(fù)操作。
三、構(gòu)建過程
CMake的構(gòu)建過程大致可以分為以下幾個(gè)步驟:
準(zhǔn)備:確定源代碼目錄和構(gòu)建目錄(如果是Out-of-Source Build)。
配置:在構(gòu)建目錄中執(zhí)行cmake命令,根據(jù)CMakeLists.txt文件生成構(gòu)建文件(如Makefile)。
構(gòu)建:使用生成的構(gòu)建文件(如make)進(jìn)行項(xiàng)目的編譯和鏈接。
安裝(可選):如果項(xiàng)目定義了安裝規(guī)則,可以執(zhí)行安裝步驟。
四、實(shí)例
以下是一個(gè)簡(jiǎn)單的CMake示例,用于構(gòu)建一個(gè)名為hello的C++程序。
1. 源代碼
創(chuàng)建一個(gè)名為hello.cpp的C++文件,內(nèi)容如下:
cpp
#include <iostream>
int main() {
std::cout << "Hello, CMake!" << std::endl;
return 0;
}
2. CMakeLists.txt
在同一目錄下創(chuàng)建一個(gè)CMakeLists.txt文件,內(nèi)容如下:
cmake
cmake_minimum_required(VERSION 3.10)
project(Hello)
# 設(shè)置C++標(biāo)準(zhǔn)
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)
# 添加可執(zhí)行文件
add_executable(hello hello.cpp)
3. 構(gòu)建
在命令行中,首先進(jìn)入源代碼目錄的父目錄(或任意目錄,但為方便管理,建議使用Out-of-Source Build),然后執(zhí)行以下命令:
bash
mkdir build
cd build
cmake ..
make
這些命令會(huì)創(chuàng)建一個(gè)build目錄(如果尚不存在),在其中生成Makefile,然后編譯項(xiàng)目。
4. 運(yùn)行
編譯完成后,在build目錄下會(huì)有一個(gè)名為hello的可執(zhí)行文件,直接運(yùn)行它即可看到輸出:
bash
./hello
輸出應(yīng)為:
Hello, CMake!
以上就是CMake的基礎(chǔ)知識(shí)