cmake基础(3)——安装

一、简介

install命令用于指定安装时的规则，由于安装命令比较复杂，这里做一部分内容的介绍，后续用到再继续完善。

1.命令简介

本文档基于3.20，目前有6种安装方式。

install(TARGETS <target>... [...])
install({FILES | PROGRAMS} <file>... [...])
install(DIRECTORY <dir>... [...])
install(SCRIPT <file> [...])
install(CODE <code> [...])
install(EXPORT <export-name> [...])

首先是通用参数：

1.1 DESTINATION

指定安装的目标目录。参数后接路径，可以是相对路径也可以是绝对路径。

相对路径则是相对于CMAKE_INSTALL_PREFIX变量值。也可以在安装时通过DESTDIR修改。

make DESTDIR=/package/stage install

实际上，上述方式是在UNIX系统下，而更加常用的是使用--prefix选项

cmake --install binPath --prefix="destPath"

1.2 PERMISSIONS

指定被安装文件的权限。包括OWNER_READ, OWNER_WRITE, OWNER_EXECUTE, GROUP_READ, GROUP_WRITE, GROUP_EXECUTE, WORLD_READ, WORLD_WRITE, WORLD_EXECUTE, SETUID, 和 SETGID。对于平台中不支持的权限则忽略。

1.3 CONFIGURATIONS

指定一个构建配置的列表(Debug,Release等)，作用于之后的内容，不对之前的内容不生效。

对于这个参数，必须要提到的是，cmake的安装动作(配置)是由外部控制的:

cmake --install srcPath --config Debug|Release...

通过上述命令中的--config参数，来控制执行安装Debug内容还是Release内容。

而对于当前配置CONFIGURATIONS则是表示其后内容隶属的动作(在Debug，Release还是其他动作时执行)。比如下面的例子：

install(TARGETS ${PROJECT_NAME}  CONFIGURATIONS ReleaseARCHIVE DESTINATION ${PROJECT_SOURCE_DIR}/lib/ReleaseLIBRARY DESTINATION ${PROJECT_SOURCE_DIR}/lib/ReleaseCONFIGURATIONS DebugRUNTIME DESTINATION ${PROJECT_SOURCE_DIR}/bin/Debug)

则表示执行

cmake --install srcPath --config Debug

命令时，只安装RUNTIME内容，而不安装ARCHIVE和LIBRARY内容。相反的，如果执行

cmake --install srcPath --config Release

命令时，只安装ARCHIVE和LIBRARY内容，而不安装RUNTIME内容。

此外，默认的安装动作和安装配置都是Release的。

1.4 COMPONENT

指定安装的组件名。目前还不确定组件的创建方式，等待后续完善。

1.5 EXCLUDE_FROM_ALL

不安装的内容。

1.6 RENAME

1.7 OPTIONAL

表示此安装命令为可选项，找不到也不会报错。

二、Installing Targets

install(TARGETS targets... [EXPORT <export-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> ...]])

1.支持的target

1.1 ARCHIVE

静态库(除了macOS)、dll导入库（也就是dll对应的lib文件）

1.2 LIBRARY

共享库(lib文件，不包括dll文件)

1.3 RUNTIME

可执行文件，dll文件。

1.4 OBJECTS

对象库的对象文件。参考add_library中的object library。

1.5 FRAMEWORK、BUNDLE、PUBLIC_HEADER、PRIVATE_HEADER、RESOURCE

这些都是与apple平台相关的内容，没有环境，不做解释。

其中PUBLIC_HEADER、PRIVATE_HEADER、RESOURCE官文解释非apple平台也有效，但是实际使用时没有反应。

HEADER使用方式：

set_target_properties(${PROJECT_NAME} PROPERTIES PUBLIC_HEADER src/hello.h)install(TARGETS ${PROJECT_NAME}  PUBLIC_HEADER DESTINATION ${PROJECT_SOURCE_DIR}/include)

2 其他参数

2.1 NAMELINK_COMPONENT、NAMELINK_ONLY、NAMELINK_SKIP

component相关。

2.2 EXPORT

将库名导出，与install(EXPORT)共同作用，将target导出。

2.3 INCLUDES DESTINATION

在执行install(EXPORT)命令进行导出时，将指定目录列表添加到target的属性INTERFACE_INCLUDE_DIRECTORIES中。

最后，对于install(targets)命令而言，一条install可以安装多个target，而一个target也有可能被install多次（都生效，而不是覆盖）。

