Setup¶
Dowloading pre-compiled OpenZen¶
The pre-compiled binaries for OpenZen for Windows and Linux are available to download here:
The folder example in this download contains a full example how to use OpenZen together with VisualStudio 2017 on Windows x64-bit. Furthermore, it also contains releases of OpenZen for Ubuntu 16.04 (and newer) with support for x64 and ARM64.
Building OpenZen from Source¶
OpenZen uses CMake (3.11 or higher) as build system, and has been built and tested on Windows (MSVC), Ubuntu (gcc7) and Mac (XCode). As OpenZen is written in C++17, an up-to-date compiler is required. The following steps guide you through building OpenZen for Windows and Linux.
Windows¶
- Install MSVC build tools, or the Visual Studio IDE (requires C++17 support)
- Install CMake, or a GUI (e.g. Visual Studio) that incorporates CMake
- Clone the repository:
git clone --recurse-submodules https://bitbucket.org/lpresearch/openzen.git
Open the folder OpenZen in Visual Studio and compile the library. You will then be able to run the the command line tool OpenZenExample in the output folder of Visual Studio.
Linux¶
- Install gcc7 or higher (requires C++17 support):
sudo apt-get install gcc-7 - Install CMake, git:
sudo apt-get install git cmake - Install the Bluetooth libraries if you need Bluetooth support:
sudo apt-get install libbluetooth-dev - Install Qt (5.11.2 or higher) if you need Bluetooth Low Energy support:
sudo apt-get install qtbase5-dev qtconnectivity5-dev - Clone the repository:
git clone --recurse-submodules https://bitbucket.org/lpresearch/openzen.git
- Create a build folder and run cmake:
cd openzen
mkdir build && cd build
cmake ..
Now you can run the OpenZenExample:
make -j4
examples/OpenZenExample
OpenZen Build Options¶
These build options can be supplied to the cmake command to customize your OpenZen build. For example
cmake -DZEN_BLUETOOTH=OFF -DZEN_PYTHON=ON ..
| Name | Default | Description |
|---|---|---|
| ZEN_USE_STATIC_LIBS | OFF | Compile OpenZen as a static library |
| ZEN_STATIC_LINK_LIBCXX | OFF | Option to statically link libstdc++ to be portable to older systems (Linux only) |
| ZEN_BLUETOOTH | ON | Compile with bluetooth support |
| ZEN_BLUETOOTH_BLE | OFF | Compile with bluetooth low-energy support, needs Qt installed |
| ZEN_NETWORK | OFF | Compile with support for network streaming of measurement data |
| ZEN_CSHARP | ON | Compile C# bindings for OpenZen |
| ZEN_PYTHON | OFF | Compile Python bindings for OpenZen |
| ZEN_TESTS | ON | Compile with OpenZen tests |
| ZEN_EXAMPLES | ON | Compile with OpenZen examples |