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

.. _HOW_TO_BUILD_A_LIBRARY_AND_LINK_IT_IN_A_FOXBMS_2_PROJECT:

How to Build A Library and Link it in a foxBMS 2 Project
========================================================

Sometimes source code can not be shared between parties.
For these cases the |foxbms| project provides a mechanism to ship a minimal
development project to the other party.
This allows the partner to build a static library.
This library and the accompanying headers can then be shared with the partner
and be included in the application.

The following example describes the workflow. In this scenario **Partner A**
develops on |foxbms| while **Partner B** should only provide a library to
**Partner A**.

- **Partner A** bootstraps a minimal development project.
  This minimal project is named ``library-project.tar.gz``.

  .. tabs::

     .. group-tab:: Win32/PowerShell

        .. code-block:: powershell

           .\fox.ps1 waf bootstrap-library-project

     .. group-tab:: Win32/cmd.exe

        .. code-block:: bat

           fox.bat waf bootstrap-library-project

     .. group-tab:: Win32/Git bash

        .. code-block:: shell

           ./fox.ps1 waf bootstrap-library-project

     .. group-tab:: Linux

        .. code-block:: shell

           ./fox.ps1 waf bootstrap-library-project

- **Partner A** shares the archive ``library-project.tar.gz`` with
  **Partner B**.
- **Partner B** installs a |code-composer-studio| as described in
  :ref:`css_install`.
- **Partner B** installs a Python environment as described in
  :ref:`python_installation_and_configuration`.
- **Partner B** builds a library by adding sources etc. to the minimal project
  as needed and builds the library.

  .. tabs::

     .. group-tab:: Win32/PowerShell

        .. code-block:: powershell

           .\fox.ps1 waf build

     .. group-tab:: Win32/cmd.exe

        .. code-block:: bat

           fox.bat waf build

     .. group-tab:: Win32/Git bash

        .. code-block:: shell

           ./fox.ps1 waf build

     .. group-tab:: Linux

        .. code-block:: shell

           ./fox.ps1 waf build

- **Partner B** shares the library and accompanying headers with **Partner A**.
- **Partner A** saves the library and accompanying headers and adds the path to
  the library to the search path, the library name the list of used libraries
  and the path to the headers to the include path (in ``cc-options.yaml``).