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

从指定的远程仓库将配方和二进制文件下载到本地缓存。

注意

请注意，conan download 与 conan install 不同，它不会下载已下载包的任何传递性依赖项。

conan download 命令可以将包下载到一个服务器仓库，由 -r=myremote 参数指定。

它有两种可能且互斥的输入方式

conan download <pattern> 基于模式的配方匹配，其模式类似于 conan list <pattern>。
conan download --list=<pkglist> 将上传 pkglist json 文件中指定的工件

您可以使用模式下载特定引用，就像其他命令一样，例如 conan list （请参阅 conan list 中的模式文档）或 conan upload

# download latest revision and packages for all openssl versions in foo remote
$ conan download "openssl/*" -r foo

注意

conan download 默认只会下载最新修订版。如果您想下载除最新修订版之外的其他修订版，您可以在引用模式参数的修订版部分使用通配符

您也可以只下载配方（在这种情况下，选择模式中的所有修订版，而不仅仅是最新修订版）

# download all recipe revisions for zlib/1.2.13
$ conan download "zlib/1.2.13#*" -r foo --only-recipe

如果您只想下载属于特定设置的包，请使用 --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 的级联操作。请参阅包列表示例。

下载元数据¶

默认情况下，不会下载配方和包的元数据文件。可以使用 conan download --metadata=xxx 参数显式检索它们。主要参数与上述相同，Conan 将下载指定的包，如果它们已在缓存中，则会跳过。

$ 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

欲了解更多信息，请参阅元数据部分。