Conan 1.58 Documentation

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

摘要

文档介绍了Conan 1.58.0版本的发布，包括安装方法、使用指南、包的创建与上传流程，以及如何进行包的开发和集成。文档详细说明了Conan的功能，如 decentralized package manager、binary management，适用于多种平台和构建系统，并提供了详细的配置和使用说明。

AI总结

## Conan 1.58 文档总结

### 1. 介绍
- **开源**：Conan 是一个开源的依赖和包管理器，遵循 MIT 许可证。
- **分布式架构**：采用客户端-服务器架构，支持从不同远程仓库拉取或上传包。
- **跨平台支持**：适用于 Windows、Linux、macOS、FreeBSD 等平台，支持嵌入式、移动和裸金属开发。
- **稳定性**：承诺无破坏性更新，适用于所有 Conan 1.X 版本。
- **社区驱动**：由活跃的社区支持，包括 ConanCenter 和众多公司用户的贡献。

### 2. 迁移指南
- **从 1.x 到 2.0**：需注意命令行参数的变化，部分旧命令如 `conan package` 和 `conan copy` 已移除。
- **食谱迁移**：更新食谱以符合 2.0 规范，建议使用 `conan export-pkg` 测试构建。
- **配置文件**：移除 `conan config set`，改用配置文件和プロファイル进行设置。

### 3. 安装与配置
- **安装方式**：
- **推荐**：使用 pip 安装。
- 其他方式：Homebrew（macOS）、AUR（Arch Linux）、二进制文件或从源码编译。
- **初始配置**：设置下载缓存和默认构建配置文件。
- **更新**：通过 `conan update` 保持客户端最新。

### 4. 使用 Conan
- **依赖管理**：通过命令行或配置文件安装和管理依赖。
- **配置文件**：使用 profiles 定义构建环境和设置。
- **工作流**：支持 CMake、Visual Studio、Makefiles 等构建系统。
- **调试**：通过日志和调试工具排查包构建问题。

### 5. 创建包
- **入门**：从简单的 C/C++ 项目开始，逐步掌握食谱编写。
- **高级技巧**：
- **食谱与源码分离**：支持将食谱和源码托管在不同仓库。
- **二进制打包**：直接打包现有二进制文件或从源码构建。
- **ABI 兼容性**：定义包的二进制接口兼容性。
- **工具链支持**：使用自定义构建助手优化构建流程。
- **验证**：通过 `conan inspect` 和 `conan test` 验证包的完整性和正确性。

### 6. 上传与协作
- **远程仓库**：使用 Artifactory 或自托管服务器上传和管理私有包。
- **团队协作**：通过工作区和配置文件实现多人协作开发。
- **版本控制**：利用锁文件和修订功能管理依赖版本。

### 7. 高级功能
- **扩展性**：通过自定义设置、Python 需求和挂钩扩展 Conan 功能。
- **模板系统**：使用 Jinja2 模板自定义输出格式。
- **版本控制**：支持语义化版本控制、包修订和锁定文件。

### 8. 整合与扩展
- **编译器与构建系统**：支持 GCC、Clang、Intel 编译器，集成 CMake、MSBuild 等工具。
- **CI 平台**：与 Jenkins、GitHub Actions、GitLab CI 等集成。
- **其他系统**：支持 Docker、SSL 证书管理、许可证收集等。
- **自定义整合**：通过 Conan 的 Python API 创建自定义命令和生成器。

### 9. 配置与调试
- **下载缓存**：管理本地缓存以提升依赖下载速度。
- **问题排查**：通过日志和环境变量调试构建问题。
- **版本控制**：使用 `conan_v2_remote_login` 管理用户认证和版本信息。

### 10. 参考文档
- **命令**：详细列出所有 Conan 命令及其用法。
- **配置文件**：解释 `conanfile.txt` 和 `conanfile.py` 的结构。
- **生成器与工具**：提供常用生成器和构建工具的文档。

### 11. 示例与案例
- **Python 包管理**：展示如何使用 Conan 管理 Python 包和 C/C++ 依赖。
- **Pybind11 示例**：通过 Poco 库和 pybind11 创建 Python 扩展模块，展示 Conan 的跨语言支持能力。

### 总结
Conan 1.58 提供了强大的依赖管理、跨平台支持和灵活的构建配置，适合 C/C++ 项目和各种开发环境。通过合理的配置和使用，用户可以高效地管理依赖、构建和分发包，同时支持团队协作和私有仓库的使用。