从零开始设置 Mac OS 环境下的工具链 (CMake)

[英文]

注解

本文档将介绍如何使用 CMake 编译系统。目前,CMake 编译系统仍处于预览发布阶段,如您在使用中遇到任何问题,请前往 ESP-IDF 提交 Issues

未来,CMake 编译系统将在 ESP-IDF v4.0 发布后过渡为默认编译系统,现行基于 GNU Make 的编译系统将在 ESP-IDF v5.0 后弃用。

软件包管理器

从零开始设置工具链,你需要安装 MacPortshomebrew 包管理器。或者,你也可以直接 下载预编译的工具链

MacPorts 需要安装完整的 XCode 软件,而 homebrew 只需要安装 XCode 命令行工具即可。

准备工作

  • 安装 pip:

    sudo easy_install pip
    
  • 安装 pyserial:

    sudo pip install pyserial
    
  • 安装 CMake 和 Ninja 编译工具:

    • 若使用 HomeBrew,你可以运行:

      brew install cmake ninja
      
    • 若使用 MacPorts,你可以运行:

      sudo port install cmake ninja
      

从源代码编译工具链

  • 相关安装:

    • 对于 MacPorts:

      sudo port install gsed gawk binutils gperf grep gettext wget libtool autoconf automake make
      
    • 对于 homebrew:

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

创建一个文件系统镜像(区分大小写):

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,并开始编译:

git clone -b xtensa-1.22.x https://github.com/espressif/crosstool-NG.git
cd crosstool-NG
./bootstrap && ./configure --enable-local && make install

编译工具链::

./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。根据 Mac OS 下设置环境变量的标准方法 中的介绍,将工具链添加到 PATH 中。

后续步骤

继续设置开发环境,请前往 获取 ESP-IDF 章节。