CMake中的“包管理“模块FetchContent

背景介绍

C++的包管理工具,好像除了微软家的vcpkg外,并没有一个特别有名的包管理器。

CMake其实也提供了基础的包管理功能。使用 FetchContent 模块系列命令可以下载项目依赖的源代码或者其他文件。

基本用法

FetchContent_Declare命令定义我们下载的内容,支持从URL、GIT、SVN、Mercurial 或 CVS获取,以常用的GIT和URL为例,基本用法如下:

cmake 复制代码
cmake_minimum_required(VERSION 3.11)
include(FetchContent)

FetchContent_Declare(
  googletest     # 大小写敏感的非空字符串,表示这个依赖项的名称,后续 find_package 中使用,建议使用项目的官方名称
  GIT_REPOSITORY https://github.com/google/googletest.git
  GIT_TAG        b514bdc898e2951020cbdca1304b75f5950d1f59 # release-1.15.2
)
FetchContent_Declare(
  myCompanyIcons
  URL      https://intranet.mycompany.com/assets/iconset_1.12.tar.gz
  URL_HASH MD5=5588a7b18261c20068beabfb4f530b87
)

FetchContent_MakeAvailable(googletest myCompanyIcons)

find_package(googletest)
find_package(myCompanyIcons)

需要调用FetchContent_MakeAvailable 执行实际的下载任务,保证 FetchContent_Declare中定义的依赖库能被当前构建系统使用

复制代码
FetchContent_MakeAvailable(<name1> [<name2>...])

这样在后续 CMake 脚本中就可以直接使用 find_package 命令引用这些依赖库。

进阶用法

FetchContent模块提供了几个有用的变量,FETCHCONTENT_BASE_DIRFETCHCONTENT_QUIETFETCHCONTENT_FULLY_DISCONNECTED

FETCHCONTENT_BASE_DIR

设置下载保存的目录,默认是${CMAKE_BINARY_DIR}/_deps,我们可以利用这个变量自定义下载保存的目录。

复制代码
set(FETCHCONTENT_BASE_DIR ${CMAKE_BINARY_DIR}/third_party)

FETCHCONTENT_QUIET

设置下载过程中是否显示详细的日志,如果我们遇到下载失败的情况,可以把这个开关打开,方便排查问题。默认是关闭状态。

复制代码
set(FETCHCONTENT_QUIET ON)

FETCHCONTENT_FULLY_DISCONNECTED

设置每次构建时是否重新下载依赖项目。赋值为ON时,它假设我们上一次构建时已经正确使用了依赖项,并且开发者知道这些依赖项的版本没有变化,后续构建时不需要重新下载。默认是每次构建都会重新下载,默认值是OFF。

复制代码
set(FETCHCONTENT_FULLY_DISCONNECTED ON)

使用 FetchContent_Declare 时,默认依赖项目的 CMakeLists.txt 文件在其根目录下。如果并非如此,例如大名鼎鼎的 protobuf 项目,其CMakeLists.txt 在其根目录的cmake 目录下,我们可以使用SOURCE_SUBDIR参数指定 CMakeLists.txt 的路径,告诉·FetchContent_Declare·去哪里找它。

复制代码
FetchContent_Declare(
  protobuf
  GIT_REPOSITORY https://github.com/protocolbuffers/protobuf.git
  GIT_TAG        1be1c9d0ea6efa2a25bd7b76186844d1669be78a # v29.4
  SOURCE_SUBDIR  cmake
)

参考资料

https://cmake.org/cmake/help/latest/module/ExternalProject.html

https://cmake.org/cmake/help/latest/module/FetchContent.html

相关推荐
代码AC不AC24 分钟前
【C++】类和对象【中下】
开发语言·c++·类和对象·学习分享·运算符重载
wuqingshun3141591 小时前
蓝桥杯 11. 最大距离
数据结构·c++·算法·职场和发展·蓝桥杯
留在街角1 小时前
<c++>使用detectMultiScale的时候出现opencv.dll冲突
开发语言·c++·opencv
机器视觉知识推荐、就业指导2 小时前
Qt/C++面试【速通笔记五】—子线程与GUI线程安全交互
c++·qt·面试·gui·子线程
大魔王(已黑化)2 小时前
LeetCode —— 94. 二叉树的中序遍历
数据结构·c++·算法·leetcode·职场和发展
南玖yy2 小时前
解锁 C++26 的未来:从语言标准演进到实战突破
开发语言·数据库·c++·人工智能·c++23·c++基础语法
六点半8883 小时前
【蓝桥杯】第十六届蓝桥杯C/C++大学B组个人反思总结
c语言·c++·算法·蓝桥杯
✿ ༺ ོIT技术༻3 小时前
笔试强训:Day3
c++·笔记·算法
让我们一起加油好吗5 小时前
【C++】类和对象(中)——默认成员函数详解(万字)
开发语言·c++·visualstudio·类和对象
fhqlongteng5 小时前
一种动态分配内存错误的解决办法
运维·服务器·网络·c++