Conan 1.3 Documentation

语言	格式	评分
英语	.pdf	3
摘要
The document provides an overview of the Conan 1.3 release, detailing deprecations, new features, and bug fixes. Key updates include changes to compiler versioning, support for cross-compilation, and improvements to profile management. The release emphasizes stability and compatibility with existing recipes and packages, ensuring minimal disruption to user workflows. Notable enhancements include enhanced cross-platform support, better handling of build systems, and new tools for managing system packages and dependencies.
AI总结
### Conan 1.3 文档总结 #### 1. 命令行变化 - 命令行参数现在使用短横线（`-`）而不是下划线（`_`），例如： ```bash $ conan build .. --source-folder=../src ``` #### 2. 弃用和移除的功能 - 移除的功能： - `scopes` 已在 Conan 0.30.X 中完全移除。 - `self.conanfile_directory` 已移除，建议使用 `self.source_folder`、`self.build_folder` 等替代。 - `self.cpp_info`、`self.env_info` 和 `self.user_info` 的作用域仅限于 `package_info()` 方法。 - `gcc` 和 `ConfigureEnvironment` 已在 Conan 0.30.1 中移除。 - `werror` 已移除，现在是内置行为。 - `test_package` 命令已移除，建议使用 `conan create` 和 `conan test` 替代。 - CMake 帮助器仅允许使用 `CMake(self)` 语法（从 Conan 0.29 开始）。 - `conan package_files` 命令已替换为 `conan export-pkg`（从 Conan 0.28 开始）。 #### 3. 设置和配置文件 - 编译器版本： - `gcc` 和 `clang` 的版本策略已更新，从 `gcc > 5` 和 `clang > 4` 开始，仅考虑主版本号，子版本号为修复版本。 - 默认的 `settings.yml` 文件中增加了主版本号，例如： ```yaml gcc: version: ["4.1", "4.4", ..., "7.2"] ``` - 建议用户使用主版本号进行设置，例如： ```bash -s compiler=gcc -s compiler.version=5 ``` #### 4. 新功能 - 交叉编译支持： - 新增默认设置 `os_build`、`arch_build`、`os_target`、`arch_target`，用于支持交叉编译。 - 这些设置不会影响 `package_id` 的计算，除非用户通过 `self.info.include_build_settings()` 显式包含它们。 - 仅适用于 `build_requires` 类型的包（如 `cmake_installer` 或 `mingw_installer`）。 - Windows 子系统支持： - 新增对 Windows 子系统的模型和工具支持，以便更好地管理 Windows 环境。 - 多平台支持： - Conan 支持 Windows、Linux（Ubuntu、Debian、RedHat 等）、macOS、FreeBSD 和 SunOS 等平台。 - 文档中提供特定平台的示例，用户可根据需求调整设置（如 `conan install . -s compiler=gcc`）。 - 稳定性承诺： - 自 Conan 1.0 起，承诺向后兼容，确保新版本不会破坏现有食谱、包或命令行流程。 - 公共接口仅限于文档中明确列出的功能，未记录的细节可能随时变更。 #### 5. 版本更新日志 - 1.3.3（2018年5月10日）： - 修复文件编码问题和 MD5 校验问题。 - 修复 `run_in_windows_bash` 的问题。 - 添加对 `apple-clang 9.1` 的支持。 - 1.3.2（2018年5月7日）： - 修复 MD5 计算问题。 - 修复 `VisualStudioBuildEnvironment` 的工具集未定义问题。 - 修复 `conan download -p=wrong_id` 的问题。 - 1.3.1（2018年5月3日）： - 修复与 `AutoToolsBuildEnvironment` 的兼容性问题。 - 修复 `pkg_config` 生成器的崩溃问题。 - 修复 `conanfile.run()` 在 `win_bash=True` 模式下的路径引号问题。 #### 6. 其他重要信息 - 配置文件和自动检测： - 新增 `conan profile` 命令的子命令（`update`、`new`、`remove`），支持配置文件的创建和管理。 - 自动检测配置文件可能因版本更新而变化，建议用户手动定义配置文件以确保一致性。 - 系统依赖管理： - 新增基于环境变量的系统依赖认证，避免令牌过期问题。 - 支持通过 `CONAN_SYSREQUIRES_MODE` 环境变量控制系统依赖的安装行为。 - 构建工具和生成器： - 新增 `SKIP_RPATH` 和 `NO_OUTPUT_DIRS` 参数以优化 CMake 构建。 - 支持 `Chocolatey` 作为 Windows 系统包管理工具。 - 测试和构建： - 新增 `conan create` 命令，替代 `test_package`，支持更灵活的测试流程。 - 新增 `--test-build-folder` 命令行参数和 `CONAN_TEMP_TEST_FOLDER` 环境变量，用于自动清理测试构建目录。 #### 7. 总结 Conan 1.3 版本在兼容性、功能扩展和性能优化方面均有显著提升，特别在交叉编译、多平台支持和稳定性方面表现突出。用户应根据需求更新配置文件和脚本，以充分利用新功能并确保兼容性。