CPACK_CUSTOM_INSTALL_VARIABLES¶
在版本 3.21 中增加。
CPack 变量(通过诸如 cpack -D
、CPackConfig.cmake
或 CPACK_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
的程序包。