Conan 1.38 Documentation

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

摘要

The document provides comprehensive information about Conan 1.38.0, detailing its features, improvements, and bug fixes. It covers new functionalities such as the PkgConfigDeps generator, Jinja2 templates for profiles, and enhanced cross-build support. The release also introduces a new conanfile.dependencies model and improved handling of package revisions. Additionally, it includes updates to toolchains, better performance optimizations, and various bug fixes to enhance stability and usability.

AI总结

### Conan 1.38 版本更新总结

#### 1. 特性概述
Conan 1.38 是一个功能丰富且稳定的版本，主要针对依赖管理、构建工具链和包创建进行了多项改进和优化。以下是其核心功能和新增特性：

- **依赖管理与构建工具链**：
- 引入了新的 `PkgConfigDeps` 生成器，支持通过 `PkgConfig` 管理依赖。
- 改进了 `CMakeToolchain` 和 `AutotoolsToolchain`，支持跨平台构建和更灵活的配置。
- 新增 `cmake_layout()` 布局助手，支持多平台 CMake 项目布局。
- 支持通过 `--conf` 命令行参数自定义配置。

- **包创建与发布**：
- 新增 `provides` 和 `deprecated` 字段，用于描述包的功能和弃用信息。
- 支持通过 `conan source` 命令执行 `source()` 方法，便于 CI 环境中并行构建。
- 改进了 `test_package()` 命令，支持自动更新依赖。

- **包管理与存储**：
- 新增 `conan remote` 命令，支持管理远程仓库和注册表。
- 支持通过 `--update` 命令更新过时的包。
- 提高了包压缩和传输效率，避免重复压缩和传输。

- **平台与工具链支持**：
- 新增对 PowerPC 和 AArch64 架构的支持。
- 改进了对 iOS、tvOS、watchOS 和 Android 的工具链支持。
- 支持通过 `Jinja2` 模板定义配置文件。

#### 2. 重要改进
- **依赖管理**：
- 新增 `requires` 模型，支持字典格式 `{requirement: ConanFileInterface}`，为 Conan 2.0 做准备。
- 支持通过 `--build` 参数匹配更多构建模式。

- **日志与输出**：
- 使用 Python 原生日志记录器输出 CLI 信息，提高可读性和调试性。
- 支持通过 `CONAN_COLOR_DISPLAY` 和 `CONAN_COLOR_DARK` 环境变量自定义颜色输出。

- **性能优化**：
- 优化了依赖图的内部表示，提升大项目构建性能。
- 提高了包缓存和传输效率，减少重复操作。

#### 3. 兼容性与稳定性
- **兼容性**：
- 确保与 Conan 1.0 及更高版本的兼容性，不会破坏现有食谱或命令行使用。

- **稳定性**：
- 修复了多项已知问题，包括依赖搜索、权限错误、构建工具链配置等。
- 改进了错误处理和构建过程中的稳定性。

#### 4. 安装与配置
- **安装方式**：
- 支持通过 `pip`、Homebrew（macOS）、AUR（Arch Linux）等安装。
- 提供二进制安装包和源码安装选项。

- **配置**：
- 初始配置支持通过 `conan config` 命令完成。
- 支持通过 `CONAN_USER_HOME` 环境变量定义用户目录，便于隔离项目依赖。

#### 5. 工作流程与工具
- **工作流程**：
- 支持通过 `conan install` 下载和安装依赖。
- 支持通过 `conan profiles` 定义构建环境和工具链。
- 提供 `conan info` 命令输出包信息，包括依赖、配置和构建输出。

- **工具与扩展**：
- 新增 `conan remote clean` 和 `conan remote update` 命令，便于管理远程仓库。
- 支持通过 `conan new` 命令生成新的包食谱，提供 Docker 镜像支持。

#### 6. 重要变更与注意事项
- **Python 2 支持**：
- Python 2 已弃用，建议迁移至 Python 3。

- **依赖更新**：
- 更新了默认设置文件，包括对 Clang 11、GCC 8.2 等的支持。

- **兼容性提示**：
- 新版本可能会影响某些旧配置，建议迁移前备份。

#### 7. 总结
Conan 1.38 版本在依赖管理、构建工具链、包创建和发布方面进行了全面优化，新增了多项实用功能，同时修复了大量已知问题。其稳定性和兼容性使其成为大规模项目和复杂构建环境的理想选择。