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

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

Basic installation

Package	Purpose	Installation
OpenSSL	Required for HTTPS/wss	`sudo apt install libssl-dev`
GStreamer	Audio & video streaming	GStreamer installation on Ubuntu (will require sudo)
	Other GStreamer dependencies	`sudo apt-get install gstreamer1.0-nice`

For a full list of apt-installed dependencies, including optional ones, see the Dockerfile in the samples/environment/docker in the Proximie SDK release archive.

Boost v1.86

The project uses a recent version of Boost (1.86). For Ubuntu at least we need to build the version we need, but the process is well documented for the various platforms.

Briefly:

Don’t use apt install, this will give you a version that is too old.
Install the required build tools (some or all of these may already be present):

sudo apt install build-essential g++ python3-dev autotools-dev libicu-dev libbz2-dev

You can download the latest Boost library from https://www.boost.org/users/download/ or choose an older/specific version from https://www.boost.org/users/history/.
Extract the Unix tar archive, which creates a folder you can build from (e.g. boost_1_86_0)
cd into this new folder, then bootstrap the B2 (Boost Build) engine:

./bootstrap.sh --prefix=/usr/ gcc

Next, execute b2 to perform build checks and to build the Boost library:

./b2

Now you can install the Boost library using the following command:

sudo ./b2 install

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. You can install it by enabling the the Kitware APT repository:

sudo apt update && \
sudo apt install --no-install-recommends -y ca-certificates gpg wget && \
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null && \
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ jammy main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null && \

Then installing the specific version of CMake:

sudo apt update && \
sudo apt install -y cmake=3.26.4-0kitware1ubuntu22.04.1 cmake-data=3.26.4-0kitware1ubuntu22.04.1