Windows 平台工具链的标准设置 (CMake)¶

注解

本文档将介绍如何使用 CMake 编译系统。目前，CMake 编译系统仍处于预览发布阶段，如您在使用中遇到任何问题，请前往 ESP-IDF 提交 Issues。

未来，CMake 编译系统将在 ESP-IDF v4.0 发布后过渡为默认编译系统，现行基于 GNU Make 的编译系统将在 ESP-IDF v5.0 后弃用。

注解

基于 CMake 的构建系统仅支持 64 位版本 Windows。

引言¶

ESP-IDF 需要安装必要的工具，以编译 ESP32 固件，包括：Git，交叉编译器，以及 CMake 构建工具。本文将对这些工具一一说明。

在此入门指南中，我们通过命令提示符进行有关操作。不过，安装 ESP-IDF 后你还可以使用 Eclipse 或支持 CMake 的图形化工具 IDE。

注解

基于 GNU Make 的构建系统要求 Windows 系统兼容 MSYS2 Unix。基于 CMake 的构建系统则无此要求。

安装 ESP-IDF 必备工具最简易的方式是下载 ESP-IDF 工具安装器，地址如下：

安装器会自动安装 ESP32 Xtensa gcc 工具链，Ninja 编译工具，以及名为 mconf-idf 的配置工具。此外，如果你的电脑还未安装有关 CMake 和 Python 2.7 的安装器，它还可以下载和运行与之对应的安装器。

安装器默认更新 Windows Path 环境变量，因而上述工具也可在其他环境中运行。如果禁止该选项，则需自行设置 ESP-IDF 所使用的环境（终端或所选 IDE），并配置正确的路径。

请注意，此安装器仅针对 ESP-IDF 工具包，并不包括 ESP-IDF。

ESP-IDF 工具安装器并不会安装 Git，因为快速入门指南默认你将以命令行的模式使用它。你可以通过 Git For Windows 下载和安装 Windows 平台的命令行 Git 工具（包括 “Git Bash” 终端）。

如果你想使用其他图形化 Git 客户端，如 Github Desktop，你可以自行安装，并在快速入门中阐释相应 Git 命令，以使用你所选的 Git 客户端。

在快速入门指南接下来的步骤说明中，我们将使用终端命令提示符进行有关操作。你也可以使用任何其他形式的命令提示符：

比如，Windows 开始菜单下内置的 Command Prompt。本文档中的所有 Windows 命令行指示均为 Windows Command Prompt 中所使用的 “batch” 命令。
你还可以使用 Git for Windows 中的 “Git Bash” 终端，其所使用的 “bash” 命令提示符语法与 Mac OS 或 Linux 的既定语法相同。安装此终端后，你可以在开始菜单下找到命令提示符窗口。
如果你已安装 MSYS2_（通过 ESP-IDF 之前版本），你还可以使用 MSYS 终端。

要继续设置开发环境，请参照获取 ESP-IDF。