Conan 1.16 Documentation

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

摘要

文档介绍了Conan 1.16版本的功能更新，包括安装方法、依赖管理、配置文件改进、新功能和修复内容。Conan是一个开源的、分布式的包管理器，支持跨平台和二进制管理。文档详细说明了如何安装、使用和创建包，以及如何上传和管理包。新版本引入了多项改进，如支持Python 3、新的命令行选项、更好的错误处理和对长路径的支持。文档还提到了一些已知问题和修复内容。

AI总结

### Conan 1.16 文档总结

#### 1. 主要特性
- **开源与分布式包管理器**：Conan 是一个开源的分布式包管理器，支持跨平台和构建系统无关的二进制管理。
- **二进制管理**：支持高效的二进制包管理，确保构建过程的稳定性和可重复性。
- **跨平台支持**：支持多种操作系统和架构，包括 Windows、Linux、macOS 等，并新增对 `ppc64le` 和 `AArch64` 的支持。
- **稳定性**：提供稳定的包管理和构建流程，适用于大规模项目。

#### 2. 安装与配置
- **安装方式**：
- 通过 pip 安装（推荐）。
- 通过 Homebrew（macOS）或 AUR（Arch Linux）安装。
- 直接安装二进制文件。
- 从源码安装。
- **配置**：提供初始配置选项，支持自定义设置。
- **Python 2 兼容性**：注意 Python 2 已逐渐弃用，建议使用 Python 3。

#### 3. 使用与工作流
- **依赖管理**：
- 支持通过配置文件和命令行安装依赖。
- 使用 profiles 管理构建环境和设置。
- 支持跨平台编译，新增 `os_build`、`arch_build` 等设置。
- **新功能**：
- `conan source` 命令：运行 Conanfile 的 `source()` 方法，适用于 CI 环境。
- `cpp_info` 和 `collect_libs()`：支持更灵活的二进制包库管理。
- `test_package` 支持自动更新依赖。
- 支持 Python 代码复用：通过 `env_info.PYTHONPATH` 将 Python 包路径添加到环境中。
- **性能优化**：
- 避免重复压缩 TGZ 文件。
- 提高构建和搜索性能，优化大型项目依赖图的处理。

#### 4. 创建包
- **包创建**：
- 支持从源码或现有二进制文件创建包。
- 提供 `recipe` 和 `sources` 的分离或合并配置。
- **新功能**：
- 支持 `short_paths`：解决 Windows 长路径问题。
- `package_folder` 属性：允许在 `package()` 方法中调用工具（如 CMake）生成包。
- `build_policy`：支持设置为 `always` 或 `missing`，适用于头文件库或动态分支构建。
- **测试与验证**：
- `conan test` 替代 `test_package`，支持自动生成测试包。
- 提供 `update` 选项，自动更新依赖。

#### 5. 上传与共享
- **上传支持**：
- 支持通过 Conan 服务器上传和共享包。
- 支持 Chocolatey 管理工具（Windows）。
- **设置与配置**：
- 更新默认设置文件 `settings.yml`，新增 `gcc` 和 `clang` 的版本支持。
- 支持通过环境变量禁用彩色输出或调整颜色主题。

#### 6. 其他改进
- **依赖管理**：
- 支持版本范围表达式（如 `Pkg/ >1.2,<1.9@user/channel`）。
- 支持按包单独指定设置和环境变量。
- **构建与测试**：
- 支持 `conan info` 命令输出需重新构建的包列表，适用于 CI 系统。
- 提供 `conan remove` 命令清理缓存。
- **工具与扩展**：
- 支持生成虚拟环境（`virtualenv`），便于管理工具包（如 CMake、MinGW）的不同版本。
- 支持通过 `generator packages` 定义自定义生成器。

#### 7. 注意事项
- **弃用与移除**：
- 移除了 `scopes` 和 `self.conanfile_directory`。
- `test_package` 命令已移除，建议使用 `conan test`。
- **兼容性**：
- 更新 `settings.yml` 中的默认设置，建议用户更新配置文件。
- 注意 `os_build` 和 `arch_build` 仅适用于构建依赖包（如 CMake 安装器）。

#### 8. 总结
Conan 1.16 版本带来了多项新功能和改进，包括跨平台支持、依赖管理优化、包创建灵活性提升以及性能优化。建议用户根据项目需求选择合适的安装和配置方式，并关注版本升级中的兼容性问题。