Conan 1.21 Documentation

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

摘要

文档详细列出了Conan 1.21版本的更新日志，包括修复多个Bug、新增功能以及对现有功能的改进。主要更新包括修复了元数据文件的并发访问问题、虚拟环境脚本的兼容性问题、上传功能的异常处理改进、新增qmake生成器、支持现代CMake接口、增强查询功能、添加描述字段、改进CI支持等。文档还介绍了如何通过环境变量和配置文件进行定制化设置，以及对依赖管理、版本控制和构建过程的优化。

AI总结

### Conan 1.21 Documentation Summary

Conan 1.21 is a release that introduces several bug fixes, new features, and improvements to enhance the functionality and usability of the Conan package manager. Below is a concise summary of the key updates:

---

#### **Version Updates**
- **1.21.3 (03-Mar-2020)**
- Bug fixes:
- Metadata file locking system for concurrent access.
- Dirty state management for cache package folders.
- Virtualenv scripts now handle pure sh shells.
- Upload process now reports exceptions to prevent silent failures.
- Added `system_libs` support for the premake generator.

- **1.21.2 (31-Jan-2020)**
- Bug fixes:
- Fixed recipe substitution for SCM multiline comments in Python 3.8.
- Resolved compression issues with `.tgz` files in Python 3.8.
- Prevented overwriting of user-defined libraries in CMake generator.

- **1.21.1 (14-Jan-2020)**
- Bug fixes:
- Improved `options` type detection.
- Fixed issues in CMake and CMake Multi generators.
- Virtualenv generator now handles backslashes correctly.

- New features:
- Added `qmake` generator.

---

#### **New Features**
- **General Improvements:**
- Enhanced folder deletion using `shutil.rmtree` for better permissions handling, especially on Windows.
- Released Conan as a pip package: `pip install conan`.
- Added precompiled binaries for Conan development via PyInstaller.
- Introduced `md5`, `sha1`, and `sha256` helpers for verifying external downloads.

- **CI and Development:**
- Added CI support for Travis-CI and AppVeyor.
- Enhanced SSL verification with support for self-signed certificates.

- **Generator and Tool Improvements:**
- Added `qmake` generator.
- Added `strip` parameter to `tools.patch()`.
- Improved compatibility with modern CMake and advanced queries.

- **Profiles and Settings:**
- Added support for custom paths in profiles.
- Introduced a `description` field for package documentation.
- Added `profile list|show` command for managing profiles.

---

#### **Versioning and Dependency Management**
- **Fixed Versions:**
- Specify exact versions using `requires = "pkg/1.2.11@user/stable"`.
- Allows deterministic builds but requires manual updates for new versions.

- **Version Ranges:**
- Use ranges like `requires = "pkg/[>1.0 <1.8]@user/stable"`.
- Automatically selects the latest version within the range, reducing manual updates.

- **Package Revisions:**
- Allows resolving the latest revision for a fixed version, streamlining dependency updates.

---

#### **Environment Variables**
- Key environment variables:
- `CONAN_COMPRESSION_LEVEL`: Default is 9. Adjust for faster compression at the cost of size.
- `CONAN_CPU_COUNT`: Default is the number of available cores.
- `CONAN_NON_INTERACTIVE`: Set to `True` to disable interactive prompts.
- `CONAN_ENV_XXXX_YYYY`: Override default settings (e.g., `CONAN_ENV_COMPILER = "Visual Studio"`).

---

#### **Key Features**
- Improved dependency resolution and build processes.
- Enhanced support for cross-platform development (e.g., FreeBSD).
- Better error handling and user feedback.
- Streamlined workflows for package creation and management.

---

This release of Conan 1.21 focuses on stability, compatibility, and usability, with a strong emphasis on resolving edge cases and improving the overall developer experience.