在 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
      
    • 若以上均不适用,访问 CMakeNinja 主页,查询有关 Mac OS 平台的下载安装问题。

  • 强烈建议同时安装 ccache 以达到更快的编写速度。如有 HomeBrew,可通过 MacPorts 上的 brew install ccachesudo 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-macos-1.22.0-97-gc752ad5-5.2.0.tar.gz

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

mkdir -p ~/esp
cd ~/esp
tar -xzf ~/Downloads/xtensa-esp32-elf-macos-1.22.0-97-gc752ad5-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,完成接下来的开发环境配置。