mirror of
https://github.com/espressif/esp-idf.git
synced 2025-09-30 19:19:21 +00:00
Backport changes made in 6147 to release/4.0
This commit is contained in:
liying
@@ -1,71 +1,101 @@
|
||||
******************************************************************
|
||||
********************************************
|
||||
从零开始设置 Windows 环境下的工具链
|
||||
******************************************************************
|
||||
********************************************
|
||||
|
||||
:link_to_translation:`en:[英文]`
|
||||
:link_to_translation:`en:[English]`
|
||||
|
||||
本文就如何运行基于 CMake 构建系统中的 :doc:`ESP-IDF 工具安装器 <windows-setup>` 进行逐步详细说明。手动安装所有工具能更好地控制整个安装流程，同时也方便高阶用户进行自定义安装。
|
||||
除了使用 :doc:`ESP-IDF 工具安装器 <windows-setup>`，用户也可以手动设置 Windows 环境下的工具链，这也是本文的主要内容。手动安装工具可以更好地控制安装流程，同时也方便高阶用户进行自定义安装。
|
||||
|
||||
使用 ESP-IDF 工具安装器对工具链及其他工具进行快速标准设置，请参照 :doc:`windows-setup`。
|
||||
|
||||
.. note::
|
||||
|
||||
基于 GNU Make 的构建系统要求 Windows 兼容 MSYS2_ Unix，基于 CMake 的构建系统则无此要求。
|
||||
|
||||
.. _get-esp-idf-windows-command-line:
|
||||
|
||||
获取 ESP-IDF
|
||||
==============
|
||||
|
||||
.. note::
|
||||
基于 GNU Make 的构建系统要求 Windows 兼容 `MSYS2`_ Unix。基于 CMake 的构建系统则无此要求。
|
||||
|
||||
较早版本 ESP-IDF 使用了 **MSYS2 bash 终端** 命令行。目前，基于 CMake 的编译系统可使用常见的 **Windows 命令窗口**，即本指南中使用的终端。
|
||||
|
||||
请注意，如果您使用基于 bash 的终端或 PowerShell 终端，一些命令语法将与下面描述有所不同。
|
||||
|
||||
打开命令提示符，后运行以下命令：
|
||||
|
||||
.. include:: /_build/inc/git-clone-windows.inc
|
||||
|
||||
ESP-IDF 将下载至 ``%userprofile%\esp\esp-idf``。
|
||||
|
||||
请前往 :doc:`/versions`，查看 ESP-IDF 不同版本的具体适用场景。
|
||||
|
||||
.. include:: /_build/inc/git-clone-notes.inc
|
||||
|
||||
.. note::
|
||||
|
||||
在克隆远程仓库时，不要忘记加上 ``--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）。
|
||||
当安装器询问“安装选项”时，选择 "Add CMake to the system PATH for all users"（为所有用户的系统路径添加 CMake）或 "Add CMake to the system PATH for the current user"（为当前用户的系统路径添加 CMake）。
|
||||
|
||||
Ninja 编译工具
|
||||
^^^^^^^^^^^^^^^^^^^^
|
||||
^^^^^^^^^^^^^^
|
||||
|
||||
.. note::
|
||||
Ninja 目前仅为 64 位版本 Windows 提供 bin 文件。你也可以通过其他编译工具使用 CMake 和 ``idf.py``，如适用于 32 位 Windows 的 mingw-make，但是目前暂无关于此工具的说明文档。
|
||||
目前，Ninja 仅提供支持 64 位 Windows 版本的 bin 文件。您也可以配合其他编译工具在 32 位 Windows 版本中使用 CMake 和 ``idf.py`` ，比如 mingw-make。但是目前暂无关于此工具的说明文档。
|
||||
|
||||
从（`下载页面 <ninja-dl>`_）下载最新发布的 Windows 平台稳定版 `ninja`_。
|
||||
从（`下载页面 <ninja-dl>`_）下载最新发布的 Windows 平台稳定版 ninja_。
|
||||
|
||||
适用于 Windows 平台的 Ninja 下载文件是一个 .zip 文件，包含一个 ``ninja.exe`` 文件。将其解压到目录，并 `添加到你的路径 <add-directory-windows-path>`_ （或者选择你的路径中已有的目录）。
|
||||
适用于 Windows 平台的 Ninja 下载文件是一个 .zip 文件，包含一个 ``ninja.exe`` 文件。您需要将该文件解压到目录，并 :ref:`添加到您的路径 <add-directory-windows-path>` （或者选择您路径中的已有目录）。
|
||||
|
||||
|
||||
Python
|
||||
^^^^^^
|
||||
|
||||
下载并运行适用于 Windows 安装器的最新版 Python_。
|
||||
|
||||
Python 安装的“自定义”那一步提供了一份选项列表，最后一个选项是 "Add python.exe to Path"（添加 python.exe 到路径中），更改该选项，选择 "Will be installed"（将会安装）。
|
||||
Python 安装器的“自定义”菜单可为您提供一系列选项，最后一项为 "Add python.exe to Path"（添加 python.exe 到路径中）。请将该选项更改到 "Will be installed"（将会安装）。
|
||||
|
||||
Python 安装完成后，打开 Windows 开始菜单下的 Command Prompt，并运行以下命令::
|
||||
Python 安装完成后，从 Windows 开始菜单中打开“命令提示符”窗口，并运行以下命令::
|
||||
|
||||
pip install --user pyserial
|
||||
pip install --user pyserial
|
||||
|
||||
适用于 IDF 的 MConf
|
||||
^^^^^^^^^^^^^^^^^^^^^^
|
||||
^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
从 `kconfig-frontends 发布页面 <mconf-idf>`_ 下载配置工具 mconf-idf。此为 ``mconf`` 配置工具，可针对 ESP-IDF 进行一些自定义操作。
|
||||
从 `kconfig-frontends releases page <mconf-idf>`_ 下载配置工具 mconf-idf。此为 ``mconf`` 配置工具，可针对 ESP-IDF 进行少量自定义操作。
|
||||
|
||||
你需将此工具解压到目录，然后 `添加到你的路径 <add-directory-windows-path>`_。
|
||||
请将此工具解压到目录，并 `添加到您的路径 <add-directory-windows-path>`_。
|
||||
|
||||
工具链设置
|
||||
===============
|
||||
|
||||
.. include:: /_build/inc/download-links.inc
|
||||
|
||||
下载预编译的 Windows 平台工具链：
|
||||
下载预编译的 Windows 工具链：
|
||||
|
||||
|download_link_win32|
|
||||
|
||||
解压压缩包文件到 ``C:\Program Files`` （或其他地址）。压缩包文件包含 ``xtensa-esp32-elf`` 目录。
|
||||
解压压缩包文件到 ``C:\Program Files`` （或其他位置）。压缩包文件包含一个 ``xtensa-esp32-elf`` 目录。
|
||||
|
||||
然后，须将该目录下的子目录 ``bin`` `添加到你的路径 <add-directory-windows-path>`_。例如，``C:\Program Files\xtensa-esp32-elf\bin``。
|
||||
然后，请将该目录下的 ``bin`` 子目录 `添加到您的路径 <add-directory-windows-path>`_。例如，``C:\Program Files\xtensa-esp32-elf\bin``。
|
||||
|
||||
.. note::
|
||||
|
||||
如果你已安装 MSYS2 环境（适用 "GNU Make" 构建系统），你可以跳过下载那一步，直接添加目录 ``C:\msys32\opt\xtensa-esp32-elf\bin`` 到路径，因为 MSYS2 环境已包含工具链。
|
||||
|
||||
如果您已安装 MSYS2 环境（适用 "GNU Make" 编译系统），则可以跳过下载那一步，直接添加目录 ``C:\msys32\opt\xtensa-esp32-elf\bin`` 到路径，因为 MSYS2 环境已包含工具链。
|
||||
|
||||
|
||||
.. _add-directory-windows-path:
|
||||
@@ -73,19 +103,21 @@ Python 安装完成后，打开 Windows 开始菜单下的 Command Prompt，并
|
||||
添加目录到路径
|
||||
========================
|
||||
|
||||
添加任何新目录到你的 Windows Path 环境变量：
|
||||
在 Windows 环境下，向 Path 环境变量增加任何新目录，请：
|
||||
|
||||
打开系统控制面板，找到环境变量对话框（对于 Windows 10，则在高级系统设置中查找对话框）。
|
||||
打开系统“控制面板”，找到环境变量对话框（Windows 10 用户请前往“高级系统设置”）。
|
||||
|
||||
双击 ``Path`` 变量（选择用户或系统路径，这取决于你是否希望其他用户路径中也存在该目录)。在最后数值那里新添 ``;<new value>``。
|
||||
双击 ``Path`` 变量（选择“用户”或“系统路径”，具体取决于您是否希望其他用户路径中也存在该目录)。在最后数值那里新添 ``;<new value>``。
|
||||
|
||||
|
||||
后续步骤
|
||||
================
|
||||
========
|
||||
|
||||
要继续设置开发环境，请参照 :ref:`get-started-get-esp-idf`。
|
||||
继续设置开发环境，请前往 :ref:`get-started-get-esp-idf` 章节。
|
||||
|
||||
.. _ninja: https://ninja-build.org/
|
||||
.. _Python: https://www.python.org/downloads/windows/
|
||||
.. _MSYS2: https://msys2.github.io/
|
||||
.. _Stable version: https://docs.espressif.com/projects/esp-idf/en/stable/
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user