Conan 1.57 Documentation

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

摘要

文档阐述了Conan 1.57版本的功能、配置和变更，包括Packages的使用与管理，Profiles的创建与应用，Community贡献以及兼容性问题。文档还涉及Revisions的默认启用，对包管理和版本控制的影响，并提供了详细的配置方法和命令释例。

AI总结

### 《Conan 1.57 Documentation》中文总结

《Conan 1.57 Documentation》文档涵盖了Conan包管理工具的主要功能、社区贡献、版本变更、配置管理以及迁移指南等内容。以下是文档的核心观点和关键信息：

---

### 1. 功能概述
Conan是一个专为C/C++设计的包管理工具，支持多平台、多构建系统和多编译器。其核心功能包括：
- **包的消费与创建**：支持在应用中使用包、下载包、管理本地缓存，以及创建和配置包。
- **包的搜索与 introspecting**：提供包搜索、依赖可视化和包内容检查功能。
- **配置管理**：通过配置文件管理设置、选项、环境变量和构建需求。
- **社区贡献**：文档和工具由社区共同完善，提供了扩展的使用指南和工作流。

---

### 2. 版本变更（Changelog）
文档列举了以下重要更新：
- **新功能**：
- 支持现代CMake，包括INTERFACE和IMPORTED目标。
- 提供更高级的搜索查询。
-新增`profile list`和`profile show`命令，方便管理配置文件。
- 初步支持FreeBSD。
- 增加了包描述字段，用于记录包内容。
- **改进和修复**：
- 修复了使用版本范围和`requirements()`方法时的重复依赖问题。
- 修复了`conan install --all`生成损坏包的问题。
- 支持自定义SSL证书验证，允许使用自签名证书。
- 优化了conda.io官方包页面，增加了描述字段。

---

### 3. 配置管理
- **Profiles配置文件**：
- 配置文件允许用户设置构建和主机环境的配置，包括设置、选项、环境变量和构建需求。
- 配置文件可以通过`conan profile new`创建，并在构建命令中使用`--profile`选项引用。
- 示例配置文件结构：

    [settings]
    os=Windows
    arch=x86_64
    compiler=Visual Studio
    
    [options]
    MyLib:shared=True
    
    [env]
    env_var=value

- **包 introspecting**：
- 使用`conan inspect`命令检查包的详细信息，例如许可证、URL、构建选项等。
- 支持通过`--json`参数输出结果，便于脚本化处理。

---

### 4. 迁移指南（Migration Guide）
文档提出了从Conan 1.x到2.0的主要变化：
- **移除功能**：
- 移除了`conan package`和`conan copy`命令。
- 包将变得不可变，传统的`conan copy`命令将不再可用。
- **新增功能**：
- 默认启用版本（Revisions）管理，支持多个包版本和修订。
- 引入构建和主机配置文件（Host and Build profiles），需要显式指定`-pr:b`参数或在全局配置中启用。
- **兼容性**：
- Conan 2.0将不再支持Python 2，建议用户尽快升级到Python 3。
- 公共仓库如ConanCenter默认使用最新版本的Conan客户端，旧版本可能导致包构建失败。

---

### 5. 社区与支持
- Conan广泛应用于生产环境，用户包括Audi、Continental、Plex等企业。
- 社区贡献活跃：
- [GitHub仓库](https://github.com/conan-io/conan)获得了超过3.5K个星标。
- 许多开发者为ConanCenter（官方包仓库）贡献了包定義。
- 社区成员通过Slack等平台提供技术支持和讨论。

---

### 6. 次世代版本（Conan 2.0）
Conan 2.0即将发布，重点包括：
- **向后兼容性**：新版本的包和配方可能与旧版本不兼容，需参考迁移指南。
- **新功能**：更多集成解决方案，尤其是针对IDE（如Visual Studio和CLion）的支持。

---

### 总结
本文档全面介绍了Conan 1.57的功能、版本更新、配置管理和未来发展方向。用户可以通过内置的工具和社区资源快速上手并高效管理C/C++依赖包。同时，文档强调了迁移到2.0版本的必要性，并为用户提供了详细的迁移指南。