Conan 1.47 Documentation

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

摘要

文档介绍了Conan 1.47版本的主要更新内容，包括移除文件夹的改进、创建pip包功能、发布pyinstaller代码以生成二进制包、添加哈希验证工具、更新默认设置文件以及新增CI支持（Travis-CI和Appveyor）。此外，还提到了对依赖管理、配置文件和环境变量的改进，以及修复了一些已知问题。

AI总结

### Conan 1.47 版本更新总结

#### 1. 新功能与改进
- **新功能**：
- **qmake 生成器**：新增 `qmake` 生成器（由 @dragly 贡献）。
- **PyInstaller 支持**：支持通过 PyInstaller 生成二进制文件，便于为 Conan 应用创建包。
- **CI 支持**：新增 Travis-CI 和 AppVeyor 的 CI 支持。
- **哈希工具**：新增 `md5`, `sha1`, `sha256` 帮助程序，用于验证外部下载资源。
- **版本兼容性**：新增 `user` 和 `channel` 字段，支持在配方中声明相同用户/通道的需求。
- **描述字段**：新增 `description` 字段，用于文档化包内容。

- **改进**：
- **文件夹删除**：改进 `shutil.rmtree` 的使用，避免因权限问题导致手动删除。
- **下载进度与帮助信息**：提升下载进度的可读性和帮助消息的友好性。
- **配置文件**：默认 `settings.yml` 中添加了最新版本的 GCC 支持。
- **Windows 支持**：改进了 Windows 系统下的文件夹管理（如大小写敏感性）。

#### 2. 已知问题与修复
- **问题修复**：
- 修复了使用版本范围和 `requirements()` 方法时的重复需求问题。
- 修复了 `ConfigureEnvironment` 忽略 `libcxx` 设置的问题。
- 修复了 `conan install --all` 生成损坏包的问题。
- 修复了 Windows 下 `conan.conf` 中换行符的问题。
- 解决了环境变量 `PYTHONPATH` 不自动添加的问题。

- **其他改进**：
- 支持更复杂的查询操作。
- 支持 FreeBSD 的初步兼容性。
- 支持通过 `--json` 格式输出搜索结果。

#### 3. 扩展与集成
- **自定义生成器**：
- 可通过两种方式贡献生成器：
1. 直接在 Conan 代码库中添加（内置生成器）。
2. 创建自定义 Conan 包并上传到仓库。
- **扩展 Conan**：
- 提供了与外部工具集成的机制，如通过 `Extending Conan` 部分进一步扩展功能。

#### 4. 兼容性与稳定性
- **Python 支持**：
- Conan 需要 Python 3 运行，不再支持 Python 2（自 1.22.0 版本起不再保证兼容性）。
- **版本兼容性**：
- 新功能和 API 的引入可能导致与旧版本的 Conan 不兼容，建议使用最新版本的 Conan 客户端以确保兼容性。

#### 5. 社区与资源
- **社区贡献**：
- Conan 在 GitHub 上拥有超过 3.5K 的スター，并吸引了近 200 名贡献者。
- 社区为 ConanCenter 贡献了大量开源库的配方。
- 超过 1000 名用户活跃于 CppLang Slack 的 #conan 频道，提供帮助和支持。

#### 6. 命令行工具
- **搜索功能**：
- 支持通过 `conan search` 命令搜索远程仓库中的包，并可输出 JSON 格式结果。
- **其他命令**：
- 支持通过 `--json` 格式输出搜索结果。
- 支持通过 `conan profile` 命令管理配置文件。

#### 7. 弃用与新规则
- **弃用**：
- 弃用 `self.info` 在 `conanfile.package()` 中的使用。
- 弃用 `tools.msvc_build_command`, `tools.build_sln_command` 等工具。
- 弃用 `cpp_info.cppflags`，建议使用 `cxxflags` 替代。
- 弃用环境变量 `CONAN_USERNAME` 和 `CONAN_CHANNEL`。
- **新规则**：
- 禁止在 `source()` 方法中使用 `self.settings` 和 `self.options`。
- 新的 `CONAN_V2_MODE` 检测算法通过编译器的宏定义检测编译器版本。

#### 8. 其他
- **文档**：
- 提供 PDF 和 PNG 格式的扩展 Cheat Sheet，便于用户快速查阅。
- **版本检测**：
- 新增对 `cppstd` 的检测，若检测到在配方中使用 `cppstd`，将触发错误。

总结来看，Conan 1.47 版本在功能、性能和用户体验方面均有显著提升，特别在生成器、CI/CD 支持、资源验证和社区生态方面表现突出。