创建软件包

本节介绍如何使用 Conan 配方创建 Conan 软件包。我们首先创建一个基本的 Conan 配方来打包一个简单的 C++ 库，您可以使用 conan new 命令进行脚手架搭建。然后，我们将解释您可以在 Conan 配方中定义的各种方法以及您可以在其中执行的操作。

• 使用 source() 方法从外部存储库检索源代码并应用补丁。

• 在 requirements() 方法中为您的 Conan 软件包添加依赖项。

• 使用 generate() 方法准备软件包构建，并自定义工具链。

• 在 configure() 和 config_options() 方法中配置设置和选项，以及它们如何影响软件包的二进制兼容性。

• 使用 build() 方法自定义构建过程并启动您正在打包的库的测试。

• 使用 package() 方法选择将包含在 Conan 软件包中的文件。

• 在 package_info() 方法中定义软件包信息，以便该软件包的消费者可以使用它。

• 使用 test_package 来测试 Conan 软件包是否可以被正确使用。

在对 Conan 配方方法进行此概述之后，我们将解释不同类型的 Conan 软件包的一些特点，例如，仅标头库、预构建二进制文件的软件包、用于构建其他软件包的工具打包或您自己的应用程序打包。

目录

• 创建你的第一个 Conan 软件包
  • 关于 Conan 缓存的说明
• 处理软件包中的源代码
  • 来自存储在远程存储库中的 zip 文件的源代码
  • 来自 git 存储库中分支的源代码
  • 使用 conandata.yml 文件
• 为软件包添加依赖项
  • 标头传递性
• 准备构建
• 在配方中配置设置和选项
  • Conan 软件包二进制兼容性：包 ID
• 构建软件包：build() 方法
  • 构建和运行项目的测试
  • 有条件地修补源代码
  • 有条件地选择您的构建系统
• 打包文件：package() 方法
  • 在 package() 方法中使用 CMake install 步骤
  • 在 package() 方法中使用 conan.tools.files.copy() 并打包许可证
  • 在 package() 方法中管理符号链接
• 定义供使用者使用的信息：package_info() 方法
  • 在 package_info() 方法中设置信息
  • 定义依赖于设置或选项的消费者的信息
  • 属性模型：为特定生成器设置信息
  • 将环境或配置信息传播给使用者
  • 为提供多个库的 Conan 软件包定义组件
• 测试 Conan 软件包
• 其他类型的软件包
  • 仅头文件软件包
  • 打包预构建二进制文件
  • 工具要求软件包

注意

Conan 2 基础培训课程可在 JFrog Academy 免费获得，其涵盖的主题与本文档相同，但更具互动性。您可以 此处 访问。