How to build
Building Vanetza is accomplished by the CMake build system. Hence, CMake needs to be available on the build host.
You need following tools and libraries on your system for compiling Vanetza:
- C++11 compatible compiler, e.g. GNU GCC or Clang
- CMake 3.12 or higher
- Boost 1.58 or higher
- GeographicLib 1.37 or higher
- Crypto++ 5.6.1 or higher
If OpenSSL (1.0 or 1.1) or LibreSSL is available on your system, an alternative security backend implementation is compiled along with the Crypto++ based backend.
security::create_backend for more details.
If you are building on Ubuntu 16.04 or 18.04, please note that these Ubuntu releases ship outdated CMake versions unsuitable for Vanetza. Have a look at the Kitware APT Repository, which lists some of your options for installing an up-to-date CMake version.
Following command line snippet demonstrates the build process using a generated Makefile. Other CMake generators and build directory setups can be used as well.
cd vanetza mkdir build && cd build cmake .. make
Vanetza comes with many unit tests covering the most critical parts.
When the CMake option
BUILD_TESTS is enabled, the Google Test sources are downloaded by the build system automatically.
The built test cases are standalone executables located in the tests subdirectory of your build directory.
For running all test cases, I recommend to invoke
ctest in your build directory.
Vanetza is primarily a library project intended for integration by other projects, e.g. V2X simulation tools such as Artery.
Projects using CMake can integrate Vanetza most easily by calling
find_package(Vanetza) and then refer to the imported Vanetza targets, such as