Conan 1.7 Documentation

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

摘要

文档详细介绍了Conan 1.7版本的功能、安装方法、使用指南以及创建和上传包的步骤。Conan是一个开源的包管理器，支持跨平台构建，提供二进制管理功能，并支持多种构建系统。文档涵盖了从安装配置到高级功能的使用，包括依赖管理、配置文件设置、构建流程优化以及新功能的介绍。

AI总结

### Conan 1.7 文档总结

#### 1. **概述**
Conan 是一个开源、去中心化的包管理工具，支持二进制管理和跨平台构建，适用于多种操作系统和构建系统。它注重稳定性，支持通过配置文件和命令行进行操作。

#### 2. **安装**
- **推荐安装方式**：使用 pip 安装（`pip install conan`）。
- **其他平台支持**：
- macOS：通过 Homebrew 安装。
- Arch Linux：通过 AUR 安装。
- **配置**：初始配置可通过命令行或手动编辑配置文件完成。
- **源码安装**：支持从源码编译安装。

#### 3. **快速入门**
- **示例**：通过一个使用 POCO 库的 Timer 示例，展示了如何安装依赖、构建项目、检查依赖以及搜索包。
- **工作流**：支持通过配置文件和命令行进行依赖管理、构建和测试。

#### 4. **使用包**
- **依赖管理**：通过 Conan 命令安装和管理依赖。
- **配置文件**：支持使用 profiles 进行环境变量和构建选项的管理。
- **工作流**：支持多种构建和测试工作流，包括并行构建和远程依赖管理。

#### 5. **创建包**
- **基础**：通过 Conan recipe 和源码创建自定义包。
- **高级功能**：
- 支持将现有二进制文件打包。
- 定义 ABI 兼容性。
- 使用工具（如 `conan source`）执行源码提取。
- **方法**：支持多种打包方式，包括从源码构建和直接使用现有二进制文件。

#### 6. **上传包**
- 支持将本地包上传到 Conan 仓库，供其他项目使用。

---

### 重要更新（Changelog）

#### **1.7.4（2018-09-18）**
- **新功能**：
- 支持 `conan source` 命令，用于执行 Conanfile 中的 `source()` 方法。
- 支持 `collect_libs()` 帮助器，用于捕获二进制包中的库文件。
- `test_package` 命令支持自动更新依赖。
- 新增对 `ppc64le` 和 `AArch64` 架构的支持。
- **修复**：
- 修复了 APIv2 的稳定性问题。
- 修复了文件下载和错误输出中的异常处理问题。

#### **1.7.3（2018-09-06）**
- **修复**：
- 修复了文件下载过程中输出的异常问题。
- 修复了选项模式的处理问题。

#### **1.7.2（2018-09-04）**
- **修复**：
- 修复了默认选项初始化问题。
- 修复了 `--test` 和 `--install` 参数的兼容性问题。

#### **1.7.1（2018-08-31）**
- **修复**：
- 修复了帮助命令中的描述问题。
- 支持通过 `--args` 参数传递自定义参数。
- 支持处理嵌套子文件夹的 SCM。

---

### 其他重要信息
- **兼容性**：Conan 1.7 不会破坏 1.0 版本的配方或命令行接口。
- **贡献**：1.7.4 版本得到了社区成员的贡献，包括功能优化和 bug 修复。
- **注意事项**：
- Windows 搜索索引可能会干扰 Conan 的本地存储，建议禁用。
- 部分功能（如 `scopes` 和 `test_package`）已弃用或移除。

---

### 总结
Conan 1.7 提供了强大的依赖管理、跨平台构建和二进制分发功能，适合需要高效管理和复用软件包的开发场景。更新版本修复了多项 bug 并引入了新功能，提升了稳定性和用户体验。