1.1.1.2. Host environment
This page outlines the steps to set up an environment for building with the Proximie SDK.
Operating System
Ubuntu 22.04 or 24.04
Ubuntu should be configured to use the XOrg/X11 display server, rather than Wayland; you can check this by running
echo $XDG_SESSION_TYPEin a terminal – it should returnx11.
Build Tools
This SDK has been developed and built using:
CMake |
3.26.4 |
g++ |
11.4.0 |
clang-tidy |
LLVM version 14.0.0 |
Installation of Dependencies
The SDK has several build- and run-time dependencies that must be installed from different sources.
We included scripts to help with this, located in samples/environment/scripts/installers/. You
can either use these, or base your own environment setup on them.
CMake v3.26.4
If you want to use the same version of CMake as the Proximie SDK was built with, 3.26.4, that specific version is likely unavailable in your distribution’s package manager. Use the provided script to add the Kitware APT repository:
samples/environment/scripts/installers/cmake_ppa.sh
The following package installation script will then be able to install CMake v3.26.4.
Pre-packaged dependencies
The Proximie SDK relies on several third-party libraries, which can be installed using apt and pip. These packages are most easily installed using the provided script:
samples/environment/scripts/installers/packages.sh
Boost v1.86
The project uses a recent version of Boost (1.86). Unfortunately, the version available in Ubuntu’s package manager is too old, so we need to build and install the required version ourselves. This can be done using the provided script:
samples/environment/scripts/installers/boost.sh
webrtcdsp Gstreamer plugin
If you are running on Ubuntu 24.04, the webrtcdsp GStreamer plugin is erroneously not included in the gstreamer1.0-plugins-bad package. Therefore it must be built and installed manually. This can be done using the provided script:
samples/environment/scripts/installers/webrtcdsp.sh