使用包

本节将展示如何使用 Conan 构建项目以管理您的依赖项。我们将从一个使用 CMake 并依赖 zlib 库的 C 项目的基本示例开始。该项目将使用 conanfile.txt 文件来声明其依赖项。

我们还将介绍如何不仅在 Conan 中使用“常规”库，还可以管理构建时可能需要的工具：例如 CMake、msys2、MinGW 等。

然后，我们将解释不同的 Conan 概念，如设置 (settings) 和选项 (options)，以及如何使用它们为不同的配置（如 Debug、Release、静态或共享库等）构建项目。

此外，我们还将解释如何从第一个示例中使用的 conanfile.txt 文件过渡到功能更强大的 conanfile.py。

之后，我们将介绍 Conan 构建和主机配置文件（build and host profiles）的概念，并解释如何使用它们将应用程序交叉编译到不同的平台。

然后，在“版本控制简介”中，我们将学习如何使用不同版本、使用版本范围定义需求、修订 (revisions) 概念以及简要介绍锁定文件 (lockfiles) 以实现依赖图的可重现性。

目录

• 使用 Conan 构建一个简单的 CMake 项目
• 将构建工具用作 Conan 包
• 针对多种配置进行构建：Release、Debug、Static 和 Shared
  • 修改设置：为应用程序及其依赖项使用 Debug 配置
  • 修改选项：将应用程序依赖项链接为共享库
  • 设置 (settings) 与选项 (options) 之间的区别
  • 介绍包 ID (Package ID) 的概念
• 理解使用 conanfile.py 与 conanfile.txt 的灵活性
  • 使用 layout() 方法
  • 使用 validate() 方法对不支持的配置引发错误
  • 使用 conanfile.py 的条件需求
  • 使用 generate() 方法从包中复制资源
  • 使用 build() 方法和 conan build 命令
• 如何使用 Conan 交叉编译您的应用程序：host 和 build 上下文
  • Conan 双配置文件模型：构建和主机配置文件 (build and host profiles)
• 版本控制介绍
  • 版本范围
  • 修订版
  • 锁定文件

注意

Conan 2 Essentials 培训课程可在 JFrog Academy 免费获取，该课程以更具互动性的方式涵盖了本文档中的相同主题。您可以在此处访问它。