项目设置

本教程所需的代码可在 examples2 仓库中找到,克隆它并移动到该文件夹

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/ci/game

服务器仓库设置

我们需要在同一个服务器中设置 3 个不同的仓库。确保您的 Artifactory 正在运行且可用。您可以从 下载页面 下载免费的 Artifactory CE 并在您自己的计算机上运行,或者使用 docker

$ docker run --name artifactory -d -p 8081:8081 -p 8082:8082 releases-docker.jfrog.io/jfrog/artifactory-cpp-ce:7.63.12
# Can be stopped with "docker stop artifactory"

启动后,您可以访问 http://localhost:8081/ 进行检查(用户:“admin”,密码:“password”)。如果您有其他可用的 Artifactory,并且可以在其中创建新仓库,也可以使用它。

第一步,登录到 web UI 并创建 3 个不同的本地仓库,分别命名为 developpackagesproducts

然后根据 project_setup.py 文件,这些是配置服务器所需的必要环境变量。请根据您的设置,如有必要,定义 ARTIFACTORY_URLARTIFACTORY_USER 和/或 ARTIFACTORY_PASSWORD

# TODO: This must be configured by users
SERVER_URL = os.environ.get("ARTIFACTORY_URL", "http://localhost:8081/artifactory/api/conan")
USER = os.environ.get("ARTIFACTORY_USER", "admin")
PASSWORD = os.environ.get("ARTIFACTORY_PASSWORD", "password")

初始依赖图

警告

  • 项目初始化将删除服务器中 developproductspackages 这 3 个仓库的内容。

  • examples2/ci/game 文件夹包含一个 .conanrc 文件,该文件定义了一个本地缓存,因此本教程中执行的命令不会污染或更改您的主 Conan 缓存。

$ python project_setup.py

这将执行多项任务:清理服务器仓库,为依赖图创建初始的 DebugRelease 二进制文件并将其上传到 develop 仓库,然后清理本地缓存。请注意,在本示例中,我们为了方便起见使用 DebugRelease 作为不同的配置,但在实际情况中,这些会是不同的配置,例如 Windows/X86_64、Linux/x86_64、Linux/armv8 等,运行在不同的计算机上。

设置完成后,可以检查到已定义了 3 个远程仓库,但只有 develop 远程仓库已启用,并且本地缓存中没有包。

$ conan remote list
products: http://localhost:8081/artifactory/api/conan/products [Verify SSL: True, Enabled: False]
develop: http://localhost:8081/artifactory/api/conan/develop [Verify SSL: True, Enabled: True]
packages: http://localhost:8081/artifactory/api/conan/packages [Verify SSL: True, Enabled: False]

$ conan list *
Found 0 pkg/version recipes matching * in local cache
Local Cache
WARN: There are no matching recipe references

重要

远程仓库的顺序很重要。如果 products 仓库被启用,它的优先级将高于 develop 仓库,因此如果它包含新版本,将从那里获取。

这个位于 develop 仓库中的包依赖图是本教程的起点,被视为项目功能稳定发展的状态,开发人员可以 conan install 以在任何不同的包中工作。

digraph repositories { node [fillcolor="lightskyblue", style=filled, shape=box] rankdir="LR"; subgraph cluster_0 { label="Packages server"; style=filled; color=lightgrey; subgraph cluster_1 { label = "packages\n repository" shape = "box"; style=filled; color=lightblue; "packages" [style=invis]; } subgraph cluster_2 { label = "products\n repository" shape = "box"; style=filled; color=lightblue; "products" [style=invis]; } subgraph cluster_3 { rankdir="BT"; shape = "box"; label = "develop repository"; color=lightblue; rankdir="BT"; node [fillcolor="lightskyblue", style=filled, shape=box] "game/1.0" -> "engine/1.0" -> "ai/1.0" -> "mathlib/1.0"; "engine/1.0" -> "graphics/1.0" -> "mathlib/1.0"; "mapviewer/1.0" -> "graphics/1.0"; "game/1.0" [fillcolor="lightgreen"]; "mapviewer/1.0" [fillcolor="lightgreen"]; } { edge[style=invis]; "packages" -> "products" -> "game/1.0" ; rankdir="BT"; } } }