Appearance

Building MAVSDK on Linux ​

This guide explains how to build MAVSDK from source on Linux systems.

Requirements ​

The build requirements are git, cmake, and a C++ compiler (GCC or Clang).

Ubuntu ​

bash
sudo apt-get update
sudo apt-get install build-essential cmake git

Fedora ​

bash
sudo dnf update
sudo dnf groupinstall "Development Tools" "Development Libraries"
sudo dnf install cmake git

Getting the Source ​

Download the source using git:

bash
git clone https://github.com/mavlink/MAVSDK.git
cd MAVSDK
git submodule update --init --recursive

Building the MAVSDK library on Linux ​

Debug Build ​

For development, use the debug build:

bash
cmake -DCMAKE_BUILD_TYPE=Debug -Bbuild -S.
cmake --build build -j8

Release Build ​

For production use, build with optimizations enabled:

bash
cmake -DCMAKE_BUILD_TYPE=Release -Bbuild -S.
cmake --build build -j8

Installation ​

System-wide Installation ​

To install system-wide in /usr/local:

bash
sudo cmake --build build --target install
sudo ldconfig  # Update linker cache

Local Installation ​

To install to a custom location, e.g. install

bash
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install -Bbuild -S.
cmake --build build --target install

Build mavsdk_server binary on Linux ​

Language wrappers for MAVSDK other than C++ connect to the MAVSDK C++ core using gRPC. This gRPC server around the MAVSDK C++ library is called mavsdk_server (in the past it was referred to as the backend).

For more information about the architecture, also see how the auto-generation works.

In order to include the mavsdk_server in the build, add -DBUILD_MAVSDK_SERVER=ON:

bash
cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_MAVSDK_SERVER=ON -Bbuild -S.
cmake --build build -j8

Build Options ​

During the configure step you can set various flags using -DFLAG=Value:

  • CMAKE_BUILD_TYPE: Choose between Debug, Release, or RelWithDebInfo (optimizations and debug symbols)
  • CMAKE_INSTALL_PREFIX: Specify directory to install library artifacts
  • BUILD_SHARED_LIBS: Set to ON for dynamic libraries (.so), OFF for static libraries (.a)
  • SUPERBUILD: Set to OFF to use system dependencies instead of third party dependencies
  • CMAKE_PREFIX_PATH: Set path where dependencies can be found if SUPERBUILD is OFF
  • BUILD_MAVSDK_SERVER: Set to ON to build mavsdk_server
  • BUILD_WITHOUT_CURL: Set to ON to build without CURL support
  • ASAN: Set to ON to enable address sanitizer
  • UBSAN: Set to ON to enable undefined behavior sanitizer
  • LSAN: Set to ON to enable leak sanitizer
  • WERROR: Set to ON to treat warnings as errors

Troubleshooting ​

Git Submodules Out of Date ​

If you encounter build issues, try updating the submodules:

bash
git submodule update --recursive

Undefined References ​

If you get undefined reference errors after installation, update the linker cache:

bash
sudo ldconfig

And try a clean build by wiping the build directory:

bash
rm -r build