.. include:: ./../../macros.txt
.. include:: ./../../units.txt

.. _BUILDING_THE_APPLICATION:

Building the Application
------------------------

.. note::

   As mentioned in :ref:`FOX_PY` it is recommended to use one of the shell
   scripts to interact with the repository, as these activate the correct build
   environment and prepare the ``PATH`` variable before starting the build
   process.
   If these shell scripts are not used to call the build tool the following
   steps are required:

   - activating the correct environment
   - make all tools available in ``PATH``
   - the current working directory must be the repository root
   - instead of ``.\fox.ps1 waf <some-command>`` use ``python3 tools/waf <some-command>``

#. Open a terminal and change into a checkout of the foxbms repository
#. Configuration of the project

   .. tabs::

      .. group-tab:: Win32/PowerShell

         .. code-block:: powershell

            .\fox.ps1 waf configure

      .. group-tab:: Win32/Git bash

         .. code-block:: shell

            ./fox.ps1 waf configure

      .. group-tab:: Linux

         .. code-block:: shell

            ./fox.ps1 waf configure

#. Now all build variants are available, e.g., to build the binaries
   (``build_app_embedded``) and the documentation (``build_docs``):

   .. tabs::

      .. group-tab:: Win32/PowerShell

         .. code-block:: powershell

            .\fox.ps1 waf build_app_embedded build_docs

      .. group-tab:: Win32/Git bash

         .. code-block:: shell

            ./fox.ps1 waf build_app_embedded build_docs

      .. group-tab:: Linux

         .. code-block:: shell

            ./fox.ps1 waf build_app_embedded build_docs

   Waf commands can be concatenated and are executed in the order of their
   appearance.

For a complete list of available |waf| commands see :ref:`FOX_WAF`.