2.5.1. Dependencies

The SDK has several build- and run-time dependencies that must be installed before building or running an application containing the SDK respectively. Note that these dependencies are resolved by following the instructions in Environment. Dependencies are detailed here for reference.

Dependencies can be printed by running a script provided in Proximie SDK releases, samples/environment/dependencies.sh. Pass the -h argument for more information, or see specific examples below.

2.5.1.1. Build-time

These dependencies are required at the point of building an application incorporating the Proximie SDK.

A list of these dependencies can be printed by running a script provided in Proximie SDK releases, samples/environment/dependencies.sh:

samples/environment/scripts/dependencies.sh app-build

Note that by default, the dependencies on the current host system’s Ubuntu version will be printed. To specify a different version, use the -u argument with either 22.04 or 24.04 as the value.

2.5.1.2. Run-time

These dependencies are required at the point of running an application incorporating the Proximie SDK.

A list of these dependencies can be printed by running a script provided in Proximie SDK releases, samples/environment/dependencies.sh:

samples/environment/scripts/dependencies.sh app-deploy

Note that by default, the dependencies on the current host system’s Ubuntu version will be printed. To specify a different version, use the -u argument with either 22.04 or 24.04 as the value.

2.5.1.3. Dependencies of note

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. This can be resolved by either:

  • Setting up your environment as described in the Environment section

  • Running a script provided in Proximie SDK releases to install Boost:

    samples/environment/scripts/installers/boost.sh

  • Fetching, building and installing Boost v1.86 yourself from the official Boost website: https://www.boost.org/releases/1.86.0/.

GStreamer >= v1.20

The Proximie SDK requires GStreamer version 1.20 or higher. On supported Ubuntu versions, this is available in the default APT repositories; Ubuntu 22.04 provides GStreamer 1.20, while Ubuntu 24.04 provides GStreamer 1.24.

CMake v3.26.4

While it isn’t necessary, 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. This can be resolved by either:

  • Setting up your environment as described in the Environment section

  • Running a script provided in Proximie SDK releases to add Kitware’s APT repository:

    samples/environment/scripts/installers/cmake_ppa.sh

    then installing CMake v3.26.4 using apt or apt-get.

webrtcdsp Gstreamer plugin

This plugin is only required if you make use of the AudioStageWebRtcDsp audio stage.

If you are running on Ubuntu 24.04, the webrtcdsp GStreamer plugin is erroneously not included in the gstreamer1.0-plugins-bad package. This can be resolved by either:

  • Setting up your environment as described in the Environment section

  • Running a script provided in Proximie SDK releases to install the plugin:

    samples/environment/scripts/installers/webrtcdsp.sh

  • Building gstreamer1.0-plugins-bad from source, ensuring that the webrtcdsp plugin is included in the build.