现代CMake高级教程 - 第 5 章：链接第三方库

news/2024/11/17 3:36:23/

双笙子佯谬老师的【公开课】现代CMake高级教程课程笔记

第 5 章：链接第三方库

案例

使用 tbb 库

main.cpp

#include <tbb/parallel_for.h>
int main()
{tbb::parallel_for(0, 4, [&] (int i){printf("hello, %d!\n", i);})
}

直接链接 tbb

CMakeLists.txt

add_executable(main main.cpp)target_link_libraries(main PUBLIC tbb)

直接链接 tbb 的缺点：

如果这样直接指定 tbb，CMake 会让链接器在系统的库目录里查找 tbb，他会找到 /usr/lib/libtbb.so 这个系统自带的，但这对于没有一个固定库安装位置的 Windows 系统并不适用。

此外，他还要求 tbb 的头文件就在 /usr/include 这个系统默认的头文件目录，这样才能 #include <tbb/parallel_for.h> 不出错，如果 tbb 的头文件在其他地方就需要再加一个 target_include_directories 设置额外的头文件查找目录。

也可以直接写出全部路径，这样也可以让没有默认系统路径的 Windows 找到安装在奇怪位置的 tbb… 不过这样根本不跨平台，你这样改了别人如果装在不同地方就出错了。

顺便一提，CMake 的路径分割符始终是 /。即使在 Windows 上，也要把所有的 \ 改成 /，这是出于跨平台的考虑。请放心，CMake 会自动在调用 MSVC 的时候转换成 \，你可以放心的用 ${x}/bin 来实现和 Python 的 os.path.join(x, ‘bin’) 一样的效果。

CMakeLists.txt

add_executable(main main.cpp)
target_link_libraries(main PUBLIC c:/Users/archibate/installed/tbb/tbb.dll)

毕竟大多数操作系统都是 Unix-like，就 Windows 喜欢搞特殊。cd /d C:\Program\ Files\ (x86)\Microsoft\ Visual\ Studio\2019\ 路径里动不动夹杂几个转移符、空格、特殊符号，这谁顶得住啊。

高情商：Windows 是最适合练习你 C 语言转义符使用水平的地方。

更通用的方式：find_package

更好的做法是用 CMake 的 find_package 命令。
find_package(TBB REQUIRED) 会查找 /usr/lib/cmake/TBB/TBBConfig.cmake 这个配置文件，并根据里面的配置信息创建 TBB::tbb 这个伪对象（他实际指向真正的 tbb 库文件路径 /usr/lib/libtbb.so），之后通过 target_link_libraries 链接 TBB::tbb 就可以正常工作了。

CMakeLists.txt

add_executable(main main.cpp)
find_package(TBB REQUIRED)
target_link_libraries(main PUBLIC TBB::tbb)

TBB::tbb 的秘密：自带了一些 PUBLIC 属性

TBB::tbb 是一个伪对象（imported），除了他会指向 /usr/lib/libtbb.so 之外，TBBConfig.cmake 还会给 TBB::tbb 添加一些 PUBLIC 属性，用于让链接了他的对象带上一些 flag 之类的。

比如，TBB 安装在 /opt/tbb 目录下，头文件在 /opt/tbb/include 里，那么这时 TBBConfig.cmake 里就会有：
target_include_directories(TBB::tbb PUBLIC /opt/tbb/include)
这样 main 在链接了 TBB::tbb 的时候也会被“传染”上 /opt/tbb/include 这个目录，不用调用者手动添加了。

再比如，TBB::tbb 链接了另一个库 Blosc::blosc，那这个库也会自动链接到 main 上，无需调用者手动添加。

比如 spdlog 的 spdlog-config.cmake 就会定义 SPDLOG_NOT_HEADER_ONLY 这个宏为 PUBLIC。从而实现直接 #include <spdlog/spdlog.h> 时候是纯头文件，而 find_package(spdlog REQUIRED) 时却变成预编译链接库的版本。（嗯，其实不是 PUBLIC 而是 INTERFACE，因为伪对象没有实体）

和古代 CMake 做对比：为什么 PUBLIC 属性的传播机制如此便利

古代 CMake

cmake_minimum_required(VERSION 2.8)
project(MyProject)list(APPEND CMAKE_MODULE_PATH "<path to FindTBB module>")find_package(TBB COMPONENTS tbb tbbmalloc)
if (NOT TBB_FOUND)message(FATAL_ERROR "TBB not found")
endif()add_executable(myapp myapp)
target_include_directories(myapp ${TBB_INCLUDE_DIRS})
target_compile_definitions(myapp ${TBB_DEFINITIONS})
target_link_libraries(myapp ${TBB_LIBRARIES})

