Conan 1.12 Documentation

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

摘要

文档详细介绍了Conan 1.12版本的功能、安装方法、使用指南、包创建和上传流程，以及与各种构建系统的集成。文档还包含了详细的更新日志，介绍了新功能、修复的bug以及对旧版本的兼容性承诺。内容涵盖了从基本安装到高级功能如Python代码复用、跨平台构建支持、生成器包使用等，适合开发者和项目管理者参考。

AI总结

### Conan 1.12 版本文档总结

Conan 是一个开源的依赖管理工具，旨在简化 C/C++ 项目的依赖管理，支持二进制包管理和跨平台构建。以下是文档的核心内容和关键信息：

---

#### 1. **Conan 的核心功能**
- **开源**：Conan 是完全开源的，遵循 MIT 许可证。
- **分布式包管理器**：支持去中心化的包管理，用户可以自定义包的存储位置。
- **二进制管理**：通过缓存机制，避免重复编译，提升构建效率。
- **跨平台支持**：支持 Windows、Linux、macOS 等平台，并与多种构建系统（如 CMake、Autotools、Visual Studio 等）兼容。
- **稳定性**：Conan 1.12 版本承诺向后兼容 1.0 版本的配方和命令行调用。

---

#### 2. **安装与配置**
- **安装方式**：
- 使用 `pip` 安装（推荐）。
- 通过 Homebrew（macOS）或 AUR（Arch Linux）安装。
- 下载预编译二进制文件。
- 从源码编译安装。
- **初始配置**：安装后可配置环境变量和默认设置。
- **更新**：支持通过命令行工具更新到最新版本。

---

#### 3. **使用 Conan**
- **依赖管理**：
- 使用 `conan install` 命令安装项目所需的依赖包。
- 支持通过配置文件（`conanfile.txt` 或 `conanfile.py`）定义依赖。
- **配置与环境**：
- 使用 profiles 管理构建环境和设置。
- 支持通过环境变量覆盖默认配置。
- **工作流**：
- 提供灵活的构建和测试工作流，支持 CI/CD 集成。

---

#### 4. **创建与打包**
- **创建包**：
- 通过 `conan create` 命令快速创建新包。
- 支持将现有二进制文件打包为 Conan 包。
- **配方开发**：
- 使用 `conanfile.py` 定义包的元数据、依赖、构建步骤和包信息。
- 支持通过 `recipe` 和 `sources` 分离代码仓库。
- **打包策略**：
- 提供多种打包方法，支持自定义打包逻辑。
- 支持定义二进制包的 ABI 兼容性。

---

#### 5. **上传与分发**
- **上传到远程仓库**：
- 支持将包上传到 Bintray、Artifactory 等远程仓库。
- 使用 `conan upload` 命令完成上传。
- **自定义服务器**：
- 支持搭建自定义的 Conan 服务器（`conan_server`）。
- **共享与协作**：
- 通过远程仓库实现团队协作和包的共享。

---

#### 6. **开发与调试**
- **包开发流程**：
- 使用 `conan develop` 命令以可编辑模式开发包。
- 支持通过工作区（workspaces）管理多个项目的依赖。
- **调试与日志**：
- 提供详细的日志输出，便于排查问题。
- 支持通过虚拟环境管理构建环境。

---

#### 7. **高级功能**
- **版本范围**：支持定义依赖包的版本范围，如 `Pkg/[>1.2,<1.9]@user/channel`。
- **构建策略**：
- 支持通过 `build_policy` 管理构建缓存。
- 提供 `build=outdated` 功能，自动检测过时的二进制包并重新构建。
- **跨平台构建**：
- 支持通过 `os_build`、`arch_build` 等设置进行交叉编译。
- 支持 Windows Subsystem（WSL、MSYS、Cygwin 等）。

---

#### 8. **集成与扩展**
- **工具与插件**：
- 支持多种构建系统（CMake、Autotools、Visual Studio 等）。
- 提供 Docker 集成，便于容器化构建。
- **Python 支持**：
- 支持在配方中复用 Python 代码。
- 支持将 Conan 用作 Python 包管理器。
- **钩子（Hooks）**：
- 支持通过钩子扩展 Conan 的功能，如自定义验证、日志记录等。

---

#### 9. **版本更新与兼容性**
- **1.12.3 版本更新**：
- 修复了多个已知问题，包括 MSBuild 辅助工具的输出警告、CMake 生成器的默认设置等。
- 支持新的架构（ppc64le 和 AArch64）。
- **Python 3 支持**：
- Conan 代码库已兼容 Python 3，未来版本将逐步弃用 Python 2。
- **向后兼容性**：
- Conan 1.12 不会破坏 1.0 版本的配方和命令行调用。

---

#### 10. **文档与资源**
- 提供详细的文档和示例，涵盖从入门到进阶的使用场景。
- 提供 FAQ 和常见问题的解决方案。
- 提供视频和链接，便于用户进一步学习。

---

### 总结
Conan 1.12 版本在功能、性能和兼容性方面均有显著提升，支持跨平台构建、二进制管理、依赖范围定义和多种集成方式。文档详细介绍了安装、使用、开发和扩展的流程，并提供了丰富的示例和工具支持，适合开发者、项目管理者和 CI/CD 工程师使用。