**************************************
在 Mac OS 上安装 ESP32 工具链
**************************************
:link_to_translation:`en:[English]`

.. important:: 对不起，CMake-based Build System Preview 还没有中文翻译。

安装准备
================

- 安装 pip::

    sudo easy_install pip

- 安装 pyserial::

    sudo pip install pyserial


安装工具链
===============

Mac OS 版本的 ESP32 工具链可以从以下地址下载：

https://dl.espressif.com/dl/xtensa-esp32-elf-osx-1.22.0-75-gbaf03c2-5.2.0.tar.gz

下载压缩文件之后，解压到 ``~/esp`` 目录中::

    mkdir -p ~/esp
    cd ~/esp
    tar -xzf ~/Downloads/xtensa-esp32-elf-osx-1.22.0-75-gbaf03c2-5.2.0.tar.gz

.. _setup-macos-toolchain-add-it-to-path:

工具链将被解压到 ``~/esp/xtensa-esp32-elf/`` 路径下。

在 ``~/.profile`` 文件中更新 ``PATH`` 环境变量以使用工具链。为了使 ``xtensa-esp32-elf`` 在各种终端会话中都可用，在 ``~/.profile`` 文件中加上以下指令::

     export PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin

或者，您可以为上述命令创建一个别名。这样只有执行以下指令时工具链才能被使用。将下面的指令添加到您的 ``〜/ .profile`` 文件中::

    alias get_esp32="export PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin"

当需要使用工具链时，在命令行里输入 ``get_esp32``，就可以将工具链添加到 ``PATH`` 中。


下一步
==========

前往 :ref:`get-started-get-esp-idf` 继续配置开发环境。


相关文档
=================

.. toctree::
    :maxdepth: 1

    macos-setup-scratch

