Install on macOS
====================

The RDK C++ and Python libraries are packed into a unified modern CMake project named ``flexiv_rdk``, which can be configured and installed using CMake on all supported OS.

C++
-------

.. _prepare_cpp_build_tools_on_macos:

Prepare build tools
~~~~~~~~~~~~~~~~~~~~

Compiler kit and CMake are needed and can be installed via:

1. Install compiler kit: In a Terminal, enter command ``xcode-select`` to invoke the installation of Xcode Command Line Tools, then follow the prompted window to finish the installation.
2. Install CMake (with GUI): Download ``cmake-3.x.x-macos-universal.dmg`` from `CMake download page <https://cmake.org/download/>`_ and install the dmg file. The minimum required version is 3.16.3. When done, start CMake from Launchpad and navigate to Tools -> How to Install For Command Line Use. Then follow the instruction "Or, to install symlinks to '/usr/local/bin', run:" to install ``cmake`` and ``cmake-gui`` commands for use in Terminal.


Install dependencies
~~~~~~~~~~~~~~~~~~~~~

The steps are identical to :ref:`install_cpp_deps_on_linux` on Linux.


Install RDK library
~~~~~~~~~~~~~~~~~~~

The steps are identical to :ref:`install_cpp_rdk_on_linux` on Linux.


Link to installed library from a user program
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The steps are identical to :ref:`link_cpp_rdk_on_linux` on Linux.


Python
-------

Prepare build tools
~~~~~~~~~~~~~~~~~~~~

Besides tools in :ref:`prepare_cpp_build_tools_on_macos`, Python interpreter and Python package manager are also needed and can be installed via::

	brew install python@3.x

Replace "3.x" with the actual Python3 version you wish to use.


Install dependencies
~~~~~~~~~~~~~~~~~~~~~

The steps are identical to :ref:`install_py_deps_on_linux` on Linux.


Install RDK library
~~~~~~~~~~~~~~~~~~~

The steps are identical to :ref:`install_py_rdk_on_linux` on Linux.


Link to installed library from a user program
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The steps are identical to :ref:`link_py_rdk_on_linux` on Linux.