创建软件包

本节展示如何使用 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 安装步骤
  • 在 package() 方法中使用 conan.tools.files.copy() 并打包许可证
  • 在 package() 方法中管理符号链接
• 定义供使用者使用的信息：package_info() 方法
  • 在 package_info() 方法中设置信息
  • 根据设置或选项为使用者定义信息
  • 属性模型：为特定生成器设置信息
  • 将环境或配置信息传播给使用者
  • 为提供多个库的 Conan 软件包定义组件
• 测试 Conan 软件包
• 其他类型的软件包
  • 仅头文件软件包
  • 打包预构建二进制文件
  • 工具要求软件包

注意

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