1***********************************************
2从零开始设置 macOS 环境下的工具链
3***********************************************
4
5:link_to_translation:`en:[English]`
6
7软件包管理器
8===============
9
10从零开始设置工具链，您需要安装 MacPorts_ 或 Homebrew_ 软件包管理器。或者，您也可以直接下载 :doc:`预编译的工具链 <macos-setup>`。
11
12MacPorts 需要完整的 XCode 软件，而 Homebrew 只需要安装 XCode 命令行工具即可。
13
14.. _Homebrew: https://brew.sh/
15.. _MacPorts: https://www.macports.org/install.php
16
17请参考 :ref:`工具链自定义设置 <get-started-customized-setup>` 章节，查看可能需要从头开始设置工具链的情况。
18
19安装准备
20=====================
21
22- 安装 pip::
23
24	sudo easy_install pip
25
26- 安装 pyserial::
27
28	pip install --user pyserial
29
30- 安装 CMake 和 Ninja 编译工具：
31
32	- 若有 Homebrew，您可以运行::
33
34		brew install cmake ninja dfu-util
35
36	- 若有 MacPorts，您可以运行::
37
38		sudo port install cmake ninja dfu-util
39
40从源代码编译工具链
41=================================
42
43安装依赖项：
44
45- 对于 MacPorts::
46
47	sudo port install gsed gawk binutils gperf grep gettext wget libtool autoconf automake make
48
49- 对于 Homebrew::
50
51	brew install gnu-sed gawk binutils gperftools gettext wget help2man libtool autoconf automake make
52
53创建一个文件系统镜像（区分大小写）::
54
55    hdiutil create ~/esp/crosstool.dmg -volname "ctng" -size 10g -fs "Case-sensitive HFS+"
56
57挂载::
58
59	hdiutil mount ~/esp/crosstool.dmg
60
61创建指向您工作目录的符号链接::
62
63    mkdir -p ~/esp
64    ln -s /Volumes/ctng ~/esp/ctng-volume
65
66前往新创建的目录::
67
68	cd ~/esp/ctng-volume
69
70下载并编译 ``crosstool-NG``:
71
72.. include-build-file:: inc/scratch-build-code.inc
73
74编译工具链::
75
76	./ct-ng {IDF_TARGET_TOOLCHAIN_PREFIX}
77	./ct-ng build
78	chmod -R u+w builds/{IDF_TARGET_TOOLCHAIN_PREFIX}
79
80编译得到的工具链会被保存到 ``~/esp/ctng-volume/crosstool-NG/builds/{IDF_TARGET_TOOLCHAIN_PREFIX}``。使用工具链前，请将 ``~/esp/ctng-volume/crosstool-NG/builds/{IDF_TARGET_TOOLCHAIN_PREFIX}/bin`` 添加至 ``PATH`` 环境变量。
81
82后续步骤
83==========
84
85请前往 :ref:`get-started-get-esp-idf` 章节继续设置开发环境。