add_compile_definitions

在 3.12 版被加入.

將預處理器定義新增到來源檔的編譯。

add_compile_definitions(<definition> ...)

Adds preprocessor definitions to the compiler command line.

The preprocessor definitions are added to the COMPILE_DEFINITIONS directory property for the current CMakeLists file. They are also added to the COMPILE_DEFINITIONS target property for each target in the current CMakeLists file.

Definitions are specified using the syntax VAR or VAR=value. Function-style definitions are not supported. CMake will automatically escape the value correctly for the native build system (note that CMake language syntax may require escapes to specify some values).

在 3.26 版被加入: Any leading -D on an item will be removed.

Arguments to add_compile_definitions may use generator expressions with the syntax $<...>. See the cmake-buildsystem(7) manual for more on defining buildsystem properties.

備註

Use of the add_compile_definitions command for new development is discouraged. Unencapsulated alterations to the build environment can have unintentionally broad effect, potentially resulting in unnecessary build dependencies. Additionally, the add_compile_definitions command cannot be used to express interface usage requirements. It is recommended that new development use the target_compile_definitions() command instead.