cmake-debug和release模式
一般在工程中,自動構建可能會編譯兩個版本的發布包,一個debug版本,一個release版本。那么通過cmake怎樣來實現呢?本文就以這個需求為例,來介紹cmake中的邏輯控制。
目錄結構
|-- bin
|-- build
|-- CMakeLists.txt
|-- src
| ? `-- main.c
Debug-Release模式控制
頂層CMakeLists.txt
cmake_minimum_required(VERSION 3.12)
project(test07)
aux_source_directory(${PROJECT_SOURCE_DIR}/src src_dirs)
# 條件判斷
if(CMAKE_BUILD_TYPE AND (CMAKE_BUILD_TYPE STREQUAL "Debug"))
? ? set(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -Wall -O0")
? ? message("Debug mode:${CMAKE_C_FLAGS_DEBUG}")
? ? add_executable(test_debug ${src_dirs})
elseif(CMAKE_BUILD_TYPE AND (CMAKE_BUILD_TYPE STREQUAL "Release"))
? ? set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} -Wall -O3")
? ? message("Release mode:${CMAKE_C_FLAGS_RELEASE}")
? ? add_executable(test_release ${src_dirs})
else()
? ? message("else:${CMAKE_BUILD_TYPE}")
? ? message("else:${CMAKE_C_FLAGS_RELEASE}")
? ? add_executable(test_release ${src_dirs})
endif()
先簡要的描述一下該CMakeLists.txt的控制邏輯。如果CMAKE_BUILD_TYPE的值為"Debug"就采用debug模式編譯;如果CMAKE_BUILD_TYPE的值為"Release"就采用release模式編譯;如果CMAKE_BUILD_TYPE的值為空,默認采用release模式
默認編譯
?從上圖可以看出,CMAKE_C_FLAGS_RELEASE 編譯選項的默認值為-O3 -DNDEBUG。最終生成可執行文件test_release,./test_release輸出’hello cmake’。test_release文件大小為8600字節。
release 編譯
從上圖可以看出,通過cmake命令行指定CMAKE_BUILD_TYPE為Release,最終生成可執行文件test_release,./test_release輸出’hello cmake’。test_release文件大小為8600字節。
debug編譯
從上圖可以看出,通過cmake命令行指定CMAKE_BUILD_TYPE為Debug,最終生成可執行文件test_release,./test_release輸出’hello cmake’。test_release文件大小為9872字節。因為debug模式編譯生成的可執行文件包含可調試的相關信息,所以文件大小會變大。
控制邏輯
通過上例知道,可以通過if命令來控制cmake的編譯邏輯,接下來,詳細介紹cmake中if命令的使用。
條件命令
if(<condition>)
? <commands>
elseif(<condition>) # optional block, can be repeated
? <commands>
else() ? ? ? ? ? ? ?# optional block
? <commands>
endif()
if條件命名的語法非常簡單。這里需要特別說明關于if(<variable>)中variable的注意點,引用文檔中的一段話:
The if command was written very early in CMake’s history, predating the ${} variable evaluation syntax, and for convenience evaluates variables named by its arguments as shown in the above signatures. Note that normal variable evaluation with ${} applies before the if command even receives the arguments.
這段話的意思是,由于if命令語法在變量引用${}語法之前出現,所以如果使用if(${var}),那么將會被引用兩次;如果使用if(var),將只會被if本身的語法引用一次。也就是要注意兩次引用問題。
舉個栗子:
# 在前面的CMakeLists.txt中
if(CMAKE_BUILD_TYPE AND (CMAKE_BUILD_TYPE STREQUAL "Debug"))
如果是通過cmake .. 編譯,而沒有指定CMAKE_BUILD_TYPE的話,那么if命令本身會引用變量CMAKE_BUILD_TYPE,其值為空,if條件判斷為假;
如果是通過cmake -DCMAKE_BUILD_TYPE=Debug .. 編譯,if命令本身會引用變量CMAKE_BUILD_TYPE,其值為Debug,if條件判斷為真;
# 如果將變量CMAKE_BUILD_TYPE通過${}再引用一次,會發生什么?
if(${CMAKE_BUILD_TYPE} AND (CMAKE_BUILD_TYPE STREQUAL "Debug"))
由于 ${CMAKE_BUILD_TYPE}的值為空,if(${CMAKE_BUILD_TYPE}相當于if(空變量),然后if命令再對"空變量"進行引用,顯然,語法上錯誤。即會報如下圖錯誤:
如果你非要使用if($var),那你必須明確的知道變量var的值是另一個變量的變量名。
?例如,將前面的CMakeLists.txt做如下修改(雖然沒有什么實際意義,僅作為解釋語法特點)
cmake_minimum_required(VERSION 3.12)
project(test07)
aux_source_directory(${PROJECT_SOURCE_DIR}/src src_dirs)
set(mode "CMAKE_BUILD_TYPE") # 修改點
# 條件判斷
if(${mode} AND (CMAKE_BUILD_TYPE STREQUAL "Debug")) # 修改點
? ? set(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -Wall -O0")
? ? message("Debug mode:${CMAKE_C_FLAGS_DEBUG}")
? ? add_executable(test_debug ${src_dirs})
elseif(${mode} AND (CMAKE_BUILD_TYPE STREQUAL "Release")) # 修改點
? ? set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} -Wall -O3")
? ? message("Release mode:${CMAKE_C_FLAGS_RELEASE}")
? ? add_executable(test_release ${src_dirs})
else()
? ? message("else:${CMAKE_BUILD_TYPE}")
? ? message("else:${CMAKE_C_FLAGS_RELEASE}")
? ? add_executable(test_release ${src_dirs})
endif()
?
總結
以上是生活随笔為你收集整理的cmake-debug和release模式的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: gpc安装及其踩坑
- 下一篇: CMake基础 第1节 初识CMake