epicsQt
Repository Structure
Introduction
This page describes how the repositories at GitHub are organised.
The transfer of the EPICS Qt framework from SourceForge to GitHub has been an ideal opportunity for a few organisational changes. These are outlined below. There were no major functionality changes per se as part of the initial transfer. However since the transfer a lot has happend (e.g. library split into load library and plugin library, archive appliance integration, PV Access integration, abd framework version 4).
The major change as part of the transfer is that EPICS Qt was been split into a number of components, each managed in its own GitHub repository.
The three primary repositories are:
- QE Framework repository which provides the framework functional and plugin libraries,
- QEGui Display Manager repository which provides the qegui display manager; and
- the qtepics.github.io repository which holds useful documentation above and beyond the detailed widget documenation currently part of the QE Framework repository.
The other repositories less significant/optional, and basically provide examples of using or extending the framework.
There is no longer an epicsqt.pro overall project file to build all sub projects. Each code repository still has its own project file(s), e.g. framework.pro, QEGuiApp.pro, and these may be opened by qtcreator in order to build each component as could be done previously.
However, each component is now located within its own EPICS top directory that allows the component to be readily and headlessly built in a much more EPICS-like fashion by just calling make from within the top directory. Under-the-covers, each component’s application directory’s Makefile essentially invokes qmake and then make on the generated Makefile.
In the case of qeframework, the include files are placed in top/include and the shared library/dll file is placed in top/lib/epics_host_arch. The qeframework plugin library is located in top/lib/epics_host_arch/designer. In the case of qegui, the executable is located in top/bin/epics_host_arch.
The use of the environment variable QE_TARGET_DIR may still be used to override this.
Each code repository has a r3.4.2 tag which corresponds to the last SourceForge 3.4.2 release. The latest release is 4.1.2, and each repository has a corresponding r4.1.2 tag.
Last updated: Sat Dec 21 14:12:53 2024