Building Test Applications

The Native SDK offers simple test applications for checking whether the SDK installation is correct. The following instructions explain how to build the applications.

Mac

Use the following commands in the SDK folder to build the application:

mkdir build && cd build

cmake .. -DMillicastSDK_DIR=/path_to_millicastSDK/lib/cmake

cmake --build .

Windows

Use the following commands in the example folder to build the application:

mkdir build && cd build

cmake .. -DMillicastSDK_DIR=/path_to_millicastSDK/lib/cmake

cmake --build . --config Debug

Before running, you might want to add the bin directory to your path as it contains the NDI DLLs, which are required in your path environment variable to start the application. After using the command, open the debug directory and execute the application.

Linux x64

Installing dependencies

Ubuntu GNU libstdc++ library

The application requires the following dependencies: X11, Xtst, Xfixes, Xdamage, Xrandr, Xcomposite,
avahi-common, and avahi-client. You may install them using the following command:

sudo apt install -y libx11-dev libxfixes-dev libxdamage-dev libxcomposite-dev libxtst-dev \
  libxrandr-dev libavahi-client3 libavahi-common3

Ubuntu LLVM libc++ library

The application requires the following dependencies: X11, Xtst, Xfixes, Xdamage, Xrandr, Xcomposite,
avahi-common, and avahi-client. You may install them using the following command:

sudo apt install -y libx11-dev libxfixes-dev libxdamage-dev libxcomposite-dev libxtst-dev \
  libxrandr-dev libavahi-client3 libavahi-common3

Compile with clang to have libc++-dev and libc++abi-dev installed:

export CC=/usr/bin/clang
export CXX=/usr/bin/clang++

Debian11 arm-v8a GNU libstdc++ library

Applications built with the debian11-armv8a-nox11-nopulse package have no extra dependencies required for the system. They do require the kernel to have V4L2 and ALSA. When run on the Raspberry Pi 3b+ and higher the SDK provides H264 hardware encoding support for applications.

Building applications

The test applications are built in the same way on all Linux platforms. Build applications using the following commands in the SDK folder:

mkdir build && cd build
cmake .. -DMillicastSDK_DIR=/path_to/MillicastSDK/lib/cmake
make -j4