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

参考

相关推荐
Andy杨1 小时前
20250712-1-Kubernetes 监控与日志管理-K8s日志管理与维护_笔记
笔记·容器·kubernetes
Tanecious.1 小时前
C++--红黑树
开发语言·c++
撰卢1 小时前
【个人笔记】负载均衡
运维·笔记·负载均衡
栈溢出了2 小时前
MyBatis实现分页查询-苍穹外卖笔记
java·笔记·mybatis
彤银浦2 小时前
Web学习笔记3
前端·笔记·学习·html5
之歆2 小时前
Python-魔术方法-创建、初始化与销毁-hash-bool-可视化-运算符重载-容器和大小-可调用对象-上下文管理-反射-描述器-二分-学习笔记
笔记·python·学习
morningcat20182 小时前
java17 gc笔记
java·jvm·笔记
优乐美香芋味好喝2 小时前
2025年7月11日学习笔记&一周归纳——模式识别与机器学习
笔记·学习·机器学习
tanyongxi664 小时前
C++ Map 和 Set 详解:从原理到实战应用
开发语言·c++
声网4 小时前
对话 AI 陪伴新宠 Tolan 创始人:拒绝「恋爱脑」,「非人」陪伴更受欢迎?丨 Voice Agent 学习笔记
人工智能·笔记·学习