Conan 1.18 Documentation

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

摘要

文档详细记录了Conan 1.18版本及其后续更新的变更日志，包括新功能的添加、问题的修复以及对不同环境和工具的兼容性改进。每个版本都列出了新增功能、bug修复以及对特定工具和平台的支持提升，例如CMake、Meson构建系统和Apple Clang等。文档还涵盖了对Python 3的支持、生成器包的使用、锁定文件机制的引入以及对Docker和CI/CD集成的支持。

AI总结

### Conan 1.18 文档总结

#### 1. **简介**
- **开源**：Conan 是一个开源的依赖管理工具。
- **去中心化包管理器**：支持通过远程仓库或本地仓库管理依赖。
- **二进制管理**：能够管理二进制文件，确保构建的可重复性。
- **跨平台支持**：支持多种操作系统和构建系统（如 CMake、Meson、Visual Studio 等）。
- **稳定性**：提供稳定且可靠的依赖管理。

#### 2. **安装**
- **推荐安装方式**：使用 pip 安装（`pip install conan`）。
- **其他安装方式**：
- macOS 使用 Homebrew：`brew install conan`。
- Arch Linux 使用 AUR：`yay -S conan`。
- 下载二进制文件安装。
- **初始配置**：可通过 `conan config` 命令进行配置。
- **更新**：使用 `conan update` 更新到最新版本。
- **从源码安装**：适合开发者或需要特定版本的用户。

#### 3. **使用**
- **依赖管理**：
- 使用 `conan install` 安装依赖。
- 使用 `conan search` 搜索包。
- 使用 `conan inspect` 检查依赖信息。
- **配置文件**：通过 profiles 管理不同环境的配置。
- **工作流程**：支持 CI/CD 和构建系统集成。

#### 4. **创建包**
- **基本流程**：
- 编写 `conanfile.py` 或 `conanfile.txt` 定义依赖和配置。
- 使用 `conan create` 或 `conan package` 打包。
- **高级功能**：
- 支持从源码或现有二进制文件生成包。
- 定义包的 ABI 兼容性。
- 使用 `conan test` 验证包。
- **工具**：
- 提供 `conan source` 和 `conan build` 等命令简化流程。
- 支持 `recipe_revision_mode` 和 `package_revision_mode` 确保版本一致性。

#### 5. **上传包**
- **锁定文件机制**：通过锁定文件（`lockfiles`）确保依赖版本的可追溯性。
- **上传工具**：支持将包上传到远程仓库（如 Artifactory、Conan Center 等）。

#### 6. **变更日志**
- **重要更新**：
- **1.17.0**：新增锁定文件机制、改进 UX、支持 `tqdm` 进度条。
- **1.18.0**：支持 `recipe_revision_mode` 和 `package_revision_mode`，增强二进制 ID 的确定性。
- **0.28.0**：重构命令行工具，支持并行构建和新生成器（如 `pc` 和 `Meson`）。
- **0.9.2**：改进性能，移除慢的更新检查，默认移除 `check_updates`。
- **修复**：
- 解决 Windows 环境下路径问题。
- 修复 `conan info` 和 `conan install` 的兼容性问题。
- 改进 `search` 命令的输出格式。

#### 7. **参考**
- **命令**：包括 `conan install`、`conan build`、`conan test` 等。
- **配置文件**：`conanfile.py` 和 `conanfile.txt` 的结构和用法。
- **生成器**：支持自定义生成器扩展功能。
- **环境变量**：如 `CONAN_COLOR_DISPLAY` 和 `CONAN_READ_ONLY_CACHE` 等。
- **FAQ 和视频链接**：提供常见问题解答和技术文档。

#### 8. **核心优势**
- **可重复性**：通过锁定文件确保构建过程的可重复性。
- **灵活性**：支持多种构建系统和依赖管理方式。
- **扩展性**：允许通过生成器和钩子（hooks）扩展功能。
- **社区驱动**：依赖于活跃的开源社区贡献和反馈。

总结：Conan 1.18 提供了强大的依赖管理和包构建功能，支持跨平台、多种构建系统和灵活的配置方式，适合用于大型项目的依赖管理和 CI/CD 流程。