对比vcpkg了解conan2.0的基本工作流程

1. 建议防火墙开启允许(因为conan依赖jfrog,jfrog是个web网站,端口默认是8081和8082)

sudo ufw allow 8081
sudo ufw allow 8082

2. 在通过conan 下载依赖库前,得先产生profile文件,否则conan不知道下载什么平台的库

conan profile detect --force

vcpkg不需要这个过程,会自动根据你选择的编译器来识别是哪个平台,甚至哪个cpu的ABI。

3. 触发下载依赖库

conan install . --output-folder=. --build=missing  --profile=default --settings=build_type=Debug
可简化为下面的:
conan install . --output-folder=. --build=missing -s build_type=Debug

如果要指定依赖的库为static或者shared,可以通过-options指定:

conan install . --output-folder=. --build=missing --options=zlib/1.2.11:shared=True

Build with cmake:

mkdir -p build/Debug
cd build/Debug
cmake ../.. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=../Debug/generators/conan_toolchain.cmake
cmake --build .

Conan在CMake本身就可以指定build目录以及CMAKE_BUILD_TYPE基础之上又额外提供一套机制,看起来像两个不同的东西硬拼在一起,因为侵入式参数较多,为此官方帮生成了对应系统平台的脚本问你,batch问你和shell文件,把细节操作在脚本文件里隐藏。
然而,通过vcpkg实现是不需要这些工作的,在执行cd build & cmake ..就自动触发了依赖库下载,然后编译还是原本cmake的命令,即:cmake --build .,一切看起来跟原来的cmake工作一样。

下面我们看下通过conan和vscode生成的build的目录结构:

微信图片_20230705175155.png

4. 动态库、共享库的运行依赖

  当用conan下载依赖,且依赖库是dll文件或者so文件时候,一般来说需要手动映射库的路径,比如:linux的LD_LIBRARY_PATH, mac的DYLD_FRAMEWORK_PATH,conan和vcpkg都提供了自动解决方案:

  • conan: 在build目录生成了conanrun.bat[or .sh], 在这个脚本文件里又会根据当前的构建类型和cpu类型去调用 conanrunenv-release-x86_64.bat[or .sh], 然后conanrunenv-release-x86_64.bat[or .sh]里是一大坨暴露的shell或者batch脚本,在此脚本文件里填充好了LD_LIBRARY_PATH或者DYLD_FRAMEWORK_PATH的路径映射,在执行可执行文件之前得先执行它。

  • vcpkg: 自动设置rpath指向了vcpkg_installed/lib目录, 非侵入式无感的,正常运行编译出来的二进制可执行文件即可,关于windows的dll文件它也会在编译期间自动触发从vcpkg_installed/bin里拷贝到exe所在目录,原理是调用了visual studio 内置的DUMPBIN分析exe依赖哪些dll,然后按需拷贝dll,这个操作也是非侵入式无感的

5. 查询仓库中的库有哪些提交

conan list zlib/1.2.12#* -r=conancenter

这是查询conancenter里zlib所有1.2.12版本下的上传,conan允许同版本覆盖上传,这个特性是很危险的。

def requirements(self):
    self.requires("zlib/1.2.12#87a7211557b6690ef5bf7fc599dd8349")

为了锁定依赖,仅仅三位版本号是不行的,还要加上revisions的版本,vcpkg的版本支持有几种风格,不过对于"x.y.z"这种版本号必须要求唯一性的,至于开发期间的版本可以在后面追加"beta"、"alpha"、"rc"字眼,然后在真正发布后都会去除,以保证三位版本号的唯一。

6. 上传二进制库文件到jfrog

首先,你的二进制库的目录结构建议如下存放:

├── conanfile.py
├── armv8-linux
│       ├── include
│       └── lib
└── x86_64-linux
│       ├── include
│       └── lib
├── armv8-macos
│       ├── include
│       └── lib
└── x86_64-macos
│       ├── include
│       └── lib
└── armv8-windows
│       └── include
│       └── lib
│       └── bin
└── x86_64-windows
         └── include
         └── lib
         └── bin

然后,你得为这套库提供一个conanfile.py,用于描述执行上传时候的copy动作内容:

import os
from conan import ConanFile
from conan.tools.files import copy

libName = "tinyxml2"    # Change it to your library's package name
libVersion = "8.0.0"    # Change it to your library's version

class LibraryRecipe(ConanFile):
    name = libName
    version = libVersion
    settings =  "arch", "os", "compiler", "build_type"

    def layout(self):
        _arch = str(self.settings.arch).lower()
        _os = str(self.settings.os).lower()
        _current = os.path.abspath(os.getcwd())

        self.folders.build = _arch + "-" + _os
        self.folders.source = self.folders.build
        self.package_dir = os.path.join(_current, _arch + "-" + _os)

    def package(self):
        local_include_folder = os.path.join(self.package_dir, "include")
        local_lib_folder = os.path.join(self.package_dir, "lib")
        local_bin_folder = os.path.join(self.package_dir, "bin")

        copy(self, "*.h", local_include_folder, os.path.join(self.package_folder, "include"), keep_path=False)
        copy(self, "*.lib", local_lib_folder, os.path.join(self.package_folder, "lib"), keep_path=False)
        copy(self, "*.a", local_lib_folder, os.path.join(self.package_folder, "lib"), keep_path=False)
        copy(self, "*.so*", local_lib_folder, os.path.join(self.package_folder, "lib"), keep_path=False)
        copy(self, "*.dll", local_bin_folder, os.path.join(self.package_folder, "bin"), keep_path=False)

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

然后,指定平台的profile创建本地仓库:

conan create . --user=admin --channel=stable --profile=myprofile

上面的 admin建议替换成你配置的账户的username
随后可以就可以通过conan list acl/1.0.0@admin/stable:*这样查本地库了

可以查当前你在jfrog里创建了几个仓库:

conan remote list

如果要上传到的仓库本地没有配置过,得提前配置:

conan remote add [repo_name] http://localhost:8081/artifactory/api/conan/[repo_name]

还要进行远程登录,否则下面没有权限上传。后面,也有一定几率在下载库的时候也提示需要再登录一次:

conan remote login [repo_name] [username] -p [password]

可以先查下你的仓库里已经上传了哪些库:

conan search "*" -r=[repo_name]

最后,执行上传命令:

conan upload [package_name] -r=[your_repository]
conan search "*" -r=[your_repository]

如果以admin作为用户上传的stable库,那么项目里添加此依赖则是:

def requirements(self):
  self.requires("smt-logger/1.0.1@admin/stable")

这套流程Conan和VCPKG比各有千秋:
类似点:

  • conan需要提供conanfile.py,vcpkg需要提供portfile.cmake,前者用python语言,后者用cmake自带函数和vcpkg扩展的cmake函数
  • conan依赖额外的web服务器用于托管二进制库文件,vcpkg可以选择性依赖git仓库托管或者ftp服务器托管。

不同点:

  • conan上传库之后当别的项目依赖它的时候,会自动生成CMake的config文件便于cmake通过find_package()集成库, 而vcpkg需要手动编写FindXXX.cmake,这是对于cmake新手来说是个挑战。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,457评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,837评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,696评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,183评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,057评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,105评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,520评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,211评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,482评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,574评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,353评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,213评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,576评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,897评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,489评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,683评论 2 335

推荐阅读更多精彩内容