target_compile_definitions¶
为目标添加编译定义。
target_compile_definitions(<target>
<INTERFACE|PUBLIC|PRIVATE> [items1...]
[<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
指定编译给定 <target>
时使用的编译定义。指定的 <target>
必须已经由诸如 add_executable()
或 add_library()
的命令创建,并且不能是 别名目标。
需要 INTERFACE
、PUBLIC
和 PRIVATE
关键字来指定后续参数的 范围。PRIVATE
和 PUBLIC
项将填充 <target>
的 COMPILE_DEFINITIONS
属性。PUBLIC
和 INTERFACE
项将填充 <target>
的 INTERFACE_COMPILE_DEFINITIONS
属性。以下参数指定编译定义。对同一个 <target>
重复调用将按调用顺序添加项。
3.11 版本新增: 允许在 导入目标 上设置 INTERFACE
项。
target_compile_definitions
的参数可以使用语法 $<...>
的生成器表达式。有关可用表达式,请参阅 cmake-generator-expressions(7)
手册。有关定义构建系统属性的更多信息,请参阅 cmake-buildsystem(7)
手册。
项上任何前导的 -D
都将被移除。空项将被忽略。例如,以下所有项都是等效的
target_compile_definitions(foo PUBLIC FOO)
target_compile_definitions(foo PUBLIC -DFOO) # -D removed
target_compile_definitions(foo PUBLIC "" FOO) # "" ignored
target_compile_definitions(foo PUBLIC -D FOO) # -D becomes "", then ignored
定义可以选择包含值
target_compile_definitions(foo PUBLIC FOO=1)
请注意,许多编译器将 -DFOO
视为等同于 -DFOO=1
,但其他工具可能在所有情况下都无法识别这一点(例如 IntelliSense)。