处理包中的源码¶

在之前的教程部分中，我们创建了一个“Hello World”C++库的 Conan 包。我们使用了 Conanfile 的 exports_sources 属性来声明库源码的位置。这是定义源码位置的最简单方法，当它们与 Conanfile 位于同一文件夹中时。但是，有时源码存储在仓库或远程服务器上的文件中，而不是与 Conanfile 位于同一位置。在本节中，我们将通过添加一个 source() 方法来修改我们之前创建的配方，并解释如何

从远程仓库中存储的 *zip* 文件中检索源码。
从 *git* 仓库的分支中检索源码。

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

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/tutorial/creating_packages/handle_sources

项目的结构与之前的示例相同，但没有库源码

.
├── CMakeLists.txt
├── conanfile.py
└── test_package
    ├── CMakeLists.txt
    ├── conanfile.py
    └── src
        └── example.cpp

从远程仓库中存储的 zip 文件中的源码¶

让我们看一下 *conanfile.py* 中的更改

from conan import ConanFile
from conan.tools.cmake import CMakeToolchain, CMake, cmake_layout
from conan.tools.files import get


class helloRecipe(ConanFile):
    name = "hello"
    version = "1.0"

    ...

    # Binary configuration
    settings = "os", "compiler", "build_type", "arch"
    options = {"shared": [True, False], "fPIC": [True, False]}
    default_options = {"shared": False, "fPIC": True}

    def source(self):
        # Please, be aware that using the head of the branch instead of an immutable tag
        # or commit is a bad practice and not allowed by Conan
        get(self, "https://github.com/conan-io/libhello/archive/refs/heads/main.zip",
                  strip_root=True)

    def config_options(self):
        if self.settings.os == "Windows":
            del self.options.fPIC

    def layout(self):
        cmake_layout(self)

    def generate(self):
        tc = CMakeToolchain(self)
        tc.generate()

    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()

    def package(self):
        cmake = CMake(self)
        cmake.install()

    def package_info(self):
        self.cpp_info.libs = ["hello"]

正如你所看到的，配方与之前相同，但我们没有像之前那样声明 exports_sources 属性，即

exports_sources = "CMakeLists.txt", "src/*", "include/*"

我们声明了一个 source() 方法，其中包含此信息

def source(self):
    # Please, be aware that using the head of the branch instead of an immutable tag
    # or commit is strongly discouraged, unsupported by Conan and likely to cause issues
    get(self, "https://github.com/conan-io/libhello/archive/refs/heads/main.zip",
              strip_root=True)

我们使用了 conan.tools.files.get() 工具，它将首先从我们作为参数传递的 URL 下载 *zip* 文件，然后解压缩它。请注意，我们传递了 strip_root=True 参数，以便如果所有解压缩的内容都在单个文件夹中，则所有内容都将移动到父文件夹（有关更多详细信息，请参阅 conan.tools.files.unzip() 参考）。

警告

期望在未来检索源码产生相同的结果。使用可变的源码来源，例如 git 中的移动引用（例如 HEAD 分支），或文件 URL，其中内容可能会随着时间的推移而变化，强烈不建议这样做，也不受支持。不遵循此做法将导致可能导致中断的不确定行为

zip 文件的内容与我们之前在 Conan 配方旁边拥有的源码相同，因此如果你执行 conan create，结果将与之前相同。

$ conan create .

...

-------- Installing packages ----------

Installing (downloading, building) binaries...
hello/1.0: Calling source() in /Users/user/.conan2/p/0fcb5ffd11025446/s/.
Downloading update_source.zip

hello/1.0: Unzipping 3.7KB
Unzipping 100 %
hello/1.0: Copying sources to build folder
hello/1.0: Building your package in /Users/user/.conan2/p/tmp/369786d0fb355069/b

...

-------- Testing the package: Running test() ----------
hello/1.0 (test package): Running test()
hello/1.0 (test package): RUN: ./example
hello/1.0: Hello World Release!
hello/1.0: __x86_64__ defined
hello/1.0: __cplusplus199711
hello/1.0: __GNUC__4
hello/1.0: __GNUC_MINOR__2
hello/1.0: __clang_major__13
hello/1.0: __clang_minor__1
hello/1.0: __apple_build_version__13160021

请检查突出显示的行，其中包含有关下载和解压缩操作的消息。

从 git 仓库的分支中的源码¶

现在，让我们修改 source() 方法，以便从 *git* 仓库而不是 *zip* 文件中获取源码。我们只显示相关部分

...

from conan.tools.scm import Git


class helloRecipe(ConanFile):
    name = "hello"
    version = "1.0"

    ...

    def source(self):
        git = Git(self)
        git.clone(url="https://github.com/conan-io/libhello.git", target=".")

    ...

在这里，我们使用 conan.tools.scm.Git() 工具。 Git 类实现了几种用于处理 *git* 仓库的方法。在这种情况下，我们调用 clone() 方法来克隆 https://github.com/conan-io/libhello.git 仓库，使用相同的文件夹克隆源码，而不是子文件夹（传递 target="." 参数）。

警告

如上所述，这只是一个简单的示例。 Git() 的源码来源也必须是不可变的。必须检出不可变的标签或特定的提交，以保证正确的行为。不允许使用仓库的 HEAD，并且可能导致不确定行为和中断。

要检出仓库中的提交或标签，我们使用 Git 工具的 checkout() 方法

def source(self):
    git = Git(self)
    git.clone(url="https://github.com/conan-io/libhello.git", target=".")
    git.checkout("<tag> or <commit hash>")

有关 Git 类方法的更多信息，请参阅 conan.tools.scm.Git() 参考。

请注意，也可以通过调用 self.run() 方法来运行其他命令。

使用 conandata.yml 文件¶

我们可以在与 conanfile.py 位于同一文件夹中写入一个名为 conandata.yml 的文件。该文件将自动导出并由 Conan 解析，我们可以从配方中读取该信息。例如，这对于提取外部源码仓库、zip 文件等的 URL 非常有用。这是一个 conandata.yml 的示例

sources:
  "1.0":
    url: "https://github.com/conan-io/libhello/archive/refs/heads/main.zip"
    sha256: "7bc71c682895758a996ccf33b70b91611f51252832b01ef3b4675371510ee466"
    strip_root: true
  "1.1":
    url: ...
    sha256: ...

配方不需要为代码的每个版本进行修改。我们可以将指定版本的 keys（url、sha256 和 strip_root）作为参数传递给 get 函数，在这种情况下，允许我们验证下载的 zip 文件是否具有正确的 sha256。因此，我们可以将源码方法修改为

def source(self):
    get(self, **self.conan_data["sources"][self.version])
    # Equivalent to:
    # data = self.conan_data["sources"][self.version]
    # get(self, data["url"], sha256=data["sha256"], strip_root=data["strip_root"])

适用于当前版本的 conandata.yml 信息也可用在序列化的配方信息中，请参阅 graph info json format

另请参阅

JFrog Academy Conan 2 基础
修补源代码
捕获 Git SCM 源码信息，而不是使用 exports_sources 复制源码。
source() 方法参考

处理包中的源码¶

从远程仓库中存储的 *zip* 文件中的源码¶

从 *git* 仓库的分支中的源码¶

使用 conandata.yml 文件¶

从远程仓库中存储的 zip 文件中的源码¶

从 git 仓库的分支中的源码¶