创建软件包

本节展示如何使用 Conan recipe 创建 Conan 软件包。我们将从创建一个基本的 Conan recipe 开始，该 recipe 用于打包一个简单的 C++ 库，您可以使用 conan new 命令来搭建它。然后，我们将解释您可以在 Conan recipe 中定义的各种方法以及您可以在其中执行的操作。

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

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

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

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

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

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

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

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

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

目录

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

注意

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