Cmake使用語(yǔ)法解析

Cmake工具

  • cmake 交叉編譯系統(tǒng)生成工具
  • ctest 自動(dòng)化測(cè)試工具
  • cpack 自動(dòng)化打包工具 可以生成各種格式的安裝程序和源碼包

Cmake 語(yǔ)法

相比于make的規(guī)則同云,輸入文件有指定的命名規(guī)則即為Makefile.
Cmake 輸入文件是以Cmake語(yǔ)法編寫的溯壶,以CmakeLists.txt命名或以.cmake擴(kuò)展名的文件.為了盡可能的跨平臺(tái)使用的7-bit ASCII 字符編寫鞍匾,使用UTF-8編碼。

1. 多級(jí)依賴目錄樹(shù)和配置文件配置

  • 使用add_subdirectory()函數(shù)蹋订,添加同樣包含CmakeList.txt,Cmake進(jìn)行編譯時(shí)赂弓,會(huì)在build相應(yīng)的目錄下生成輸出文件.
  • 通用資源或配置可以添加<script>.cmake,以模塊的形式進(jìn)行加載,相應(yīng)的加載函數(shù)為include().
  • 單獨(dú)運(yùn)行配置文件,使用-P選項(xiàng) 如:cmake -P <script>.cmake

2. 命令調(diào)用

命令格式

命令調(diào)用是方法名加圓括號(hào)的形式,括號(hào)內(nèi)的參數(shù)以空格或換行符分割開(kāi)雁比。方法命名不區(qū)分大小寫。

line_ending  ::=  line_comment? newline
space        ::=  <match '[ \t]+'>
newline      ::=  <match '\n'>
separation   ::=  space | line_ending

三種參數(shù)格式支持

命令調(diào)用支持三種語(yǔ)法格式撤嫩,分別是引用格式偎捎、未引用格式、lua長(zhǎng)括號(hào)語(yǔ)法序攘。
未引用格式所有 空格茴她、()两踏、#败京、"\都應(yīng)該使用轉(zhuǎn)譯符\進(jìn)行注釋
實(shí)例如下:

#引用語(yǔ)法(quoted argument )
message(STATUS "config is called syntax 1 ")
#未引用語(yǔ)法(unquoted argument)
message(STATUS config\ is\ called\ syntax\ 2)
#長(zhǎng)括號(hào)語(yǔ)法(Bracket Argument)
message(STATUS [==[config is called syntax 3]==])

#result
cmake -P ../app/config.cmake
-- config is called syntax 1
-- config is called syntax 2
-- config is called syntax 3

變量引用

引用變量格式為${<variable>}梦染,可以在引用格式或未引用格式中使用赡麦。支持變量的嵌套,由內(nèi)而外的解析${outer_${inner_variable}_variable}帕识。

注釋

注釋應(yīng)該以#開(kāi)頭泛粹,支持lua長(zhǎng)括號(hào)語(yǔ)法\

# this is a Comment

#[=[ lua long bracket syntax Comment]=]  #可多行

3. 控制語(yǔ)句

控制語(yǔ)句主要分為以下幾類:

  • 條件語(yǔ)句
  • 循環(huán)語(yǔ)句
  • 宏、函數(shù)定義
  • 變量肮疗、環(huán)境變量
  • 列表

條件語(yǔ)句

使用if()/elseif()/else()/endif() 命令分割代碼塊完成條件控制晶姊。

if(<condition>)
  <commands>
elseif(<condition>) # optional block, can be repeated
  <commands>
else()              # optional block
  <commands>
endif()

循環(huán)語(yǔ)句

使用foreach()/endforeach() / while()/endwhile() 來(lái)劃分代碼塊用以在循環(huán)中執(zhí)行。類似于其他語(yǔ)言使用 break()提前結(jié)束循環(huán)伪货, 使用 continue() 函數(shù)提前開(kāi)始下一個(gè)迭代過(guò)程们衙。

#foreach 遍歷循環(huán)
foreach(<loop_var> <items>)
  <commands>
endforeach()

