Conan 1.46 Documentation

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

摘要

文档介绍了Conan 1.46版本的功能和更新，包括新功能、bug修复以及版本兼容性。重点介绍了如何安装、使用、创建和上传包，以及如何扩展和集成Conan到其他系统中。文档还详细列出了不同平台和构建系统的支持，强调了Conan的稳定性和社区支持。

AI总结

以下是《Conan 1.46 Documentation》的中文总结：

---

### **Conan 1.46 版本文档总结**

#### **1. 简介**
- **开源**：Conan 是一个开源的包管理工具。
- **分布式包管理器**：支持去中心化的包管理。
- **二进制管理**：能够高效管理二进制文件。
- **多平台支持**：支持所有平台、构建系统和编译器。
- **稳定性**：版本更新遵循稳定性承诺，确保兼容性。
- **社区驱动**：依赖社区贡献和协作。

#### **2. 快速上手**
- **安装依赖**：通过 `conan install` 安装项目所需的依赖。
- **依赖检查**：使用 `conan inspect` 查看依赖信息。
- **搜索包**：通过 `conan search` 查找可用包。
- **其他配置**：支持其他构建配置。

#### **3. 安装指南**
- **推荐安装方式**：使用 `pip` 安装（`pip install conan`）。
- **其他平台**：
- macOS：使用 Homebrew 安装。
- Arch Linux：使用 AUR 安装。
- **初始配置**：安装后进行基本配置。
- **更新**：通过 `pip` 或其他方式更新 Conan。
- **源码安装**：支持从源码安装。

#### **4. 使用包**
- **安装依赖**：使用 `conan install` 下载和安装依赖。
- **配置文件**：支持通过配置文件（如 `global.conf`）进行全局配置。
- **工作流程**：支持定义工作流程，便于管理和调试。
- **调试**：提供调试功能，帮助排查问题。

#### **5. 创建包**
- **入门指南**：从简单的包开始，逐步学习创建流程。
- **食谱与源码**：支持将食谱和源码放在不同的仓库或同一仓库。
- **打包过程**：理解打包逻辑，定义包的ABI兼容性和元数据。
- **工具链**：支持通过工具链（如 CMake、Meson）进行构建。
- **包信息**：定义包的元数据，如 `PackageInfo` 和 `CppInfo`。

#### **6. 上传包**
- **远程仓库**：支持上传到远程仓库（如 Conan Center）。
- **Artifactory 集成**：提供对 Artifactory 的支持。
- **Conan 服务器**：支持自托管的 Conan 服务器。

#### **7. 开发包**
- **开发流程**：定义从开发到发布的完整流程。
- **包布局**：支持定义包的布局方式。
- **可编辑模式**：支持以可编辑模式管理包。
- **工作区**：通过工作区管理多个项目。

#### **8. 版本控制**
- **版本简介**：版本控制是 Conan 的核心功能。
- **版本范围**：支持定义版本范围和依赖关系。
- **包修订**：支持包修订（Package Revisions）。
- **锁定文件**：通过锁定文件（Lockfiles）管理依赖版本。

#### **9. 高级功能**
- **模板系统**：支持自定义模板，覆盖 Conan 的默认输出。
- **HTML 输出**：提供 HTML 表格输出，便于查看搜索结果。
- **并行上传**：改进并行上传功能，提升效率。
- **下载缓存**：支持共享下载缓存，提升性能。
- **环境变量管理**：支持通过 `env_info` 管理环境变量。

#### **10. 系统与交叉构建**
- **交叉构建**：支持在不同平台上进行交叉构建。
- **Windows 子系统**：支持 Windows 子系统（WSL）。

#### **11. 扩展 Conan**
- **自定义设置**：支持自定义设置（如 `settings.yml`）。
- **Python 要求**：支持定义 Python 版本要求。
- **钩子**：支持通过钩子（Hooks）自定义行为。
- **模板系统**：支持通过模板系统自定义输出。

#### **12. 集成**
- **CI/CD**：支持与 CI/CD 系统集成。
- **虚拟环境**：支持生成虚拟环境，便于工具安装和管理。
- **系统工具**：支持通过 Conan 安装系统工具（如 CMake、MinGW）。

---

### **变更日志（Changelog）**
- **1.46.2**：
- 修复了弃用导入检查的行号问题。
- 修复了苹果 clang 13 的 CMake 生成问题。
- **1.46.1**：
- 添加了对 Conan 2.x 的弃用导入检查功能。
- 支持苹果 clang 13 的主版本号。
- 支持 clang 15。
- **1.46.0**：
- 支持混合 1.X 和 2.0 二进制仓库的搜索。
- 支持 Jinja2 渲染 `global.conf` 文件。
- 支持通过 `PackageReference` 获取包信息。
- **其他版本**：包含更多功能改进和 bug 修复，如 Python 2 的弃用、下载缓存的改进等。

---

### **总结**
Conan 1.46 提供了强大的包管理功能，支持多平台、多构建系统和多种编译器，适用于开源项目和企业级开发。新版本优化了二进制管理、依赖搜索、远程仓库支持和版本控制功能，同时修复了多个已知问题，提升了稳定性和兼容性。