创建包

本节介绍如何使用 Conan recipe 创建 Conan 包。我们首先创建一个基本的 Conan recipe 来打包一个简单的 C++ 库，你可以使用 conan new 命令搭建这个库的骨架。然后，我们将解释你可以在 Conan recipe 中定义的不同方法以及你可以在这些方法中执行的操作

• 使用 source() 方法从外部仓库检索源文件，并将补丁应用于这些源文件。

• 在 requirements() 方法中向你的 Conan 包添加需求。

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

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

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

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

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

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

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

目录

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