Conan package_info应该怎么配置

阿芳姑娘_7690

阿芳姑娘_7690

2026-09-24

268人浏览

原创

package_info() 必须填写 self.cpp_info.libs、includedirs 和 defines 等关键信息,否则 find_package() 或 target_link_libraries() 会因链接失败或头文件找不到而报错;需按实际库名(不含前缀/后缀)、安装后路径和构建选项条件配置,并与 package_id() 联动确保二进制兼容性。

conan package_info应该怎么配置

package_info() 里必须填什么

这个方法不是可选的——只要你的包要被别人 find_package()target_link_libraries(),就必须在 package_info() 中明确告诉消费者:链接哪些库、加什么宏、包含哪些头文件路径。漏掉 self.cpp_info.libs 是最常见错误,结果就是 CMake 找得到包但链接失败,报 undefined reference

  • self.cpp_info.libs = ["mylib", "mylib_static"]:按实际生成的库文件名写(不含 lib 前缀或后缀,Linux/macOS 下是 mylib,Windows 下也写 mylib,Conan 会自动补 .lib/.a/.so
  • self.cpp_info.includedirs = ["include"]:头文件根目录,相对于包安装后的路径(不是源码路径)
  • self.cpp_info.defines = ["MYLIB_SHARED"]:需要传递给消费者的预处理器宏
  • 如果库依赖其他 Conan 包,用 self.requires("zlib/1.2.11") 声明即可,不用在 package_info() 里重复导出

动态库 vs 静态库怎么区分配置

Conan 不会自动判断你打包的是 .dll/.so 还是 .a/.lib,package_info() 必须配合 settings.build_typeoptions.shared 做条件分支,否则 Windows 下容易出现 LNK2019(导入库没导出符号)或 Linux 下 -lmylib 找不到动态库。

Conan 2.31.2
Conan 2.31.2

Conan 2.31.2 官方历史源码包,适合复现依赖解析、CMake 配置、二进制包兼容性和跨平台构建环境。

下载
  • if self.options.shared: 判断是否启用了共享构建,然后设置不同的 libsdefines
  • 静态库通常需要额外链接运行时(如 self.cpp_info.system_libs = ["m", "pthread"]),动态库一般不需要
  • 不要硬编码 mylib.dlllibmylib.so —— self.cpp_info.libs 只写逻辑名,后缀由 Conan 根据平台和 shared 选项自动处理

为什么 package_id() 和 package_info() 要联动

package_info() 里暴露的内容,直接影响 package_id() 的计算结果。比如你只在 shared=True 时才加 MYLIB_SHARED 宏,但 package_id() 没把 shared 选项纳入哈希,就会导致:同一个二进制包被同时用于 shared=Trueshared=False 场景,链接时符号不匹配。

  • 默认情况下,shared 选项已参与 package_id 计算,但如果你重写了 package_id() 却忘了调用 self.info.include(self.settings)self.info.include(self.options),就可能丢失关键维度
  • 如果 package_info() 中根据 self.settings.os == "Windows" 添加了 self.cpp_info.system_libs = ["ws2_32"],那 package_id() 就必须保留 os 设置,否则 Linux 用户可能误取到 Windows 二进制
  • 验证方式:conan create . user/channel --build=missing 后,检查 conan search mylib/1.0@user/channel 输出的 package ID 是否随 -o mylib:shared=True/False 改变

CMakeDeps 生成器下 package_info() 还要不要写 include dirs

要写,而且必须写对。CMakeDeps 不会读取你源码里的 include_directories(),它只信任 package_info().cpp_info.includedirs。如果你写成 ["src/include"] 但实际安装后头文件在 include/ 目录下,CMake 就会报 fatal error: mylib/myheader.h: No such file or directory

  • 路径必须是安装后结构中的相对路径,不是源码树路径;典型做法是在 package() 方法里用 self.copy("*.h", dst="include", src="src/include"),然后 includedirs = ["include"]
  • 如果头文件分散在多级目录(如 include/mylib/v1/include/mylib/detail/),统一设为 ["include"] 即可,让使用者用 #include <mylib></mylib>
  • 不要依赖 self.cpp_info.builddirsself.cpp_info.resdirs 来“修复”头文件路径问题——那是给构建时资源用的,不是给 #include 用的
真正容易被忽略的是:当你改了 package_info(),必须重新 conan createconan export-pkg,否则旧二进制包里的元信息不会更新,下游 conan install 拿到的还是老配置。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

20

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

0

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

0

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

20

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

0

19

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

2026.09.22

0

19

NumPy常见函数使用方法
NumPy常见函数使用方法

本专题整理 NumPy 常见函数使用方法相关教程,覆盖函数大全、参数用法、数组运算、统计聚合、排序处理、where 条件筛选、linspace 创建数列等常用场景,帮助读者快速掌握 NumPy 函数调用思路和实际数据处理技巧。

2026.09.22

0

21

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

20

25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 新特性与架构变化
Conan 2 新特性与架构变化

共0课时 | 0人学习