Conan 1.50 Documentation

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

摘要

文档详细介绍了Conan 1.50版本的更新内容，包括改进和新增功能如文件夹删除、pip安装、PyInstaller支持、MD5校验及 mới GCC版本。同时新增了CI支持和人性化的下载进度显示。文档还包括了对社区贡献的Cheatsheet的描述，涵盖了包配置、使用、搜索、创建等内容。此外，迁移指南部分详细说明了从Conan 1.X到2.0的enser兼容更改，包括配置变更、 Profiles调整以及新功能CONAN_V2_MODE带来的更新。

AI总结

以下是对《Conan 1.50 Documentation》的中文总结，重点突出核心观点和关键信息，语言简洁明了，逻辑连贯：

---

### Conan 1.50 主要更新与改进

#### 新增功能
1. **新生成器与安装方式**
- 新增 `qmake` 生成器（感谢 @dragly）。
- 支持通过 `pip install conan` 安装。
- 提供 `pyinstaller` 代码，方便从 Python 源代码创建二进制文件，分发包制作更简单。

2. **工具与安全性**
- 添加 `md5`、`sha1`、`sha256` 工具，用于验证 `conanfile.py` 中的外部下载。
- 在默认设置文件 `settings.yml` 中添加最新的 GCC 版本。

3. **CI 支持与用户体验**
- 增加了 Travis-CI 和 Appveyor 的 CI 支持，利于 Conan 的开发。
- 提升下载进度和帮助信息的可读性。

4. **依赖管理与编译**
- 新增编译器检测算法，通过编译器的内置宏定义检测编译器和版本（适用于 `CONAN_V2_MODE`）。
- 建立包名称规则统一化，避免之前的生成器特殊处理。

---

#### 功能改进
1. **文件操作与权限**
- 改进文件夹删除逻辑，使用 `shutil.rmtree`，减少因权限问题导致的手动删除操作，尤其在 Windows 上表现更好。

2. **构建与缓存**
- 构建助手（如 `build_type` 和 `compiler` 未定义时）会抛出错误，避免潜在问题。
- 优化包缓存逻辑，提升稳定性。

3. **搜索与introspection**
- 搜索功能支持 `--json` 输出，便于解析和自动化处理搜索结果。
- 优化搜索结果的排版和可读性。

---

#### 社区贡献与文档
1. **便捷表与快速参考**
- 提供 PDF 和 PNG 格式的简明便捷表，方便用户打印和使用。
- 社区贡献的扩展便捷表包含日常操作的工作流摘要，涵盖安装、配置、包创建、依赖管理等内容。

2. **迁移指南**
- 提供从 Conan 1.x 到 2.0 的迁移指南，明确弃用功能和行为变化。

---

#### 弃用与行为变化
1. **弃用功能**
- 禁止在 `conanfile::source()` 方法中访问 `self.settings` 和 `self.options`。
- 弃用 `tools.msvc_build_command` 和 `tools.build_sln_command`，建议使用更现代的构建工具。
- 弃用环境变量 `CONAN_USERNAME` 和 `CONAN_CHANNEL`。

2. **行为变化**
- `CONAN_V2_MODE` 下，`self.info` 在 `conanfile.package()` 中不可访问。
- `default_options` 必须为字典类型。
- `cpp_info.cppflags` 弃用，建议使用 `cxxflags`。
- 取消自动加入 `PYTHONPATH` 到环境变量。

---

#### 其它变更
1. **包管理**
- 包名称规则统一化，之前的特殊处理已移除。
- 包 ID 计算模式与依赖冲突解决逻辑优化。

2. **平台支持**
- 新增对 macOS 和 Linux 的更好支持，覆盖更多编译器版本。

3. **错误修复**
- 修复了多个 minor bug，提升整体稳定性。

---

### 总结
Conan 1.50 版本在功能、性能和用户体验方面均有显著提升，新增了更多便捷的安装方式和开发工具，优化了依赖管理和编译逻辑，同时明确了部分功能的弃用和行为变化，帮助用户更好地迁移和适应新版本。