target_compile_options

为目标添加编译选项。

target_compile_options(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

向 COMPILE_OPTIONS 或 INTERFACE_COMPILE_OPTIONS 目标属性添加选项。这些选项用于编译给定的 <target>，该目标必须由 add_executable() 或 add_library() 等命令创建，并且不能是 别名目标。

注意

这些选项在链接目标时不会使用。有关此内容，请参阅 target_link_options() 命令。

参数

如果指定了 BEFORE，则内容将添加到属性的开头，而不是附加到末尾。请参阅策略 CMP0101，该策略会影响 BEFORE 在某些情况下是否会被忽略。

关键词 INTERFACE、PUBLIC 和 PRIVATE 用于指定以下参数的 作用域。PRIVATE 和 PUBLIC 条目将填充 <target> 的 COMPILE_OPTIONS 属性。PUBLIC 和 INTERFACE 条目将填充 <target> 的 INTERFACE_COMPILE_OPTIONS 属性。以下参数指定编译选项。对同一 <target> 的重复调用将按调用顺序追加条目。

3.11 版本新增: 允许在 导入目标 上设置 INTERFACE 项。

target_compile_options 的参数可以使用生成器表达式，语法为 $<...>。有关可用表达式，请参阅 cmake-generator-expressions(7) 手册。有关定义构建系统属性的更多信息，请参阅 cmake-buildsystem(7) 手册。

选项去重

用于目标的最终选项集通过累积当前目标及其依赖项的使用要求的选项来构建。选项集经过去重以避免重复。

在 3.12 版本加入： 虽然对单个选项有利，但去重步骤可能会打断选项组。例如，-option A -option B 会变成 -option A B。可以使用类似 shell 的引用和 SHELL: 前缀来指定选项组。将删除 SHELL: 前缀，其余选项字符串将使用 separate_arguments() 命令的 UNIX_COMMAND 模式进行解析。例如，"SHELL:-option A" "SHELL:-option B" 会变成 -option A -option B。

另请参阅

• 此命令可用于添加任何选项。但是，对于添加预处理器定义和包含目录，建议使用更具体的命令 target_compile_definitions() 和 target_include_directories()。

• 对于目录范围的设置，可以使用命令 add_compile_options()。

• 对于文件特定的设置，可以使用源文件属性 COMPILE_OPTIONS。

• 此命令为目标中的所有语言添加编译选项。使用 COMPILE_LANGUAGE 生成器表达式来指定每种语言的编译选项。

• target_compile_features()

• target_link_libraries()

• target_link_directories()

• target_link_options()

• target_precompile_headers()

• target_sources()

• CMAKE_<LANG>_FLAGS 和 CMAKE_<LANG>_FLAGS_<CONFIG> 添加传递给编译器所有调用的语言范围标志。这包括驱动编译和驱动链接的调用。

• CheckCompilerFlag 模块用于检查编译器是否支持给定的标志。