Conan 1.13 Documentation

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

摘要

文档详细介绍了Conan 1.13版本的更新内容，包括多个bug修复和新功能的添加。主要更新包括：支持Python 3的.deb和Windows安装程序、允许通过conan.conf配置不同的默认package_id模式、使用Jinja2处理布局文件、支持传递PackageReference到conan get命令、重新实现基于可编辑包的工作区等功能。文档还强调了向后兼容性，确保1.13版本不会破坏1.0版本的配方或命令行调用，并提供了如何激活修订功能和配置选项的说明。

AI总结

### Conan 1.13 版本更新总结

#### 1. 版本更新日志（Changelog）
- **1.13.3 (2019-03-27)**
- 修复了Git仓库存在但无提交时计算修订版本失败的问题（#4830）。
- 修复了使用“update”和“build outdated”选项安装引用时的异常（#4790）。
- 修复了构建依赖和工作区指定布局时的崩溃问题（#4783）。

- **1.13.2 (2019-03-21)**
- 修复了构建依赖的递归处理问题（#4737）。

- **1.13.1 (2019-03-15)**
- 新增`with_login`参数到`tools.run_in_windows_bash()`（#4673）。
- Conan的.deb和Windows安装程序现在使用Python 3（#4663）。
- 允许通过`conan.conf`配置默认的`package_id`模式（#4644）。
- 支持将Jinja2应用于布局文件（#4596）。
- 支持传递`PackageReference`到`conan get`命令（#4494）。
- 重构工作区基于可编辑包（#4481）。
- 新增QMake生成器（贡献者：@dragly）。

- **1.13.0 (2019-03-07)**
- 改进文件夹删除逻辑，避免权限问题。
- 支持通过Pip安装Conan：`pip install conan`。
- 提供PyInstaller二进制文件，便于创建Conan应用包。
- 新增`md5`、`sha1`、`sha256`校验工具。
- 更新默认`settings.yml`中的gcc版本。
- 支持Travis-CI和AppVeyor的CI集成。
- 提升下载进度和帮助信息的可读性。

#### 2. 包修订功能
- **激活修订功能**：
- 在`conan.conf`中添加`revisions_enabled=1`，或设置环境变量`CONAN_REVISIONS_ENABLED=1`。
- **注意事项**：
- 启用修订后，旧二进制包可能无法与新修订的食谱兼容，需重新生成和上传二进制包。
- **服务器支持**：
- `conan_server`版本需>=1.13。
- Artifactory和Bintray支持即将推出。

#### 3. 命令行变化
- 从0.X升级到1.0时，命令行参数发生变化：
- 主要命令（如`conan install`、`conan export`、`conan create`）不再使用`--path`和`--file`，改用当前目录或文件路径。
- 参数使用短横线（`-`）替代下划线（`_`）。

#### 4. 配置钩子
- 钩子用于扩展Conan功能，可通过以下方式管理：
- 使用`conan config set`命令激活钩子（如`conan config set hooks.my_custom_hook/hook`）。
- 钩子可存放在`~/.conan/hooks`目录的Git仓库中。
- **官方钩子**：
- `attribute_checker`钩子默认启用，用于检查食谱是否缺少必要元数据（如`url`、`license`、`description`）。

#### 5. 其他改进
- 提供了更详细的文档和改进的用户体验，包括：
- 支持更多语言和操作系统的构建生成。
- 改进测试包的生成和安装流程。
- 支持自定义路径和用户/渠道字段。

总结：Conan 1.13版本在功能、性能和兼容性方面均有显著提升，新增了多项实用功能（如修订支持、Python 3兼容、CI集成等），同时修复了多个关键问题，提升了用户体验。