|
1 |
| -.. _installing_zephyr_mac: |
| 1 | +.. _mac-setup-alts: |
2 | 2 |
|
3 |
| -Install macOS Host Dependencies |
4 |
| -############################### |
5 |
| - |
6 |
| -This section describes how to set up a Zephyr development environment on macOS. |
7 |
| - |
8 |
| -These instructions have been tested on the following macOS versions: |
9 |
| - |
10 |
| -* macOS 10.14 Mojave |
11 |
| -* macOS 10.15 Catalina |
12 |
| - |
13 |
| -Update Your Operating System |
14 |
| -**************************** |
15 |
| - |
16 |
| -Before proceeding with the build, ensure your OS is up to date. |
17 |
| - |
18 |
| -.. _mac_requirements: |
19 |
| - |
20 |
| -Install Requirements and Dependencies |
21 |
| -************************************* |
22 |
| - |
23 |
| -.. NOTE FOR DOCS AUTHORS: DO NOT PUT DOCUMENTATION BUILD DEPENDENCIES HERE. |
24 |
| -
|
25 |
| - This section is for dependencies to build Zephyr binaries, *NOT* this |
26 |
| - documentation. If you need to add a dependency only required for building |
27 |
| - the docs, add it to doc/README.rst. (This change was made following the |
28 |
| - introduction of LaTeX->PDF support for the docs, as the texlive footprint is |
29 |
| - massive and not needed by users not building PDF documentation.) |
30 |
| -
|
31 |
| -Zephyr requires Python 3, while macOS only provides a Python 2 |
32 |
| -installation. After following these instructions, the version of Python 2 |
33 |
| -provided by macOS in ``/usr/bin/`` will sit alongside the Python 3 installation |
34 |
| -from Homebrew in ``/usr/local/bin``. |
35 |
| - |
36 |
| -First, install :program:`Homebrew` by following instructions on the `Homebrew |
37 |
| -site`_. Homebrew is a free and open-source package management system that |
38 |
| -simplifies the installation of software on macOS. While installing Homebrew, |
39 |
| -you may be prompted to install additional missing dependencies; please follow |
40 |
| -any such instructions as well. |
41 |
| - |
42 |
| -Now install these host dependencies with the ``brew`` command: |
43 |
| - |
44 |
| -.. code-block:: console |
45 |
| -
|
46 |
| - brew install cmake ninja gperf ccache dfu-util qemu dtc python3 |
47 |
| -
|
48 |
| -.. _Homebrew site: https://brew.sh/ |
| 3 | +macOS alternative setup instructions |
| 4 | +#################################### |
49 | 5 |
|
50 | 6 | .. _mac-gatekeeper:
|
51 | 7 |
|
|
0 commit comments