target_compile_options 指令用于为指定的目标添加编译器选项。通过这些选项,可以影响编译器如何处理目标的源代码。
语法
target_compile_options(<target> [INTERFACE|PUBLIC|PRIVATE] <options>...)
- target: 要应用这些编译选项的目标,通常是通过 add_executable 或 add_library 定义的目标。
- INTERFACE: 编译选项将仅应用于使用此目标的其他目标,不会应用于该目标本身。通常用于库的公共 API。
- PUBLIC: 编译选项将应用于该目标及所有链接到该目标的目标。适用于库的公共部分和使用该库的可执行文件或其他库。
- PRIVATE: 编译选项将仅应用于该目标,不会传播给其他依赖于该目标的目标。
示例
- 为目标添加私有编译选项:
add_executable(my_executable main.cpp)
# Add a compile option for this target
target_compile_options(my_executable PRIVATE -Wall -Wextra)
在这个例子中,-Wall 和 -Wextra 选项将仅应用于 my_executable 目标,编译器在编译 main.cpp 时会启用这些警告选项。
- 公共编译选项:
add_library(my_library my_library.cpp)
target_compile_options(my_library PUBLIC -O3)
add_executable(my_executable main.cpp)
target_link_libraries(my_executable my_library)
在这个例子中,-O3 优化选项不仅应用于 my_library 的编译,还会传递到链接到 my_library 的所有目标中,例如 my_executable。
- 接口编译选项:
add_library(my_library INTERFACE)
target_compile_options(my_library INTERFACE -DINTERFACE_OPTION)
add_executable(my_executable main.cpp)
target_link_libraries(my_executable my_library)
这里,my_library 是一个接口库,它本身不编译代码,但 -DINTERFACE_OPTION 选项会传递给所有链接到 my_library 的目标,即 my_executable。
使用场景
- 启用编译器警告或错误: 强制所有目标或特定目标在编译时启用额外的警告或错误。
- 编译优化: 为不同的目标设置不同级别的优化选项,如 -O2、-O3。
- 跨平台支持: 根据不同的平台设置特定的编译器选项,如 -std=c++11、-fPIC。
通过 target_compile_options,你可以精细控制每个目标的编译选项,确保项目在不同环境下以最佳配置编译。