产品管道：单配置

在本节中，我们将实现一个非常基础的产品管道，不进行分布式构建，不使用 lockfile 或构建多种配置。

主要思想是说明需要重新构建一些包，因为有了新的 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 仓库。但这只是一个非常基础和简单的管道，让我们稍微等待一下，继续进行更高级的场景。