73 lines
2.7 KiB
ReStructuredText
73 lines
2.7 KiB
ReStructuredText
**********************************************
|
||
Windows 平台工具链的标准设置（传统 GNU Make）
|
||
**********************************************
|
||
:link_to_translation:`en:[English]`
|
||
|
||
.. include:: ../gnu-make-legacy.rst
|
||
|
||
概述
|
||
====
|
||
|
||
Windows 系统没有内置的 "make" 环境，所以除了安装工具链之外，您还需要一个兼容 GNU 的环境。这里，我们使用 MSYS2_ 环境兼容 GNU。您无需一直使用这个环境，比如您可以使用 :doc:`Eclipse <eclipse-setup>` 或其他前端，仅需在后台运行 MSYS2_ 即可。
|
||
|
||
|
||
工具链设置
|
||
==========
|
||
|
||
最简便的工具链设置方法是从下方地址下载 Windows 多合一工具链和 MSYS2 压缩包文件：
|
||
|
||
https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20190611.zip
|
||
|
||
请将压缩包文件解压至 ``C:\``（或其他目录，但本文档中以 ``C:\`` 为例），该文件将为您创建一个带有预配置环境的 ``msys32`` 目录。
|
||
|
||
|
||
开始尝试
|
||
========
|
||
|
||
请运行 ``C:\msys32\mingw32.exe`` 文件，打开一个 MSYS2 MINGW32 终端窗口。该窗口的环境为 bash shell。请创建一个名为 ``esp`` 的文件夹，作为 ESP32 应用程序开发的默认目录。您可以使用以下命令创建文件夹::
|
||
|
||
mkdir -p ~/esp
|
||
|
||
您还可以通过 ``cd ~/esp`` 命令，进入刚刚创建的文件夹。如无其他问题，本步骤到此结束。
|
||
|
||
.. figure:: ../../_static/msys2-terminal-window.png
|
||
:align: center
|
||
:alt: MSYS2 MINGW32 shell 窗口
|
||
:figclass: align-center
|
||
|
||
MSYS2 MINGW32 shell 窗口
|
||
|
||
请在后续步骤中，使用本窗口配置 ESP32 的开发环境。
|
||
|
||
|
||
后续步骤
|
||
==========
|
||
|
||
继续设置开发环境，请前往 :ref:`get-started-get-esp-idf-legacy` 章节。
|
||
|
||
更新环境
|
||
========
|
||
|
||
当 IDF 有更新时，有时需要安装新的工具链或为 Windows MSYS2 环境添加新的要求。如需将旧版本预编译环境中的数据迁移至新版本，您可以：
|
||
|
||
1. 复制旧的 MSYS2 环境（即 ``C:\msys32``），并将其移动/重命名到不同目录下（即 ``C:\msys32_old``）。
|
||
2. 使用上述步骤，下载新的预编译环境。
|
||
3. 将新的 MSYS2 环境解压缩至 ``C:\msys32`` （或您指定的其他位置）。
|
||
4. 找到旧的 ``C:\msys32_old\home`` 文件夹，并将其移动至 ``C:\msys32``。
|
||
5. 此时，如无其他需要，您可以删除旧的 ``C:\msys32_old\home`` 文件夹。
|
||
|
||
注意，您可以在电脑中安装多个不同的 MSYS2 环境，仅需将它们保存在不同的路径下即可。
|
||
|
||
此外，您还可以 :ref:`直接更新现有环境（无需下载新的版本）<updating-existing-windows-environment-legacy>`，但步骤更加复杂。
|
||
|
||
相关文档
|
||
========
|
||
|
||
.. toctree::
|
||
:maxdepth: 1
|
||
|
||
windows-setup-scratch
|
||
|
||
|
||
.. _MSYS2: https://msys2.github.io/
|
||
|