CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE_BEFORE

在 3.17 版本中添加。

一个 CMake 语言文件,将在任何 project() 命令调用中,以 <PROJECT-NAME> 作为项目名称时,作为第一个步骤被包含。这旨在将自定义代码注入项目构建中,而无需修改其源代码。有关 project() 调用期间可能包含的文件的详细讨论,请参阅 代码注入

在 3.29 版本中加入: 此变量可以是一个 CMake 语言文件的 分号分隔的列表,这些文件将被按顺序包含。它现在也可以指向在 CMAKE_MODULE_PATH 中找到的模块名称,或者作为 CMake 内置模块。

另请参阅 CMAKE_PROJECT_<PROJECT-NAME>_INCLUDECMAKE_PROJECT_INCLUDECMAKE_PROJECT_INCLUDE_BEFORECMAKE_PROJECT_TOP_LEVEL_INCLUDES 变量。