项目设置¶
本教程所需的代码在 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 个不同的本地仓库,分别命名为 develop
、packages
和 products
。
然后根据 project_setup.py
文件,这些是配置服务器所需的必要环境变量。如果需要适应您的设置,请定义 ARTIFACTORY_URL
、ARTIFACTORY_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")
初始依赖图¶
警告
项目初始化将移除服务器中 3 个
develop
、products
和packages
仓库的内容。examples2/ci/game
文件夹包含一个定义本地缓存的.conanrc
文件,因此本教程中执行的命令不会污染或更改您的主 Conan 缓存。
$ python project_setup.py
这将执行多项任务:清理服务器仓库,为依赖图创建初始 Debug
和 Release
二进制文件并将它们上传到 develop
仓库,然后清理本地缓存。请注意,在此示例中,我们为了方便使用 Debug
和 Release
作为不同的配置,但在实际情况下,这些将是不同的配置,例如 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
仓库中包的这个依赖图是本教程的起点,它被假定为项目功能稳定且处于“develop”状态,开发人员可以 conan install
以处理任何不同的包。