Conan 1.16 Documentation

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

摘要

文档详细介绍了Conan 1.16版本的更新内容，包括新功能、改进和修复。主要更新包括支持通过pip安装Conan，改进了构建系统和依赖管理，修复了文件删除权限问题，新增了CI支持（Travis-CI和Appveyor），以及对更多操作系统的支持。文档还提供了命令参考和返回码信息，帮助用户更好地理解和使用Conan。

AI总结

### Conan 1.16 文档总结

#### 新功能与改进
1. **新功能**
- **qmake 生成器**：新增 `qmake` 生成器，支持 Qt 项目。
- **CI 支持**：新增 Travis-CI 和 AppVeyor 的 CI 支持。
- **MD5/SHA 帮助工具**：新增 `md5`, `sha1`, `sha256` 帮助工具，用于验证外部下载文件的完整性。
- **现代 CMake 支持**：支持使用现代 CMake 的 `INTERFACE IMPORTED` 目标。
- **高级查询支持**：支持更复杂的搜索查询。
- **新命令**：新增 `profile list` 和 `profile show` 命令，用于管理配置文件。
- **FreeBSD 支持**：初步支持 FreeBSD 系统。
- **描述字段**：新增 `description` 字段，用于文档化包内容。
- **导入功能**：支持生成 `imports manifest` 和 `conan imports --undo` 功能。
- **SSL 验证**：支持可选 SSL 证书验证，允许使用自签名证书。
- **自定义路径**：支持在配置文件中使用自定义路径。
- **用户和渠道字段**：新增 `user` 和 `channel` 字段，用于声明用户/渠道范围的依赖。

2. **改进**
- **删除文件夹**：改进 `shutil.rmtree` 的使用，避免因权限问题导致删除失败。
- **安装流程**：改进 `conan install --all` 的流程，避免生成损坏的包。
- **构建策略**：改进对长路径的支持，特别是在 Windows 系统上。
- **帮助信息**：提升下载进度和帮助信息的可读性。
- **生成工具**：`tools.get()` 现在支持指定目标文件夹。
- **系统包工具**：改进 `SystemPackageTool`，默认启用 `--no-install-recommends`。

3. **移除的功能**
- **弃用 `conanfile_directory`**：不再支持 `conanfile_directory`，建议使用 `source_folder`, `build_folder` 等替代方案。
- **移除 `ConfigureEnvironment` 和 `GCC` 构建助手**：这些工具已完全移除。
- **移除 `test_package` 命令**：建议使用 `conan create` 和 `conan test` 替代。

4. **已知问题与限制**
- **werror 行为**：默认启用 `werror` 行为，依赖冲突时会报错。
- **Python 2 兼容性**：未来新功能将主要针对 Python 3，建议尽快升级到 Python 3。
- **范围依赖问题**：使用版本范围和 `requirements()` 方法时，可能存在重复依赖问题。

5. **其他**
- **PyInstaller 支持**：支持通过 PyInstaller 生成二进制文件，便于包构建。
- **许可证信息**：新增对许可证信息的管理，支持 MIT 许可证等。
- **配置文件管理**：改进 `settings.yml` 的迁移和管理，支持新 VS 工具集。
- **远程依赖**：支持通过远程仓库管理依赖，提升依赖管理的灵活性。

总结来看，Conan 1.16 版本在功能扩展、性能优化和用户体验改进方面有显著提升，同时对部分旧功能进行了调整和移除，建议用户及时升级并参考文档调整使用习惯。