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
    

  • 若以上均不适用，请访问 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。

安装并设置 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
  ln -s /usr/local/bin/python3.8 /usr/local/bin/python
  

  将上述的目录名 /usr/local/bin/python3.8 修改为 Python 3 所在的目录。您可以运行 which -a python3 来查看 Python 3 所在的目录。

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

  sudo port install python38
  sudo port select --set python python38
  

现在您可以打开终端窗口验证默认运行的 Python 版本:

python --version

如果输出结果类似于 Python 3.8.5 则代表安装成功。

注解

上述设置为全局设置，同时会影响到其它应用。

停用 Python 2

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

后续步骤

继续设置开发环境，请前往 第二步：获取 ESP-IDF 章节。

提供有关此文档的反馈