conan入门(六):conanfile.txt conanfile.py的区别

conan conanfile.txt conanfile.py的区别

在之前的博客《conan入门(四):conan 引用第三方库示例》中我们以cJSON为例说明了如何在项目中引用一个conan 包。

conanfile.txt

在这篇博客中我们为了引用cjson/1.7.13库,创建了一个conanfile.txt文件用于指定json_test.c程序的依赖库cjson

[requires]
cjson/1.7.13

[generators]
cmake

关于conanfile.txt的详细说明参见Conan官方文档《conanfile.txt》和《Installing dependencies》

conanafile.txt还有一些别的字段:options,imports。。。

可以理解这个conanfile.txt的作用就是定义当前项目的conan配置。conan 的install,create,export,export-pkg,upload...等命令都会用依据这个配置文件来执行。

conanfile.py

在《conan入门(三):上传预编译的库(artifact)》中,我们用到了create new创建一个新的包:

使用conan new命令创建基本配置:

$ cd cjson.build/release/
$ conan new cjson/1.7.15 --bare
File saved: conanfile.py

conan new会在当前文件夹下生成conanfile.py,

from conans import ConanFile
from conan.tools.cmake import CMakeToolchain, CMake, cmake_layout


class HelloConan(ConanFile):
    name = "hello"
    version = "0.1"

    # Optional metadata
    license = ""
    author = " "
    url = ""
    description = ""
    topics = ("", "", "")

    # Binary configuration
    settings = "os", "compiler", "build_type", "arch"
    options = {"shared": [True, False], "fPIC": [True, False]}
    default_options = {"shared": False, "fPIC": True}

    # Sources are located in the same place as this recipe, copy them to the recipe
    exports_sources = "CMakeLists.txt", "src/*"

    def config_options(self):
        if self.settings.os == "Windows":
            del self.options.fPIC

    def layout(self):
        cmake_layout(self)

    def generate(self):
        tc = CMakeToolchain(self)
        tc.generate()

    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()

    def package(self):
        cmake = CMake(self)
        cmake.install()

    def package_info(self):
        self.cpp_info.libs = ["hello"]

这个conanfile.py也是用于定义当前项目的conan配置,它以python 类的方式定义了一个conan包的所有配置,显然相对于conanfile.txt ,这个python脚本的内容要丰富许多,灵活许多(因为可以使用方法定义逻辑)。

difference

都是用于conan配置,conanfile.txt和conanfile.py有何区别?为何要设计两种配置定义方式?如果一个项目中存在两个定义文件文件会怎么样?

这些问题把刚conan入门的我搞糊涂了。

谷歌上搜索了一下,发现有人与我有同样的问题问了conan官方:《Mix conanfile.py and conanfile.txt in the same project #307》

以下是作者的回复:
conan入门(六):conanfile.txt conanfile.py的区别_第1张图片

conanfile.txt是一种简单的conan配置定义方式,并不是每个程序员都懂python脚本(我就不懂),对于开发人员如果只是作为一个消费者角色(consumer),想使用conan简化第三方库的引用方式,在大多数情况下,一般只要正确设置requires,generators,conan就可以正常工作,那么首选使用conanfile.txt这种配置文件定义方式,因为它是更加直观易懂的。

如果开发人员要作为生产者角色(producer),把自己的项目也封装成conan包上传到conan服务器供第三方使用,conanfile.txt是不能满足要求的,必须使用全能的confile.py脚本来定义包的配置,事实上conan在分发包时就是基于python脚本的灵活性通过conanfile.py来定义包的全部配置的。所以当我们执行conan new命令创建一个新的conan配置时,自动生成的是conanfile.py脚本。

所以一个项目中是不允许conanfile.txt和conanfile.py共存的(都来是包定义,到底听谁的呢),执行conan命令会报错。

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,conan,conanfile.txt,conanfile.py,difference)