复用cmake代码的其他方法

 复用cmake代码的其他方法

函数和宏是代码复用的方法,在cmake3.18版本开始,cmake添加了cmake_language()命令,通过这个命令我们可以直接调用任意的cmake代码,无需将这些可复用的代码使用函数或者宏包起来.

当然cmake_language()命令不是为了代替函数和宏而设计的,而是希望通过该命令可以以一种更简洁的方式来调用可复用的cmake代码,作为函数和宏的补充.

下面是这个命令的签名

cmake_language(CALL command [arg ...])
cmake_language(EVAL CODE code ...)

CALL方式可以调用cmake命令,同时可以传入参数,但是某些内置的命令不能通过这种方式调用,特别是那些处理逻辑的命令.例如if() elseif() foreach() endforeach()等等.

demo

function(at_generate_moc)
    set(cmd qt${QT_DEFAULT_MAJOR_VERSION}_generate_moc)

    cmake_language(CALL ${cmd} ${ARGV})
endfunction()

这个例子中,我们通过QT的QT_DEFAULT_MAJOR_VERSION 变量组成了一个叫做 qt${QT_DEFAULT_MAJOR_VERSION}_generate_moc的命令,其实这个命令是由Qt的cmake模块提供的,我们使用的时候可以通过cmake_language(CALL ${cmd} ${ARGV})去调用qt${QT_DEFAULT_MAJOR_VERSION}_generate_moc命令,而无需将其包装成函数或者宏.

当然CALL子命令的用处相当有限,EVAL CODE子命令提供了更加强大的功能,它几乎可以执行任何有效的cmake脚本.

set(myProjTraceCall [=[
    message("Called ${CMAKE_CURRENT_FUNCTION}")
    set(__x 0)
    while(__x LESS ${ARGC})
        message(" ARGV${__x} = ${ARGV${__x}}")
        math(EXPR __x "${__X} + 1")
    endwhile()
    unset(__X)
]=])


function(func)
    cmake_language(EVAL CODE "${myProjTraceCall}")
    # ...
endfunction()

func(one two three)

 

cmake -P test.cmake

 注意test.cmake是cmake的脚本文件,执行脚本文件使用上面的命令即可.

这个例子中,我们通过一个CMake脚本放在一个变量中,然后使用EVAL CODE子命令去调用这个Cmake脚本.

cmake3.19版本对cmake_language()命令做了扩展,添加了DEFER子命令的支持.不过这个命令非常复杂,通常不建议使用.

cmake3.24版本对cmake_language()命令做了扩展,添加了子命令的支持.SET_DEPENDENCY_PROVIDER子命令的支持.

cmake3.25版本对cmake_language()命令做了扩展,添加了GET_MESSAGE_LOG_LEVEL子命令的支持.

cmake_language — CMake 3.27.0-rc5 Documentation