1********************************************************
2从零开始设置 Mac OS 环境下的工具链(传统 GNU Make)
3********************************************************
4:link_to_translation:`en:[English]`
5
6.. include:: ../gnu-make-legacy.rst
7
8.. note::
9
10    安装工具链的标准方法请见 :doc:`这里 <macos-setup>`。请参考 :ref:`工具链自定义设置 <get-started-customized-setup-legacy>` 章节,查看可能需要从头开始设置工具链的情况。
11
12安装准备
13========
14
15- 安装 pip::
16
17    sudo easy_install pip
18
19.. note::
20
21    ``pip`` 稍后将用于安装 :ref:`必要的 Python 软件包 <get-started-get-packages-legacy>`。
22
23从源代码编译工具链
24===================
25
26- 安装依赖项:
27
28    - 安装 MacPorts_ 或 homebrew_ 安装包管理器。MacPorts 需要完整的 XCode 软件,而 homebrew 只需要安装 XCode 命令行工具即可。
29
30    .. _homebrew: https://brew.sh/
31    .. _MacPorts: https://www.macports.org/install.php
32
33        - 对于 MacPorts::
34
35            sudo port install gsed gawk binutils gperf grep gettext wget libtool autoconf automake
36
37        - 对于 homebrew::
38
39            brew install gnu-sed gawk binutils gperftools gettext wget help2man libtool autoconf automake
40
41- 创建一个文件系统镜像(区分大小写)::
42
43    hdiutil create ~/esp/crosstool.dmg -volname "ctng" -size 10g -fs "Case-sensitive HFS+"
44
45- 挂载::
46
47    hdiutil mount ~/esp/crosstool.dmg
48
49- 创建指向您工作目录的符号链接::
50
51    mkdir -p ~/esp
52    ln -s /Volumes/ctng ~/esp/ctng-volume
53
54- 前往新创建的目录 ::
55
56    cd ~/esp/ctng-volume
57
58- 下载并编译 ``crosstool-NG`` :
59
60    .. include-build-file:: inc/scratch-build-code.inc
61
62- 编译工具链::
63
64    ./ct-ng xtensa-esp32-elf
65    ./ct-ng build
66    chmod -R u+w builds/xtensa-esp32-elf
67
68编译得到的工具链会被保存到 ``~/esp/ctng-volume/crosstool-NG/builds/xtensa-esp32-elf``。请按照 :ref:`标准设置指南 <setup-macos-toolchain-add-it-to-path-legacy>` 的介绍,将工具链添加到 ``PATH``。
69
70
71后续步骤
72========
73
74继续设置开发环境,请前往 :ref:`get-started-get-esp-idf-legacy` 章节。
75