Conan 1.27 Documentation

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

摘要

文档详细介绍了Conan 1.27版本的更新内容，包括新功能和修复的bug。主要更新包括对现代CMake的支持、改进的查询功能、新的下载缓存机制、对FreeBSD的初步支持以及改进的配置文件管理。文档还提到了对Python 2的弃用通知，并鼓励用户升级到Python 3。此外，版本更新日志中详细记录了多个bug的修复和功能的增强。

AI总结

### Conan 1.27 Documentation Summary

Conan 1.27 introduces several new features and bug fixes, enhancing its functionality and usability as a dependency management tool. Below is a concise summary of the key updates and changes:

---

#### **New Features**
1. **Modern CMake Support**
- Added support for modern CMake with `INTERFACE IMPORTED` targets defined per package.

2. **Advanced Query and Search**
- Enhanced search functionality for more advanced queries.

3. **Profile Management**
- Introduced `profile list` and `profile show` commands to list or display details of profiles.

4. **FreeBSD Support**
- Added preliminary support for FreeBSD.

5. **Package Description Field**
- Added a new `description` field to document package contents.

6. **Imports Manifest and Undo Functionality**
- Added support for generating an imports manifest and an `--undo` option to remove imported files.

7. **SSL Certificate Verification**
- Optional SSL certificate verification for remotes, allowing self-signed certificates.

8. **Custom Paths in Profiles**
- Profiles can now include custom paths, enabling easier sharing within teams or repositories.

9. **User and Channel Fields**
- Introduced `user` and `channel` fields in Conan recipes to declare requirements for the same user/channel.

10. **Improved Conan.io Integration**
- Enhanced the Conan package web interface with better description support.

11. **CMake Helper Improvements**
- Allowed modification of the CMake generator in the CMake helper class.

12. **Patch Utility Enhancement**
- Added a `strip` parameter to the `tools.patch()` utility.

13. **Download Cache**
- Introduced an experimental download cache to reduce time for populating the Conan package cache. This cache stores downloaded artifacts, including Conan files and zipped artifacts, and is configurable via `conan.conf`.

14. **Linting Support**
- Added a plugin for `pylint` to handle dynamic fields in Conan recipes, improving code quality checks.

15. **Workspace Support**
- Added support for Conan workspaces, enabling better project organization.

16. **System Libraries in CMake**
- Added system libraries to the `cmake_find_package` generator.

17. **SIGTERM Signal Handler**
- Added a signal handler to quit safely.

18. **Improved Compiler and Platform Detection**
- Enhanced detection of compilers (e.g., GCC, Clang) and platform-specific issues.

19. **C++20 Standard Support**
- Improved support for C++20 standard usage with modern compilers.

20. **Case Sensitivity and File Management**
- Improved case-sensitive folder management and handling of directory names on Windows.

---

#### **Bug Fixes**
1. **Duplicate Requirements**
- Fixed an issue where duplicate requirements were declared in `conanfile`.

2. **Corrupted Packages**
- Resolved an issue where `conan install --all` generated corrupted packages.

3. **ConfigureEnvironment Helper**
- Fixed the `ConfigureEnvironment` helper to correctly handle the `libcxx` setting.

4. **Crashes and Errors**
- Fixed crashes related to duplicate requires, imported files with symlinks, and missing options in the web interface.

5. **Checksum Handling**
- Improved checksum validation for cached downloads, ensuring artifacts are correctly cached even with revisions.

6. **Windows Line Endings**
- Fixed incorrect line endings in Windows for `conan.conf`.

7. **Link Order and Private Requirements**
- Corrected link order issues with private requirements.

8. **Duplicate `-std` Flags**
- Removed duplicate `-std` flags for CMake versions below 3.0.

9. **Build Type Detection**
- Fixed misdetection of GCC 1 on Linux systems.

10. ** SCM Tool Warnings**
- Modified confusing warning messages for SCM tools when remotes couldn’t be detected.

---

#### **Key Improvements**
- **Python 2 Deprecation**
- Conan 1.27 and later versions no longer support Python 2. Users are strongly encouraged to upgrade to Python 3.

- **Cross-Platform Compatibility**
- Conan continues to support all platforms, build systems, and compilers, ensuring compatibility with the latest Conan client versions.

- **Community and Integration**
- Conan is widely used by companies like Audi, Continental, and Mercedes-Benz, with an active community contributing recipes and improving functionality.

---

#### **Installation and Usage**
- **Upgrade Instructions**
- Conan can be updated using `pip install conan --upgrade` or by downloading the latest installer.

- **Python 2 Compatibility Notice**
- New features in Conan 1.27 and later are only available in Python 3. Python 2 support was deprecated in Conan 1.22 and removed in Conan 2.x.

- **Testing and Configuration**
- Users can test their Conan scripts and regenerate settings by removing the `settings.yml` file.

---

This summary highlights the major updates and improvements in Conan 1.27, focusing on new features, bug fixes, and compatibility changes. For detailed information, refer to the full documentation at [conan.io](https://conan.io).