在 Mac OS 上安装 ESP32 工具链 (CMake)

[英文]

注解

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

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

安装准备

ESP-IDF 将使用 Mac OS 上默认安装的 Python 版本。

  • 安装 pip:

    sudo easy_install pip

  • 安装 pyserial:

    sudo pip install pyserial

  • 安装 CMake 和 Ninja 编译工具：

    • 若有 HomeBrew，你可以运行:

      brew install cmake ninja

    • 若有 MacPorts，你可以运行:

      sudo port install cmake ninja

    • 若以上均不适用，访问 CMake 和 Ninja 主页，查询有关 Mac OS 平台的下载安装问题。

  • 强烈建议同时安装 ccache 以达到更快的编写速度。如有 HomeBrew，可通过 MacPorts 上的 brew install ccache 或 sudo port install ccache 完成安装。

注解

如在任一步骤中出现以下报错信息:

``xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun``

你需要安装 XCode 命令行工具才能继续，具体可运行 xcode-select --install 进行安装。

安装工具链

下载 MacOS 版本的 ESP32 工具链，请前往乐鑫官网：

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

完成下载后，请在 ~/esp 目录下进行解压：

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

此后，该工具链将解压至 ~/esp/xtensa-esp32-elf/ 目录。

为了开始使用工具链，你必须更新 ~/.profile 文件中的 PATH 环境变量。为了让所有终端都可以使用 xtensa-esp32-elf，请将下方命令增加至你的 ~/.profile 文件：:

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

此外，你可以为以上命令增加一个别名。这样，你就可以仅在有需要时获取工具链。具体方式是在 ~/.profile 文件中增加下方命令：:

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

此时，你可以直接输入 get_esp32 命令，即可将工具链添加至你的 PATH。

注意，这里需要退出并重新登陆，.profile 更改才会生效。

此外，你可以使用以下命令，验证 PATH 是否设置正确：:

printenv PATH

后续步骤

前往 获取 ESP-IDF，完成接下来的开发环境配置。