conan download¶
$ conan download -h
usage: conan download [-h] [-v [V]] [-cc CORE_CONF] [-f FORMAT]
[--out-file OUT_FILE] [--only-recipe] [-p PACKAGE_QUERY]
-r REMOTE [-m METADATA] [-l LIST]
[pattern]
Download (without installing) a single conan package from a remote server.
It downloads just the package, but not its transitive dependencies, and it will not call
any generate, generators or deployers.
It can download multiple packages if patterns are used, and also works with
queries over the package binaries.
positional arguments:
pattern A pattern in the form
'pkg/version#revision:package_id#revision', e.g:
"zlib/1.2.13:*" means all binaries for zlib/1.2.13. If
revision is not specified, it is assumed latest one.
options:
-h, --help show this help message and exit
-v [V] Level of detail of the output. Valid options from less
verbose to more verbose: -vquiet, -verror, -vwarning,
-vnotice, -vstatus, -v or -vverbose, -vv or -vdebug,
-vvv or -vtrace
-cc CORE_CONF, --core-conf CORE_CONF
Define core configuration, overwriting global.conf
values. E.g.: -cc core:non_interactive=True
-f FORMAT, --format FORMAT
Select the output format: json
--out-file OUT_FILE Write the output of the command to the specified file
instead of stdout.
--only-recipe Download only the recipe/s, not the binary packages.
-p PACKAGE_QUERY, --package-query PACKAGE_QUERY
Only download packages matching a specific query. e.g:
os=Windows AND (arch=x86 OR compiler=gcc)
-r REMOTE, --remote REMOTE
Download from this specific remote
-m METADATA, --metadata METADATA
Download the metadata matching the pattern, even if
the package is already in the cache and not downloaded
-l LIST, --list LIST Package list file
从指定的远程仓库将 recipe 和 binaries 下载到本地缓存。
注意
请注意，与 conan install 不同，conan download 不会下载所下载包的任何传递性依赖项。
conan download 命令可以通过 -r=myremote 参数下载到 1 个服务器仓库。
它有 2 种可能的、互斥的输入方式：
conan download <pattern>基于模式匹配的 recipe，其模式类似于conan list <pattern>。conan download --list=<pkglist>将上传pkglistjson 文件中指定的 artifacts。
你可以像在其他命令（例如 conan list（参见那里的模式文档 conan list）或 conan upload）中使用模式一样，使用模式下载特定的 references。
# download latest revision and packages for all openssl versions in foo remote
$ conan download "openssl/*" -r foo
注意
conan download 默认只下载最新的 revision。如果你想下载最新的 revision 之外的更多 revision，可以在 reference 模式参数的 revision 部分使用通配符。
你也可以只下载 recipes（在这种情况下，会选择模式中的所有 revisions，而不仅仅是最新的一个）。
# download all recipe revisions for zlib/1.2.13
$ conan download "zlib/1.2.13#*" -r foo --only-recipe
如果你只想下载属于特定设置的 packages，请使用 --package-query 参数。
$ conan download "zlib/1.2.13#*" -r foo --package-query="os=Linux and arch=x86"
如果指定了 --format=json 格式化器，结果将是一个“PackageList”，与其他 Conan 命令兼容，例如 conan upload 命令，因此可以使用生成的 json 文件来串联 download + upload。请参阅 Packages Lists 示例。
下载元数据¶
recipes 和 packages 的元数据文件默认不会被下载。可以使用 conan download --metadata=xxx 参数显式检索它们。主要参数与上面相同，Conan 将下载指定的 packages，或者如果它们已经存在于缓存中则跳过。
$ conan download pkg/0.1 -r=default --metadata="*"
# will download pgkg/0.1 recipe with all the recipe metadata
# And also all package binaries (latest package revision)
# with all the binaries metadata
如果只需要一个或几个元数据文件夹或文件集，也可以指定。
$ conan download pkg/0.1 -r=default --metadata="logs/*" --metadata="tests/*"
# Will download only the logs and tests metadata, but not other potential metadata files
有关更多信息，请参阅 元数据部分。