本文探讨了在使用conan构建项目时，因cmake版本不匹配导致的构建失败问题。当项目依赖要求特定高版本cmake而本地环境不满足时，手动修改cmakelists.txt是无效且不推荐的。教程将详细介绍如何通过conan的配置文件（特别是tool_requires指令）来声明并注入所需的cmake版本，从而在不影响系统cmake安装的情况下，为构建过程提供正确的工具链，确保项目顺利编译。
Conan构建中CMake版本冲突问题解析
在使用Conan进行C/C++项目构建时，开发者可能会遇到一个常见问题：项目依赖的CMakeLists.txt文件指定了高于当前系统安装的CMake版本要求（例如，项目要求CMake 3.23，而系统仅有3.20）。这会导致构建过程中断，并抛出CMake Error at CMakeLists.txt:3 (cmake_minimum_required): CMake 3.23 or higher is required.的错误。
尽管手动修改依赖包的CMakeLists.txt文件（例如，将cmake_minimum_required(VERSION 3.23)改为cmake_minimum_required(VERSION 3.20)）似乎能暂时解决问题，并使CMake配置成功，但这种方法在Conan的工作流中是不可持续的。Conan作为包管理器，在每次构建或更新时会重置其构建环境，这意味着任何对Conan缓存中文件进行的修改都将被覆盖，导致问题反复出现。
为什么不应手动修改或忽略cmake_minimum_required
- Conan缓存的不可变性： Conan旨在提供可重复的构建。它将依赖项下载并解压到其内部缓存中。对这些缓存文件进行手动修改，Conan会在后续操作中将其重置，以确保构建的一致性。尝试使用chattr +i等文件锁定工具也可能导致Conan在清理阶段失败。
- 尊重上游项目要求： cmake_minimum_required指令是项目开发者明确声明的最低CMake版本要求。即使在旧版本CMake下看似可以编译，也可能存在未知的兼容性问题、功能缺失或行为差异，从而导致潜在的运行时错误或构建不稳定。
- CMake不提供忽略选项： CMake本身没有提供通过环境变量或其他机制来强制忽略cmake_minimum_required版本检查的功能。这是为了确保项目构建环境的最低要求得到满足。
解决方案：通过Conan配置文件管理CMake版本
解决此问题的最佳实践是利用Conan的包管理能力，让Conan本身来提供满足项目要求的CMake版本。这可以通过在Conan配置文件中声明tool_requires来实现。tool_requires允许您指定构建工具的依赖，Conan会在构建过程中自动下载并注入这些工具，而不会影响您的系统环境。
步骤一：创建或修改Conan配置文件
您可以在Conan的默认配置文件（通常是~/.conan2/profiles/default或~/.conan/profiles/default）中添加所需的tool_requires，或者创建一个新的自定义配置文件。
示例：创建myprofile.txt
在您的项目根目录或Conan配置文件目录中创建一个名为myprofile.txt的文件，并添加以下内容：
include(default) [tool_requires] cmake/[>=3.23]
- include(default)：这行表示该配置文件会继承您的默认Conan配置。
- [tool_requires]：此部分用于声明构建工具的依赖。
- cmake/[>=3.23]：这表示您的项目需要一个CMake版本大于或等于3.23的包。Conan将尝试从其远程仓库中查找并下载满足此条件的CMake包。
步骤二：应用Conan配置文件
在运行Conan命令时，通过-pr（profile）参数指定您创建的配置文件。
示例：使用自定义配置文件进行构建
conan install . --build=missing --update -o cura:devtools=True -g VirtualPythonEnv -pr=myprofile
如果您选择修改了default配置文件，则无需额外指定-pr参数。
工作原理： 当Conan执行此命令时，它会首先解析myprofile.txt。根据[tool_requires]中的声明，Conan会检查其缓存中是否存在满足cmake/[>=3.23]的CMake包。如果不存在，它将从配置的远程仓库下载一个合适的CMake版本，并将其添加到构建环境中。这样，当依赖包的CMakeLists.txt被处理时，Conan提供的CMake版本将满足其最低要求，从而避免构建错误。
注意事项与最佳实践
- 版本精确性： 尽管[>=3.23]可以工作，但为了构建的精确性和可重复性，如果项目明确指定了某个版本，最好使用精确的版本号，例如cmake/3.23.0。
- Conan版本： 确保您的Conan版本支持tool_requires语法。本文示例基于Conan 2.x版本。Conan 1.x使用build_requires，但原理类似。
- 上游修复： 如果您是项目维护者，最好的方法是更新项目本身的conanfile.py，在其中声明tool_requires("cmake/...")，这样所有使用者都能自动获得正确的CMake版本。
- 避免系统污染： 通过Conan管理CMake版本的好处是，它不会修改您的系统CMake安装。这对于需要同时处理多个对CMake版本有不同要求的项目来说非常有用。
总结
当Conan构建遇到cmake_minimum_required版本不匹配的问题时，最佳且专业的解决方案是利用Conan的tool_requires功能。通过在Conan配置文件中声明所需的CMake版本，您可以让Conan自动下载并注入正确的构建工具，从而确保项目在隔离且可控的环境中顺利构建，同时避免了手动修改文件和系统环境污染的风险。这种方法不仅解决了当前的构建问题，也提升了项目的可维护性和可重复性。