现代 CMake

cmake_minimum_required(VERSION 3.12)
project(MyProject LANGUAGES CXX)find_package(TBB COMPONENTS tbb tbbmalloc REQUIRED)add_executable(myapp myapp)
target_link_libraries(myapp TBB::tbb TBB::tbbmalloc)

和 find_package(TBB CONFIG REQUIRED) 的区别

其实更好的是通过 find_package(TBB CONFIG REQUIRED)，添加了一个 CONFIG 选项。这样他会优先查找 TBBConfig.cmake（系统自带的）而不是 FindTBB.cmake（项目作者常把他塞在 cmake/ 目录里并添加到 CMAKE_MODULE_PATH）。这样能保证寻找包的这个 .cmake 脚本是和系统自带的 tbb 版本是适配的，而不是项目作者当年下载的那个版本的 .cmake 脚本。

CMakeLists.txt

add_executable(main main.cpp)find_package(TBB CONFIG REQUIRED)
target_link_libraries(main PUBLIC TBB::tbb)

当然，如果你坚持要用 find_package(TBB REQUIRED) 也是可以的。

  • 没有 CONFIG 选项：先找 FindTBB.cmake，再找 TBBConfig.cmake，找不到则报错
  • 有 CONFIG 选项：只会找 TBBConfig.cmake，找不到则报错

此外，一些老年项目（例如 OpenVDB）只提供 Find 而没有 Config 文件，这时候就必须用 find_package(OpenVDB REQUIRED) 而不能带 CONFIG 选项。

/usr/lib/cmake/TBB/TBBConfig.cmake

不论是 TBBConfig.cmake 还是 FindTBB.cmake，这个文件通常由库的作者提供，在 Linux 的包管理器安装 tbb 后也会自动安装这个文件。少部分对 CMake 不友好的第三方库，需要自己写 FindXXX.cmake 才能使用。

# Create imported target TBB::tbb
add_library(TBB::tbb SHARED IMPORTED)set_target_properties(TBB::tbb PROPERTIESINTERFACE_COMPILE_DEFINITIONS "\$<\$<CONFIG:DEBUG>:TBB_USE_DEBUG>"INTERFACE_INCLUDE_DIRECTORIES "${_IMPORT_PREFIX}/include"
)# Create imported target TBB::tbbmalloc
add_library(TBB::tbbmalloc SHARED IMPORTED)set_target_properties(TBB::tbbmalloc PROPERTIESINTERFACE_COMPILE_DEFINITIONS "\$<\$<CONFIG:DEBUG>:TBB_USE_DEBUG>"INTERFACE_INCLUDE_DIRECTORIES "${_IMPORT_PREFIX}/include"
)# Create imported target TBB::tbbmalloc_proxy
add_library(TBB::tbbmalloc_proxy SHARED IMPORTED)set_target_properties(TBB::tbbmalloc_proxy PROPERTIESINTERFACE_COMPILE_DEFINITIONS "\$<\$<CONFIG:DEBUG>:TBB_USE_DEBUG>"INTERFACE_INCLUDE_DIRECTORIES "${_IMPORT_PREFIX}/include"
)

老年项目案例：OpenVDB（反面教材）

一些老年项目作者喜欢在项目里自己塞几个 FindXXX.cmake，然而版本可能和系统里的不一样，比如用 3.0 的 finder 去找 2.0 的包，容易出现一些奇奇怪怪的错误。

不建议大家这样用自己创建一个 cmake/ 目录来存用到的所有库的 finder，尽量用系统自带的，可以保证用的是系统自带库的那个配置。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-n37qGqZL-1683089549162)(./images/1677557642969.png)]

find_package(Qt5 REQUIRED) 出错了

find_package(Qt5 REQUIRED)
target_link_libraries(main PUBLIC Qt5::Widgets Qt5::Gui)

CMake Error at CMakeLists.txt:6 (find_package):Found package configuration file:/usr/lib64/cmake/Qt5/Qt5Config.cmakebut it set Qt5_FOUND to FALSE so package "Qt5" is considered to be NOT FOUND. Reason given by package:
The 0t5 package requires atleast onecomponent

原因：Qt5 具有多个组件，必须指定你需要哪些组件。

find_package 生成的伪对象（imported target）都按照“包名::组件名”的格式命名。你可以在 find_package 中通过 COMPONENTS 选项，后面跟随一个列表表示需要用的组件。

find_package(Qt5 COMPONENTS Widgets Gui REQUIRED)
target_link_libraries(main PUBLIC Qt5::Widgets Qt5::Gui)

