从所有依赖项中复制源代码

请首先克隆源代码以重新创建此项目。您可以在 GitHub 的 examples2 仓库中找到它们。

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/examples/extensions/deployers/sources

在本例中,我们将看到如何创建和使用自定义部署器(deployer)。此部署器会将所有依赖项的源文件复制到一个特定的输出文件夹中

注意

为了更好地理解本示例,强烈建议您事先阅读部署器(Deployers) 参考。

定位部署器

在本例中,部署器与我们的示例 conanfile 位于同一目录中,但如部署器(Deployers) 参考所示,Conan 将按顺序在几个额外的位置查找指定的部署器,即

  1. 绝对路径

  2. 相对于当前工作目录(cwd)

  3. [CONAN_HOME]/extensions/deployers 文件夹中

  4. 内置部署器

运行它

在我们的示例中,我们有一个简单的 recipe,它将 zlibmcap 列为依赖项。借助 tools.build:download_source=True 配置,我们可以强制调用其 source() 方法,这将确保即使无需执行构建,源代码也可用。

现在,您应该能够在任何给定 recipe 的 conan installconan graph 命令中使用新的部署器。

$ conan graph info . -c tools.build:download_source=True --deployer=sources_deploy

检查命令输出,我们可以看到它复制了我们直接依赖项 zlibmcap 的源代码,以及我们传递性依赖项 zstdlz4 的源代码,到一个 dependencies_sources 文件夹中。完成此操作后,可以进行额外的预处理以满足更具体的需求。

请注意,您可以传递 --deployer-folder 参数来更改部署器的基本输出文件夹路径。

代码导览

source_deploy.py 文件包含以下代码

sources_deploy.py
from conan.tools.files import copy
import os


def deploy(graph, output_folder, **kwargs):
    # Note the kwargs argument is mandatory to be robust against future changes.
    for name, dep in graph.root.conanfile.dependencies.items():
        if dep.folders is None or dep.folders.source_folder is None:
            raise ConanException(f"Sources missing for {name} dependency.\n"
                                  "This deployer needs the sources of every dependency present to work, either building from source, "
                                  "or by using the 'tools.build:download_source' conf.")
        copy(graph.root.conanfile, "*", dep.folders.source_folder, os.path.join(output_folder, "dependency_sources", str(dep)))

deploy()

deploy() 方法由 Conan 调用,并获取依赖图和输出文件夹路径作为参数。它遍历 recipe 的所有依赖项,并使用 conan.tools.copy 将每个源文件复制到 dependencies_sources 下的各自文件夹中。

注意

如果您将此部署器用作自己的示例,请记住 tools.build:download_source=True 是必需的,以便 dep.folders.source_folder 为依赖项定义。如果没有该配置,则对于那些不需要从源代码构建的依赖项,以及不需要构建的命令(例如 conan graph),此变量将不会被定义。

注意

如果您的自定义部署器需要访问完整的依赖图,包括可能被跳过的库,请使用 tools.graph:skip_binaries=False 配置。这对于收集(例如)图中所有许可证非常有用。