Conan 2.10 Documentation

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

摘要

该文档是Conan 2.10.1版本的用户文档，介绍Conan作为开源、去中心化的C/C++包管理器，支持所有平台、构建系统和编译器。文档概述了Conan 2的新特性，包括新的图模型、公共Python API、构建系统集成、自定义用户命令、CLI、部署器、package_id、compatibility.py、锁文件、配置与环境管理、多版本缓存、扩展插件、包不可变性优化、包列表、元数据文件、第三方备份源以及从Conan包安装配置等。此外，文档还包含了从2.0.0-beta2到2.10.1版本的详细变更日志，记录了各版本的功能改进和错误修复。

AI总结

Conan 2.10 是一个开源的、去中心化的 C/C++ 包管理器，支持所有平台、构建系统和编译器。其核心功能包括二进制管理、稳定的版本控制和社区支持。

**主要新特性 (相对 Conan 1.X):**
- **新图模型:** 改进了依赖关系处理。
- **新公共 Python API:** 提供了更强大的编程接口。
- **新构建系统集成:** 更好地与 CMake 等工具协同。
- **新 CLI 和命令:** 包括自定义用户命令。
- **新 `package_id`:** 采用动态策略，根据依赖类型（如静态库 vs 应用）决定是否需要重新构建。
- **`compatibility.py`:** 允许在全局层面定义二进制兼容性回退规则。
- **新锁文件 (Lockfiles):** 更灵活，支持多配置和合并。
- **新配置和环境管理:** 使用 `[conf]` 系统替代环境变量，更清晰。
- **多版本缓存:** 可存储多个修订版本。
- **新扩展插件:** 包括配置文件检查器、命令包装器和包签名功能。
- **包不可变性优化:** 基于修订版本实现更高效的传输和追踪。

**版本 2.10.1 (2024-12-04) 更新:**
- 修复了 `replace_requires` 在替换相同引用名称时的问题。

**版本 2.10.0 (2024-12-02) 更新:**
- 新增功能: `conan remote auth` 强制认证、`conan new` 命令输出选项、改进的 CMakeDeps 组件定义、BazelDeps 库定位优化、初始工作区 (workspace) 功能、以及 Docker 运行器的网络配置。
- 修复: 修复了 PowerShell 配置帮助信息、`Git.fetch_commit()` 在子文件夹中的错误、CMakeDeps 对 `fooConfig.cmake` 的支持、以及添加了关于选项冲突的风险警告。

**其他历史版本亮点 (2.0.x 系列):**
- 2.0.17: 修复了 libcxx 检测和 CMakeToolchain 的 winsdk_version 问题。
- 2.0.15: 新增 `conan lock remove` 命令、`CMake.ctest()` 辅助方法、以及 `CONAN_LOG_LEVEL` 环境变量。
- 2.0.0-beta 系列: 引入了对锁文件别名、`conan source` 命令改进、以及 `build_id()` 修复等多项功能和修复。