三、Installing Files

install(<FILES|PROGRAMS> files...TYPE <type> | DESTINATION <dir>[PERMISSIONS permissions...][CONFIGURATIONS [Debug|Release|...]][COMPONENT <component>][RENAME <name>] [OPTIONAL] [EXCLUDE_FROM_ALL])

1.FILES | PROGRAMS

两者都是安装文件，只不过FILES安装后的文件默认权限为OWNER_WRITE, OWNER_READ, GROUP_READ和WORLD_READ(如果设置了PERMISSIONS则按PERMISSIONS来)；而对PROGRAMS而言，还多了OWNER_EXECUTE, GROUP_EXECUTE和WORLD_EXECUTE三个权限。

安装的文件内容，可以是生成器表达式$<...>,但是以任何表达式开始的文件都要求是完整路径(实际上不是表达式也需要全路径)。

2.TYPE | DESTINATION

两者用于指定文件安装的目标目录，两者不能同事存在。如果使用TYPE的话则会指定文件的类型，并从GNUInstallDirs中获取相应的变量，而如果没有定义此变量则使用内置的默认值。下表则是文件类型对应的变量和默认路径。

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}

<LOCALSTATEdir>/run

DATA

${CMAKE_INSTALL_DATADIR}

<DATAROOTdir>

INFO

${CMAKE_INSTALL_INFODIR}

<DATAROOTdir>/info

LOCALE

${CMAKE_INSTALL_LOCALEDIR}

<DATAROOTdir>/locale

MAN

${CMAKE_INSTALL_MANDIR}

<DATAROOTdir>/man

DOC

${CMAKE_INSTALL_DOCDIR}

<DATAROOTdir>/doc

如果提供了DESTINATION参数，则使用DESTINATION参数提供的目录。

四、Installing Directories

install(DIRECTORY dirs...TYPE <type> | DESTINATION <dir>[FILE_PERMISSIONS permissions...][DIRECTORY_PERMISSIONS permissions...][USE_SOURCE_PERMISSIONS] [OPTIONAL] [MESSAGE_NEVER][CONFIGURATIONS [Debug|Release|...]][COMPONENT <component>] [EXCLUDE_FROM_ALL][FILES_MATCHING][[PATTERN <pattern> | REGEX <regex>][EXCLUDE] [PERMISSIONS permissions...]] [...])

用于安装一个或多个目录到目标目录，目录结构被完整的拷贝。每个目录的最后一项会被添加到目标目录，如果不想这样则可以以/结尾，表示最后一项为空。

#表示将build目录下的内容安装到test目录下
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build/ 
DESTINATION ${PROJECT_SOURCE_DIR}/test)#表示将build目录的内容安装到test目录下
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build 
DESTINATION ${PROJECT_SOURCE_DIR}/test)

如果输入目录为空，则创建目标目录，且内容为空。

1.权限

FILE_PERMISSIONS、DIRECTORY_PERMISSIONS 、USE_SOURCE_PERMISSIONS三者用于控制目标目录(DIRECTORY_PERMISSIONS)和文件(FILE_PERMISSIONS)的权限。如果使用了USE_SOURCE_PERMISSIONS，而FILE_PERMISSIONS没有指定，则文件权限与源文件权限一样。

如果没有指定FILE_PERMISSIONS权限，则文件的权限与FILES命令的权限一样（OWNER_WRITE, OWNER_READ, GROUP_READ和WORLD_READ），而目录权限与PROGRAMS一样（OWNER_WRITE, OWNER_READ, GROUP_READ，WORLD_READ，OWNER_EXECUTE, GROUP_EXECUTE和WORLD_EXECUTE）

2.过滤

目录的安装可以通过PATTERN和REGEX选项细粒度的控制，其中PATTERN匹配完整文件名，REGEX默认匹配文件名中的任何一部分(可以通过/或者$实现与PATTERN相同的效果)。

默认情况下，所有文件和目录都会被install(不论PATTERN和REGEX的匹配结果),但是我们可以通过设置FILES_MATCHING过滤没有匹配的文件。

