MacOS 平台工具链的标准设置

[English]

安装准备

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

  • 安装 pip:

    sudo easy_install pip
    
  • 安装 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

安装 Python 3

Catalina 10.15 发布说明 中表示不推荐使用 Python 2.7 版本,在未来的 macOS 版本中也不会默认包含 Python 2.7。执行以下命令来检查您当前使用的 Python 版本:

python --version

如果输出结果是 Python 2.7.17,则代表您的默认解析器是 Python 2.7。这时需要您运行以下命令检查电脑上是否已经安装过 Python 3:

python3 --version

如果运行上述命令出现错误,则代表电脑上没有安装 Python 3。

请根据以下步骤安装 Python 3:

  • 使用 HomeBrew 进行安装的方法如下:

    brew install python3
    
  • 使用 MacPorts 进行安装的方法如下:

    sudo port install python38
    

停用 Python 2

Python 2 已经 结束生命周期,ESP-IDF 很快将不再支持 Python 2。请安装 Python 3.6 或以上版本。可参考上面列出的 macOS 安装说明。

后续步骤

继续设置开发环境,请前往 :ref:get-started-get-esp-idf。