软件包流程：使用锁定文件的多配置

在前面的示例中，我们为 ai/1.1.0 构建了 Debug 和 Release 软件包二进制文件。在实际场景中，需要构建的二进制文件将是不同的平台（Windows、Linux、嵌入式）、不同的架构，而且通常无法在同一台机器上构建，这需要不同的计算机。

前面的示例有一个重要的假设：在构建过程中，ai/1.1.0 的依赖项完全不会改变。在许多场景下，这个假设不成立，例如，如果存在其他并发的 CI 作业，并且一个成功的作业在 develop 仓库中发布了一个新的 mathlib/1.1 版本。

那么，一个 ai/1.1.0 的构建（例如，在 Linux 服务器上运行的构建）可能开始得更早，并使用之前的 mathlib/1.0 版本作为依赖项，而 Windows 服务器开始得稍晚，那么它们的构建将使用最新的 mathlib/1.1 版本作为依赖项。这是一个非常不希望发生的情况，即相同 ai/1.1.0 版本的二进制文件使用了不同的依赖项版本。这可能导致后续图解析问题，甚至更糟的是，导致发布时不同平台有不同的行为。

避免依赖项不一致的方法是强制使用相同的依赖项版本和修订版本，这可以通过 锁定文件 来实现。

创建和应用锁定文件相对直接。创建和提升配置的过程将与上一节相同，只是应用了锁定文件。

创建锁定文件

我们像往常一样确保从干净的状态开始

$ conan remove "*" -c  # Make sure no packages from last run

然后我们可以创建一个 conan.lock 文件

# Capture a lockfile for the Release configuration
$ conan lock create . -s build_type=Release --lockfile-out=conan.lock
# extend the lockfile so it also covers the Debug configuration
# in case there are Debug-specific dependencies
$ conan lock create . -s build_type=Debug --lockfile=conan.lock --lockfile-out=conan.lock

请注意，不同的配置，使用不同的配置文件或设置，可能导致不同的依赖项图。锁定文件可以用于锁定不同的配置，但重要的是要迭代不同的配置/配置文件并将它们的信息捕获到锁定文件中。

注意

在 conan.lock 是默认参数，如果存在 conan.lock 文件，它可能会被 conan install/create 和其他图命令自动使用。这可以简化许多命令，但本教程为了清晰和教学目的，展示了完整的显式命令。

可以检查 conan.lock 文件，它看起来会是这样的：

{
    "version": "0.5",
    "requires": [
        "mathlib/1.0#f2b05681ed843bf50d8b7b7bdb5163ea%1724319985.398"
    ],
    "build_requires": [],
    "python_requires": [],
    "config_requires": []
}

正如我们所见，它锁定了 mathlib/1.0 依赖项的版本和修订版本。

有了锁定文件，创建不同的配置是完全相同的，只需向 conan create 命令提供 --lockfile=conan.lock 参数，它将保证 mathlib/1.0#f2b05681ed843bf50d8b7b7bdb5163ea 始终是使用的确切依赖项，而不管是否存在新的 mathlib/1.1 版本或新的修订版本。以下构建可以并行启动，但执行时间不同，它们仍然会始终使用相同的 mathlib/1.0 依赖项。

Release build

$ cd ai  # If you were not inside "ai" folder already
$ conan create . --build="missing:ai/*" --lockfile=conan.lock -s build_type=Release --format=json > graph.json
$ conan list --graph=graph.json --graph-binaries=build --format=json > built.json
$ conan remote enable packages
$ conan upload -l=built.json -r=packages -c --format=json > uploaded_release.json
$ conan remote disable packages

Debug build

$ conan create . --build="missing:ai/*" --lockfile=conan.lock -s build_type=Debug --format=json > graph.json
$ conan list --graph=graph.json --graph-binaries=build --format=json > built.json
$ conan remote enable packages
$ conan upload -l=built.json -r=packages -c --format=json > uploaded_debug.json
$ conan remote disable packages

请注意，与前一个示例唯一的修改是添加了 --lockfile=conan.lock。提升过程也将与前一个相同。

Promoting from packages->product

# aggregate the package list
$ conan pkglist merge -l uploaded_release.json -l uploaded_debug.json --format=json > uploaded.json

$ conan remote enable packages
$ conan remote enable products
# Promotion using Conan download/upload commands
# (slow, can be improved with art:promote custom command)
$ conan download --list=uploaded.json -r=packages --format=json > promote.json
$ conan upload --list=promote.json -r=products -c
$ conan remote disable packages
$ conan remote disable products

最终结果将与上一节相同，但这次只是保证 Debug 和 Release 二进制文件都是使用完全相同的 mathlib 版本构建的。

现在我们有了 products 仓库中新的 ai/1.1.0 二进制文件，我们可以认为 packages pipeline 已经完成，并继续下一节，构建并检查我们的产品，看看这个新的 ai/1.1.0 版本是否能正确集成。