#目录全部拷贝，安装以target开始的文件
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build/ DESTINATION ${PROJECT_SOURCE_DIR}/test
FILES_MATCHINGPATTERN "target*")#目录全部拷贝，只安装target文件
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build/ DESTINATION ${PROJECT_SOURCE_DIR}/test
FILES_MATCHINGPATTERN "target")#目录全部拷贝，安装文件名包含target的文件
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build/ DESTINATION ${PROJECT_SOURCE_DIR}/test
FILES_MATCHINGREGEX "target")#REGEX通过前缀$或后缀/达到与PATTERN相同的效果
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build/ DESTINATION ${PROJECT_SOURCE_DIR}/test
FILES_MATCHINGREGEX "target/")
install(DIRECTORY  ${PROJECT_SOURCE_DIR}/build/ DESTINATION ${PROJECT_SOURCE_DIR}/test
FILES_MATCHINGREGEX "$target")

五、Installing Exports

install(EXPORT <export-name> DESTINATION <dir>[NAMESPACE <namespace>] [[FILE <name>.cmake]|[PERMISSIONS permissions...][CONFIGURATIONS [Debug|Release|...]][EXPORT_LINK_INTERFACE_LIBRARIES][COMPONENT <component>][EXCLUDE_FROM_ALL])

生成并安装一个CMake文件，该文件包含了将targets从安装目录中导入到其他项目的代码。安装的内容是跟上面install(TARGETS)中EXPORT的选项一样。

NAMESPACE选项将在目标名被写入导入文件时在前面添加<namespace>。默认生成的文件为<export-name>.cmake，而FILE选项可以将其设置为其他名字，这个名字必须以.cmake结尾。

下面是一个简单的例子：

创建一个项目hello：

cmake_minimum_required(VERSION 3.20)
project(target01 VERSION 1.0.0)
file(GLOB SOURCES "src/*")set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS ON)
set(CMAKE_INSTALL_PREFIX ${PROJECT_SOURCE_DIR}/../helloPkg/)add_library(${PROJECT_NAME} SHARED ${SOURCES})set_target_properties(${PROJECT_NAME} PROPERTIES PUBLIC_HEADER src/hello.h)install(TARGETS ${PROJECT_NAME} EXPORT ${PROJECT_NAME}ARCHIVE DESTINATION ${PROJECT_SOURCE_DIR}/../helloPkg/lib/ReleaseRUNTIME DESTINATION ${PROJECT_SOURCE_DIR}/../helloPkg/bin/ReleasePUBLIC_HEADER DESTINATION ${PROJECT_SOURCE_DIR}/../helloPkg/include)# install(FILES ${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}Config.cmakeinstall(EXPORT ${PROJECT_NAME} DESTINATION ${PROJECT_SOURCE_DIR}/../helloPkg/lib/cmake/${PROJECT_NAME}NAMESPACE TEST::)
configure_file(${PROJECT_SOURCE_DIR}/${PROJECT_NAME}.cmake.in ${PROJECT_BINARY_DIR}/${PROJECT_NAME}Config.cmake @ONLY)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}Config.cmakeDESTINATION ${PROJECT_SOURCE_DIR}/../helloPkg/lib/cmake/${PROJECT_NAME})

同目录下创建src文件夹，并创建：

class __declspec(dllexport) Hello
{
public:void print();
};
#include "hello.h"
#include <iostream>void Hello::print() {std::cout << "hello world!" << std::endl;
}

CMakeLists.txt统计目录下创建target01.cmake.in：

@PACKAGE_INIT@include("${CMAKE_CURRENT_LIST_DIR}/@PROJECT_NAME@.cmake")

然后在hello同级目录下创建main项目

cmake_minimum_required(VERSION 3.20)
project(main)set(CMAKE_INSTALL_PREFIX  ${PROJECT_SOURCE_DIR}/../helloPkg/lib/cmake)
set(target01_DIR  ${PROJECT_SOURCE_DIR}/../helloPkg/lib/cmake/target01/)find_package(target01 REQUIRED PATHS ${PROJECT_SOURCE_DIR}/../helloPkg/)
add_executable(${PROJECT_NAME} src/main.cpp)target_include_directories(${PROJECT_NAME} PRIVATE ${PROJECT_SOURCE_DIR}/../helloPkg/include)
target_link_libraries(${PROJECT_NAME} PRIVATE TEST::target01)

创建src目录并创建main.cpp

#include "hello.h"int main()
{Hello h;h.print();return 0;
}

最后，在main项目同级目录下创建helloPkg文件夹。

这里虽然没搞懂中间的configure_file和*.cmake.in文件的作用，但是试出来了，先记一下。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/31460.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

检测ChatGPT生成内容的工具经常误报，怪不得OpenAI停用它

检测ChatGPT生成内容的工具经常误报，怪不得OpenAI停用它

