Conan 1.34 Documentation

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

摘要

Conan是一个开源的、分布式的包管理工具，支持跨平台、多种构建系统和编译器，旨在简化C和C++项目的依赖管理。文档介绍了Conan 1.34版本的安装方法、使用流程、创建工作流程以及新增功能，包括对新架构的支持、工具链改进、CI/CD集成优化等。

AI总结

### Conan 1.34 版本总结

#### 1. 特性概述
- **开源与去中心化**：Conan 是一个开源的去中心化包管理工具，支持跨平台、跨构建系统和编译器。
- **二进制管理**：支持二进制文件管理，提升构建效率。
- **稳定性与社区支持**：注重稳定性，提供活跃的社区支持。

#### 2. 安装指南
- **推荐安装方式**：通过 `pip` 安装（支持 Python 3）。
- **其他平台支持**：支持 macOS（通过 Homebrew）和 Arch Linux（通过 AUR）。
- **初始配置**：提供基本配置选项。

#### 3. 使用指南
- **安装依赖**：通过 Conan 安装项目所需的依赖包。
- **配置文件**：支持使用配置文件（Profiles）进行环境变量和工具链的管理。
- **工作流程**：提供从依赖管理到构建、测试和上传的完整工作流程。
- **调试**：支持调试功能，帮助排查包构建问题。

#### 4. 创建包
- **入门**：提供创建自定义包的基本步骤。
- **食谱与源码管理**：支持将食谱和源码放在不同或相同的仓库中。
- **二进制打包**：允许将现成二进制文件打包为 Conan 包。
- **ABI 兼容性**：定义包的 ABI 兼容性，确保不同版本的二进制文件兼容性。

#### 5. 新功能与改进
- **新特性**：
- 支持新架构（如 s390 和 s390x）。
- 增强 `CMake` 和 `Autotools` 构建工具的灵活性。
- 支持多配置构建（如 `RelWithDebInfo` 和 `MinRelSize`）。
- 实验性支持 REST API v2 和 SVN 版本控制。
- **性能优化**：
- 提升构建图传播性能，从 O(n²) 优化至 O(n)。
- 提高文件压缩和上传效率。
- **用户体验改进**：
- 增强日志输出，支持 Python 标准日志模块。
- 提供更清晰的依赖安装信息和构建反馈。

#### 6. 兼容性与稳定性
- **向后兼容**：Conan 1.34 不会破坏 1.0 版本的食谱或命令行接口。
- **Python 2 支持**：已发出弃用警告，建议逐步迁移至 Python 3。

#### 7. 工具与插件
- **新工具**：
- `CMakeDeps`：替代 `cmake_find_package_multi`，支持更灵活的配置。
- `tools.replace_path_in_file`：支持跨平台路径替换。
- `tools.collect_libs`：增强对动态库路径的搜索能力。
- **插件支持**：引入实验性插件系统，扩展功能。

#### 8. 重要注意事项
- **架构检测**：优化了 GNU 三元组的架构检测逻辑。
- **环境变量管理**：避免 PATH 环境变量溢出问题，支持 Windows 系统的路径限制。
- **依赖约束**：新增 `ConanInvalidConfiguration` 错误，用于标识无效的配置。

#### 9. 示例
- 提供了一个使用 Conan 包装 C++ 库（如 Poco）并生成 Python 扩展的完整示例，展示了从源码到二进制包的构建流程。

#### 10. 其他改进
- **CI/CD 支持**：新增 `lockfile` 的“bundle”功能，优化多项目构建流程。
- **文件管理**：改进了 `conan_package.tgz` 的上传逻辑，避免元数据问题。
- **依赖管理**：支持通过 `default_options` 以字典形式定义默认选项。

总结：Conan 1.34 版本在功能、性能和用户体验方面均有显著提升，特别增强了对复杂 C/C++ 项目的构建支持，并提供了更灵活的配置和更高效的依赖管理。