Conan 1.19 Documentation

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

摘要

Conan是一个用于C/C++项目的开源依赖管理和包管理工具，支持跨平台和多种构建系统。文档详细介绍了Conan的安装方法、使用流程、包的创建与上传、以及版本控制策略。Conan 1.19版本引入了多项新功能，包括对Python 3.4的弃用支持、增强的Visual Studio生成器、对Clang 9和GCC 9.2的支持，以及改进了对Apple框架和Docker容器的支持。文档还强调了Conan的稳定性承诺，确保向后兼容性，并提供了详细的使用指南和故障排除信息。

AI总结

### Conan 1.19 文档总结

#### 1. **简介**
Conan 是一个开源、分布式的包管理器，专注于跨平台和构建系统无关的二进制管理。其主要特点包括：
- **开源**：完全开源，支持社区贡献和协作。
- **分布式**：依赖项存储在本地或远程仓库，支持灵活的依赖管理。
- **二进制管理**：通过二进制缓存减少构建时间，支持跨平台复用。
- **跨平台**：支持 Windows、Linux、macOS、FreeBSD 等平台，与 CMake 等构建系统兼容。
- **稳定性承诺**：从 1.0 版本开始，Conan 保证不会破坏现有的功能和命令行接口，新增功能和修改仅适用于新版本。

#### 2. **安装与配置**
- **安装方式**：
- 使用 pip（推荐）：`pip install conan`
- macOS 使用 Homebrew：`brew install conan`
- Arch Linux 使用 AUR：`yay -S conan`
- 从二进制文件安装
- 从源码编译安装
- **初始配置**：通过 `conan config` 命令进行配置，支持定义环境变量、设置代理等。
- **更新**：使用 `conan update` 更新到最新版本。

#### 3. **快速入门**
- **示例**：通过一个简单的 MD5 加密器示例，展示如何使用 Poco 库和 Conan 管理依赖项。
- **依赖管理**：通过 `conan install` 命令安装项目所需的依赖项。
- **依赖检查**：使用 `conan inspect` 查看依赖项的详细信息。
- **包搜索**：通过 `conan search` 命令搜索可用包。
- **构建配置**：支持通过命令行参数或配置文件定义构建选项。

#### 4. **使用包**
- **安装依赖**：使用 `conan install` 命令安装依赖项。
- **配置文件**：通过 profiles 管理构建配置，支持自定义环境变量、工具链等。
- **工作流程**：支持从源码构建、二进制复用和混合模式。

#### 5. **创建包**
- **基本步骤**：
1. 创建 `conanfile.py` 或 `conanfile.txt` 定义包的元数据和构建逻辑。
2. 使用 `conan create` 命令生成包。
3. 使用 `conan package` 或 `conan export_pkg` �导出二进制包。
- **高级功能**：
- **食谱与源码管理**：支持将食谱和源码放在不同的仓库或同一仓库。
- **ABI 兼容性**：通过 `cpp_info` 和 `name` 属性定义二进制兼容性。
- **打包方法**：支持从源码构建、复用二进制和直接打包现有二进制文件。
- **工具**：提供 `conan new`、`conan inspect` 等工具简化开发流程。

#### 6. **上传与分发**
- **远程仓库**：支持将包上传到 Bintray、Artifactory 或自托管的 Conan 服务器。
- **配置远程**：通过 `conan remote` 命令管理远程仓库。
- **上传命令**：使用 `conan upload` 将包上传到指定远程仓库。

#### 7. **版本控制与稳定性**
- **版本策略**：
- 支持语义化版本控制，定义版本范围和依赖约束。
- 通过 `lockfiles` 管理构建依赖的锁定，确保构建一致性。
- **包修订**：通过 `reciperevision` 和 `packagerevision` 管理包的版本和变更。
- **兼容性**：从 1.0 版本开始，Conan 保证向后兼容，新增功能仅适用于新版本。

#### 8. **扩展与集成**
- **自定义功能**：
- 通过 Hooks 扩展 Conan 的功能，定义预处理和后处理逻辑。
- 支持自定义生成器（如 CMake、Autotools 等）和构建工具（如 Docker）。
- **集成**：
- 支持 CI/CD 平台（如 Jenkins、GitHub Actions）。
- 提供与 IDE（如 VS Code、CLion）和 VCS（如 Git、SVN）的集成。

#### 9. **变更日志**
- **主要更新**：
- **1.19.3**：修复了 Python 2 兼容性问题，改进了依赖搜索功能。
- **1.19.2**：新增对 Clang 9 和 GCC 9.2 的支持，修复了依赖覆盖问题。
- **1.19.0**：新增对 macOS、watchOS、tvOS、iOS 的版本支持，改进了 C++ 框架支持。
- **重要变更**：
- 从 1.19 版本开始，Python 2 支持逐渐弃用。
- 新增对远程仓库的认证支持，改进了二进制缓存机制。

#### 10. **FAQ 与支持**
- **常见问题**：
- 如何升级到新版本？
- 如何处理构建失败或依赖问题？
- 如何管理多个项目和配置？
- **资源**：
- [官方文档](https://conan.io/docs/)
- [GitHub 仓库](https://github.com/conan-io/conan)
- [社区与支持](https://community.conan.io/)

#### 11. **总结**
Conan 1.19 提供了强大的包管理功能，支持跨平台、二进制复用和灵活的依赖管理。通过简洁的命令行接口和丰富的配置选项，用户可以轻松管理 C/C++ 项目的依赖和构建流程。文档详细介绍了从安装、使用到创建和分发包的完整流程，并提供了大量示例和工具支持。对于开发者和项目管理者来说，Conan 是一个高效且可靠的依赖管理工具。