如何通过CMake/预处理器为ESP-IDF项目设置最低版本要求？

在ESP-IDF项目的根目录CMakeLists.txt中添加以下代码，就能在构建阶段（包括Eclipse环境）强制检查用户安装的ESP-IDF版本是否满足最低要求，效果类似cmake_minimum_required：

# 设置项目要求的ESP-IDF最低版本
set(MIN_REQUIRED_IDF_VERSION "5.1")

# 解析最低版本的主、次、修订号
string(REGEX MATCH "^([0-9]+)\\.([0-9]+)(\\.([0-9]+))?$" _ ${MIN_REQUIRED_IDF_VERSION})
set(MIN_IDF_MAJOR ${CMAKE_MATCH_1})
set(MIN_IDF_MINOR ${CMAKE_MATCH_2})
set(MIN_IDF_PATCH ${CMAKE_MATCH_4})
if(NOT MIN_IDF_PATCH)
    set(MIN_IDF_PATCH 0) # 若未指定修订号，默认设为0
endif()

# 检查当前ESP-IDF版本是否达标
if(IDF_VERSION_MAJOR LESS MIN_IDF_MAJOR OR
   (IDF_VERSION_MAJOR EQUAL MIN_IDF_MAJOR AND IDF_VERSION_MINOR LESS MIN_IDF_MINOR) OR
   (IDF_VERSION_MAJOR EQUAL MIN_IDF_MAJOR AND IDF_VERSION_MINOR EQUAL MIN_IDF_MINOR AND IDF_VERSION_PATCH LESS MIN_IDF_PATCH))
    message(FATAL_ERROR "错误：当前ESP-IDF版本为 ${IDF_VERSION}，项目要求最低版本为 ${MIN_REQUIRED_IDF_VERSION}，请升级ESP-IDF后重新构建。")
endif()

注意事项： #

• 这段代码必须放在include($ENV{IDF_PATH}/tools/cmake/project.cmake)语句之后，因为ESP-IDF的版本变量（IDF_VERSION、IDF_VERSION_MAJOR等）是在导入这个CMake脚本后才被定义的。
• 当用户使用Eclipse构建时，插件会自动执行CMake流程，一旦版本不满足要求，构建会直接终止并在控制台输出错误提示，无需用户查看代码。

备选预处理器方案（双重检查） #

如果需要同时在代码编译阶段也做检查，可以在CMake中添加版本宏定义，再在C/C++代码中用预处理器判断：

1. 在CMakeLists.txt中添加：

target_compile_definitions(${PROJECT_NAME} PRIVATE
    MIN_IDF_MAJOR=${MIN_IDF_MAJOR}
    MIN_IDF_MINOR=${MIN_IDF_MINOR}
    MIN_IDF_PATCH=${MIN_IDF_PATCH}
)

2. 在项目的任意.h或.c文件中添加：

#if (IDF_VERSION_MAJOR < MIN_IDF_MAJOR) || \
    (IDF_VERSION_MAJOR == MIN_IDF_MAJOR && IDF_VERSION_MINOR < MIN_IDF_MINOR) || \
    (IDF_VERSION_MAJOR == MIN_IDF_MAJOR && IDF_VERSION_MINOR == MIN_IDF_MINOR && IDF_VERSION_PATCH < MIN_IDF_PATCH)
#error "当前ESP-IDF版本低于项目要求的最低版本，请升级后再编译。"
#endif

内容的提问来源于stack exchange，提问作者LappiesJA