从零开始设置 Windows 环境下的工具链

[English]

除了使用 ESP-IDF 工具安装器,用户也可以手动设置 Windows 环境下的工具链,这也是本文的主要内容。手动安装工具可以更好地控制安装流程,同时也方便高阶用户进行自定义安装。

使用 ESP-IDF 工具安装器对工具链及其他工具进行快速标准设置,请参照 Windows 平台工具链的标准设置

注解

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

获取 ESP-IDF

注解

较早版本 ESP-IDF 使用了 MSYS2 bash 终端 命令行。目前,基于 CMake 的编译系统可使用常见的 Windows 命令窗口,即本指南中使用的终端。

请注意,如果您使用基于 bash 的终端或 PowerShell 终端,一些命令语法将与下面描述有所不同。

打开命令提示符,运行以下命令:

mkdir %userprofile%\esp
cd %userprofile%\esp
git clone -b v4.1.3 --recursive https://github.com/espressif/esp-idf.git

ESP-IDF 将下载至 %userprofile%\esp\esp-idf

请前往 ESP-IDF 版本简介,查看 ESP-IDF 不同版本的具体适用场景。

注解

git clone 命令的 -b v4.1.3 选项告诉 git 从 ESP-IDF 仓库中克隆与此版本的文档对应的分支。

注解

作为备份,还可以从 Releases page 下载此稳定版本的 zip 文件。不要下载由 GitHub 自动生成的”源代码”的 zip 文件,它们不适用于 ESP-IDF。

注解

在克隆远程仓库时,不要忘记加上 --recursive 选项。否则,请接着运行以下命令,获取所有子模块

cd esp-idf
git submodule update --init

工具

cmake 工具

下载最新发布的 Windows 平台稳定版 CMake,并运行安装器。

当安装器询问“安装选项”时,选择 “Add CMake to the system PATH for all users”(为所有用户的系统路径添加 CMake)或 “Add CMake to the system PATH for the current user”(为当前用户的系统路径添加 CMake)。

Ninja 编译工具

注解

目前,Ninja 仅提供支持 64 位 Windows 版本的 bin 文件。您也可以配合其他编译工具在 32 位 Windows 版本中使用 CMake 和 idf.py ,比如 mingw-make。但是目前暂无关于此工具的说明文档。

从(下载页面)下载最新发布的 Windows 平台稳定版 ninja

适用于 Windows 平台的 Ninja 下载文件是一个 .zip 文件,包含一个 ninja.exe 文件。您需要将该文件解压到目录,并 添加到您的路径 (或者选择您路径中的已有目录)。

Python

下载并运行适用于 Windows 安装器的最新版 Python

Python 安装器的“自定义”菜单可为您提供一系列选项,最后一项为 “Add python.exe to Path”(添加 python.exe 到路径中)。请将该选项更改到 “Will be installed”(将会安装)。

Python 安装完成后,从 Windows 开始菜单中打开“命令提示符”窗口,并运行以下命令:

pip install --user pyserial

适用于 IDF 的 MConf

kconfig-frontends releases page 下载配置工具 mconf-idf。此为 mconf 配置工具,可针对 ESP-IDF 进行少量自定义操作。

请将此工具解压到目录,并 添加到您的路径

工具链设置

下载预编译的 Windows 工具链:

https://dl.espressif.com/dl/xtensa-esp32-elf-gcc8_4_0-esp-2020r3-win32.zip

解压压缩包文件到 C:\Program Files (或其他位置)。压缩包文件包含一个 xtensa-esp32-elf 目录。

然后,请将该目录下的 bin 子目录 添加到您的路径。例如,C:\Program Files\xtensa-esp32-elf\bin

注解

如果您已安装 MSYS2 环境(适用 “GNU Make” 编译系统),则可以跳过下载那一步,直接添加目录 C:\msys32\opt\xtensa-esp32-elf\bin 到路径,因为 MSYS2 环境已包含工具链。

添加目录到路径

在 Windows 环境下,向 Path 环境变量增加任何新目录,请:

打开系统“控制面板”,找到环境变量对话框(Windows 10 用户请前往“高级系统设置”)。

双击 Path 变量(选择“用户”或“系统路径”,具体取决于您是否希望其他用户路径中也存在该目录)。在最后数值那里新添 ;<new value>

后续步骤

继续设置开发环境,请前往 第三步:设置工具 章节。