​近日&#xff0c;加利福尼亚大学戴维斯分校的学生被指控使用ChaGPT作弊。他的老师指控他在历史考试中使用了ChatGPT&#xff0c;这一指控得到了某生成式内容检测工具的支持。然而&#xff0c;该名学生坚决否认这一指控&#xff0c;他通过提供在线文档的编辑日志为自己洗清了嫌…
阅读更多...
中电金信：逐数兴业 智启未来——“数据二十条”影响之解读 （下）

中电金信：逐数兴业 智启未来——“数据二十条”影响之解读 （下）

在逐数兴业 智启未来——“数据二十条”影响之解读&#xff08;上&#xff09;篇内容中&#xff0c;主要解读了有关于“数据二十条”发布的背景与意义、建立数据要素市场面临的挑战与应对。在今天的文章里&#xff0c;将继续解读“数据二十条”的主要内容以及对金融行业和金融科…
阅读更多...
Git仓关联多个远程仓路径

Git仓关联多个远程仓路径

前言 Git仓如果需要将代码push到多个仓&#xff0c;常用的做法是添加多个远程仓路径&#xff0c;然后分别push。这样虽然可以实现目的&#xff0c;但是需要多次执行push指令&#xff0c;很麻烦。 本文介绍关联多个远程仓路径且执行一次push指令的方法&#xff1a;git remote …
阅读更多...
【Docker】Docker私有仓库的使用

【Docker】Docker私有仓库的使用

目录 一、搭建私有仓库 二、上传镜像到私有仓库 三、从私有仓库拉取镜像 一、搭建私有仓库 首先我们需要拉取仓库的镜像 docker pull registry 然后创建私有仓库容器 docker run -it --namereg -p 5000:5000 registry 这个时候我们可以打开浏览器访问5000端口看是否成功&…
阅读更多...
过程控制与需求变更

过程控制与需求变更

1.1　过程控制与质量保障 通过先进的过程管理方法来提高个人和团队的工作质量。采用PSP/TSP过程管理有助于每个人和小组工作质量的稳步提高&#xff0c;从而达到项目整体质量的提高&#xff0c;PSP用一系列的步骤解释个人软件过程的改进&#xff0c;每一步包含前一步所有元素并…
阅读更多...
微服务与Nacos概述-3

微服务与Nacos概述-3

流量治理 在微服务架构中将业务拆分成一个个的服务&#xff0c;服务与服务之间可以相互调用&#xff0c;但是由于网络原因或者自身的原因&#xff0c;服务并不能保证服务的100%可用&#xff0c;如果单个服务出现问题&#xff0c;调用这个服务就会出现网络延迟&#xff0c;此时…
阅读更多...
【mysql并行批量删除死锁排查】

【mysql并行批量删除死锁排查】

文章目录 背景表单和索引结构原因分析解决方案 背景 mysql批量删除并插入新数据的场景下&#xff0c;为提高执行效率&#xff0c;使用了多线程并发执行的方式。当然mysql建表时使用了分区&#xff08;partition&#xff09;机制&#xff0c;聚焦到我们这次讨论的问题&#xff…
阅读更多...
Redis_主从复制

Redis_主从复制

8. 主从复制 8.1 简介 主从库采用读写分离的方式 读操作&#xff1a;主库、从库都可以处理写操作&#xff1a;首先写到主库执行&#xff0c;然后再将主库同步给从库。 实现读写分离&#xff0c;性能扩展 容灾快速恢复 8.2 主从复制步骤 创建一个目录 ,在root下创建一个m…
阅读更多...
hive on tez资源控制

hive on tez资源控制

sql insert overwrite table dwintdata.dw_f_da_enterprise2 select * from dwintdata.dw_f_da_enterprise; hdfs文件大小数量展示 注意这里文件数有17个 共计321M 最后是划分为了21个task 为什么会有21个task&#xff1f;不是128M 64M 或者说我这里小于128 每个文件一个map…
阅读更多...
(C++)继承

(C++)继承

目录 1.继承的概念及定义 1.1继承的概念 1.2继承定义 1.2.1定义格式 1.2.2继承方式和访问限定符 1.2.3继承基类成员访问方式的变化 2.基类和派生类对象赋值转换 3.继承中的作用域 4.派生类的默认成员函数 5.继承与友元 6.继承与静态成员 7.复杂的菱形继承及菱形虚拟…
阅读更多...
请简述React是什么？React的主要特点有哪些？React中有哪些主要组件？

