产品管道：单配置

在本节中，我们将实现一个非常基本的产品管道，不进行构建分发，不使用锁定文件或构建多个配置。

主要思想是说明由于我们的主要产品可以集成新的 ai/1.1.0 版本，因此需要重建某些包。这个新的 ai 版本位于 products 仓库中，因为它已经由“包管道”成功构建。让我们首先确保我们有一个具有正确仓库定义的干净环境。

# First clean the local "build" folder
$ pwd  # should be <path>/examples2/ci/game
$ rm -rf build  # clean the temporary build folder
$ mkdir build && cd build # To put temporary files

# Now clean packages and define remotes
$ conan remove "*" -c  # Make sure no packages from last run
# NOTE: The products repo is first, it will have higher priority.
$ conan remote enable products

请记住，products 仓库的优先级高于 develop 仓库。这意味着 Conan 将首先在 products 仓库中进行解析，如果它找到定义的版本范围的有效版本，它将在此处停止并返回该版本，而不检查 develop 仓库（可以使用 --update 检查所有仓库，但这会更慢，并且使用正确的仓库排序，没有必要）。

正如我们已经定义的那样，我们的主要产品是 game/1.0 和 mapviewer/1.0，让我们首先尝试安装和使用 mapviewer/1.0

$ conan install --requires=mapviewer/1.0
...
Requirements
    graphics/1.0#24b395ba17da96288766cc83accc98f5 - Downloaded (develop)
    mapviewer/1.0#c4660fde083a1d581ac554e8a026d4ea - Downloaded (develop)
    mathlib/1.0#f2b05681ed843bf50d8b7b7bdb5163ea - Downloaded (develop)
...
Install finished successfully

# Activate the environment and run the executable
# Use "conanbuild.bat && mapviewer" in Windows
$ source conanrun.sh && mapviewer
...
graphics/1.0: Checking if things collide (Release)!
mapviewer/1.0:serving the game (Release)!

正如我们所见，mapviewer/1.0 根本不依赖于 ai 包，任何版本都不依赖。因此，如果我们安装它，我们将已经拥有它的预编译二进制文件，一切正常。

但是，如果我们现在尝试使用 game/1.0 做同样的事情

$ conan install --requires=game/1.0
...
======== Computing necessary packages ========
...
ERROR: Missing binary: game/1.0:bac7cd2fe1592075ddc715563984bbe000059d4c

game/1.0: WARN: Cant find a game/1.0 package binary bac7cd2fe1592075ddc715563984bbe000059d4c for the configuration:
...
[requires]
ai/1.1.0#01a885b003190704f7617f8c13baa630

它将失败，因为它将从 products 仓库获取 ai/1.1.0，并且将没有针对这个新版本的 ai 的 game/1.0 的预编译二进制文件。这是正确的，ai 是一个静态库，因此我们需要针对它重建 game/1.0，让我们使用 --build=missing 参数来完成它

$ conan install --requires=game/1.0 --build=missing
...
======== Computing necessary packages ========
Requirements
    ai/1.1.0:8b108997a4947ec6a0487a0b6bcbc0d1072e95f3 - Download (products)
    engine/1.0:de738ff5d09f0359b81da17c58256c619814a765 - Build
    game/1.0:bac7cd2fe1592075ddc715563984bbe000059d4c - Build
    graphics/1.0:8b108997a4947ec6a0487a0b6bcbc0d1072e95f3 - Download (develop)
    mathlib/1.0:4d8ab52ebb49f51e63d5193ed580b5a7672e23d5 - Download (develop)

-------- Installing package engine/1.0 (4 of 5) --------
engine/1.0: Building from source
...
engine/1.0: Package de738ff5d09f0359b81da17c58256c619814a765 created
-------- Installing package game/1.0 (5 of 5) --------
game/1.0: Building from source
...
game/1.0: Package bac7cd2fe1592075ddc715563984bbe000059d4c created
Install finished successfully

请注意，--build=missing 知道 engine/1.0 也需要一个新的二进制文件，因为它依赖于新的 ai/1.1.0 版本。然后，Conan 按照正确的顺序构建包，首先必须构建 engine/1.0，因为 game/1.0 依赖于它。构建完成后，我们可以列出新构建的二进制文件，并查看它们如何依赖于新版本

$ conan list engine:*
Local Cache
  engine
    engine/1.0
      revisions
        fba6659c9dd04a4bbdc7a375f22143cb (2024-09-30 12:19:54 UTC)
          packages
            de738ff5d09f0359b81da17c58256c619814a765
              info
                ...
                requires
                  ai/1.1.Z
                  graphics/1.0.Z
                  mathlib/1.0.Z

$ conan list game:*
Local Cache
  game
    game/1.0
      revisions
        1715574045610faa2705017c71d0000e (2024-09-30 12:19:55 UTC)
          packages
            bac7cd2fe1592075ddc715563984bbe000059d4c
              info
                ...
                requires
                  ai/1.1.0#01a885b003190704f7617f8c13baa630:8b108997a4947ec6a0487a0b6bcbc0d1072e95f3
                  engine/1.0#fba6659c9dd04a4bbdc7a375f22143cb:de738ff5d09f0359b81da17c58256c619814a765
                  graphics/1.0#24b395ba17da96288766cc83accc98f5:8b108997a4947ec6a0487a0b6bcbc0d1072e95f3
                  mathlib/1.0#f2b05681ed843bf50d8b7b7bdb5163ea:4d8ab52ebb49f51e63d5193ed580b5a7672e23d5

新的 engine/1.0:de738ff5d09f0359b81da17c58256c619814a765 二进制文件依赖于 ai/1.1.Z，因为它是静态库，它只需要对次要版本的更改进行重建，而不需要对补丁进行重建。而 game/1.0 新的二进制文件将依赖于完整的精确的 ai/1.1.0#revision:package_id，以及依赖于 ai/1.1.Z 的新的 engine/1.0:de738ff5d09f0359b81da17c58256c619814a765 新的二进制文件。

现在可以执行游戏了

# Activate the environment and run the executable
# Use "conanbuild.bat && game" in Windows
$ source conanrun.sh && game
mathlib/1.0: mathlib maths (Release)!
ai/1.1.0: SUPER BETTER Artificial Intelligence for aliens (Release)!
ai/1.1.0: Intelligence level=50
graphics/1.0: Checking if things collide (Release)!
engine/1.0: Computing some game things (Release)!
game/1.0:fun game (Release)!

我们可以看到新的 game/1.0 二进制文件包含了 ai/1.1.0 中的改进，并与新的 engine/1.0 二进制文件正确链接。

这是一个基本“产品管道”，我们设法在必要时构建和测试我们的主要产品（请记住 mapviewer 实际上没有受到影响，因此根本不需要重建）。通常，生产“产品管道”将完成将构建的包上传到存储库，并对 develop 存储库进行新的升级。但由于这是一个非常基本和简单的管道，让我们稍等一下，然后继续进行更高级的场景。