Conan 1.40 Documentation

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

摘要

The document provides comprehensive documentation for Conan 1.40, an open-source, decentralized package manager designed for cross-platform and cross-compiler dependency management. It covers installation methods, usage guidelines, package creation, and version control. The release notes highlight improvements such as support for new architectures, enhanced dependency resolution, and various bug fixes, ensuring compatibility with existing recipes while introducing new features and optimizations.

AI总结

### Conan 1.40 文档总结

#### 1. **介绍**
- **开源**：Conan 是一个开源的包管理工具。
- **去中心化**：支持去中心化的包管理，用户可以在本地或远程仓库中查找和管理依赖。
- **二进制管理**：支持二进制包的管理，减少构建时间。
- **多平台支持**：支持所有平台、构建系统和编译器。
- **稳定性**：向后兼容，不会破坏 1.0 版本的食谱或命令。
- **社区驱动**：依赖于活跃的开源社区。

#### 2. **快速入门**
- 提供图形化和社区创建的格式，帮助用户快速上手。
- 提供培训课程，帮助用户掌握 Conan 的基本使用。

#### 3. **安装**
- **推荐安装方式**：通过 pip 安装。
- 其他安装方式：Homebrew（macOS）、AUR（Arch Linux）、二进制安装。
- 初始配置：用户可以根据需求进行个性化设置。
- 更新：支持从源码或二进制安装最新版本。

#### 4. **使用包**
- **安装依赖**：通过 Conan 命令轻松安装项目所需的依赖。
- **配置文件**：支持使用配置文件（profiles）来管理构建环境。
- **工作流**：提供灵活的工作流，支持并行构建和 CI/CD 集成。
- **调试**：支持调试包，帮助用户排查依赖问题。

#### 5. **创建包**
- **入门**：提供详细的包创建指南。
- **食谱与源码**：支持将食谱和源码放在不同的仓库或同一仓库。
- **现有二进制**：支持从现有二进制文件创建包。
- **ABI 兼容性**：定义包的二进制接口兼容性。
- **工具链**：支持自定义工具链，满足特定项目需求。

#### 6. **上传包**
- **远程仓库**：支持将包上传到远程仓库。
- **Artifactory 集成**：提供与 Artifactory 的集成支持。
- **Conan Server**：支持运行自己的 Conan 服务器。

#### 7. **开发包**
- **开发流程**：提供从创建到测试的完整开发流程。
- **布局**：支持定义包的布局方式。
- **可编辑模式**：支持在可编辑模式下开发包。
- **工作区**：支持使用工作区进行协作开发。

#### 8. **版本控制**
- **版本范围**：支持定义版本范围，灵活管理依赖版本。
- **包修订**：支持包修订，确保依赖的可追溯性。
- **锁定文件**：支持使用锁定文件（lockfiles）固定依赖版本。

#### 9. **掌握 Conan**
- **高级功能**：包括使用 `conanfile.py`、条件设置、构建策略、环境变量、虚拟环境等。
- **日志**：支持日志记录，帮助排查问题。
- **共享配置**：支持共享设置和配置，方便团队协作。

#### 10. **扩展 Conan**
- **自定义设置**：支持自定义设置，满足特定需求。
- **Python 依赖**：支持将 Python 代码作为依赖管理。
- **钩子**：支持自定义钩子，扩展 Conan 的功能。
- **模板系统**：允许用户自定义模板，生成符合需求的输出。

#### 11. **变更日志**
- **Conan 1.40.4**：
- 修复 SSL 证书问题。
- 支持 Xcode 13 和 Apple clang 13。
- 默认 `cmake_layout()` 的源文件夹更改为当前目录。
- **其他版本**：
- 新增对 PPC64LE 和 AArch64 的支持。
- 支持更多 GCC 版本和新架构。
- 提升命令输出的清晰度和用户体验。
- 修复多项与 Python 3 兼容性相关的 bug。

#### 12. **核心新功能**
- **新命令**：`conan source` 可执行 `source()` 方法，适合 CI 使用。
- **依赖传播**：支持通过 `cpp_info` 和 `collect_libs()` 捕捉二进制包的依赖。
- **测试包**：支持自动更新依赖。
- **性能优化**：避免重复压缩未更改的 TGZ 文件。
- **环境变量**：支持通过环境变量禁用彩色输出和配置颜色主题。

#### 13. **总结**
Conan 1.40 是一个功能强大且灵活的包管理工具，支持从依赖管理、包创建到上传和共享的完整流程。其核心优势包括开源、去中心化、多平台支持以及强大的社区和文档支持。通过丰富的功能和插件扩展，用户可以轻松管理和构建跨平台项目。