find_package(TBB COMPONETS tbb tbbmalloc tbbmalloc_proxy REQUIRED)
target_link_libraries(main PUBLIC TBB::tbb TBB::tbbmalloc TBB::tbbmalloc_proxy)

测试一下能否找到 Qt 的头文件并编译通过：
main.cpp

#include <QDebug>
#include <QString>int main()
{QString hello = "hello, world!\n";qInfo() << hello;return 0;
}

常见问题：Windows 上找不到 Qt5 包怎么办？我明明安装了！

你是 Windows 系统，可能你安装了 Qt5，但是因为 Windows 系统的安装路径非常混乱，没有固定的 /usr/lib 之类的默认路径可以搜索，所以出错了。

CMake Error at CMakeLists.txt:6 (find_package):Could not find a package configuration file provided by "Qt5" with any ofthe following names:Qt5Config.cmakeqt5-config.cmakeAdd the installation prefix of "Qt5" to CMAKE_PREFIX_PATH or set "Qt5_DIR" to a directory containing one of the above files. If "Qt5" provides a separate development package or SDK, be sure it has been installed.

假设你的 Qt5 安装在 C:\Qt\Qt5.14.2，则你去找找这个目录：

C:\Qt\Qt5.14.2\msvc2019_64\lib\cmake\

你会看到他里面有个 Qt5Config.cmake 对吧。现在，有四种方法让 CMake 找得到他。

  • 第一种是设置 CMAKE_MODULE_PATH 变量，添加一下包含 Qt5Config.cmake 这个文件的目录路径 C:\Qt\Qt5.14.2\msvc2019_64\lib\cmake，当然刚刚说了尽管你是 Windows 还是要把 \ 全部换成 /，因为 CMake 是“亲 Unix”的构建系统。

    set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} C:/Qt/Qt5.14.2/msvc2019_64/lib/cmake)find_package(Qt5 REQUIRED COMPONENTS Widgets Gui REQUIRED)
target_link_libraries(main PUBLIC Qt5::Widgets Qt5::Gui)

  • 更好的方法：设置 <包名>_DIR 变量指向 <包名>Config.cmake 所在位置
    第二种是设置 Qt5_DIR 这个变量为 C:\Qt\Qt5.14.2\msvc2019_64\lib\cmake。这样只有 Qt5 这个包会去这个目录里搜索 Qt5Config.cmake，更有针对性。

    set(Qt5_DIR C:/Qt/Qt5.14.2/msvc2019_64/lib/cmake)find_package(Qt5 REQUIRED COMPONENTS Widgets Gui REQUIRED)
target_link_libraries(main PUBLIC Qt5::Widgets Qt5::Gui)

  • 更好的方法：设置 <包名>_DIR 变量指向 <包名>Config.cmake 所在位置
    第三种(推荐)，直接在命令行通过 -DQt5_DIR=”xxx” 指定，这样不用修改 CMakeLists.txt。

    cmake -B build -DQt5_DIR="C:/Qt/Qt5.14.2/msvc2019_64/lib/cmake"

  • 更好的方法：设置 <包名>_DIR 变量指向 <包名>Config.cmake 所在位置
    第四种，还可以通过设置环境变量 Qt5_DIR 也是可以的，就是对 Windows 用户比较困难。

    export Qt5_DIR="/opt/Qt5.14.2/lib/cmkae"
cmake -B build

不指定 REQUIRED

不指定 REQUIRED，找不到时不报错，只会设置 TBB_FOUND 为 FALSE

find_package(TBB)
if (TBB_FOUND)message(STATUS "TBB found at: ${TBB_DIR}")target_link_libraries(main PUBLIC TBB::tbb)target_compile_definitions(main PUBLIC WITH_TBB)
else()message(WARNING "TBB not found! using serial for")
endif()

-- TBB found at: /usr/lib64/cmake/TBB

如果没有 REQUIRED 选项，找不到时将不会报错。这样可以用于添加一些可选的依赖，如果没有也不要紧的那种，这时我们可以抛出一个警告。

找到了会把 TBB_FOUND 设为 TRUE，TBB_DIR 设为 TBBConfig.cmake 所在路径。
找不到会把 TBB_FOUND 设为 FALSE，TBB_DIR 为空。

这里我们在找到 TBB 时定义 WITH_TBB 宏，稍后 .cpp 里就可以根据这个判断。如果找不到 TBB 可以 fallback 到保守的实现。

这样在 .cpp 里可以判断 WITH_TBB 宏，找不到 TBB 时退化到串行 for 循环

#include <cstdio>
#ifdef WITH_TBB
#include <tbb/parallel_for.h>
#endifint main()
{
#ifdef WITH_TBBtbb::parallel_for(0, 4, [&](int i){
#elsefor (int i = 0; i < 4; i++){
#endifprintf("hello, %d!\n", i);
#ifdef WITH_TBB});
#else}
#endif
}

