|
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