macos-setup-scratch.rst

从零开始设置 Mac OS 环境下的工具链（传统 GNU Make）

:link_to_translation:`en:[English]`

Note

安装工具链的标准方法请见 :doc:`这里 <macos-setup>`。请参考 :ref:`工具链自定义设置 <get-started-customized-setup-legacy>` 章节，查看可能需要从头开始设置工具链的情况。

安装准备

• 安装 pip:

  sudo easy_install pip
  

Note

pip 稍后将用于安装 :ref:`必要的 Python 软件包 <get-started-get-packages-legacy>`。

从源代码编译工具链

• 安装依赖项：

  • 安装 MacPorts 或 homebrew 安装包管理器。MacPorts 需要完整的 XCode 软件，而 homebrew 只需要安装 XCode 命令行工具即可。

  • 对于 MacPorts:

    sudo port install gsed gawk binutils gperf grep gettext wget libtool autoconf automake
    

  • 对于 homebrew:

    brew install gnu-sed gawk binutils gperftools gettext wget help2man libtool autoconf automake
    

• 创建一个文件系统镜像（区分大小写）:

  hdiutil create ~/esp/crosstool.dmg -volname "ctng" -size 10g -fs "Case-sensitive HFS+"
  

• 挂载:

  hdiutil mount ~/esp/crosstool.dmg
  

• 创建指向您工作目录的符号链接:

  mkdir -p ~/esp
  ln -s /Volumes/ctng ~/esp/ctng-volume
  

• 前往新创建的目录

  cd ~/esp/ctng-volume
  

• 下载并编译 crosstool-NG ：

  .. include-build-file:: inc/scratch-build-code.inc
  
  

• 编译工具链:

  ./ct-ng xtensa-esp32-elf
  ./ct-ng build
  chmod -R u+w builds/xtensa-esp32-elf
  

编译得到的工具链会被保存到 ~/esp/ctng-volume/crosstool-NG/builds/xtensa-esp32-elf。请按照 :ref:`标准设置指南 <setup-macos-toolchain-add-it-to-path-legacy>` 的介绍，将工具链添加到 PATH。

后续步骤

继续设置开发环境，请前往 :ref:`get-started-get-esp-idf-legacy` 章节。