cmake find_package 使用笔记

目录

  • [1 find_package](#1 find_package)
  • [2 config mode](#2 config mode)
    • [2.1 搜索的文件名](#2.1 搜索的文件名)
    • [2.2 搜索路径](#2.2 搜索路径)
  • [3 module mode](#3 module mode)
    • [3.1 搜索的文件名](#3.1 搜索的文件名)
    • [3.2 搜索路径](#3.2 搜索路径)
  • 参考

1 find_package

这是官方文档

下面是学习总结:

首先是find_package的作用是什么?引入预编译的库。

find_package有两种模式:config mode和module mode。config mode使用于cmake系库的引入,反之就是module mode。

2 config mode

bash 复制代码
find_package(SomeThing
  NAMES
    SameThingOtherName   # Another name for the package
    SomeThing            # Also still look for its canonical name
)

2.1 搜索的文件名

bash 复制代码
# 核心文件
<PackageName>Config.cmake or <LowercasePackageName>-config.cmake
# 版本信息
<PackageName>ConfigVersion.cmake or <LowercasePackageName>-config-version.cmake

2.2 搜索路径

  1. 默认搜索路径前缀,注意这里是前缀,cmake会在其后的 lib/cmake/ 下去找。linux默认在 /usrwindows 默认在 Program Files
  2. 可以在 CMAKE_PREFIX_PATH 里追加自定义路径前缀,有多种方法,比如
bash 复制代码
# 在CMakeLists.txt中
set(CMAKE_PREFIX_PATH /path/to/libA;/path/to/libB)

# 在cmake配置的时候
cmake .. -DCMAKE_PREFIX_PATH=/path/to/libA;/path/to/libB

# 设置环境变量
# linux
export CMAKE_PREFIX_PATH=/path/to/libA:/path/to/libB
# windows
set CMAKE_PREFIX_PATH="/path/to/libA;/path/to/libB"
  1. 指定某些包的搜索路径,注意不是前缀,比如
bash 复制代码
# 搜索的报名为 SomePackage
set(SomePackage_DIR /opt/somepackage/lib/cmake/SomePackage)

3 module mode

如果module mode搜索失败,才会进入config mode。在module mode 搜索的文件名是:

3.1 搜索的文件名

bash 复制代码
Find<PackageName>.cmake

cmake维护了常用库的这个搜索文件。如果cmake没有维护,就只能参考这个教程自己写了。

3.2 搜索路径

搜索路径可以通过CMAKE_MODULE_PATH设置。

bash 复制代码
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
include(Foo) # Loads ${CMAKE_CURRENT_SOURCE_DIR}/cmake/Foo.cmake
find_package(Bar) # Loads ${CMAKE_CURRENT_SOURCE_DIR}/cmake/FindBar.cmake

参考

相关推荐
量子炒饭大师14 小时前
收集飞花令碎片——C语言关键字typedef
c语言·c++·算法
Naiva14 小时前
ESP32-C3 入门09:基于 ESP-IDF + LVGL + ST7789 的 1.54寸 WiFi 时钟(SquareLine Studio 移植)
ide·笔记·vscode
..过云雨15 小时前
03.【Linux系统编程】基础开发工具1(yum软件安装、vim编辑器、编辑器gcc/g++)
linux·c语言·笔记·学习
宁静致远202115 小时前
【C++设计模式】第五篇:装饰器模式
c++·设计模式·装饰器模式
青草地溪水旁15 小时前
Linux 高性能 I/O 事件通知机制的核心系统调用—— `epoll_ctl`
linux·c语言·c++
肥肠可耐的西西公主15 小时前
后端(FastAPI)学习笔记(CLASS 3):Tortoise ORM
笔记·学习·fastapi
孙同学_15 小时前
【C++】AVL树
c++·redis
PigeonGuan16 小时前
C盘扩容笔记
笔记
君宝16 小时前
Linux ALSA架构:PCM_OPEN流程 (二)
java·linux·c++
island131416 小时前
【C++框架#5】Elasticsearch 安装和使用
开发语言·c++·elasticsearch