deploy()

警告

此功能处于实验阶段,可能会发生重大更改。有关更多信息,请参阅 Conan 稳定性 部分。

deploy() 方法用于部署(复制)当前包中的工件。它仅在提供 --deployer-package 参数时,在 conan install 时执行,否则 deploy() 将被忽略。

工件应部署到 self.deploy_folder,默认情况下为当前文件夹。可以使用 --deployer-folder 定义自定义目标。一个基本的 deploy() 方法会将包文件夹中的所有文件复制到部署文件夹。

from conan import ConanFile
from conan.tools.files import copy

class Pkg(ConanFile):

    def deploy(self):
        copy(self, "*", src=self.package_folder, dst=self.deploy_folder)

有关更多信息,请参阅 conan install 命令 的文档。

注意

最佳实践

  • 仅可部署“二进制”包工件,从 self.package_folder 复制。建议仅从包文件夹复制,而不是其他文件夹。

  • deploy() 方法旨在用于最终生产部署或在机器上安装二进制文件,因为它会从 Conan 缓存中提取文件。它不适用于正常的开发操作,也不适用于针对已部署的二进制文件构建 Conan 包。建议针对 Conan 缓存中的包进行构建。

  • self.deploy_folder 只能在 deploy() 方法中使用。