编译工具:CMake(四)|安装目标文件、普通文件、脚本、目录
- 如何安装
- 目标文件的安装
- 普通文件的安装:
- 非目标文件的可执行程序安装(比如脚本之类)
- 目录的安装
如何安装
安装的需要有两种,一种是从代码编译后直接 make install 安装,一种是打包时的指定目录安装。
HelloWorld 进行安装需要引入一个新的 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]
] [...])
参数中的 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
)
上面的例子会将:
可执行二进制 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 权限。
非目标文件的可执行程序安装(比如脚本之类)
INSTALL(PROGRAMS files... DESTINATION <dir>
[PERMISSIONS permissions...]
[CONFIGURATIONS [Debug|Release|...]]
[COMPONENT <component>]
[RENAME <name>] [OPTIONAL])
跟上面的 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...]] [...])
这里主要介绍其中的 DIRECTORY
、PATTERN
以及PERMISSIONS
参数。
DIRECTORY
后面连接的是所在 Source 目录的相对路径,但务必注意:
abc 和 abc/有很大的区别。如果目录名不以/结尾,那么这个目录将被安装为目标路径下的 abc,如果目录名以/结尾,
代表将这个目录中的内容安装到目标路径,但不包括这个目录本身。PATTERN
用于使用正则表达式进行过滤,PERMISSIONS
用于指定 PATTERN
过滤后的文件权限。