Conan 2.10 Documentation

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

摘要

Conan 2.10文档详细介绍了Conan 2.0版本的新特性和改进，重点包括新的图模型以更好地支持C和C++二进制文件的关系、编译和链接；新增的公开Python API，支持用户自动化操作；更灵活的构建系统集成，如CMakeDeps和CMakeToolchain；以及改进的包ID计算、更强大的锁文件机制、配置和环境管理等功能。文档还提供了Conan 2.0的迁移指南，帮助用户从Conan 1.X版本顺利升级。此外，Conan 2.0还引入了包列表、元数据文件、第三方备份源等新功能，增强了包的批量操作、可追溯性和可重复性。

AI总结

《Conan 2.10 Documentation》主要介绍了Conan 2.0版本的新特性、迁移指南以及相关功能改进。以下是核心内容总结：

### 1. **Conan 2.0 新特性**
- **新的图模型**：更好地支持C和C++二进制文件的关系、编译和链接，引入了新的需求特性和包类型。
- **公共Python API**：提供了模块化的Python API，支持用户自动化操作和扩展。
- **构建系统集成**：更灵活和强大的构建系统集成，如CMakeDeps和CMakeToolchain。
- **自定义用户命令**：用户可以通过Python API创建自定义命令，并通过`conan config install`共享和安装。
- **CLI接口改进**：命令更简洁，输出更结构化。
- **部署机制**：支持将缓存中的工件复制到用户文件夹，并在构建时使用这些副本。
- **包ID计算改进**：基于新的图模型，包ID计算更加详细。
- **兼容性扩展**：通过`compatibility.py`机制，用户可以全局定义二进制兼容性。
- **锁文件**：更简单且功能强大的锁文件，确保构建的可重复性。
- **配置和环境管理**：通过`[conf]`和`conan.tools.env`工具，配置和环境管理更加灵活。
- **缓存多版本存储**：Conan缓存现在可以同时存储多个版本。
- **扩展插件**：支持实现配置文件检查、包签名和构建命令包装的插件。
- **包不可变性**：改进了更新、安装和上传流程。

### 2. **迁移指南**
- 从Conan 1.X迁移到2.0时，建议阅读迁移指南，了解如何准备包配方并适应新版本的变化。Conan 1.X的最新集成与Conan 2.0兼容，且两者的二进制文件可以在同一服务器仓库中共存。

### 3. **其他重要功能**
- **包列表**：支持批量操作多个配方和包，如上传、下载、删除和列出。
- **元数据文件**：允许存储、上传、下载和修改与配方和包相关的元数据文件，用于跟踪、合规性和业务目的。
- **第三方备份源**：在构建第三方包时，自动备份互联网上的源文件，确保构建的可重复性。
- **从Conan包安装配置**：支持从Conan包中安装配置文件，并使用版本范围和锁文件实现可重复性。

### 4. **集成与工具**
- **Visual Studio扩展**：支持在Visual Studio中集成Conan，简化项目配置。
- **Autotools工具**：提供了AutotoolsDeps、AutotoolsToolchain等工具，帮助管理使用Autotools的项目。

### 5. **文档与支持**
- 文档提供了详细的API参考、集成指南和示例，帮助用户更好地使用Conan。
- 用户可以通过GitHub项目提交问题、报告错误和请求新功能。

总结：Conan 2.0在构建系统集成、包管理、自动化操作和可重复性方面进行了大量改进，提供了更灵活和强大的功能，同时确保了与1.X版本的兼容性。