#while條件循環(huán)
while(<condition>)
  <commands>
endwhile()

宏、函數(shù)定義

使用 macro()/endmacro(), and function()/endfunction() 命令定義宏或者函數(shù)碱呼,在后面作為新的命令調(diào)用相應(yīng)代碼塊蒙挑。

變量、環(huán)境變量

變量和環(huán)境變量類型都是字符串類型愚臀,使用set()unset()命令令進(jìn)行定義和撤銷變量忆蚀,但是其他命令可以更新變量值。注意姑裂,變量名不同于命令是區(qū)分大小寫的馋袜,理論上名命可以是任意字符,但是只推薦使用-_作為分隔符舶斧。
環(huán)境變量的區(qū)別在于欣鳖,作用域是當(dāng)前Cmake進(jìn)程,設(shè)置和引用時(shí)要增加ENV標(biāo)記.

#變量設(shè)置
set(<variable> <value>... CACHE <type> <docstring> [FORCE])
#變量引用
${<variable>}

#環(huán)境變量設(shè)置
set(ENV{<variable>} [<value>])
#環(huán)境變量引用
$ENV{<variable>}

列表

列表是以;區(qū)分開(kāi)的字符串茴厉,而且大多數(shù)的命令并不會(huì)自動(dòng)轉(zhuǎn)譯掉;观堂,因此可以扁平化嵌套列表.

set(x a "b;c") # sets "x" to "a;b;c", not "a;b\;c"
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末让网,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子师痕,更是在濱河造成了極大的恐慌溃睹,老刑警劉巖,帶你破解...
    沈念sama閱讀 221,888評(píng)論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件胰坟,死亡現(xiàn)場(chǎng)離奇詭異因篇,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)笔横,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,677評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門竞滓,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人吹缔,你說(shuō)我怎么就攤上這事商佑。” “怎么了厢塘?”我有些...
    開(kāi)封第一講書人閱讀 168,386評(píng)論 0 360
  • 文/不壞的土叔 我叫張陵茶没,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我晚碾,道長(zhǎng)抓半,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書人閱讀 59,726評(píng)論 1 297
  • 正文 為了忘掉前任格嘁,我火速辦了婚禮笛求,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘糕簿。我一直安慰自己探入,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,729評(píng)論 6 397
  • 文/花漫 我一把揭開(kāi)白布懂诗。 她就那樣靜靜地躺著蜂嗽,像睡著了一般。 火紅的嫁衣襯著肌膚如雪响禽。 梳的紋絲不亂的頭發(fā)上徒爹,一...
    開(kāi)封第一講書人閱讀 52,337評(píng)論 1 310
  • 那天荚醒,我揣著相機(jī)與錄音芋类,去河邊找鬼。 笑死界阁,一個(gè)胖子當(dāng)著我的面吹牛侯繁,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播泡躯,決...
    沈念sama閱讀 40,902評(píng)論 3 421
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼贮竟,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼丽焊!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起咕别,我...
    開(kāi)封第一講書人閱讀 39,807評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤技健,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后惰拱,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體雌贱,經(jīng)...
    沈念sama閱讀 46,349評(píng)論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,439評(píng)論 3 340
  • 正文 我和宋清朗相戀三年偿短,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了欣孤。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,567評(píng)論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡昔逗,死狀恐怖降传,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情勾怒,我是刑警寧澤婆排,帶...
    沈念sama閱讀 36,242評(píng)論 5 350
  • 正文 年R本政府宣布,位于F島的核電站控硼,受9級(jí)特大地震影響泽论,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜卡乾,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,933評(píng)論 3 334
  • 文/蒙蒙 一翼悴、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧幔妨,春花似錦鹦赎、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 32,420評(píng)論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至锁施,卻和暖如春陪踩,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背悉抵。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 33,531評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工肩狂, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人姥饰。 一個(gè)月前我還...
    沈念sama閱讀 48,995評(píng)論 3 377
  • 正文 我出身青樓傻谁,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親列粪。 傳聞我的和親對(duì)象是個(gè)殘疾皇子审磁,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,585評(píng)論 2 359