Conan 1.20 Documentation

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

摘要

文档主要介绍了Conan 1.20版本的功能、安装和使用方法。Conan是一个开源的、去中心化的包管理工具，支持跨平台和多种构建系统。文档详细说明了如何安装Conan，包括使用pip、Homebrew、AUR等方式，并提供了初始配置和更新的指导。此外，文档还涵盖了使用Conan管理依赖、创建和上传包的步骤，强调了Conan的稳定性和对多种平台和构建系统的支持。

AI总结

### Conan 1.20 文档总结

#### 1. **核心功能与特点**
- **开源与去中心化**：Conan 是一个开源的去中心化包管理工具，支持跨平台和多种构建系统。
- **二进制管理**：Conan 提供二进制包管理，避免重复构建，提升效率。
- **跨平台与构建系统无关**：支持 Windows、Linux（Ubuntu、Debian、RedHat 等）、macOS、FreeBSD 等平台，且与具体构建系统无关，可与 CMake、Autotools 等配合使用。
- **稳定性承诺**：从 1.0 版本开始，Conan 承诺不破坏用户空间的功能，新增功能和 API 仅适用于新版本，旧版本的包和脚本不会被破坏。

#### 2. **安装与配置**
- **安装方式**：
- 使用 pip（推荐）。
- 使用 Homebrew（macOS）。
- 使用 AUR（Arch Linux）。
- 下载二进制文件。
- 从源码安装。
- **配置**：初始配置可自定义，推荐使用配置文件（`conan.conf`）和配置文件（`profiles`）确保重复性和稳定性。

#### 3. **使用包**
- **依赖管理**：通过 Conan 安装依赖，支持使用配置文件和资料库。
- **配置文件与工作流**：支持配置文件（`conanfile.py`）定义依赖、选项和构建策略，提供灵活的工作流。
- **二进制包**：依赖包可从远程仓库下载，若无可用二进制包，则从源码构建。

#### 4. **创建包**
- **入门**：从简单的加密器示例开始，学习如何定义依赖、构建配置和包信息。
- **高级功能**：
- **ABI 兼容性**：定义包的二进制接口兼容性。
- **包检查**：通过 `inspect` 命令检查包信息。
- **包上传**：支持将包上传到远程仓库（如 Bintray、Artifactory）。
- **工具**：提供 `conan source`、`conan build_info` 等命令辅助开发和调试。

#### 5. **新版本更新（1.20.5）**
- **改进与修复**：
- 修复 `conan_build_info` 命令的环境捕获问题。
- 优化 `conan_scm` 的源码导出逻辑。
- 改善 `conan_create` 的依赖管理。
- 支持新架构（如 ppc64le 和 AArch64）。
- 提升构建系统的兼容性（如 CMake、B2 等）。
- **新功能**：
- 支持多配置包（如 debug/release）。
- 提供 `conan config` 命令管理配置。
- 改进 CMake 构建助手功能。
- 支持自定义头文件和资源目录。

#### 6. **扩展与集成**
- **扩展性**：支持自定义设置、钩子（Hooks）和插件，可与 CI/CD 平台、IDE 等集成。
- **版本控制**：支持版本范围、包修订和锁文件，确保依赖管理的灵活性和一致性。

#### 7. **重要注意事项**
- **Python 2 支持**：从 1.6 版本开始逐步弃用 Python 2，新功能仅支持 Python 3。
- **兼容性**：公共仓库（如 conan-center）假设使用最新版本的 Conan 客户端，旧版本可能无法正常工作。
- **稳定性保障**：新增功能和 API 仅适用于新版本，旧版本的包和脚本不会被破坏。

#### 8. **总结**
Conan 1.20 是一个功能强大且灵活的包管理工具，支持跨平台、多种构建系统和依赖管理，适合 C/C++ 项目。新版本在稳定性、兼容性和功能扩展性上均有显著提升，推荐开发者和团队使用。