Custom installation

These instructions are intended for developers.

All COA packages are ordinary CMake packages and they can be compiled and installed on any Linux distribution of the user’s choice, like any other CMake project.

Prerequisites for oac-tree GUI

• C++-17

• CMake >= 3.14

• gtest >= 1.12

• libxml2

• oac-tree and plugins

• Qt6 (qt6-base, qt6-tools, qt6-charts, qt6-svg)

A Qt5 build is also possible with the -DCOA_USE_QT6=OFF flag.

Install COA packages

Check out and install packages from oac-tree repository collections

• sup-utils

• sup-dto

• sup-di

• sup-protocol

• sup-epics

• oac-tree

• oac-tree-epics

• oac-tree-server

• sup-mvvm

• sup-gui-extra

• sup-gui-core

• oac-tree-gui

Packages have to be installed one-by-one using the standard CMake chain in the order given by the list above. The example below is provided for the sup-utils package. This assumes that the user wants to install all dependencies into <path-to-local-install> (e.g. /opt/local):

git clone https://github.com/oac-tree/sup-utils.git
mkdir <build>; cd <build>
cmake -DCMAKE_PREFIX_PATH=<path-to-local-install> -DCMAKE_INSTALL_PREFIX=<path-to-local-install> <path-to-repo>
make -j4; ctest; make install

You might need to add <path-to-local-install>/lib to LD_LIBRARY_PATH.

Alternative installation method

This method doesn’t require installing the packages; all packages will be used from their <build> directories thanks to CMake’s build tree export feature (the configuration is located in the $HOME/.cmake directory). Use -DCOA_EXPORT_BUILD_TREE=ON during the CMake configuration phase:

git clone https://github.com/oac-tree/sup-utils.git
mkdir <build>; cd <build>
cmake -DCOA_EXPORT_BUILD_TREE=ON <path-to-repo>
make -j4; ctest