macos-setup.rst 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. **********************************************
  2. macOS 平台工具链的标准设置
  3. **********************************************
  4. :link_to_translation:`en:[English]`
  5. 安装准备
  6. =====================
  7. ESP-IDF 将使用 macOS 上默认安装的 Python 版本。
  8. - 安装 pip::
  9. sudo easy_install pip
  10. - 安装 CMake 和 Ninja 编译工具:
  11. - 若有 HomeBrew_,您可以运行::
  12. brew install cmake ninja dfu-util
  13. - 若有 MacPorts_,您可以运行::
  14. sudo port install cmake ninja dfu-util
  15. - 若以上均不适用,请访问 CMake_ 和 Ninja_ 主页,查询有关 macOS 平台的下载安装问题。
  16. - 强烈建议同时安装 ccache_ 以获得更快的编译速度。如有 HomeBrew_,可通过 MacPorts_ 上的 ``brew install ccache`` 或 ``sudo port install ccache`` 完成安装。
  17. .. note::
  18. 如您在上述任何步骤中遇到以下错误::
  19. ``xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at:/Library/Developer/CommandLineTools/usr/bin/xcrun``
  20. 则必须安装 XCode 命令行工具,具体可运行 ``xcode-select --install``。
  21. 安装 Python 3
  22. ---------------------------------------------
  23. `Catalina 10.15 发布说明`_ 中表示不推荐使用 Python 2.7 版本,在未来的 macOS 版本中也不会默认包含 Python 2.7。执行以下命令来检查您当前使用的 Python 版本::
  24. python --version
  25. 如果输出结果是 ``Python 2.7.17``,则代表您的默认解析器是 Python 2.7。这时需要您运行以下命令检查电脑上是否已经安装过 Python 3::
  26. python3 --version
  27. 如果运行上述命令出现错误,则代表电脑上没有安装 Python 3。
  28. 请根据以下步骤安装 Python 3:
  29. - 使用 HomeBrew_ 进行安装的方法如下::
  30. brew install python3
  31. - 使用 MacPorts_ 进行安装的方法如下::
  32. sudo port install python38
  33. 后续步骤
  34. ==========
  35. 请前往 :ref:`get-started-get-esp-idf` 章节继续设置开发环境。
  36. .. _cmake: https://cmake.org/
  37. .. _ninja: https://ninja-build.org/
  38. .. _ccache: https://ccache.samba.org/
  39. .. _homebrew: https://brew.sh/
  40. .. _MacPorts: https://www.macports.org/install.php
  41. .. _Catalina 10.15 发布说明: https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes