57 lines
2.0 KiB
ReStructuredText
57 lines
2.0 KiB
ReStructuredText
.. _installing_zephyr_mac:
|
|
|
|
Development Environment Setup on macOS
|
|
######################################
|
|
|
|
.. important::
|
|
|
|
This section only describes OS-specific setup instructions; it is the first step in the
|
|
complete Zephyr :ref:`getting_started`.
|
|
|
|
This section describes how to set up a Zephyr development environment on macOS.
|
|
|
|
These instructions have been tested on the following macOS versions:
|
|
|
|
* Mac OS X 10.11 (El Capitan)
|
|
* macOS Sierra 10.12
|
|
|
|
Update Your Operating System
|
|
****************************
|
|
|
|
Before proceeding with the build, ensure your OS is up to date.
|
|
|
|
.. _mac_requirements:
|
|
|
|
Install Requirements and Dependencies
|
|
*************************************
|
|
|
|
.. NOTE FOR DOCS AUTHORS: DO NOT PUT DOCUMENTATION BUILD DEPENDENCIES HERE.
|
|
|
|
This section is for dependencies to build Zephyr binaries, *NOT* this
|
|
documentation. If you need to add a dependency only required for building
|
|
the docs, add it to doc/README.rst. (This change was made following the
|
|
introduction of LaTeX->PDF support for the docs, as the texlive footprint is
|
|
massive and not needed by users not building PDF documentation.)
|
|
|
|
.. note::
|
|
|
|
Zephyr requires Python 3, while macOS only provides a Python 2
|
|
installation. After following these instructions, the version of Python 2
|
|
provided by macOS in ``/usr/bin/`` will sit alongside the Python 3
|
|
installation from Homebrew in ``/usr/local/bin``.
|
|
|
|
First, install :program:`Homebrew` by following instructions on the `Homebrew
|
|
site`_. Homebrew is a free and open-source package management system that
|
|
simplifies the installation of software on macOS. While installing Homebrew,
|
|
you may be prompted to install additional missing dependencies; please follow
|
|
any such instructions as well.
|
|
|
|
After Homebrew is successfully installed, install the following tools using
|
|
the ``brew`` command line tool in the Terminal application.
|
|
|
|
.. code-block:: console
|
|
|
|
brew install cmake ninja gperf ccache dfu-util qemu dtc python3
|
|
|
|
.. _Homebrew site: https://brew.sh/
|