Conan 1.21 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: docs.conan.io

摘要

文档介绍了Conan 1.21版本的功能和更新内容，包括安装方法、使用指南、包创建和上传流程，以及各个版本的更新日志，涵盖了功能增强、bug修复和新特性。

AI总结

### Conan 1.21 文档总结

#### 引言
Conan 是一个开源的去中心化包管理工具，支持跨平台和多种构建系统，专注于二进制管理，确保稳定性和可重复性。其核心特性包括：
- **开源**：免费且开放的依赖管理工具。
- **去中心化**：支持通过 Git、HTTP 等方式获取包。
- **二进制管理**：通过二进制缓存加速构建过程。
- **跨平台**：支持 Windows、Linux、macOS 等平台。
- **稳定性**：向后兼容，避免破坏现有功能。

#### 安装
- **推荐安装方式**：使用 pip 安装。
- **其他安装方式**：
- macOS：使用 Homebrew。
- Arch Linux：使用 AUR。
- 二进制文件：直接下载安装。
- **配置**：初始配置和环境变量设置。
- **更新**：通过 pip 或其他方式更新。
- **注意事项**：Python 2 已逐步弃用。

#### 入门指南
- **依赖管理**：通过 Conan 安装和管理依赖。
- **依赖检查**：查看依赖树和版本信息。
- **包搜索**：支持通过查询条件搜索包。
- **构建配置**：支持多种构建配置和工具链。

#### 使用包
- **安装依赖**：通过 Conan 命令安装所需的依赖。
- **配置文件**：使用配置文件（profiles）管理构建环境。
- **工作流程**：支持 CI/CD 和自动化构建流程。

#### 创建包
- **基础**：从简单的食谱开始，定义包的构建和打包逻辑。
- **食谱与源文件**：支持将食谱和源文件放在不同或相同的仓库中。
- **二进制打包**：支持从现有二进制文件创建包。
- **高级功能**：
- 定义 ABI 兼容性。
- 检查和验证包信息。
- 使用工具生成包。

#### 上传包
- **上传流程**：将本地包上传到 Conan 仓库。
- **注意事项**：确保包的元数据和依赖信息正确。

#### 版本更新日志
- **1.21.3**：
- 修复了元数据文件的并发访问问题。
- 修复了虚拟环境脚本在纯 `sh` 环境中的兼容性问题。
- 优化了上传逻辑，避免静默失败。
- **1.21.2**：
- 修复了 Python 3.8 下的压缩问题。
- 优化了 CMake 生成器的依赖管理。
- **1.21.1**：
- 修复了类型检测和宏定义问题。
- 优化了包元数据的读取和处理。
- **1.12.3**：
- 修复了版本降级问题。
- 优化了 MSBuild 辅助工具的输出。
- **1.12.0**：
- 新增 JSON 输出功能。
- 支持多配置文件和多配置生成器。
- 新增 `conan source` 命令，直接执行食谱的 `source()` 方法。
- 支持传递多个配置文件，优先级按顺序处理。

#### 其他重要更新
- **0.12.0**：
- 重构搜索 API，支持分离食谱和二进制包搜索。
- 支持通过环境变量禁用彩色输出。
- 支持使用绝对路径导入文件。
- **0.9.2**：
- 支持 Python 3。
- 新增生成器包功能，允许动态加载生成器。
- 优化文档，新增创建包的详细指南。
- **0.8.4**：
- 修复了苹果clang 的链接问题。
- 支持自定义生成器和构建工具链。

#### 总结
Conan 1.21 版本在功能、性能和稳定性上均有显著提升，支持更多平台和工具链，优化了依赖管理和构建流程，新增了多项实用功能（如 `conan source` 和多配置支持）。文档详细介绍了安装、使用、创建和上传包的步骤，并提供了丰富的示例和配置选项，适合开发者、CI/CD 工程师和包维护者使用。