Buffer Interprocess Sharing: Getting Started - Building BIPS

From RidgeRun Developer Wiki


Previous: Getting Started/Getting the Code Index  






Dependencies

BIPS has the following dependencies for building from source:

  • libboost-system
  • libspdlog

Info: You may need to have POSIX Shared Memory enabled in your kernel.

Core

Please, install them using (in Debian-based systems):

sudo apt install -y     \
    libboost-system-dev \
    libspdlog-dev       \
    python3-dev

Documentation (optional)

For the documentation, consider the following dependencies:

  • doxygen
  • graphviz
  • java

Please, install them using (in Debian-based systems):

sudo apt install -y     \
    doxygen             \
    graphviz            \
    default-jre         \
    texlive-font-utils

Meson building system

At the building system level:

  • ninja-build
  • python3-pip
  • pkg-config
  • meson

Please, install them using (in Debian-based systems):

sudo apt install -y \
     python3        \
     python3-pip    \
     ninja-build    \
     pkg-config

The process should be similar in other systems, not based on Debian.

Then, install meson and other elements.

sudo pip3 install meson      \
                  pre-commit
pip3 install numpy

Building the project

Once fulfilled the dependencies, you can run a default compilation with:

meson build -Dnvsci_lib=/usr/lib/$(uname -m)-linux-gnu
ninja -C build
sudo ninja -C build install

For additional customization, you may refer to the following table of options:

`
Configure Option Description
-Denable-python=disabled Skip the Python API compilation. Enabled by default.
-Dwith-python-version=3.8 Sets the Python version. It takes '3' by default.
-Denable-docs=disabled Skip documentation generation. Enabled by default.
--prefix /usr Set the installation path of the library
Table 1. BIPS configuration options (Meson)

Examples are compiled in the build folder for testing purposes. You can run them in build/src/examples



Previous: Getting Started/Getting the Code Index