也可以用 TARGET 判断是否存在 TBB::tbb 这个伪对象，实现同样效果

find_package(TBB)
if (TARGET TBB::tbb)message(STATUS "TBB found at: ${TBB_DIR}")target_link_libraries(main PUBLIC TBB::tbb)target_compile_definitions(main PUBLIC WITH_TBB)
else()message(WARNING "TBB not found! using serial for")
endif()

也可以复合 if 的各种判断语句，例如 NOT TARGET TBB::tbb AND TARGET Eigen3::eigen 表示找得到 TBB 但是找不到 Eigen3 的情况。


http://www.ppmy.cn/news/59164.html

相关文章

【JS笔记】JS常见的事件、事件传播、事件解绑、事件委托、阻止事件冒泡、阻止默认行为、正则表达式

【JS笔记】JS常见的事件、事件传播、事件解绑、事件委托、阻止事件冒泡、阻止默认行为、正则表达式

目录 一、JS事件 1.1、事件介绍 1.2、绑定和解绑事件 （1）绑定事件 （2）解绑事件
阅读更多...
【Vue.js】1668- 初中级前端必须掌握的 10 个 Vue 优化技巧

【Vue.js】1668- 初中级前端必须掌握的 10 个 Vue 优化技巧

优化 Vue.js 应用性能是每个前端开发人员都需要关注的问题。本文我将分享 10 个初中级前端必须掌握的 Vue.js 优化技巧&#xff0c;无论您是正在学习 Vue.js&#xff0c;还是已经在应用开发中使用它&#xff0c;希望这些技巧都会对你的工作有所帮助。 1. 优雅的设置 v-for 中的…
阅读更多...
AIGC提示词（Prompt）网站

AIGC提示词（Prompt）网站

目录 Learning PromptSnack PromptFlow GPTPrompt HeroPublic Prompts 整理的 AI提示词&#xff08;Prompt&#xff09;网站&#xff0c;让AI工具效率翻倍&#xff01; 我的Blog https://xxlab.tech/archives/aigc-ti-shi-ci-prompt-wang-zhan Learning Prompt https://learn…
阅读更多...
常见提高SQL执行效率示例

常见提高SQL执行效率示例

1、减少与数据库的交互&#xff1a; 当传参是一个list集合时&#xff0c;通过遍历查询数据库会造成数据库压力过大&#xff0c;这样查询效率就比较低&#xff0c;应该减少与数据库的交互来提高查询效率&#xff1a;(这里的objId为“ljydl”,"ljtpfl") QueryWrapper&…
阅读更多...
香港top5功能完善炒期货投资app软件排名（最新评测）

香港top5功能完善炒期货投资app软件排名（最新评测）

选择一款合适的炒期货投资软件对于投资者来说至关重要。考虑软件稳定、交易流畅度、交易品种、数据可靠性、而且还要考虑费用等多方面因素。 首先&#xff0c;软件的稳定性很重要。选用稳定性高的软件可以避免如断电、手机或电脑死机等突发状况&#xff0c;保证交易安全顺畅。…
阅读更多...
Vue电商项目--axios二次封装

Vue电商项目--axios二次封装

postman测试接口 刚刚经过postman工具测试&#xff0c;发现接口果然发生了改变。 新的接口为http://gmall-h5-api.atguigu.cn 如果服务器返回的数据code字段200&#xff0c;代表服务器返回数据成功 整个项目&#xff0c;接口前缀都有/api字样 axios二次封装 XmlHttpRequ…
阅读更多...
掌握 Python 接口自动化测试理论，深度解读测试框架源码

掌握 Python 接口自动化测试理论，深度解读测试框架源码

目录&#xff1a;导读 引言 一、什么是接口测试、为什么要做接口测试 1、什么是接口测试 2、为什么要做接口测试 二、接口测试的流程 1、接口测试的流程 2、为什么要写测试用例 3、接口测试设计要点 三、python接口自动化-requests的应用 1、requests简介 2、reques…
阅读更多...
代码随想录算法训练营第五十二天 |动态规划 part13

代码随想录算法训练营第五十二天 |动态规划 part13

300. 最长递增子序列 给你一个整数数组 nums &#xff0c;找到其中最长严格递增子序列的长度。 子序列 是由数组派生而来的序列&#xff0c;删除&#xff08;或不删除&#xff09;数组中的元素而不改变其余元素的顺序。例如&#xff0c;[3,6,2,7] 是数组 [0,3,1,6,2,2,7] 的子序…
阅读更多...
最新文章

Copyright @ 2022~2023