conan 入门(三十八):conan二进制包的兼容性及自定义package_id的方式

conan二进制包的兼容性是指一个package是否可以满足当前profile中定义的settings,以及conanfile.py指定的options参数。
默认情况下,conan在搜索一个依赖库匹配的二进制包(package)时,要求settings,options中所有参数都匹配,才算是一个兼容的包。
conan会根据settings,options中提供的参数算出哈希值作为package_id。以确保二进制包的唯一性。
简单说,settings.os=Linux的包就不能用于windows平台,同样,settings.compiler=gcc的包也不能用于msvc编译器。
对于options也是同样的道理,如果一个recipe的conanfile.py中定义了options,那么options中定义的所有参数必须都与要求的匹配才能满足当前编译环境要求。

在大多数情况下,这样的兼容策略都是合理的。

但是有的情况下settings,options中所有参数完全匹配的要求就有些多余,
比如,conanfile.py中定义了options.build_test参数用于指定是否编译测试程序。
一般来说,测试程序主要用于测试,并不算依赖库的一部分,在项目构建时不会被引用或执行,所以是否有测试程序并不影响二进制包的兼容性。
但根据默认的兼容性要求,options.build_test参数为TrueFalse编译出来就是两个不同的二进制包。没什么意义却又占用了空间。

所以conan提供了自定义二进制包兼容性的能力,
对于上面的options.build_test参数的问题,如下就可以在生成package_id时将options.build_test排除在外。这样,不论options.build_test参数为TrueFalse都不影响package_id的值。

    def package_id(self):
        del self.info.options.build_test

https://gitee.com/l0km/jpegwrapper是一个支持conan封装的项目,它的conafile.py就定义options.build_test参数,但如上定义了package_id方法将options.build_test排除在外
最终生成的package中就没有options.build_test,如下是conan list 方法查询输出的二进制包信息:
conan 入门(三十八):conan二进制包的兼容性及自定义package_id的方式_第1张图片
以上只是一个简单应用,仔细看看官方文档《Customizing the binary compatibility》你还可以发现更灵活的应用示例

参考资料

《Customizing the binary compatibility》

conan系列文章

《conan入门(一):conan 及 JFrog Artifactory 安装》
《conan入门(二):conan 服务配置-密码管理及策略》
《conan入门(三):上传预编译的库(artifact)》
《conan入门(四):conan 引用第三方库示例》
《conan入门(五):conan 交叉编译引用第三方库示例》
《conan入门(六):conanfile.txt conanfile.py的区别》
《conan入门(七):将自己的项目生成conan包》
《conan入门(八):交叉编译自己的conan包项目》
《conan入门(九):NDK交叉编译自己的conan包项目塈profile的定义》
《conan入门(十):Windows下Android NDK交叉编译Boost》
《conan入门(十一):Linux下Android NDK交叉编译Boost》
《conan入门(十二):Windows NDK 编译 boost报错:CMake was unable to find a build program … MinGW Makefile》
《conan入门(十三):conan info 命令的基本用法》
《conan入门(十四):conan new 命令的新特性–模板功能(–template)》
《conan入门(十五):AttributeError: ‘CMake‘ object has no attribute ‘definitions‘》
《conan入门(十六):profile template功能实现不同平台下profile的统一》
《conan入门(十七):支持android NDK (armv7,armv8,x86,x86_64)交叉编译的统一profile jinja2模板》
《conan入门(十八):Cannot recognize the Windows subsystem, install MSYS2/cygwin or specify a build_require》
《conan入门(十九):封装第三方开源库cpp_redis示例》
《conan入门(二十):封装只包含头文件(header_only)的库示例》
《conan入门(二十一):解决MinGW编译Openssl的编译错误:crypto/dso/dso_win32.c》
《conan入门(二十二):编译 openssl要求python 3.7以上版本》
《conan入门(二十三):Windows下MinGW编译libcurl》
《conan入门(二十四):通过CONAN_DISABLE_CHECK_COMPILER禁用编译器检查》
《conan入门(二十五):imports将包安装到本地项目或其他指定位置》
《conan入门(二十七):因profile [env]字段废弃导致的boost/1.81.0 在aarch64-linux-gnu下交叉编译失败》
《conan入门(二十八):解决conan 1.60.0下 arch64-linux-gnu交叉编译openssl/3.1.2报错问题》
《conan入门(二十九):对阿里mnn进行Conan封装塈conans.CMake和conan.tools.cmake.CMake的区别》
《conan入门(三十):对腾讯ncnn进行Conan封装》
《conan入门(三十一):在命令行(shell)中从profile中读取配置参数》
《conan 入门(三十二):package_info中配置禁用CMakeDeps生成使用项目自己生成的config.cmake》
《conan 入门(三十三):requirements()指定header的可见性(transitive_headers)》
《conan 入门(三十四):conan 2.x实现对只有Makefile的项目(erpcgen)的封装示例》
《conan 入门(三十五):在conanfile.py中获取C++编译器完整路径的方法》
《conan入门(三十六):在set_version方法中从pom.xml中读取版本号实现动态版本定义》
《conan 入门(三十七):conan 2.x通过定义环境变量(environment)执行make编译只有Makefile的项目(erpcgen)》
《conan 入门(三十八):conan二进制包的兼容性及自定义package_id的方式》

你可能感兴趣的:(conan,conan,兼容性,package_id,compatibility,conanfile.py)