Building QET from source

This section is for users and contributors wanting to build and/or improve QElectroTech (QET).

This guide assumes that you have forked the source repo and that your system has the Git VCS (Version Control System) configured to point to that fork.

If you need help to setup Git or you are unsure about something regarding pushing code to the repo, please have a look at the Contributing guidelines.

Prerequisites

  • Get the sources and initialize the submodules by running this command

git clone --recursive https://github.com/qelectrotech/qelectrotech-source-mirror.git

Linux

Native

  • For a Debian-like machine (Ubuntu, Linux Mint, etc), install the required packages

sudo apt install libqt5svg5-dev qt5-qmake qtbase5-dev libkf5widgetsaddons-dev libkf5coreaddons-dev libsqlite3-dev pkgconf

Containerized

If you are worried about risks of dependency breakage, you can use a tool like Distrobox to easily setup a contained environment. After creating the box with your choice OS, follow the package install guidelines in the “Native” part of the build docs.

Example of Debian box creation. Replace <name> with the one you want to give to it.

distrobox-create -i debian:latest -n <name>

Compilation instructions

Windows

Linux

IDE Setup

  1. After installing the dependencies, install the QT Creator IDE. Depending on your OS type, you have two options:

  • If you are using a bleeding edge distro like Fedora, Arch or Ubuntu Non LTS , chances are that their builds are up to date. Install it by running the apt command:

sudo apt install qt-creator

  • If you are using a distro with a slower release cycle like Debian, you’ll need to do two things:

    1. First setup Flatpak

    2. Then use Flatpak to install the QT Creator IDE

flatpak install flathub io.qt.QtCreator

  1. After installation, click on “File”>”Open File or Project” or use the shortcut ctrl+O to open your OS file dialog. Click the .pro file to open the project and click “Build”>”Run” to run the project.

CLI Compilation

If you do not want to use the QT Creator IDE or you are using another IDE (VSCode, Sublime Text, etc…), you can compile the codebase using these commands:

cd qelectrotech-source-mirror.git
mkdir build && cd build
qmake  ../qelectrotech.pro
make -j$(nproc)

This will instruct qmake to prepare the required files in the build directory and launch compilation with the make command.