当前位置：首页 > news >正文

【CMakeLists.txt】CMake 编译定义带值参数详解

news 2025/10/23 9:14:21

add_compile_definitions(LC_VERSION=2.2.2.5-alpha)
add_compile_definitions(LC_PRERELEASE=true)

指令作用

add_compile_definitions 用于向编译器添加带值的预处理器定义，相当于在代码中使用 #define NAME VALUE 指令。

1. `add_compile_definitions(LC_VERSION=2.2.2.5-alpha)`

作用：定义 LC_VERSION 宏并赋值为字符串 “2.2.2.5-alpha”

这会在编译过程中定义 LC_VERSION 预处理器宏
等价于在 C/C++ 代码中写入：
```
#define LC_VERSION "2.2.2.5-alpha"
```
用于定义版本号信息

应用场景：

在代码中嵌入版本信息
条件编译基于版本的功能
运行时版本检查

代码使用示例：

#include <iostream>int main() {std::cout << "Library version: " << LC_VERSION << std::endl;#ifdef LC_VERSIONstd::cout << "Compiled with version: " << LC_VERSION << std::endl;#endifreturn 0;
}

2. `add_compile_definitions(LC_PRERELEASE=true)`

作用：定义 LC_PRERELEASE 宏并赋值为字符串 “true”

这会在编译过程中定义 LC_PRERELEASE 预处理器宏
等价于在 C/C++ 代码中写入：
```
#define LC_PRERELEASE "true"
```
用于标记预发布版本状态

应用场景：

启用或禁用预发布版本特有的功能
添加预发布版本的特殊行为
调试或测试功能开关

代码使用示例：

#include <iostream>int main() {#ifdef LC_PRERELEASEstd::cout << "This is a pre-release version: " << LC_PRERELEASE << std::endl;// 预发布版本特有的代码enableExperimentalFeatures();showBetaWarning();#endifreturn 0;
}

完整 CMake 示例

cmake_minimum_required(VERSION 3.12)
project(MyLibrary)# 添加带值的编译定义
add_compile_definitions(LC_VERSION=2.2.2.5-alpha)
add_compile_definitions(LC_PRERELEASE=true)add_library(MyLibrary src/mylib.cpp)# 也可以合并为一行
add_compile_definitions(LC_VERSION=2.2.2.5-alphaLC_PRERELEASE=true
)

实际应用场景

版本管理和功能标记：

// 在头文件中定义基于版本的功能
#ifndef LC_VERSION#error "LC_VERSION not defined"
#endifvoid initializeLibrary() {std::cout << "Initializing library version: " << LC_VERSION << std::endl;#ifdef LC_PRERELEASEif (strcmp(LC_PRERELEASE, "true") == 0) {enableDebugLogging();collectUsageStatistics();}#endif
}

替代语法比较

# 现代 CMake 方式（推荐）
add_compile_definitions(LC_VERSION=2.2.2.5-alpha LC_PRERELEASE=true)# 传统方式（不推荐）
add_definitions(-DLC_VERSION="2.2.2.5-alpha" -DLC_PRERELEASE="true")# 目标特定定义（更精确）
target_compile_definitions(MyLibrary PRIVATE LC_VERSION=2.2.2.5-alphaLC_PRERELEASE=true
)