CPACK_CUSTOM_INSTALL_VARIABLES

在版本 3.21 中增加。

CPack 变量(通过诸如 cpack -DCPackConfig.cmakeCPACK_PROJECT_CONFIG_FILE 脚本设置)在安装脚本中不能直接使用。相反,可以在 CPACK_CUSTOM_INSTALL_VARIABLES 变量中传递 varName=value 对的列表。在安装时,每个列表项将导致一个指定名称(varName)的变量被设置为给定的 value。对于空的 value,可以省略 =

CPACK_CUSTOM_INSTALL_VARIABLES 允许在 CPack 运行时由用户或驱动脚本影响打包安装,而无需重新生成安装脚本。

示例

install(FILES large.txt DESTINATION data)

install(CODE [[
  if(ENABLE_COMPRESSION)
    # "run-compressor" is a fictional tool that produces
    # large.txt.xz from large.txt and then removes the input file
    execute_process(COMMAND run-compressor $ENV{DESTDIR}${CMAKE_INSTALL_PREFIX}/large.txt)
  endif()
]])

通过上面的示例代码段,cpack 在默认情况下会使用未设置的 ENABLE_COMPRESSION 运行安装脚本,从而生成包含未压缩的 large.txt 的程序包。以下命令可以覆盖此项设置,以调用 cpack

cpack -D "CPACK_CUSTOM_INSTALL_VARIABLES=ENABLE_COMPRESSION=TRUE"

然后,安装脚本将运行,并将 ENABLE_COMPRESSION 设置为 TRUE,从而生成包含已压缩的 large.txt.xz 的程序包。