请简述React是什么？React的主要特点有哪些？React中有哪些主要组件？

1、请简述React是什么&#xff1f; React是一个用于构建用户界面的JavaScript库&#xff0c;它由Facebook开发并开源。React的主要特点是其数据驱动和组件化的设计理念。它允许开发者将复杂的界面分解为简单的组件&#xff0c;并将这些组件以数据流的方式组合在一起&#xff0…
阅读更多...
2.0 Python 数据结构与类型

2.0 Python 数据结构与类型

数据类型是编程语言中的一个重要概念&#xff0c;它定义了数据的类型和提供了特定的操作和方法。在 python 中&#xff0c;数据类型的作用是将不同类型的数据进行分类和定义&#xff0c;例如数字、字符串、列表、元组、集合、字典等。这些数据类型不仅定义了数据的类型&#xf…
阅读更多...
题目：灾后重建

题目：灾后重建

【题目描述】 B地区在地震过后&#xff0c;所有村庄都造成了一定的损毁&#xff0c;而这场地震却没对公路造成什么影响。但是在村庄重建好之前&#xff0c;所有与未重建完成的村庄的公路均无法通车。换句话说&#xff0c;只有连接着两个重建完成的村庄的公路才能通车&#xff…
阅读更多...
cmake常用命令(1)——函数相关

cmake常用命令(1)——函数相关

一、function/endfunction cmake中的函数与其他语言相似&#xff0c;表示一个命令集&#xff0c;可以被重复调用。形式如下&#xff1a; function(<name> [<arg1> ...])<commands> endfunction() function&#xff1a;表示函数开始 <name>&#xf…
阅读更多...
Nexus npm仓库如何设置同步频率

Nexus npm仓库如何设置同步频率

在 Nexus Repository Manager 中&#xff0c;设置同步频率可以确保你的代理或镜像仓库能够及时获取外部仓库中的最新包。以下是设置同步频率的一般步骤&#xff1a; 登录到 Nexus 管理界面&#xff1a;使用管理员账号登录到 Nexus Repository Manager 的 Web 管理界面。 选择仓…
阅读更多...
SpringBoot复习：（24）DeferredImportSelector

SpringBoot复习：（24）DeferredImportSelector

功能&#xff1a; 定一一个字符串数组&#xff0c;每个元素都是一个类的全限定名&#xff08;包名类名&#xff09;&#xff0c;把这些类的实例注册到Spring 容器。 一、定义要注册的类&#xff1a; package cn.edu.tju.service;import java.util.Arrays; import java.util.Li…
阅读更多...
Android11 设置备用DNS

Android11 设置备用DNS

在Android11 版本的rom 产品开发过程中&#xff0c;遇到一个问题&#xff0c;发现分配的DNS不可用的情况&#xff0c;所以需要设置备用DNS。 直接上代码 //frameworks/base/services/core/java/com/android/server/ConnectivityService //ConnectivityService.java --> //…
阅读更多...
【脚踢数据结构】链表（1）

【脚踢数据结构】链表（1）

(꒪ꇴ꒪ )&#xff0c;Hello我是祐言QAQ我的博客主页&#xff1a;C/C语言,Linux基础,ARM开发板&#xff0c;软件配置等领域博主&#x1f30d;快上&#x1f698;&#xff0c;一起学习&#xff0c;让我们成为一个强大的攻城狮&#xff01;送给自己和读者的一句鸡汤&#x1f914;&…
阅读更多...
机器学习基础之《特征工程（3）—特征预处理》

机器学习基础之《特征工程（3）—特征预处理》

一、什么是特征预处理 通过一些转换函数将特征数据转换成更加适合算法模型的特征数据过程 处理前&#xff0c;特征值是数值&#xff0c;处理后&#xff0c;进行了特征缩放 1、包含内容 数值型数据的无量纲化&#xff1a; 归一化 标准化 2、特征预处理API sklearn.preproces…
阅读更多...
什么是训练数据?

什么是训练数据?

算法从数据中学习。算法从得到的训练数据中找到关系&#xff0c;形成理解&#xff0c;做出决策&#xff0c;并评估信心。训练数据越好&#xff0c;模型的表现就越好。 实际上&#xff0c;与算法本身一样&#xff0c;训练数据的质量和数量与数据项目的成功有很大关系。 现在&…
阅读更多...
最新文章

Copyright @ 2022~2023