我正在尝试修改某个目录下所有目录的编译器标志(即,递归地修改所有当前目录的子目录及其所有子目录)。所以我发现这里有两种方法:
add_directory(dir1)
# ...
add_directory(dirN)
add_compile_options(flag1 flag2 ...)
# or for CMake versions < 3.0 to do something more like:
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} flag1 flag2 ...")
add_compile_options
的手册页非常清楚地指出,效果将是"当前目录及以下"(这是我想要的),但对于set(CMAKE_CXX_FLAGS ...)
,我不太确定。
Cmake集变量是递归的吗
简单的答案是,每个子目录都有自己的变量作用域,在add_subdirectory()
调用时用当前变量值的副本初始化。
有关详细答案,请参阅What';设置和使用变量的CMake语法是什么?
目录&目标属性与(全局)变量
CMake:处理add_compile_options()
和CMAKE_CXX_FLAGS
的方式不同
-
使用
add_compile_options()
指定的所有内容都会附加到COMPILE_OPTIONS
目录属性中。然后使用add_library()
或add_executable()
"创建目标时,此属性用于初始化COMPILE_OPTIONS
目标属性"。当解析器调用
add_subdirectory()
时,目录属性的当前状态用于初始化子目录属性。 -
CMAKE_CXX_FLAGS
是一个全局缓存变量。您可以通过定义本地目录范围的变量(隐藏全局缓存的变量)来扩展/覆盖它。这些变量的上下文被复制到
add_subdirectory()
上的子目录范围中(传播到子目录)。CMake在每个
CMakeLists.txt
文件的端查看其值,并将其应用于同一CMakeLists.txt
中的所有目标(允许后期声明,另请参阅下面的Complete Formula和Test Code)。 -
因此,对于CMake版本<3.0,相当于CCD_ 16的是CCD_。功能仍然存在,但将定义与编译选项混合使用是很奇怪的。于是
add_compile_options()
被发明了。
编译器标志的完整生成器公式
它在CMake的代码中(参见cmCommonTargetGenerator::GetFlags()
、cmLocalGenerator::AddCompileOptions()
和cmLocalGenerator::AddLanguageFlags()
)。
此示例显示了一个没有导出的DEBUG
构建配置库,没有考虑基于特征的标志或类似CMAKE_CXX_USE_RESPONSE_FILE_FOR_INCLUDES
或CMAKE_QUOTE_INCLUDE_PATHS
:
CMAKE_CXX_FLAGS // as set at the end of target's CMakeLists.txt
+ CMAKE_CXX_FLAGS_DEBUG
+ Include Directories // pefixed with CMAKE_INCLUDE_FLAG_CXX/CMAKE_INCLUDE_SYSTEM_FLAG_CXX
(CMAKE_INCLUDE_CURRENT_DIR) ?
+ CMAKE_CURRENT_SOURCE_DIR + CMAKE_CURRENT_BINARY_DIR
+ CMAKE_CXX_IMPLICIT_INCLUDE_DIRECTORIES
+ Target[INCLUDE_DIRECTORIES]
+ DependingTargets[INTERFACE_INCLUDE_DIRECTORIES]
+ Define Flags // compiler flags given with add_definitions()
+ Target[COMPILE_FLAGS] // deprecated
- Filtered by CMAKE_CXX_FLAG_REGEX
+ Target[COMPILE_OPTIONS]
+ DependingTargets[INTERFACE_COMPILE_OPTIONS]
测试代码
为了更好地理解,这里是我测试编译器选项的代码和我得到的结果:
注意:通常我会使用add_definitions()
和target_compile_definitions()
而不是add_compile_options()
和target_compile_options()
来设置编译器定义,但为了演示编译器选项的传播,我(错误)使用了-D
标志。
CMakeLists.txt
cmake_minimum_required(VERSION 3.0)
project(CxxFlagsTest)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DCXX_FLAG")
add_compile_options("-DCOMPILE_OPTION")
add_subdirectory(lib)
file(WRITE main.cpp "int main() { return 0; }")
add_executable(main main.cpp)
target_link_libraries(main lib)
target_compile_options(main PRIVATE "-DMAIN_COMPILE_OPTION")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DLATE_CXX_FLAG")
get_target_property(_main_compile_options main COMPILE_OPTIONS)
message(STATUS "main COMPILE_OPTIONS: ${_main_compile_options}")
get_directory_property(_root_compile_options COMPILE_OPTIONS)
message(STATUS "root COMPILE_OPTIONS: ${_root_compile_options}")
message(STATUS "root CMAKE_CXX_FLAGS: ${CMAKE_CXX_FLAGS}")
lib/CMakeLists.txt
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DSUB_CXX_FLAG")
add_compile_options("-DSUB_COMPILE_OPTION")
file(WRITE lib.cpp "")
add_library(lib lib.cpp)
target_compile_options(lib PUBLIC "-DLIB_COMPILE_OPTION")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DLATE_SUB_CXX_FLAG")
get_target_property(_lib_compile_options lib COMPILE_OPTIONS)
message(STATUS "lib COMPILE_OPTIONS: ${_lib_compile_options}")
get_directory_property(_sub_compile_options COMPILE_OPTIONS)
message(STATUS "sub COMPILE_OPTIONS: ${_sub_compile_options}")
message(STATUS "sub CMAKE_CXX_FLAGS: ${CMAKE_CXX_FLAGS}")
将导致以下消息:
-- lib COMPILE_OPTIONS: -DCOMPILE_OPTION;-DSUB_COMPILE_OPTION;-DLIB_COMPILE_OPTION
-- sub COMPILE_OPTIONS: -DCOMPILE_OPTION;-DSUB_COMPILE_OPTION
-- sub CMAKE_CXX_FLAGS: ... -DCXX_FLAG -DSUB_CXX_FLAG -DLATE_SUB_CXX_FLAG
-- main COMPILE_OPTIONS: -DCOMPILE_OPTION;-DMAIN_COMPILE_OPTION
-- root COMPILE_OPTIONS: -DCOMPILE_OPTION
-- root CMAKE_CXX_FLAGS: ... -DCXX_FLAG -DLATE_CXX_FLAG
并且正在设置以下预处理器定义:
lib
CXX_FLAG SUB_CXX_FLAG LATE_SUB_CXX_FLAG COMPILE_OPTION SUB_COMPILE_OPTION LIB_COMPILE_OPTION
main
CXX_FLAG LATE_CXX_FLAG COMPILE_OPTION MAIN_COMPILE_OPTION LIB_COMPILE_OPTION
这里有趣的部分是传播链接库的LATE
CXX标志和LIB
编译选项。
参考
- cmake-全局链接器标志设置(适用于目录中的所有目标)
- 什么';设置和使用变量的CMake语法是什么