软件包流水线

当有开发者向组织仓库的源代码提交更改时,软件包流水线将为不同的配置和平台构建、创建并上传软件包二进制文件。例如,如果开发者对 ai 软件包进行了更改,改进了库的一些功能,并将版本提升到 ai/1.1.0。如果组织需要支持 Windows 和 Linux 平台,那么软件包流水线将在认为更改有效之前,为 Windows 和 Linux 构建新的 ai/1.1.0。如果某些配置在特定平台下构建失败,通常会将更改视为无效,并停止处理这些更改,直到代码被修复。

对于 package pipeline,我们将从 ai recipe 中的一个简单源代码更改开始,模拟 ai 软件包的一些改进,为我们的游戏提供更好的算法。

让我们在 ai 软件包中进行以下更改:

  • 让我们更改 ai/src/ai.cpp 函数的实现,并将消息从 Some Artificial 更改为 SUPER BETTER Artificial

  • 让我们将 ai/include/ai.h 中的默认值 intelligence=0 更改为新的默认值 intelligence=50

  • 最后,让我们提升版本。由于我们对软件包的公共头文件进行了一些更改,建议提升 minor 版本,因此让我们编辑 ai/conanfile.py 文件并在其中定义 version = "1.1.0"(而不是之前的 1.0)。请注意,如果我们对 ai 的公共 API 进行了破坏性更改,建议改为更改 major 版本并创建新的 2.0 版本。

软件包流水线将负责为新的 ai/1.1.0 构建不同的软件包二进制文件,并将它们上传到 packages 二进制仓库,以避免干扰或给其他开发者和 CI 作业带来潜在问题。如果流水线成功,它将把这些二进制文件提升(复制)到 products 二进制仓库,否则就会停止。

在为 ai/1.1.0 构建这些二进制软件包时,需要考虑不同的方面。以下教程部分完成相同的工作,但基于不同的假设。它们按复杂度递增的方式解释。

请注意,所有命令都可以在仓库的 run_example.py 文件中找到。此文件主要供维护人员和测试使用,但在出现问题时可能有用作参考。