export()

等效于 exports 属性，但以方法的形式存在。此方法将在 export 时刻被调用，这发生在 conan export 和 conan create 命令中，其目的是允许从用户文件夹复制文件到 Conan 缓存文件夹，从而使文件成为配方的一部分。这些源文件将与配方一起上传到服务器，但通常不会下载，除非软件包是从源代码构建的。

当前工作目录将是 self.recipe_folder，它可以将 self.export_folder 用作目标文件夹，以使用 copy() 或您的自定义复制操作。

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

class Pkg(ConanFile):
    def export(self):
        # This LICENSE file is intended to be the license of the current conanfile.py recipe
        # and go with it. It is not intended to be the license of the final package (for that
        # purpose export_sources() would be recommended)
        copy(self, "LICENSE.md", self.recipe_folder, self.export_folder)

有 2 个文件始终导出到缓存，而无需在配方中显式定义：conanfile.py 配方，以及 conandata.yml 文件（如果存在）。conandata.yml 文件在每次加载 conanfile.py 时都会自动加载，成为 self.conan_data 属性，因此它是配方的固有部分，是 “exported” 配方文件的一部分，而不是 “exported” 源文件的一部分。

注意

最佳实践

• 配方文件必须是配置独立的。这些文件对于所有配置都是通用的，因此无法对不同的设置、选项或平台执行条件 export()。不要尝试进行任何类型的条件导出。如有必要，一次性导出所有配置所需的所有文件。

• export() 方法不会接收来自 profile 的任何信息，甚至不包括 conf。只有 global.conf 可用，但在任何情况下，都无法使用该 conf 来定义条件。

• 保持 export() 方法的简洁。其目的是将文件从用户文件夹复制到缓存，以便将这些文件与配方一起存储。

• 导出的文件必须小。使用配方导出大文件会使依赖项的解析速度变慢。

• 只有评估 conanfile.py 配方所需的文件才必须使用此方法导出。从源代码构建所需的文件应使用 exports_sources 属性或 export_source() 方法导出。