CMake 如何设置 Debug 和 Release 下的不同配置

简介: CMake 设置 Debug 和 Release 下不同的工程依赖库,编译选项宏隔离等

CMake 如何设置 Debug 和 Release 下的不同配置

I - 原因

由于 Debug 和 Release 下工程的依赖库不同,另外,方便定义不同的宏来隔离调试和发布的代码,如不希望在发布时打印调试信息影响性能等。

示例代码

#ifdef DEV_CODE
#define LOG(msg)  std::cout <<"["<< __FILE__<<"]:" <<__func__<<__LINE__ << msg << std::endl
#else
#define LOG(msg)
#endif

//...
bool Console::CallMethod(const std::string & param)
{
   
    //...
    if (error)
    {
   
        LOG("error message");
        return false;
    }
}

则 "error message" 只会在宏 DEV_CODE 被定义的情况下才会被打印

注:__FUNCTION__ 与 __func__ 的不同之处为,前者会带有类名,上述代码,前者内容为 Console::CallMethod ,后者只有 CallMethod

II - 如何设置

2.1 - 配置不同的库


Windows 平台开发,通常会需要依赖 VC 的运行库,而 Debug 和 Release 两种编译类型下的依赖库名称不同,Release 类型的依赖库通常会少一个字符 d, 如:
msvcrtd.lib 和 msvcrt.lib。

在这种情况下,就可以通过 CMake 的两个关键字 debug 和 optimized 来区分配置,在 Debug 编译时链接库 msvcrtd.lib ,在 Release 编译时链接库 msvcrt.lib 。

示例:

set(target_name Demo)

# 区分 debug 和 release 下不同的链接库
target_link_libraries(${
   target_name} PUBLIC 
    debug msvcrtd.lib 
    optimized msvcrt.lib)

2.2 - 配置不同的宏


CMake 设置宏定义可使用 target_compile_definitions 或者 add_definitions 指令。

区分 Debug 还是 Release 可通过判断变量 CMAKE_BUILD_TYPE,此变量可设置为四种不同的值:

  • Debug
  • Release
  • MinSizeRel
  • RelWithDebInfo (使用 Release 编译并且可以使用调试器)

注: Release 编译有很多等级,如 O1, O2, O3, O3 为最高,O表示 optimization 优化。

此外,每个 Release 编译都会定义宏 NDEBUG,Debug 编译一般会定义 DEBUG 宏为 1。

如何定义?

需要执行 cmake 命令时添加 -DCMAKE_BUILD_TYPE:STRING=Debug

cmake .. -DCMAKE_BUILD_TYPE:STRING=Debug
cmake .. -DCMAKE_BUILD_TYPE:STRING=Release

或者在 CMakeLists.txt 中定义

set(CMAKE_BUILD_TYPE "Debug")
# 或
set(CMAKE_BUILD_TYPE "Release")

如何判断?

使用判断指令 :STREQUAL

#判断
if (${
   CMAKE_BUILD_TYPE} STREQUAL "Debug")
# Debug 配置
elseif (${
   CMAKE_BUILD_TYPE} STREQUAL "Release")
# Release 配置
else ()
# 其他配置
endif ()

所以综上所述,为了实现自定义的 DEV_CODE 定义,CMakeLists.txt 的写法如下

if (${
   CMAKE_BUILD_TYPE} STREQUAL "Debug")
    target_compile_definitions(${
   proj_name} PRIVATE DEV_CODE=1)
else ()
    # -UDEV_CODE 表示取消 DEV_CODE 的定义
    add_definitions(-UDEV_CODE)
endif ()

此部分 CMakeLists.txt 表示在判断编译类型,在 Debug 编译时定义宏 DEV_CODE 并设置值为 1 ,若不为 Debug 编译,或者说 Release 编译时,则取消 DEV_CODE 的定义。

注:不要忽略 else 和 endif 之后的括号,否则会产生 CMake 语法错误。

也可以使用以下语句表示定义宏

add_definitions(-DDEV_CODE=1)

-D 表示 define 定义,-U 表示 undefine 撤销定义

参考链接:https://www.10sxj.com/post/27.html

目录
相关文章
|
编译器 API C语言
C/C++ 获取文件名的方法:分享一些实用的获取文件名的方法和技巧(__FILE__,__builtin_FILE(),__BASE_FILE__等)
C/C++ 获取文件名的方法:分享一些实用的获取文件名的方法和技巧(__FILE__,__builtin_FILE(),__BASE_FILE__等)
1956 0
CMake的拷贝文件到指定目录——CMake三板斧
CMake的拷贝文件到指定目录——CMake三板斧
2415 0
|
存储 Shell iOS开发
CMake中文手册_target_link_libraries(3.26)
CMake中文手册_target_link_libraries(3.26)
2224 0
|
存储 数据库 Python
使用HTTP POST协议将本地压缩数据发送到服务器
总的来说,使用HTTP POST协议将本地压缩数据发送到服务器是一个涉及多个步骤的过程,包括创建压缩文件,设置HTTP客户端,发送POST请求,以及服务器端的处理。虽然这个过程可能看起来复杂,但一旦你理解了每个步骤,就会变得相对简单。
560 19
qml import 自定义模块 cmake
qml import 自定义模块 cmake
1367 1
MQTT的心跳保活机制是通过`setKeepAliveInterval()`方法设置的,
MQTT的心跳保活机制是通过`setKeepAliveInterval()`方法设置的,
1324 1
|
人工智能 定位技术
如何将国家地图服务系统的EPS地图转为shp图层
如何将国家地图服务系统的EPS地图转为shp图层
5680 0
|
开发者 数据格式
【软件设计师备考 专题 】设计系统功能:系统结构和子系统
【软件设计师备考 专题 】设计系统功能:系统结构和子系统
842 0