Modern CMake的install详解(一)

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平台则不受影响。

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值