[7] CMake总结 - 4 INSTALL

本帖子适用于初学者，StepByStep的入门CMake，CMake也是一门编程语言，只不过是针对编译和连接这种程序构建的过程的语言，学习基本语法就能够初步入门，后面须要什么复杂的功能，进阶掌握须要本身去查找官方文档，后续会给出查阅的一些方式

INSTALL指令
安装的须要有两种，一种是从代码编译后直接make install安装，一种是打包时的指定目录安装。 
这里须要引入一个新的cmake 指令 INSTALL和一个很是有用的变量CMAKE_INSTALL_PREFIX。 
CMAKE_INSTALL_PREFIX变量相似于configure脚本的 –prefix，常见的使用方法看 
起来是这个样子： 
cmake -DCMAKE_INSTALL_PREFIX=/usr .

INSTALL指令用于定义安装规则，安装的内容能够包括目标二进制、动态库、静态库以及 
文件、目录、脚本等。

INSTALL指令包含了各类安装类型，咱们须要一个个分开解释：

目标文件的安装
INSTALL(TARGETS targets...
        [[ARCHIVE|LIBRARY|RUNTIME]
                   [DESTINATION <dir>]
                   [PERMISSIONS permissions...]
                   [CONFIGURATIONS
        [Debug|Release|...]]
                   [COMPONENT <component>]
                   [OPTIONAL]
                ] [...])
1
2
3
4
5
6
7
8
9
参数中的TARGETS后面跟的就是咱们经过ADD_EXECUTABLE或者ADD_LIBRARY定义的 
目标文件，多是可执行二进制、动态库、静态库。

目标类型也就相对应的有三种，ARCHIVE特指静态库，LIBRARY特指动态库，RUNTIME 
特指可执行目标二进制。

DESTINATION定义了安装的路径，若是路径以/开头，那么指的是绝对路径，这时候 
CMAKE_INSTALL_PREFIX其实就无效了。若是你但愿使用CMAKE_INSTALL_PREFIX来 
定义安装路径，就要写成相对路径，即不要以/开头，那么安装后的路径就是 
${CMAKE_INSTALL_PREFIX}/<DESTINATION定义的路径>

举个简单的例子：

INSTALL(TARGETS myrun mylib mystaticlib
       RUNTIME DESTINATION bin
       LIBRARY DESTINATION lib
       ARCHIVE DESTINATION libstatic
)
1
2
3
4
5
上面的例子会将： 
可执行二进制myrun安装到${CMAKE_INSTALL_PREFIX}/bin目录 
动态库libmylib安装到${CMAKE_INSTALL_PREFIX}/lib目录 
静态库libmystaticlib安装到${CMAKE_INSTALL_PREFIX}/libstatic目录 
特别注意的是你不须要关心TARGETS具体生成的路径，只须要写上TARGETS名称就能够 
了。

普通文件的安装
INSTALL(FILES files... DESTINATION <dir>
         [PERMISSIONS permissions...]
         [CONFIGURATIONS [Debug|Release|...]]
         [COMPONENT <component>]
         [RENAME <name>] [OPTIONAL])
可用于安装通常文件，并能够指定访问权限，文件名是此指令所在路径下的相对路径。
若是默认不定义权限PERMISSIONS，安装后的权限为,OWNER_WRITE,OWNER_READ,
GROUP_READ,和WORLD_READ，即644权限。
1
2
3
4
5
6
7
8
非目标文件的可执行程序安装(好比脚本之类)
INSTALL(PROGRAMS files... DESTINATION <dir>
     [PERMISSIONS permissions...]
     [CONFIGURATIONS [Debug|Release|...]]
     [COMPONENT <component>]
     [RENAME <name>] [OPTIONAL])
1
2
3
4
5
跟上面的FILES指令使用方法同样，惟一的不一样是安装后权限为: 
OWNER_EXECUTE, GROUP_EXECUTE, 和WORLD_EXECUTE，即755权限

目录的安装
INSTALL(DIRECTORY dirs... DESTINATION <dir>
     [FILE_PERMISSIONS permissions...]
     [DIRECTORY_PERMISSIONS permissions...]
     [USE_SOURCE_PERMISSIONS]
     [CONFIGURATIONS [Debug|Release|...]]
     [COMPONENT <component>]
     [[PATTERN <pattern> | REGEX <regex>]
      [EXCLUDE] [PERMISSIONS permissions...]] [...])
1
2
3
4
5
6
7
8
这里主要介绍其中的DIRECTORY、PATTERN以及PERMISSIONS参数。 
DIRECTORY后面链接的是所在Source目录的相对路径，但务必注意： 
abc和abc/有很大的区别。 
abc意味着abc这个目录会安装在目标路径下； 
abc/意味着abc这个目录的内容会被安装在目标路径下； 
若是目录名不以/结尾，那么这个目录将被安装为目标路径下的abc，若是目录名以/结尾， 
表明将这个目录中的内容安装到目标路径，但不包括这个目录自己。 
PATTERN用于使用正则表达式进行过滤， 
PERMISSIONS用于指定PATTERN过滤后的文件权限。

咱们来看一个例子:

INSTALL(DIRECTORY icons scripts/ DESTINATION share/myproj
        PATTERN "CVS" EXCLUDE
        PATTERN "scripts/*"
        PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ
        GROUP_EXECUTE GROUP_READ)
1
2
3
4
5
这条指令的执行结果是： 
将icons目录安装到 <prefix>/share/myproj，将scripts/中的内容安装到 
<prefix>/share/myproj 
不包含目录名为CVS的目录，对于scripts/*文件指定权限为 OWNER_EXECUTE 
OWNER_WRITE OWNER_READ GROUP_EXECUTE GROUP_READ.

安装时cmake脚本的执行 INSTALL([[SCRIPT <file>] [CODE <code>]] [...]) SCRIPT参数用于在安装时调用cmake脚本文件（也就是<abc>.cmake文件） CODE参数用于执行CMAKE指令，必须以双引号括起来。好比： INSTALL(CODE "MESSAGE(\"Sample install message.\")") ---------------------  做者：WhateverYoung  来源：CSDN  原文：https://blog.csdn.net/yangfeng2014/article/details/50638601  版权声明：本文为博主原创文章，转载请附上博文连接！