conanfile.py中定义的package_info()
方法用于向package的调用者(conumer)提供包库名,编译/连接选项,文件夹等等信息,有了这些信息构建工具的generator就可以根据它们生成对应的文件,用于调用者引用package.
比如基于cmake的CMakeDeps可以根据这些信息自动生成Find<Package>.cmake
和<Package>-config.cmake
.
调用者的CMakeLists.txt中通过FindPackage(<Package>)
就可以自动找到package.创建对应的import target.
比如我为mnn 项目写的conanfile.py(https://gitee.com/l0km/mnn/blob/conan1.2.7/conanfile.py)
def package_info(self):
self.cpp_info.libs = ["MNN"]
if not self.options.shared :
if self.settings.compiler == "msvc":
self.cpp_info.sharedlinkflags.extend(["/WHOLEARCHIVE:MNN"])
self.cpp_info.exelinkflags = self.cpp_info.sharedlinkflags
elif self.settings.compiler == "gcc":
# about LINKER: ,see also https://cmake.org/cmake/help/latest/command/target_link_options.html#handling-compiler-driver-differences
self.cpp_info.sharedlinkflags.extend(["LINKER:--whole-archive",self._mnn_lib,"LINKER:--no-whole-archive"])
self.cpp_info.exelinkflags = self.cpp_info.sharedlinkflags
elif self.settings.compiler == "clang":
self.cpp_info.sharedlinkflags.extend(["LINKER:--whole-archive",self._mnn_lib,"LINKER:--no-whole-archive"])
self.cpp_info.exelinkflags = self.cpp_info.sharedlinkflags
mnn这个项目本身没有生成cmake配置文件,但conan会在调用方在引用mnn package时CMakeDeps generator会自动生成mnn-config.cmake及相关文件,如下图,这样就减少了package开发中编译脚本的工作量。
但是有的时候,package本身的CMake编译脚本中已经有了config-cmake生成的逻辑,可以自己生成config-cmake.我们可以通过在package_info()
进行配置,让conan使用package自带的config.cmake.而不需要CMakeDeps
生成cmake配置文件。
如下在package_info
中定义builddirs
和cmake_find_mode
参数就可以实现
def package_info(self):
self.cpp_info.builddirs.append(self.package_folder)
self.cpp_info.set_property("cmake_find_mode", "none")
参见 《Disable CMakeDeps For Installed CMake configuration files》
jpegwrapper是我几年前写的一个jpeg相关项目,最近给它增加了conan支持,这个项目原本就会自动生成config.cmake。所以写conanfile.py时我希望调用者使用原本的config.cmake,
所以在package_info
方法就是通过上面的定义来实现的:
https://gitee.com/l0km/jpegwrapper/blob/master/conanfile.py
def package_info(self):
self.cpp_info.libs = ["jpegwrapper"]
# 指定将安装路径加入CMAKE_PREFIX_PATH,以便执行find_package时能扫描到安装路径
self.cpp_info.builddirs.append(self.package_folder)
# 抑制conan生成jpegwrapper-config.cmake使用jpegwrapper自己生成的cmake配置文件
self.cpp_info.set_property("cmake_find_mode", "none")
# cmake_find_mode为none时不需要配置此参数
#self.cpp_info.requires = ["common_source_cpp::common_source_cpp","libjpeg-turbo::libjpeg-turbo","openjpeg::openjpeg"]
参考资料
《package_info》
《Recipe tools》
《CMakeDeps》
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入门(二十六):使用make编译makefile》
《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 2.x 引用第三方库示例》