Conan 1.51 Documentation

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

摘要

文档介绍了Conan 1.51版本的更新内容，包括改进的删除文件夹机制、通过pip安装Conan、支持PyInstaller创建二进制文件、添加了多个安全哈希帮卷 проверки、更新了默认GCC版本、增加了CI支持、提升了下载进度和帮助消息的可读性。同时文档记录了Conan从1.x迁移到2.0版本的变更指南，涵盖了配置、依赖管理和兼容性等方面的调整。文档还包括详细的命令参考和环境变量说明，帮助用户更好地使用Conan进行包管理。版本历史（Changelog）详细列出了各个版本的功能改进和修复。

AI总结

以下是对《Conan 1.51 Documentation》的中文总结，重点突出核心观点和关键信息：

---

### 《Conan 1.51 Documentation》总结

#### 简要概述
这是一份关于Conan 1.51版本的更新日志和功能说明文档，涵盖了新功能、改进点、错误修复以及环境变量等内容。

---

#### 1. 新功能与改进
- **新功能**
- 新增qmake生成器（由@dragly贡献）。
- 支持通过`pip install conan`安装Conan。
- 提供PyInstaller代码，用于从Conan Python源代码创建二进制文件，方便分发包创建者打包。
- 在工具中添加了md5、sha1、sha256辅助功能，用于检查外部下载文件的完整性。
- 添加了最新的gcc版本到默认设置文件`settings.yml`。
- 增加了CI支持（Travis-ci、Appveyor）。
- 提升了下载进度和帮助信息的可读性。
- 提供了.HTML格式的用户 Migration 指南，便于用户快速参考。

- **改进**
- 使用`shutil.rmtree`改进了文件夹的删除操作，解决了因权限问题导致的失败问题，尤其在Windows上效果显著。
- 优化了搜索功能，支持更复杂的查询。
- 添加了初步的FreeBSD支持。
- 支持自定义证书的SSL验证。
- 支持在配置文件中添加描述字段，便于文档化包 contents。
- 改进了CMake生成器的兼容性。

---

#### 2. 错误修复
- 修复了`conan install --all`生成损坏包的问题。
- 修复了`conanfile.py`中使用版本范围和`requirements()`方法导致的重复依赖问题。
- 解决了在测试套件中自动使用`txt`和`env`生成器的问题。
- 修复了Windows上因换行符导致的错误。

---

#### 3. 社区贡献
- 社区贡献者提供了一份扩展的cheatsheet，涵盖了以下内容：
- 配置与安装。
- 包的创建与使用。
- 包的搜索与依赖可视化。
- 包管理的最佳实践。
- 包ID模式的计算与依赖冲突的解决。

---

#### 4. 环境变量与其他更改
- **环境变量**
- `CLICOLOR`：控制控制台输出颜色，默认值未定义。
- `CLICOLOR_FORCE`：强制启用控制台输出颜色。
- `NO_COLOR`：禁用控制台输出颜色。
- `CONAN_COLOR_DARK`：设置暗黑模式的输出颜色，默认为`False`。
- `CONAN_COMPRESSION_LEVEL`：用于调整.tgz压缩级别，默认值为9。
- `CONAN_V2_MODE`：启用Conan 2.0兼容性模式。

- **其他更改**
- 移除了对`self.info`在`conanfile.package()`中的访问。
- 强制要求`default_options`为字典。
- 禁止在`conanfile::source()`方法中使用`self.settings`和`self.options`。
- 弃用了`tools.msvc_build_command`和`tools.build_sln_command`。
- 弃用了`cpp_info.cppflags`，建议使用`cxxflags`。
- 弃用了环境变量`CONAN_USERNAME`和`CONAN_CHANNEL`。

---

#### 5. 测试与兼容性
- 提供了测试命令`conan profile list|show`，用于列表或显示配置文件详情。
- 新增了对.lockfiles的支持，用于加快依赖解析速度。
- 分析了包ID模式的计算与依赖冲突的解决方法。

---

#### 6. 安装与使用
- 支持通过`pip install conan`安装。
- 提供了用户手册的HTML和PNG格式文档，便于快速参考。

---

以上是《Conan 1.51 Documentation》的核心内容总结，重点涵盖了新功能、改进、错误修复和环境变量等关键信息。