cmake使用教（二） install的使用_cmakelist install

2401_86638664

于 2024-09-05 02:29:36 发布

阅读量857

点赞数 24

文章标签： java 开发语言

本文链接：https://blog.csdn.net/2401_86638664/article/details/141908326

版权

    [RUNTIME_DEPENDENCIES args...|RUNTIME_DEPENDENCY_SET <set-name>]
    [[ARCHIVE|LIBRARY|RUNTIME|OBJECTS|FRAMEWORK|BUNDLE|
      PRIVATE_HEADER|PUBLIC_HEADER|RESOURCE]
     [DESTINATION <dir>]
     [PERMISSIONS permissions...]
     [CONFIGURATIONS [Debug|Release|...]]
     [COMPONENT <component>]
     [NAMELINK_COMPONENT <component>]
     [OPTIONAL] [EXCLUDE_FROM_ALL]
     [NAMELINK_ONLY|NAMELINK_SKIP]
    ] [...]
    [INCLUDES DESTINATION [<dir> ...]]
    )


下表显示了目标类型及其关联变量和内置默认值，这些默认值适用于未指定目标的情况：




| 目标类型 | GNUInstallDirs 变量 | 内置默认值 |
| --- | --- | --- |
| `RUNTIME` | `${CMAKE_INSTALL_BINDIR}` | `bin` |
| `LIBRARY` | `${CMAKE_INSTALL_LIBDIR}` | `lib` |
| `ARCHIVE` | `${CMAKE_INSTALL_LIBDIR}` | `lib` |
| `PRIVATE_HEADER` | `${CMAKE_INSTALL_INCLUDEDIR}` | `include` |
| `PUBLIC_HEADER` | `${CMAKE_INSTALL_INCLUDEDIR}` | `include` |


参数中的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名称就可以  
 了。


## 2.普通文件安装

install(<FILES|PROGRAMS> files…
TYPE | DESTINATION

[PERMISSIONS permissions…]
[CONFIGURATIONS [Debug|Release|…]]
[COMPONENT ]
[RENAME ] [OPTIONAL] [EXCLUDE_FROM_ALL])





| `TYPE` Argument | GNUInstallDirs Variable | Built-In Default |
| --- | --- | --- |
| `BIN` | `${CMAKE_INSTALL_BINDIR}` | `bin` |
| `SBIN` | `${CMAKE_INSTALL_SBINDIR}` | `sbin` |
| `LIB` | `${CMAKE_INSTALL_LIBDIR}` | `lib` |
| `INCLUDE` | `${CMAKE_INSTALL_INCLUDEDIR}` | `include` |
| `SYSCONF` | `${CMAKE_INSTALL_SYSCONFDIR}` | `etc` |
| `SHAREDSTATE` | `${CMAKE_INSTALL_SHARESTATEDIR}` | `com` |
| `LOCALSTATE` | `${CMAKE_INSTALL_LOCALSTATEDIR}` | `var` |
| `RUNSTATE` | `${CMAKE_INSTALL_RUNSTATEDIR}` | `<LOCALSTATE dir>/run` |
| `DATA` | `${CMAKE_INSTALL_DATADIR}` | `<DATAROOT dir>` |
| `INFO` | `${CMAKE_INSTALL_INFODIR}` | `<DATAROOT dir>/info` |
| `LOCALE` | `${CMAKE_INSTALL_LOCALEDIR}` | `<DATAROOT dir>/locale` |
| `MAN` | `${CMAKE_INSTALL_MANDIR}` | `<DATAROOT dir>/man` |
| `DOC` | `${CMAKE_INSTALL_DOCDIR}` | `<DATAROOT dir>/doc` |


可用于安装一般文件，并可以指定访问权限，文件名是此指令所在路径下的相对路径。如果默认不定义权限PERMISSIONS，安装后的权限为：  
 OWNER\_WRITE, OWNER\_READ, GROUP\_READ,和WORLD\_READ，即 644权限。 


## 3.目录的安装

install(DIRECTORY dirs…
TYPE | DESTINATION

[FILE_PERMISSIONS permissions…]
[DIRECTORY_PERMISSIONS permissions…]
[USE_SOURCE_PERMISSIONS] [OPTIONAL] [MESSAGE_NEVER]
[CONFIGURATIONS [Debug|Release|…]]
[COMPONENT ] [EXCLUDE_FROM_ALL]
[FILES_MATCHING]
[[PATTERN | REGEX ]
[EXCLUDE] [PERMISSIONS permissions…]] […])


这里主要介绍其中的DIRECTORY、PATTERN 以及 PERMISSIONS 参数。  
 DIRECTORY 后面连接的是所在Source目录的相对路径，但务必注意：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)


这条指令的执行结果是：  
 将icons 目录安装到 <prefix>/share/myproj，将 scripts/中的内容安装到  
 <prefix>/share/myproj  
 不包含目录名为CVS的目录，对于scripts/\* 文件指定权限为 OWNER\_EXECUTE  
 OWNER\_WRITE OWNER\_READ GROUP\_EXECUTE GROUP\_READ.


这里测试一下：根据[上一篇]( )的文章进行安装测试：


## 4.测试


修改根目录下的CMakeLists.txt文件如下，其实就增加了install，这里你需要先创建几个文件，才能尝试安装：