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.png4. 动态库、共享库的运行依赖
当用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新手来说是个挑战。
网友评论