在上一节中,我们只构建了 1 种配置。本节将涵盖我们需要构建多于 1 种配置的情况。为方便起见,我们将在此处使用 Release
和 Debug
配置,因为这更容易理解,但在实际情况中,这些配置会更像是 Windows、Linux、OSX,为不同架构构建,交叉构建等。
让我们开始清理缓存
我们将在计算机中按顺序为这 2 种配置创建包,但请注意,这些通常会在不同的计算机上运行,因此 CI 系统并行启动不同配置的构建是很常见的。
$ conan remove "*" -c # Make sure no packages from last run
Release 构建¶
$ cd ai # If you were not inside "ai" folder already
$ conan create . --build="missing:ai/*" -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
第一步与上一节中的步骤类似,即执行 conan create
,只是为了清晰起见,明确了我们的配置 -s build_type=Release
,并将 conan create
的输出捕获到 graph.json
文件中。
第二步是从
graph.json
创建一个built.json
包列表文件,其中包含需要上传的包。在本例中,只上传从源代码构建的包(--graph-binaries=build
)。这样做是为了提高效率和加快上传速度。第三步是启用
packages
仓库。之前未启用它是为了确保所有可能的依赖都只来自develop
仓库。然后,我们将
built.json
包列表上传到packages
仓库,同时创建uploaded_release.json
包列表,其中包含包的新位置(服务器仓库)。最后,我们将再次禁用
packages
仓库同样,Debug 构建也将执行相同的步骤
Debug 构建¶
$ conan create . --build="missing:ai/*" -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
当 ai/1.1.0
的所有不同二进制文件都正确构建后,包管道
可以认为其任务成功,并决定提升这些二进制文件。但还需要进一步的包构建和检查,因此 包管道
可以将它们提升到 products
二进制仓库,而不是提升到 develop
仓库。由于所有其他开发人员和 CI 都使用 develop
仓库,所以在这个阶段也不会有人受到影响。
从 packages->product 提升¶
conan pkglist merge
命令合并“Release”和“Debug”配置的包列表,并将其合并成一个单独的 uploaded.json
包列表。此列表将用于运行提升操作。# 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
在此示例中,我们使用了慢速的 conan download
+ conan upload
提升方式。使用 conan art:promote
扩展命令可以大大提高效率。
运行提升后,服务器上将有以下包
总结
我们构建了 2 种不同的配置,Release
和 Debug
(也可以是 Windows/Linux 或其他),并将它们上传到 packages
仓库。
当所有配置的所有包二进制文件都成功构建后,我们将它们从
packages
仓库提升到products
仓库,以便它们可用于products pipeline
。在包创建过程中捕获了包列表,并将其合并成一个单独的列表以运行提升操作。
我们还有一个方面尚未考虑,即
ai/1.1.0
的依赖项在构建期间可能发生变化。请转到下一节,了解如何使用锁定文件实现更一致的多配置构建。