Modern CMake的install详解(一)
install(TARGETS target… […])
install({FILES | PROGRAMS} file… […])
install(DIRECTORY dir… […])
install(SCRIPT file […])
install(CODE code […])
install(EXPORT export-name […])
为项目生成安装规则。在安装期间,将按顺序执行源目录中调用此命令指定的规则(目录之间的顺序未定义)。
此命令有多个签名。其中一些定义了文件和目标的安装选项。
这里介绍了多个签名的常用选项,但它们仅对指定它们的签名有效。
例如:
DESTINATION
指定磁盘上要安装文件的目录。如果给出了完整路径(带正斜杠或驱动器号),则直接使用它。如果给定了相对路径,则相对于CMAKE_INSTALL_PREFIX变量的值来解释它。可以使用CMAKE_install_prefix变量文档中解释的DESTDIR机制在安装时重新定位前缀。
PERMISSIONS
指定已安装文件的权限。有效权限包括OWNER_READ、OWNER_WRITE、OWNER_EXECUTE、GROUP_READ、GROUP_WRITE、GROUP_EXECUTE、WORLD_WRITE、WORLD_EXECUTE、SETUID和SETGID。在某些平台上没有意义的权限在这些平台上会被忽略。
CONFIGURATIONS
指定应用安装规则的生成配置列表(调试、发布等)。请注意,为此选项指定的值仅适用于“配置”选项后列出的选项。
install(TARGETS target
CONFIGURATIONS Debug
RUNTIME DESTINATION Debug/bin)
install(TARGETS target
CONFIGURATIONS Release
RUNTIME DESTINATION Release/bin)
COMPONENT
指定与安装规则关联的安装组件名称,例如“运行时”或“开发”。在特定于组件的安装期间,将只执行与给定组件名称关联的安装规则。在完全安装过程中,除非标记有“从全部排除”标记,否则将安装所有组件。如果未提供组件,则会创建默认组件“Unspecified”。默认组件名可以用CMAKE_INSTALL_default_component_name变量控制。
EXCLUDE_FROM_ALL
指定从完整安装中排除该文件,并且仅作为特定于组件的安装的一部分进行安装(插件式安装)。
RENAME
为安装的文件指定一个可能与原始文件不同的名称。仅当命令安装了单个文件时,才允许重命名。
OPTIONAL
如果指定要安装的文件不存在,则不报错。
注意:
安装文件的命令签名可能会在安装期间打印消息。使用CMAKE_INSTALL_MESSAGE变量控制打印哪些消息。 许多install()变量都隐式地创建包含已安装文件的目录。
如果设置CMAKE_INSTALL_DEFAULT_DIRECTORY_权限,则将使用指定的权限创建这些目录。否则,它们将根据Unix类平台上的uname规则创建。Windows平台则不受影响。