From af168c75b3e22476744ac6302ca4c75b622b7775 Mon Sep 17 00:00:00 2001 From: Marek Fiala Date: Tue, 29 Jul 2025 11:31:57 +0200 Subject: [PATCH] docs(migration-guide): Information on how to update CMake --- docs/en/migration-guides/release-6.x/6.0/tools.rst | 9 +++++++++ docs/zh_CN/migration-guides/release-6.x/6.0/tools.rst | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/docs/en/migration-guides/release-6.x/6.0/tools.rst b/docs/en/migration-guides/release-6.x/6.0/tools.rst index df4f80a7ca..e07e059956 100644 --- a/docs/en/migration-guides/release-6.x/6.0/tools.rst +++ b/docs/en/migration-guides/release-6.x/6.0/tools.rst @@ -44,3 +44,12 @@ Changes in Configuration Files Syntax ------------------------------------- ESP-IDF v6 uses esp-idf-kconfig v3, which introduces several changes in the configuration (``Kconfig``) files. For the full list of changes, please refer to the `esp-idf-kconfig migration guide from v2.x to v3.x `_. + +CMake version upgrade +--------------------- + +The minimal supported CMake version has been upgraded to 3.22.1. In case you encounter build issues regarding this change, we recommend updating your operating system to a version that includes CMake 3.22 or newer. + +If updating the OS is not possible, you can install a recommended CMake version using the following command: ``./tools/idf_tools.py install cmake``. + +This affects ESP-IDF users who use system-provided CMake and custom CMake. diff --git a/docs/zh_CN/migration-guides/release-6.x/6.0/tools.rst b/docs/zh_CN/migration-guides/release-6.x/6.0/tools.rst index 7f81a57c18..819f20ec17 100644 --- a/docs/zh_CN/migration-guides/release-6.x/6.0/tools.rst +++ b/docs/zh_CN/migration-guides/release-6.x/6.0/tools.rst @@ -44,3 +44,12 @@ Python 3.9 已不再受支持。现在要求的最低 Python 版本为 3.10。 ---------------- ESP-IDF v6 使用了 esp-idf-kconfig v3，对配置文件 ``Kconfig`` 的语法进行了若干变更。完整变更列表请参阅 `Migration Guide From esp-idf-kconfig v2.x to v3.x `_。 + +CMake 版本升级 +--------------------- + +最低支持的 CMake 版本已升级至 3.22.1。如果你在构建过程中遇到与此相关的问题，建议将操作系统升级到包含 CMake 3.22 或更高版本。 + +如果无法升级操作系统，可以使用以下命令安装推荐的 CMake 版本：``./tools/idf_tools.py install cmake``。 + +此变更影响所有使用系统自带 CMake 或自定义 CMake 的 ESP-IDF 用户。