使用包列表¶
注意
此功能处于预览阶段。 这意味着它不太可能被删除,也不太可能进行重大更改。 维护者将尽最大努力避免破坏它,并且只有在非常必要的情况下才会这样做。 有关更多信息,请参阅Conan 稳定性部分。
包列表是一个强大且方便的 Conan 功能,允许自动化和连接不同的 Conan 命令。 让我们看一些常见的用例
列出包并下载它们¶
第一个简单的用例可能是在服务器中列出一些配方和/或二进制文件,然后下载它们。
我们可以执行任何 conan list
,例如,列出所有高于 1.2.11
的 zlib
版本、最新的配方修订版、该最新配方修订版的所有 Windows 二进制文件,以及最后每个二进制文件的最新包修订版。 请注意,如果我们想稍后实际下载某些内容,则必须指定 latest
包修订版,否则只会下载配方。
$ conan list "zlib/[>1.2.11]#latest:*#latest" -p os=Windows --format=json -r=conancenter > pkglist.json
命令的输出以 json
格式发送到文件 pkglist.json
,如下所示
"conancenter": {
"zlib/1.2.12": {
"revisions": {
"b1fd071d8a2234a488b3ff74a3526f81": {
"timestamp": 1667396813.987,
"packages": {
"ae9eaf478e918e6470fe64a4d8d4d9552b0b3606": {
"revisions": {
"19808a47de859c2408ffcf8e5df1fdaf": {
}
},
"info": {
"settings": {
"arch": "x86_64",
"os": "Windows"
}
}
}
}
}
},
"zlib/1.2.13": {
}
}
pkglist.json
中的第一层是“origin”远程仓库或“本地缓存”(如果列表发生在缓存中)。 在这种情况下,由于我们列出了 conancenter
远程仓库中的包,这将是 origin。
我们现在可以使用单个 conan download
调用来下载这些配方和二进制文件
$ conan download --list=pkglist.json -r=conancenter
# Download the recipes and binaries in pkglist.json
# And displays a report of the downloaded things
从一个远程仓库下载并上传到不同的远程仓库¶
假设我们从上一步下载的包中创建一个新的包列表
$ conan download --list=pkglist.json -r=conancenter --format=json > downloaded.json
# Download the recipes and binaries in pkglist.json
# And stores the result in "downloaded.json"
生成的 downloaded.json
将与 pkglist.json
文件几乎相同,但在这种情况下,这些包的“origin”是 "Local Cache"
(因为下载的包将在缓存中)
"Local Cache": {
"zlib/1.2.12": {
"revisions": {
}
}
}
这意味着我们现在可以将同一组配方和二进制文件上传到不同的远程仓库
$ conan upload --list=downloaded.json -r=myremote -c
# Upload those artifacts to the same remote
注意
最佳实践
这将是在不同服务器仓库之间运行升级的慢速机制。 像 Artifactory 这样的服务器提供了直接将包从一个仓库复制到另一个仓库的方法,而无需使用客户端,由于文件重复数据删除,这种方法速度快几个数量级,因此这是推荐的方法。 本节中介绍的方法可用于气隙环境和其他无法进行服务器到服务器复制的情况。
构建和上传包¶
最有趣的流程之一是当一些包在本地缓存中构建时,使用 conan create
或 conan install --build=xxx
命令。 通常,我们希望将本地构建的包上传到服务器,这样其他人就不必再次重新构建它们。 但我们可能只想上传构建的二进制文件,而不是所有其他的传递依赖项,或者我们之前在本地缓存中的其他包。
可以从 conan install
、conan create
和 conan graph info
命令的输出中计算包列表。 然后,该包列表可以用于上传。 一步一步
首先假设我们有自己的包 mypkg/0.1
,我们创建它
$ conan new cmake_lib -d name=mypkg -d version=0.1
$ conan create . --format=json > create.json
这将创建一个图的 json 表示,其中包含有关已构建包的信息 "binary": "Build"
{
"graph": {
"nodes": {
"0": {
"ref": "conanfile",
"id": "0",
"recipe": "Cli",
"context": "host",
"test": false
},
"1": {
"ref": "mypkg/0.1#f57cc9a1824f47af2f52df0dbdd440f6",
"id": "1",
"recipe": "Cache",
"package_id": "2401fa1d188d289bb25c37cfa3317e13e377a351",
"prev": "75f44d989175c05bc4be2399edc63091",
"build_id": null,
"binary": "Build"
}
}
}
我们可以从此文件中计算一个包列表,然后将这些工件上传到服务器,如下所示
$ conan list --graph=create.json --graph-binaries=build --format=json > pkglist.json
# Create a pkglist.json with the known list of recipes and binaries built from sources
$ conan upload --list=pkglist.json -r=myremote -c
删除包列表¶
也可以首先 conan list
并创建一个要删除的事物列表,然后删除它们
# Removes everything from the cache
$ conan list "*#*" --format=json > pkglist.json
$ conan remove --list=pkglist.json -c
请注意,在这种情况下,list
和 remove
中的默认模式是不同的,因为 conan remove
具有破坏性
当一个配方传递给
remove
时,如conan remove zlib/1.2.13
,它将删除zlib/1.2.13
的配方及其所有二进制文件,因为二进制文件不能脱离配方而存在。当传递
package_id
时,如conan remove zlib/1.2.13:package_id
,那么该特定的package_id
将被删除,但配方不会
那么,如果我们直接调用 conan remove
或首先调用 conan list
,则删除所有内容的模式将有所不同,例如
# Removes everything from the cache
$ conan remove "*"
# OR via list, we need to explicitly include all revisions
$ conan list "*#*" --format=json > pkglist.json
$ conan remove --list=pkglist.json -c
# Removes only the binaries from the cache (leave recipes)
$ conan remove "*:*"
# OR via list, we need to explicitly include all revisions
$ conan list "*#*:*" --format=json > pkglist.json
$ conan remove --list=pkglist.json -c
有关更多信息,请参阅参考命令部分