创建包

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

• 使用 source() 方法从外部仓库获取源代码并应用补丁。

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

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

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

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

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

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

• 使用一个 *test_package* 来测试 Conan 包是否可以正确消费。

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

目录

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

注意

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