Conan 1.47 Documentation

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

摘要

文档介绍了Conan 1.47版本的更新内容，包括新功能、改进和bug修复。主要更新包括对Android的交叉编译支持、Meson和CMake工具链的增强、包管理功能的优化以及对旧版本的兼容性承诺。文档还详细列出了新功能和修复的bug，如对Xcode 13.3的支持、新增的CMakePresets.json支持以及对MSBuild集成的改进。

AI总结

### Conan 1.47 文档总结

#### 概述
Conan 1.47 是一个开源、分散式包管理器，支持跨平台、多种构建系统和编译器，专注于二进制管理和依赖管理，同时保持稳定性和社区驱动的特性。

---

#### 主要功能
1. **新功能**
- **CMakePresets.json 支持**：支持 CMakePresets.json 文件，简化 CMake 项目配置。
- **Android 交叉编译支持**：在 MesonToolchain 中支持 Android 交叉编译。
- **Xcode 工具链增强**：支持 Xcode 13.3、iOS 15.4、watchOS 8.5 和 tvOS 15.4。
- **MSBuild 工具链改进**：新增 `modern MSBuild VS integration`。
- **工具链增强**：新增 `wrap_mode=nofallback` 作为默认值，支持 `rmdir` 工具。
- **检测和日志**：新增 `conan.tool.microsoft.unix_path` 和 `checker for Conan 2.x deprecations`。

2. **兼容性和稳定性**
- **向后兼容**：Conan 1.47 不会破坏 1.0 版本的配方或命令行调用。
- **Python 2 升级**：移除对 Python 2 的支持，全面转向 Python 3。

3. **其他改进**
- **依赖管理**：支持通过 `[conf]` 注入额外标志，优化依赖覆盖机制。
- **工作流**：新增 `conan new` 模板，支持 Bazel 示例。

---

#### 安装指南
1. **推荐安装方式**：
- 使用 `pip` 安装：`pip install conan`。
- **macOS**：通过 Homebrew 安装。
- **Arch Linux**：通过 AUR 安装。
- **二进制安装**：直接下载并安装预编译二进制文件。
- **源码安装**：从源码编译安装。

2. **初始配置**：
- 安装完成后，运行 `conan --version` 验证安装。
- 配置环境变量或编辑 `conan.conf` 文件。

---

#### 使用指南
1. **依赖管理**：
- 使用 `conan install` 安装项目依赖。
- 使用 `conan inspect` 检查依赖信息。
- 使用 `conan search` 搜索包。

2. **配置与工作流**：
- 使用 `profiles` 定义构建环境。
- 使用 `workflows` 管理构建流程。
- 使用 `conan create` 和 `conan test_package` 创建和测试包。

3. **调试与日志**：
- 使用 `conan debug` 和 `conan logs` 分析构建问题。

---

#### 包创建与上传
1. **包创建**：
- 使用 `conan new` 创建新包。
- 编写 `conanfile.py` 定义配方和源码。
- 使用 `conan package` 打包。

2. **上传与分发**：
- 使用 `conan remote` 管理远程仓库。
- 使用 `conan upload` 将包上传到远程仓库（如 Artifactory 或 Conan 服务器）。

---

#### 版本控制与兼容性
1. **版本管理**：
- 支持版本范围和包修订。
- 使用 `lockfiles` 管理依赖版本锁定。

2. **兼容性**：
- 支持 `compatibility()` 方法，兼容 Conan 2.x 和 1.x 的包。

---

#### 关键修复与改进
1. **工具链与构建改进**：
- 修复 `CMakeToolchain` 和 `MesonToolchain` 的标志传递问题。
- 支持更广泛的编译器版本（如旧版 MSVC 和 Clang）。

2. **依赖管理优化**：
- 修复依赖覆盖机制，确保下游依赖正确传播。
- 支持更多生成器（如 `cmake_multi` 和 `b2`）。

3. **错误修复**：
- 修复 `conan export-pkg` 和 `conan build` 的元数据更新问题。
- 修复 Windows 长路径问题和文件下载验证问题。

4. **性能与稳定性**：
- 优化构建缓存和并行支持。
- 修复 SCM 模式的版本计算问题。

---

#### 总结
Conan 1.47 提供了强大的依赖管理、跨平台支持和灵活的工具链配置，适合复杂的 C/C++ 项目。其改进和修复增强了稳定性和兼容性，适合企业级构建和分发。