Conan 1.64 Documentation

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

摘要

The document provides comprehensive documentation for Conan 1.64, covering installation, usage, package creation, and integration. It details new features, bug fixes, and improvements across various versions, including updates to dependency management, build systems, and configuration options. The release emphasizes compatibility with existing recipes and commands, ensuring stability while introducing new functionalities such as enhanced CMake integration, improved dependency graph handling, and better support for diverse build environments.

AI总结

《Conan 1.64 文档》主要介绍了 Conan 1.64 版本的功能更新、改进和相关注意事项。以下是文档的核心内容总结：

### 1. Conan 1.64 发行说明
- **版本兼容性**：Conan 1.64 不会破坏现有的 1.0 版本配方或命令行调用。若发现不兼容，请向 GitHub 提交报告。
- **新功能**：
- **下载缓存**：新增 `download_cache` 配置，允许多个用户共享缓存，提升并发访问效率。
- **生成器改进**：新增 `--output-folder` 选项，支持在 `layout()` 方法中使用。
- **CMake 支持**：改进 CMake 目标生成，支持 `GLOBAL` 属性，便于消费者使用 `ALIAS`。
- **Python 2 警告**：强制提示用户 Python 2 已弃用。
- **SCM 支持**：新增 `opt-in` 模式，将 SCM 数据存储到 `conandata.yml` 文件中。
- **构建工具改进**：新增 `MSBuildCmd` 类，优化 MSBuild 调用流程。

- **性能优化**：
- **conan info 性能提升**：修复慢存储系统中依赖图信息查询的性能问题。
- **依赖管理**：优化依赖图的传播性能，从 O(n²) 提升至 O(n)。

### 2. 迁移指南
- **配方迁移**：提供详细的迁移步骤，确保旧版本配方兼容新版本。
- **命令调整**：部分命令参数和行为已更新，需参考文档进行调整。
- **配置文件**：新增和调整了部分配置文件，请确保更新以匹配新版本。

### 3. 安装与配置
- **安装方式**：
- **推荐安装**：使用 pip 安装。
- **其他平台**：支持 macOS 使用 Homebrew，Arch Linux 使用 AUR。
- **手动安装**：提供二进制包和源码安装选项。
- **初始配置**：安装后需进行基础配置，包括设置下载缓存路径和用户信息。

### 4. 使用与工作流程
- **依赖管理**：支持通过配方和配置文件管理项目依赖。
- **配置文件**：新增 `conan.conf` 配置，支持代理设置和下载缓存优化。
- **调试与构建**：提供调试工具和构建辅助功能，便于排查问题。

### 5. 创建包
- **新包模板**：优化 `conan new` 命令，支持生成 Travis-CI 和 Appveyor 配置文件。
- **构建工具**：新增 `conan.tools` 模块，提供更强大的构建辅助功能。
- **包上传**：优化上传逻辑，避免文件元数据冲突。

### 6. 集成与扩展
- **编译器支持**：支持 GCC 7.1+、Intel 编译器、Visual Studio 等多种编译器。
- **构建系统**：支持 CMake、Autotools、Meson、QMake 等多种构建系统。
- **CI 平台**：支持 Travis、Appveyor、Jenkins 等持续集成工具。
- **插件支持**：新增实验性插件功能，便于扩展 Conan 功能。

### 7. 注意事项
- **Python 2 移除**：未来版本将移除对 Python 2 的支持，请尽快迁移至 Python 3。
- **依赖冲突**：部分功能可能因依赖版本冲突导致问题，需检查依赖版本并更新。
- **缓存清理**：定期清理本地缓存，避免存储空间不足。

### 总结
Conan 1.64 版本在依赖管理、构建工具、性能优化和集成支持方面均有显著提升，同时增强了对多种开发环境和工具链的支持，适合需要跨平台和复杂构建需求的项目使用。