Conan 1.23 Documentation

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

摘要

The document provides comprehensive documentation for Conan version 1.23.0, detailing its features, installation, and usage. It covers key functionalities such as dependency management, binary caching, and compatibility across various build systems and platforms. The release notes highlight new features like parallel downloading, improved test handling, and support for transitive dependencies. Additionally, it addresses bug fixes and deprecated features, ensuring backward compatibility with previous versions.

AI总结

# Conan 1.23 版本更新总结

Conan 1.23 版本带来了多项新功能和改进，涵盖安装、使用、创建包以及性能优化等多个方面。以下是本次更新的核心内容：

---

## 1. 概述
- **开源**：Conan 是一个开源的包管理器。
- **分布式**：支持去中心化的包管理。
- **二进制管理**：高效管理二进制文件。
- **跨平台支持**：支持所有平台、构建系统和编译器。
- **稳定性**：保持向后兼容性，确保 1.0 版本的食谱和命令不会被破坏。
- **社区驱动**：依赖于活跃的开源社区。

---

## 2. 安装
- **推荐安装方式**：使用 pip 安装。
- 其他安装方式：Brew（macOS）、AUR（Arch Linux）、二进制文件或从源码编译。
- **初始配置**：可通过配置文件 `conan.conf` 自定义行为。
- **更新**：支持从旧版本无缝更新。

---

## 3. 入门
- **示例**：通过 Poco 库创建一个 MD5 哈希计算器。
- **依赖管理**：支持安装、检查和搜索依赖包。
- **配置**：允许通过配置文件或命令行参数灵活调整行为。

---

## 4. 使用包
- **依赖安装**：通过 Conan 命令轻松安装项目依赖。
- **配置文件**：支持使用 profiles 自定义构建环境。
- **工作流程**：提供灵活的构建和测试工作流。
- **调试**：支持调试和修复已安装的包。

---

## 5. 创建包
- **入门指南**：从简单的食谱开始，逐步掌握包创建技巧。
- **食谱与源码管理**：支持将食谱和源码放在不同或相同的仓库中。
- **二进制打包**：允许将现有二进制文件打包为 Conan 包。
- **ABI 兼容性**：定义和检查二进制兼容性。
- **高级功能**：支持多种打包方法和依赖图分析。

---

## 6. 新功能与改进
### 重要新功能
1. **并行下载**：新增 `general.parallel_download` 配置，支持并行下载二进制文件，加速缓存填充。
2. **Meson 测试与安装**：新增 `meson_test()` 和 `meson_install()` 方法，支持 Meson 工具链。
3. **V2 模式**：通过 `CONAN_V2_MODE` 环境变量启用 Conan v2 行为。
4. **依赖图清理**：新增 `conan graph clean-modified` 命令，清理锁文件的修改状态。
5. **Python 依赖升级**：将 `six` 依赖升级至 1.14.0。
6. **新命令**：新增 `conan source` 命令，直接执行食谱的 `source()` 方法。

### 性能与稳定性改进
- **错误修复**：修复了多项与依赖解析、编译器配置和环境变量相关的 bug。
- **兼容性提升**：支持更多平台（如 ppc64le 和 AArch64）和编译器（如 GCC 8.3、9.1）。
- **日志与输出**：改进了错误和警告的输出，支持将日志输出到标准错误。

### 其他改进
- **上传与下载**：支持重试机制，优化网络连接问题处理。
- **CI 支持**：新增 `conan source` 命令，适合 CI 环境并行构建。
- **环境变量**：新增 `CONAN_V2_MODE` 环境变量，支持实验性 v2 行为。

---

## 7. 兼容性与稳定性
- **向后兼容**：Conan 1.23 不会破坏 1.0 版本的食谱和命令。
- **反馈机制**：用户可通过 GitHub 提交问题和建议。

---

Conan 1.23 版本在功能、性能和用户体验方面均有显著提升，推荐所有用户升级以体验最新特性。