Conan 1.18 Documentation

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

摘要

《Conan 1.18 Documentation》记录了Conan 1.18版本及其后续更新的详细变更日志，包括修复的bug、新增的功能和改进。文档涵盖了多个版本的发布日期、修复的问题（如递归私有依赖、路径处理、字符编码等问题）以及新特性（如对现代CMake的支持、新增profile命令、对FreeBSD的支持等）。文档还提到了一些重要的注意事项和-breaking changes，确保用户能够顺利升级和使用新版本。

AI总结

### Conan 1.18 Documentation Summary

Conan 1.18版本的文档主要记录了从1.7.0到1.18.5版本之间的功能更新、修复和改进。以下是核心内容的总结：

---

#### **1. 主要功能更新**
1. **新功能**
- **支持现代CMake**：支持CMake的`INTERFACE IMPORTED`目标，增强CMake生成器的功能。
- **高级查询支持**：改进了对搜索功能的查询支持。
- **配置文件支持**：新增`profile list|show`命令，支持查看和管理配置文件。
- **初步支持FreeBSD**：增加了对FreeBSD平台的支持。
- **描述字段**：新增`description`字段，用于文档化包内容。
- **导入功能**：支持生成导入清单和撤销导入文件的功能。
- **SSL证书验证**：支持可选SSL证书验证，允许使用自签名证书。
- **自定义路径支持**：配置文件（profiles）可指定自定义路径，便于团队协作。
- **用户和渠道字段**：新增`user`和`channel`字段，允许在配方中声明用户/渠道范围的依赖。
- **改进生成工具**：新增`qmake`生成器，支持更多构建环境。
- **系统包工具改进**：`SystemPackageTool`（如`apt-get`）默认使用`--no-install-recommends`。
- **文件路径增强**：支持长路径（`short_paths`）在Windows默认启用。

2. **移除或变更的功能**
- **移除`scopes`**：不再支持`scopes`功能，建议使用环境变量或`conanfile.develop`属性。
- **移除`test_package`命令**：建议使用`conan create`和`conan test`替代。
- **`werror`行为默认启用**：依赖冲突将默认报错，需手动修复。
- **移除`conanfile_directory`**：建议使用`source_folder`、`build_folder`等替代。

---

#### **2. 重要问题修复**
1. **Bug修复**
- **排除模式与符号链接**：修复了`export_sources`排除模式中包含符号链接的问题。
- **递归依赖处理**：修复了递归依赖处理中的断言失败问题。
- **非ASCII字符路径**：修复了文件名包含非ASCII字符时的路径处理问题。
- **SCM功能增强**：修复了`scm`功能在子文件夹中查找仓库根路径的问题。
- **Windows子系统支持**：修复了`OSInfo.bash_path()`在无Windows子系统环境中的问题。
- **构建环境设置**：修复了`AutotoolsBuildEnvironment`在不同Linux发行版中的输出库目录问题。
- **文件下载错误处理**：修复了下载文件时的异常处理问题。
- **选项模式问题**：修复了使用版本范围和`requirements()`方法时的重复需求问题。
- **包ID生成**：修复了版本范围解析中未指定用户/渠道时的上传问题。

2. **性能和兼容性改进**
- **删除文件夹改进**：改进了`shutil.rmtree`的使用，避免权限问题，特别是在Windows中。
- **文件路径处理**：修复了文件路径的大小写敏感性问题。
- **构建工具改进**：修复了`ConfigureEnvironment`和`GCC`构建助手的移除问题。
- **生成器改进**：修复了生成器失败时的错误信息输出问题。

---

#### **3. 其他改进**
- **文档和用户体验**
- 改进了帮助命令的输出信息。
- 提供了更清晰的下载进度和错误信息。
- 更新了Python加密库的依赖（如`pyOpenSSL`）以支持更高版本的OSX。
- 修复了`conan_server`的编码问题。

- **CI支持**
- 新增了对Travis-CI和AppVeyor的CI支持。

- **二进制生成**
- 提供了使用`pip install conan`和PyInstaller生成二进制文件的功能。

---

#### **4. 注意事项**
- **兼容性**：Conan 1.18版本不会破坏1.0版本的配方或命令行使用。
- **弃用功能**：部分功能（如`scopes`和`test_package`）已移除或调整，请参考文档更新代码。

---

#### **5. 总结**
Conan 1.18版本在功能增强、性能优化和问题修复方面均有显著提升，特别在支持现代构建工具、改进依赖管理和增强跨平台兼容性方面表现突出。建议用户更新至最新版本以获得更好的开发体验。